sys/sys/procctl.h

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