sys/sys/procctl.h

   1 /*-
   2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
   3  *
   4  * Copyright (c) 2013 Hudson River Trading LLC
   5  * Copyright (c) 2014, 2016 The FreeBSD Foundation
   6  * Written by: John H. Baldwin <jhb@FreeBSD.org>
   7  * All rights reserved.
   8  *
   9  * Portions of this software were developed by Konstantin Belousov
  10  * under sponsorship from the FreeBSD Foundation.
  11  *
  12  * Redistribution and use in source and binary forms, with or without
  13  * modification, are permitted provided that the following conditions
  14  * are met:
  15  * 1. Redistributions of source code must retain the above copyright
  16  *    notice, this list of conditions and the following disclaimer.
  17  * 2. Redistributions in binary form must reproduce the above copyright
  18  *    notice, this list of conditions and the following disclaimer in the
  19  *    documentation and/or other materials provided with the distribution.
  20  *
  21  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  22  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  25  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31  * SUCH DAMAGE.
  32  *
  33  * $FreeBSD$
  34  */
  35
  36 #ifndef _SYS_PROCCTL_H_
  37 #define _SYS_PROCCTL_H_
  38
  39 #ifndef _KERNEL
  40 #include <sys/types.h>
  41 #include <sys/wait.h>
  42 #endif
  43
  44 /* MD PROCCTL verbs start at 0x10000000 */
  45 #define PROC_PROCCTL_MD_MIN     0x10000000
  46 #include <machine/procctl.h>
  47
  48 #define PROC_SPROTECT           1       /* set protected state */
  49 #define PROC_REAP_ACQUIRE       2       /* reaping enable */
  50 #define PROC_REAP_RELEASE       3       /* reaping disable */
  51 #define PROC_REAP_STATUS        4       /* reaping status */
  52 #define PROC_REAP_GETPIDS       5       /* get descendants */
  53 #define PROC_REAP_KILL          6       /* kill descendants */
  54 #define PROC_TRACE_CTL          7       /* en/dis ptrace and coredumps */
  55 #define PROC_TRACE_STATUS       8       /* query tracing status */
  56 #define PROC_TRAPCAP_CTL        9       /* trap capability errors */
  57 #define PROC_TRAPCAP_STATUS     10      /* query trap capability status */
  58 #define PROC_PDEATHSIG_CTL      11      /* set parent death signal */
  59 #define PROC_PDEATHSIG_STATUS   12      /* get parent death signal */
  60 #define PROC_ASLR_CTL           13      /* en/dis ASLR */
  61 #define PROC_ASLR_STATUS        14      /* query ASLR status */
  62 #define PROC_PROTMAX_CTL        15      /* en/dis implicit PROT_MAX */
  63 #define PROC_PROTMAX_STATUS     16      /* query implicit PROT_MAX status */
  64
  65 /* Operations for PROC_SPROTECT (passed in integer arg). */
  66 #define PPROT_OP(x)     ((x) & 0xf)
  67 #define PPROT_SET       1
  68 #define PPROT_CLEAR     2
  69
  70 /* Flags for PROC_SPROTECT (ORed in with operation). */
  71 #define PPROT_FLAGS(x)  ((x) & ~0xf)
  72 #define PPROT_DESCEND   0x10
  73 #define PPROT_INHERIT   0x20
  74
  75 /* Result of PREAP_STATUS (returned by value). */
  76 struct procctl_reaper_status {
  77         u_int   rs_flags;
  78         u_int   rs_children;
  79         u_int   rs_descendants;
  80         pid_t   rs_reaper;
  81         pid_t   rs_pid;
  82         u_int   rs_pad0[15];
  83 };
  84
  85 /* struct procctl_reaper_status rs_flags */
  86 #define REAPER_STATUS_OWNED     0x00000001
  87 #define REAPER_STATUS_REALINIT  0x00000002
  88
  89 struct procctl_reaper_pidinfo {
  90         pid_t   pi_pid;
  91         pid_t   pi_subtree;
  92         u_int   pi_flags;
  93         u_int   pi_pad0[15];
  94 };
  95
  96 #define REAPER_PIDINFO_VALID    0x00000001
  97 #define REAPER_PIDINFO_CHILD    0x00000002
  98 #define REAPER_PIDINFO_REAPER   0x00000004
  99
 100 struct procctl_reaper_pids {
 101         u_int   rp_count;
 102         u_int   rp_pad0[15];
 103         struct procctl_reaper_pidinfo *rp_pids;
 104 };
 105
 106 struct procctl_reaper_kill {
 107         int     rk_sig;         /* in  - signal to send */
 108         u_int   rk_flags;       /* in  - REAPER_KILL flags */
 109         pid_t   rk_subtree;     /* in  - subtree, if REAPER_KILL_SUBTREE */
 110         u_int   rk_killed;      /* out - count of processes successfully
 111                                    killed */
 112         pid_t   rk_fpid;        /* out - first failed pid for which error
 113                                    is returned */
 114         u_int   rk_pad0[15];
 115 };
 116
 117 #define REAPER_KILL_CHILDREN    0x00000001
 118 #define REAPER_KILL_SUBTREE     0x00000002
 119
 120 #define PROC_TRACE_CTL_ENABLE           1
 121 #define PROC_TRACE_CTL_DISABLE          2
 122 #define PROC_TRACE_CTL_DISABLE_EXEC     3
 123
 124 #define PROC_TRAPCAP_CTL_ENABLE         1
 125 #define PROC_TRAPCAP_CTL_DISABLE        2
 126
 127 #define PROC_ASLR_FORCE_ENABLE          1
 128 #define PROC_ASLR_FORCE_DISABLE         2
 129 #define PROC_ASLR_NOFORCE               3
 130 #define PROC_ASLR_ACTIVE                0x80000000
 131
 132 #define PROC_PROTMAX_FORCE_ENABLE       1
 133 #define PROC_PROTMAX_FORCE_DISABLE      2
 134 #define PROC_PROTMAX_NOFORCE            3
 135 #define PROC_PROTMAX_ACTIVE             0x80000000
 136
 137 #ifndef _KERNEL
 138 __BEGIN_DECLS
 139 int     procctl(idtype_t, id_t, int, void *);
 140 __END_DECLS
 141
 142 #endif
 143
 144 #endif /* !_SYS_PROCCTL_H_ */