ptrace.h 5.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197
  1. /* `ptrace' debugger support interface. Linux version.
  2. Copyright (C) 1996-2012 Free Software Foundation, Inc.
  3. This file is part of the GNU C Library.
  4. The GNU C Library is free software; you can redistribute it and/or
  5. modify it under the terms of the GNU Lesser General Public
  6. License as published by the Free Software Foundation; either
  7. version 2.1 of the License, or (at your option) any later version.
  8. The GNU C Library is distributed in the hope that it will be useful,
  9. but WITHOUT ANY WARRANTY; without even the implied warranty of
  10. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  11. Lesser General Public License for more details.
  12. You should have received a copy of the GNU Lesser General Public
  13. License along with the GNU C Library; if not, see
  14. <http://www.gnu.org/licenses/>. */
  15. #ifndef _SYS_PTRACE_H
  16. #define _SYS_PTRACE_H 1
  17. #include <features.h>
  18. __BEGIN_DECLS
  19. /* Type of the REQUEST argument to `ptrace.' */
  20. enum __ptrace_request
  21. {
  22. /* Indicate that the process making this request should be traced.
  23. All signals received by this process can be intercepted by its
  24. parent, and its parent can use the other `ptrace' requests. */
  25. PTRACE_TRACEME = 0,
  26. #define PT_TRACE_ME PTRACE_TRACEME
  27. /* Return the word in the process's text space at address ADDR. */
  28. PTRACE_PEEKTEXT = 1,
  29. #define PT_READ_I PTRACE_PEEKTEXT
  30. /* Return the word in the process's data space at address ADDR. */
  31. PTRACE_PEEKDATA = 2,
  32. #define PT_READ_D PTRACE_PEEKDATA
  33. /* Return the word in the process's user area at offset ADDR. */
  34. PTRACE_PEEKUSER = 3,
  35. #define PT_READ_U PTRACE_PEEKUSER
  36. /* Write the word DATA into the process's text space at address ADDR. */
  37. PTRACE_POKETEXT = 4,
  38. #define PT_WRITE_I PTRACE_POKETEXT
  39. /* Write the word DATA into the process's data space at address ADDR. */
  40. PTRACE_POKEDATA = 5,
  41. #define PT_WRITE_D PTRACE_POKEDATA
  42. /* Write the word DATA into the process's user area at offset ADDR. */
  43. PTRACE_POKEUSER = 6,
  44. #define PT_WRITE_U PTRACE_POKEUSER
  45. /* Continue the process. */
  46. PTRACE_CONT = 7,
  47. #define PT_CONTINUE PTRACE_CONT
  48. /* Kill the process. */
  49. PTRACE_KILL = 8,
  50. #define PT_KILL PTRACE_KILL
  51. /* Single step the process.
  52. This is not supported on all machines. */
  53. PTRACE_SINGLESTEP = 9,
  54. #define PT_STEP PTRACE_SINGLESTEP
  55. /* Get all general purpose registers used by a processes.
  56. This is not supported on all machines. */
  57. PTRACE_GETREGS = 12,
  58. #define PT_GETREGS PTRACE_GETREGS
  59. /* Set all general purpose registers used by a processes.
  60. This is not supported on all machines. */
  61. PTRACE_SETREGS = 13,
  62. #define PT_SETREGS PTRACE_SETREGS
  63. /* Get all floating point registers used by a processes.
  64. This is not supported on all machines. */
  65. PTRACE_GETFPREGS = 14,
  66. #define PT_GETFPREGS PTRACE_GETFPREGS
  67. /* Set all floating point registers used by a processes.
  68. This is not supported on all machines. */
  69. PTRACE_SETFPREGS = 15,
  70. #define PT_SETFPREGS PTRACE_SETFPREGS
  71. /* Attach to a process that is already running. */
  72. PTRACE_ATTACH = 16,
  73. #define PT_ATTACH PTRACE_ATTACH
  74. /* Detach from a process attached to with PTRACE_ATTACH. */
  75. PTRACE_DETACH = 17,
  76. #define PT_DETACH PTRACE_DETACH
  77. /* Get all extended floating point registers used by a processes.
  78. This is not supported on all machines. */
  79. PTRACE_GETFPXREGS = 18,
  80. #define PT_GETFPXREGS PTRACE_GETFPXREGS
  81. /* Set all extended floating point registers used by a processes.
  82. This is not supported on all machines. */
  83. PTRACE_SETFPXREGS = 19,
  84. #define PT_SETFPXREGS PTRACE_SETFPXREGS
  85. /* Continue and stop at the next (return from) syscall. */
  86. PTRACE_SYSCALL = 24,
  87. #define PT_SYSCALL PTRACE_SYSCALL
  88. /* Set ptrace filter options. */
  89. PTRACE_SETOPTIONS = 0x4200,
  90. #define PT_SETOPTIONS PTRACE_SETOPTIONS
  91. /* Get last ptrace message. */
  92. PTRACE_GETEVENTMSG = 0x4201,
  93. #define PT_GETEVENTMSG PTRACE_GETEVENTMSG
  94. /* Get siginfo for process. */
  95. PTRACE_GETSIGINFO = 0x4202,
  96. #define PT_GETSIGINFO PTRACE_GETSIGINFO
  97. /* Set new siginfo for process. */
  98. PTRACE_SETSIGINFO = 0x4203,
  99. #define PT_SETSIGINFO PTRACE_SETSIGINFO
  100. /* Get register content. */
  101. PTRACE_GETREGSET = 0x4204,
  102. #define PTRACE_GETREGSET PTRACE_GETREGSET
  103. /* Set register content. */
  104. PTRACE_SETREGSET = 0x4205,
  105. #define PTRACE_SETREGSET PTRACE_SETREGSET
  106. /* Like PTRACE_ATTACH, but do not force tracee to trap and do not affect
  107. signal or group stop state. */
  108. PTRACE_SEIZE = 0x4206,
  109. #define PTRACE_SEIZE PTRACE_SEIZE
  110. /* Trap seized tracee. */
  111. PTRACE_INTERRUPT = 0x4207,
  112. #define PTRACE_INTERRUPT PTRACE_INTERRUPT
  113. /* Wait for next group event. */
  114. PTRACE_LISTEN = 0x4208
  115. };
  116. /* Flag for PTRACE_LISTEN. */
  117. enum __ptrace_flags
  118. {
  119. PTRACE_SEIZE_DEVEL = 0x80000000
  120. };
  121. /* Options set using PTRACE_SETOPTIONS. */
  122. enum __ptrace_setoptions
  123. {
  124. PTRACE_O_TRACESYSGOOD = 0x00000001,
  125. PTRACE_O_TRACEFORK = 0x00000002,
  126. PTRACE_O_TRACEVFORK = 0x00000004,
  127. PTRACE_O_TRACECLONE = 0x00000008,
  128. PTRACE_O_TRACEEXEC = 0x00000010,
  129. PTRACE_O_TRACEVFORKDONE = 0x00000020,
  130. PTRACE_O_TRACEEXIT = 0x00000040,
  131. PTRACE_O_TRACESECCOMP = 0x00000080,
  132. PTRACE_O_MASK = 0x000000ff
  133. };
  134. /* Wait extended result codes for the above trace options. */
  135. enum __ptrace_eventcodes
  136. {
  137. PTRACE_EVENT_FORK = 1,
  138. PTRACE_EVENT_VFORK = 2,
  139. PTRACE_EVENT_CLONE = 3,
  140. PTRACE_EVENT_EXEC = 4,
  141. PTRACE_EVENT_VFORK_DONE = 5,
  142. PTRACE_EVENT_EXIT = 6,
  143. PTRAVE_EVENT_SECCOMP = 7
  144. };
  145. /* Perform process tracing functions. REQUEST is one of the values
  146. above, and determines the action to be taken.
  147. For all requests except PTRACE_TRACEME, PID specifies the process to be
  148. traced.
  149. PID and the other arguments described above for the various requests should
  150. appear (those that are used for the particular request) as:
  151. pid_t PID, void *ADDR, int DATA, void *ADDR2
  152. after REQUEST. */
  153. extern long int ptrace (enum __ptrace_request __request, ...) __THROW;
  154. __END_DECLS
  155. #endif /* _SYS_PTRACE_H */