xref: /freebsd/usr.sbin/jail/jailp.h (revision 9f44a47fd07924afc035991af15d84e6585dea4f)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2011 James Gritton.
5  * All rights reserved.
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  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  *
28  * $FreeBSD$
29  */
30 
31 #include <sys/param.h>
32 #include <sys/types.h>
33 #include <sys/jail.h>
34 #include <sys/queue.h>
35 #include <sys/time.h>
36 
37 #include <jail.h>
38 #include <stdio.h>
39 
40 #define CONF_FILE	"/etc/jail.conf"
41 
42 #define DEP_FROM	0
43 #define DEP_TO		1
44 
45 #define DF_SEEN		0x01	/* Dependency has been followed */
46 #define DF_LIGHT	0x02	/* Implied dependency on jail existence only */
47 #define DF_NOFAIL	0x04	/* Don't propagate failed jails */
48 
49 #define PF_VAR		0x0001	/* This is a variable, not a true parameter */
50 #define PF_APPEND	0x0002	/* Append to existing parameter list */
51 #define PF_BAD		0x0004	/* Unable to resolve parameter value */
52 #define PF_INTERNAL	0x0008	/* Internal parameter, not passed to kernel */
53 #define PF_BOOL		0x0010	/* Boolean parameter */
54 #define PF_INT		0x0020	/* Integer parameter */
55 #define PF_CONV		0x0040	/* Parameter duplicated in converted form */
56 #define PF_REV		0x0080	/* Run commands in reverse order on stopping */
57 #define	PF_IMMUTABLE	0x0100	/* Immutable parameter */
58 #define	PF_NAMEVAL	0x0200	/* Parameter is in "name value" form */
59 
60 #define JF_START	0x0001	/* -c */
61 #define JF_SET		0x0002	/* -m */
62 #define JF_STOP		0x0004	/* -r */
63 #define JF_DEPEND	0x0008	/* Operation required by dependency */
64 #define JF_WILD		0x0010	/* Not specified on the command line */
65 #define JF_FAILED	0x0020	/* Operation failed */
66 #define JF_PARAMS	0x0040	/* Parameters checked and imported */
67 #define JF_RDTUN	0x0080	/* Create-only parameter check has been done */
68 #define JF_PERSIST	0x0100	/* Jail is temporarily persistent */
69 #define JF_TIMEOUT	0x0200	/* A command (or process kill) timed out */
70 #define JF_SLEEPQ	0x0400	/* Waiting on a command and/or timeout */
71 #define JF_FROM_RUNQ	0x0800	/* Has already been on the run queue */
72 #define JF_SHOW		0x1000	/* -e Exhibit list of configured jails */
73 
74 #define JF_OP_MASK		(JF_START | JF_SET | JF_STOP)
75 #define JF_RESTART		(JF_START | JF_STOP)
76 #define JF_START_SET		(JF_START | JF_SET)
77 #define JF_SET_RESTART		(JF_SET | JF_STOP)
78 #define JF_START_SET_RESTART	(JF_START | JF_SET | JF_STOP)
79 #define JF_DO_STOP(js)		(((js) & (JF_SET | JF_STOP)) == JF_STOP)
80 
81 enum intparam {
82 	IP__NULL = 0,		/* Null command */
83 	IP_ALLOW_DYING,		/* Allow making changes to a dying jail */
84 	IP_COMMAND,		/* Command run inside jail at creation */
85 	IP_DEPEND,		/* Jail starts after (stops before) another */
86 	IP_EXEC_CLEAN,		/* Run commands in a clean environment */
87 	IP_EXEC_CONSOLELOG,	/* Redirect optput for commands run in jail */
88 	IP_EXEC_FIB,		/* Run jailed commands with this FIB */
89 	IP_EXEC_JAIL_USER,	/* Run jailed commands as this user */
90 	IP_EXEC_POSTSTART,	/* Commands run outside jail after creating */
91 	IP_EXEC_POSTSTOP,	/* Commands run outside jail after removing */
92 	IP_EXEC_PREPARE,	/* Commands run outside jail before addrs and mounting */
93 	IP_EXEC_PRESTART,	/* Commands run outside jail before creating */
94 	IP_EXEC_PRESTOP,	/* Commands run outside jail before removing */
95 	IP_EXEC_RELEASE,	/* Commands run outside jail after addrs and unmounted */
96 	IP_EXEC_CREATED,	/* Commands run outside jail right after it was started */
97 	IP_EXEC_START,		/* Commands run inside jail on creation */
98 	IP_EXEC_STOP,		/* Commands run inside jail on removal */
99 	IP_EXEC_SYSTEM_JAIL_USER,/* Get jail_user from system passwd file */
100 	IP_EXEC_SYSTEM_USER,	/* Run non-jailed commands as this user */
101 	IP_EXEC_TIMEOUT,	/* Time to wait for a command to complete */
102 #if defined(INET) || defined(INET6)
103 	IP_INTERFACE,		/* Add IP addresses to this interface */
104 	IP_IP_HOSTNAME,		/* Get jail IP address(es) from hostname */
105 #endif
106 	IP_MOUNT,		/* Mount points in fstab(5) form */
107 	IP_MOUNT_DEVFS,		/* Mount /dev under prison root */
108 	IP_MOUNT_FDESCFS,	/* Mount /dev/fd under prison root */
109 	IP_MOUNT_PROCFS,	/* Mount /proc under prison root */
110 	IP_MOUNT_FSTAB,		/* A standard fstab(5) file */
111 	IP_STOP_TIMEOUT,	/* Time to wait after sending SIGTERM */
112 	IP_VNET_INTERFACE,	/* Assign interface(s) to vnet jail */
113 #ifdef INET
114 	IP__IP4_IFADDR,		/* Copy of ip4.addr with interface/netmask */
115 #endif
116 #ifdef INET6
117 	IP__IP6_IFADDR,		/* Copy of ip6.addr with interface/prefixlen */
118 #endif
119 	IP__MOUNT_FROM_FSTAB,	/* Line from mount.fstab file */
120 	IP__OP,			/* Placeholder for requested operation */
121 	KP_ALLOW_CHFLAGS,
122 	KP_ALLOW_MOUNT,
123 	KP_ALLOW_RAW_SOCKETS,
124 	KP_ALLOW_SET_HOSTNAME,
125 	KP_ALLOW_SOCKET_AF,
126 	KP_ALLOW_SYSVIPC,
127 	KP_DEVFS_RULESET,
128 	KP_HOST_HOSTNAME,
129 #ifdef INET
130 	KP_IP4_ADDR,
131 #endif
132 #ifdef INET6
133 	KP_IP6_ADDR,
134 #endif
135 	KP_JID,
136 	KP_NAME,
137 	KP_PATH,
138 	KP_PERSIST,
139 	KP_SECURELEVEL,
140 	KP_VNET,
141 	IP_NPARAM
142 };
143 
144 STAILQ_HEAD(cfvars, cfvar);
145 
146 struct cfvar {
147 	STAILQ_ENTRY(cfvar)	tq;
148 	char			*name;
149 	size_t			pos;
150 };
151 
152 TAILQ_HEAD(cfstrings, cfstring);
153 
154 struct cfstring {
155 	TAILQ_ENTRY(cfstring)	tq;
156 	char			*s;
157 	size_t			len;
158 	struct cfvars		vars;
159 };
160 
161 TAILQ_HEAD(cfparams, cfparam);
162 
163 struct cfparam {
164 	TAILQ_ENTRY(cfparam)	tq;
165 	char			*name;
166 	struct cfstrings	val;
167 	unsigned		flags;
168 	int			gen;
169 };
170 
171 TAILQ_HEAD(cfjails, cfjail);
172 STAILQ_HEAD(cfdepends, cfdepend);
173 
174 struct cfjail {
175 	TAILQ_ENTRY(cfjail)	tq;
176 	char			*name;
177 	char			*comline;
178 	struct cfparams		params;
179 	struct cfdepends	dep[2];
180 	struct cfjails		*queue;
181 	struct cfjail		*cfparent;
182 	struct cfparam		*intparams[IP_NPARAM];
183 	struct cfstring		*comstring;
184 	struct jailparam	*jp;
185 	struct timespec		timeout;
186 	const enum intparam	*comparam;
187 	unsigned		flags;
188 	int			jid;
189 	int			seq;
190 	int			pstatus;
191 	int			ndeps;
192 	int			njp;
193 	int			nprocs;
194 };
195 
196 struct cfdepend {
197 	STAILQ_ENTRY(cfdepend)	tq[2];
198 	struct cfjail		*j[2];
199 	unsigned		flags;
200 };
201 
202 struct cflex {
203 	const char		*cfname;
204 	int			error;
205 };
206 
207 extern void *emalloc(size_t);
208 extern void *erealloc(void *, size_t);
209 extern char *estrdup(const char *);
210 extern int create_jail(struct cfjail *j);
211 extern void failed(struct cfjail *j);
212 extern void jail_note(const struct cfjail *j, const char *fmt, ...);
213 extern void jail_warnx(const struct cfjail *j, const char *fmt, ...);
214 
215 extern int next_command(struct cfjail *j);
216 extern int finish_command(struct cfjail *j);
217 extern struct cfjail *next_proc(int nonblock);
218 
219 extern void load_config(const char *cfname);
220 extern void include_config(void *scanner, const char *cfname);
221 extern struct cfjail *add_jail(void);
222 extern void add_param(struct cfjail *j, const struct cfparam *p,
223     enum intparam ipnum, const char *value);
224 extern int bool_param(const struct cfparam *p);
225 extern int int_param(const struct cfparam *p, int *ip);
226 extern const char *string_param(const struct cfparam *p);
227 extern int check_intparams(struct cfjail *j);
228 extern int import_params(struct cfjail *j);
229 extern int equalopts(const char *opt1, const char *opt2);
230 extern int wild_jail_name(const char *wname);
231 extern int wild_jail_match(const char *jname, const char *wname);
232 extern void free_param_strings(struct cfparam *p);
233 
234 extern void dep_setup(int docf);
235 extern int dep_check(struct cfjail *j);
236 extern void dep_done(struct cfjail *j, unsigned flags);
237 extern void dep_reset(struct cfjail *j);
238 extern struct cfjail *next_jail(void);
239 extern int start_state(const char *target, int docf, unsigned state,
240     int running);
241 extern void requeue(struct cfjail *j, struct cfjails *queue);
242 extern void requeue_head(struct cfjail *j, struct cfjails *queue);
243 
244 extern struct cflex *yyget_extra(void *scanner);
245 extern FILE *yyget_in(void *scanner);
246 extern int yyget_lineno(void *scanner);
247 extern char *yyget_text(void *scanner);
248 
249 extern struct cfjails cfjails;
250 extern struct cfjails ready;
251 extern struct cfjails depend;
252 extern int iflag;
253 extern int note_remove;
254 extern int paralimit;
255 extern int verbose;
256