ptrace.h 4.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131
  1. #ifndef _LINUX_PTRACE_H
  2. #define _LINUX_PTRACE_H
  3. /* ptrace.h */
  4. /* structs and defines to help the user use the ptrace system call. */
  5. /* has the defines to get at the registers. */
  6. #define PTRACE_TRACEME 0
  7. #define PTRACE_PEEKTEXT 1
  8. #define PTRACE_PEEKDATA 2
  9. #define PTRACE_PEEKUSR 3
  10. #define PTRACE_POKETEXT 4
  11. #define PTRACE_POKEDATA 5
  12. #define PTRACE_POKEUSR 6
  13. #define PTRACE_CONT 7
  14. #define PTRACE_KILL 8
  15. #define PTRACE_SINGLESTEP 9
  16. #define PTRACE_ATTACH 0x10
  17. #define PTRACE_DETACH 0x11
  18. #define PTRACE_SYSCALL 24
  19. /* 0x4200-0x4300 are reserved for architecture-independent additions. */
  20. #define PTRACE_SETOPTIONS 0x4200
  21. #define PTRACE_GETEVENTMSG 0x4201
  22. #define PTRACE_GETSIGINFO 0x4202
  23. #define PTRACE_SETSIGINFO 0x4203
  24. /* options set using PTRACE_SETOPTIONS */
  25. #define PTRACE_O_TRACESYSGOOD 0x00000001
  26. #define PTRACE_O_TRACEFORK 0x00000002
  27. #define PTRACE_O_TRACEVFORK 0x00000004
  28. #define PTRACE_O_TRACECLONE 0x00000008
  29. #define PTRACE_O_TRACEEXEC 0x00000010
  30. #define PTRACE_O_TRACEVFORKDONE 0x00000020
  31. #define PTRACE_O_TRACEEXIT 0x00000040
  32. #define PTRACE_O_MASK 0x0000007f
  33. /* Wait extended result codes for the above trace options. */
  34. #define PTRACE_EVENT_FORK 1
  35. #define PTRACE_EVENT_VFORK 2
  36. #define PTRACE_EVENT_CLONE 3
  37. #define PTRACE_EVENT_EXEC 4
  38. #define PTRACE_EVENT_VFORK_DONE 5
  39. #define PTRACE_EVENT_EXIT 6
  40. #include <asm/ptrace.h>
  41. #ifdef __KERNEL__
  42. /*
  43. * Ptrace flags
  44. *
  45. * The owner ship rules for task->ptrace which holds the ptrace
  46. * flags is simple. When a task is running it owns it's task->ptrace
  47. * flags. When the a task is stopped the ptracer owns task->ptrace.
  48. */
  49. #define PT_PTRACED 0x00000001
  50. #define PT_DTRACE 0x00000002 /* delayed trace (used on m68k, i386) */
  51. #define PT_TRACESYSGOOD 0x00000004
  52. #define PT_PTRACE_CAP 0x00000008 /* ptracer can follow suid-exec */
  53. #define PT_TRACE_FORK 0x00000010
  54. #define PT_TRACE_VFORK 0x00000020
  55. #define PT_TRACE_CLONE 0x00000040
  56. #define PT_TRACE_EXEC 0x00000080
  57. #define PT_TRACE_VFORK_DONE 0x00000100
  58. #define PT_TRACE_EXIT 0x00000200
  59. #define PT_ATTACHED 0x00000400 /* parent != real_parent */
  60. #define PT_TRACE_MASK 0x000003f4
  61. /* single stepping state bits (used on ARM and PA-RISC) */
  62. #define PT_SINGLESTEP_BIT 31
  63. #define PT_SINGLESTEP (1<<PT_SINGLESTEP_BIT)
  64. #define PT_BLOCKSTEP_BIT 30
  65. #define PT_BLOCKSTEP (1<<PT_BLOCKSTEP_BIT)
  66. #include <linux/compiler.h> /* For unlikely. */
  67. #include <linux/sched.h> /* For struct task_struct. */
  68. extern long arch_ptrace(struct task_struct *child, long request, long addr, long data);
  69. extern struct task_struct *ptrace_get_task_struct(pid_t pid);
  70. extern int ptrace_traceme(void);
  71. extern int ptrace_readdata(struct task_struct *tsk, unsigned long src, char __user *dst, int len);
  72. extern int ptrace_writedata(struct task_struct *tsk, char __user *src, unsigned long dst, int len);
  73. extern int ptrace_attach(struct task_struct *tsk);
  74. extern int ptrace_detach(struct task_struct *, unsigned int);
  75. extern void ptrace_disable(struct task_struct *);
  76. extern int ptrace_check_attach(struct task_struct *task, int kill);
  77. extern int ptrace_request(struct task_struct *child, long request, long addr, long data);
  78. extern void ptrace_notify(int exit_code);
  79. extern void __ptrace_link(struct task_struct *child,
  80. struct task_struct *new_parent);
  81. extern void __ptrace_unlink(struct task_struct *child);
  82. extern void ptrace_untrace(struct task_struct *child);
  83. extern int ptrace_may_attach(struct task_struct *task);
  84. static inline void ptrace_link(struct task_struct *child,
  85. struct task_struct *new_parent)
  86. {
  87. if (unlikely(child->ptrace))
  88. __ptrace_link(child, new_parent);
  89. }
  90. static inline void ptrace_unlink(struct task_struct *child)
  91. {
  92. if (unlikely(child->ptrace))
  93. __ptrace_unlink(child);
  94. }
  95. #ifndef force_successful_syscall_return
  96. /*
  97. * System call handlers that, upon successful completion, need to return a
  98. * negative value should call force_successful_syscall_return() right before
  99. * returning. On architectures where the syscall convention provides for a
  100. * separate error flag (e.g., alpha, ia64, ppc{,64}, sparc{,64}, possibly
  101. * others), this macro can be used to ensure that the error flag will not get
  102. * set. On architectures which do not support a separate error flag, the macro
  103. * is a no-op and the spurious error condition needs to be filtered out by some
  104. * other means (e.g., in user-level, by passing an extra argument to the
  105. * syscall handler, or something along those lines).
  106. */
  107. #define force_successful_syscall_return() do { } while (0)
  108. #endif
  109. #endif
  110. #endif