include/uapi/linux/ptrace.h

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