xref: /dragonfly/sys/sys/procctl.h (revision 245bd6bc)
1 /*
2  * Copyright (c) 2014 The DragonFly Project.  All rights reserved.
3  *
4  * This code is derived from software contributed to The DragonFly Project
5  * by Matthew Dillon <dillon@backplane.com>
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in
15  *    the documentation and/or other materials provided with the
16  *    distribution.
17  * 3. Neither the name of The DragonFly Project nor the names of its
18  *    contributors may be used to endorse or promote products derived
19  *    from this software without specific, prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
24  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
25  * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
26  * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
27  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
28  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
29  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
30  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
31  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32  * SUCH DAMAGE.
33  */
34 
35 #ifndef _SYS_PROCCTL_H_
36 #define _SYS_PROCCTL_H_
37 
38 #include <sys/cdefs.h>
39 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
40 #include <sys/lock.h>
41 #else
42 #include <sys/types.h>
43 #endif
44 
45 #ifndef _IDTYPE_T_DECLARED
46 #define _IDTYPE_T_DECLARED
47 /* SEE ALSO SYS/WAIT.H */
48 
49 typedef enum idtype {
50 	/*
51 	 * These names were mostly lifted from Solaris source code and
52 	 * still use Solaris style naming to avoid breaking any
53 	 * OpenSolaris code which has been ported to FreeBSD/DragonFly.
54 	 * There is no clear DragonFly counterpart for all of the names, but
55 	 * some have a clear correspondence to DragonFly entities.
56 	 *
57 	 * The numerical values are kept synchronized with the Solaris
58 	 * values.
59 	 */
60 	P_PID,			/* A process identifier. */
61 	P_PPID,			/* A parent process identifier.	*/
62 	P_PGID,			/* A process group identifier. */
63 	P_SID,			/* A session identifier. */
64 	P_CID,			/* A scheduling class identifier. */
65 	P_UID,			/* A user identifier. */
66 	P_GID,			/* A group identifier. */
67 	P_ALL,			/* All processes. */
68 	P_LWPID,		/* An LWP identifier. */
69 	P_TASKID,		/* A task identifier. */
70 	P_PROJID,		/* A project identifier. */
71 	P_POOLID,		/* A pool identifier. */
72 	P_JAILID,		/* A zone identifier. */
73 	P_CTID,			/* A (process) contract identifier. */
74 	P_CPUID,		/* CPU identifier. */
75 	P_PSETID		/* Processor set identifier. */
76 } idtype_t;			/* The type of id_t we are using. */
77 
78 #endif
79 
80 struct reaper_status {
81 	uint32_t	flags;
82 	uint32_t	refs;
83 	long		reserved1[15];
84 	pid_t		pid_head;
85 	int		reserved2[15];
86 };
87 
88 union reaper_info {
89 	struct reaper_status	status;
90 };
91 
92 #define _PROCCTL_PRESENT
93 
94 #define PROC_REAP_ACQUIRE	0x0001
95 #define PROC_REAP_RELEASE	0x0002
96 #define PROC_REAP_STATUS	0x0003
97 #define PROC_PDEATHSIG_CTL	0x0004
98 #define PROC_PDEATHSIG_STATUS	0x0005
99 
100 #define REAPER_STAT_OWNED	0x00000001
101 #define REAPER_STAT_REALINIT	0x00000002
102 
103 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
104 
105 struct proc;
106 
107 struct sysreaper {
108 	struct lock	lock;		/* thread or topo access */
109 	struct sysreaper *parent;	/* upward topology only */
110 	struct proc	*p;		/* who the reaper is */
111 	uint32_t	flags;		/* control flags */
112 	u_int		refs;		/* shared structure refs */
113 };
114 
115 #endif
116 
117 #if !defined(_KERNEL)
118 
119 __BEGIN_DECLS
120 int procctl(idtype_t idtype, id_t id, int cmd, void *arg);
121 __END_DECLS
122 
123 #endif
124 
125 #endif
126