ptrace.h 3.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111
  1. /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
  2. #ifndef _UAPI_LINUX_PTRACE_H
  3. #define _UAPI_LINUX_PTRACE_H
  4. /* ptrace.h */
  5. /* structs and defines to help the user use the ptrace system call. */
  6. /* has the defines to get at the registers. */
  7. #include <linux/types.h>
  8. #define PTRACE_TRACEME 0
  9. #define PTRACE_PEEKTEXT 1
  10. #define PTRACE_PEEKDATA 2
  11. #define PTRACE_PEEKUSR 3
  12. #define PTRACE_POKETEXT 4
  13. #define PTRACE_POKEDATA 5
  14. #define PTRACE_POKEUSR 6
  15. #define PTRACE_CONT 7
  16. #define PTRACE_KILL 8
  17. #define PTRACE_SINGLESTEP 9
  18. #define PTRACE_ATTACH 16
  19. #define PTRACE_DETACH 17
  20. #define PTRACE_SYSCALL 24
  21. /* 0x4200-0x4300 are reserved for architecture-independent additions. */
  22. #define PTRACE_SETOPTIONS 0x4200
  23. #define PTRACE_GETEVENTMSG 0x4201
  24. #define PTRACE_GETSIGINFO 0x4202
  25. #define PTRACE_SETSIGINFO 0x4203
  26. /*
  27. * Generic ptrace interface that exports the architecture specific regsets
  28. * using the corresponding NT_* types (which are also used in the core dump).
  29. * Please note that the NT_PRSTATUS note type in a core dump contains a full
  30. * 'struct elf_prstatus'. But the user_regset for NT_PRSTATUS contains just the
  31. * elf_gregset_t that is the pr_reg field of 'struct elf_prstatus'. For all the
  32. * other user_regset flavors, the user_regset layout and the ELF core dump note
  33. * payload are exactly the same layout.
  34. *
  35. * This interface usage is as follows:
  36. * struct iovec iov = { buf, len};
  37. *
  38. * ret = ptrace(PTRACE_GETREGSET/PTRACE_SETREGSET, pid, NT_XXX_TYPE, &iov);
  39. *
  40. * On the successful completion, iov.len will be updated by the kernel,
  41. * specifying how much the kernel has written/read to/from the user's iov.buf.
  42. */
  43. #define PTRACE_GETREGSET 0x4204
  44. #define PTRACE_SETREGSET 0x4205
  45. #define PTRACE_SEIZE 0x4206
  46. #define PTRACE_INTERRUPT 0x4207
  47. #define PTRACE_LISTEN 0x4208
  48. #define PTRACE_PEEKSIGINFO 0x4209
  49. struct ptrace_peeksiginfo_args {
  50. __u64 off; /* from which siginfo to start */
  51. __u32 flags;
  52. __s32 nr; /* how may siginfos to take */
  53. };
  54. #define PTRACE_GETSIGMASK 0x420a
  55. #define PTRACE_SETSIGMASK 0x420b
  56. #define PTRACE_SECCOMP_GET_FILTER 0x420c
  57. #define PTRACE_SECCOMP_GET_METADATA 0x420d
  58. struct seccomp_metadata {
  59. __u64 filter_off; /* Input: which filter */
  60. __u64 flags; /* Output: filter's flags */
  61. };
  62. /* Read signals from a shared (process wide) queue */
  63. #define PTRACE_PEEKSIGINFO_SHARED (1 << 0)
  64. /* Wait extended result codes for the above trace options. */
  65. #define PTRACE_EVENT_FORK 1
  66. #define PTRACE_EVENT_VFORK 2
  67. #define PTRACE_EVENT_CLONE 3
  68. #define PTRACE_EVENT_EXEC 4
  69. #define PTRACE_EVENT_VFORK_DONE 5
  70. #define PTRACE_EVENT_EXIT 6
  71. #define PTRACE_EVENT_SECCOMP 7
  72. /* Extended result codes which enabled by means other than options. */
  73. #define PTRACE_EVENT_STOP 128
  74. /* Options set using PTRACE_SETOPTIONS or using PTRACE_SEIZE @data param */
  75. #define PTRACE_O_TRACESYSGOOD 1
  76. #define PTRACE_O_TRACEFORK (1 << PTRACE_EVENT_FORK)
  77. #define PTRACE_O_TRACEVFORK (1 << PTRACE_EVENT_VFORK)
  78. #define PTRACE_O_TRACECLONE (1 << PTRACE_EVENT_CLONE)
  79. #define PTRACE_O_TRACEEXEC (1 << PTRACE_EVENT_EXEC)
  80. #define PTRACE_O_TRACEVFORKDONE (1 << PTRACE_EVENT_VFORK_DONE)
  81. #define PTRACE_O_TRACEEXIT (1 << PTRACE_EVENT_EXIT)
  82. #define PTRACE_O_TRACESECCOMP (1 << PTRACE_EVENT_SECCOMP)
  83. /* eventless options */
  84. #define PTRACE_O_EXITKILL (1 << 20)
  85. #define PTRACE_O_SUSPEND_SECCOMP (1 << 21)
  86. #define PTRACE_O_MASK (\
  87. 0x000000ff | PTRACE_O_EXITKILL | PTRACE_O_SUSPEND_SECCOMP)
  88. #include <asm/ptrace.h>
  89. #endif /* _UAPI_LINUX_PTRACE_H */