2 * SPDX-License-Identifier: BSD-2-Clause
4 * Copyright (c) 2011 James Gritton.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
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.
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
31 #include <sys/param.h>
32 #include <sys/types.h>
34 #include <sys/queue.h>
40 #define CONF_FILE "/etc/jail.conf"
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 */
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 */
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 */
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)
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 */
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 */
114 IP__IP4_IFADDR, /* Copy of ip4.addr with interface/netmask */
117 IP__IP6_IFADDR, /* Copy of ip6.addr with interface/prefixlen */
119 IP__MOUNT_FROM_FSTAB, /* Line from mount.fstab file */
120 IP__OP, /* Placeholder for requested operation */
123 KP_ALLOW_RAW_SOCKETS,
124 KP_ALLOW_SET_HOSTNAME,
144 STAILQ_HEAD(cfvars, cfvar);
147 STAILQ_ENTRY(cfvar) tq;
152 TAILQ_HEAD(cfstrings, cfstring);
155 TAILQ_ENTRY(cfstring) tq;
161 TAILQ_HEAD(cfparams, cfparam);
164 TAILQ_ENTRY(cfparam) tq;
166 struct cfstrings val;
171 TAILQ_HEAD(cfjails, cfjail);
172 STAILQ_HEAD(cfdepends, cfdepend);
175 TAILQ_ENTRY(cfjail) tq;
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;
197 STAILQ_ENTRY(cfdepend) tq[2];
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, ...);
215 extern int next_command(struct cfjail *j);
216 extern int finish_command(struct cfjail *j);
217 extern struct cfjail *next_proc(int nonblock);
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);
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,
241 extern void requeue(struct cfjail *j, struct cfjails *queue);
242 extern void requeue_head(struct cfjail *j, struct cfjails *queue);
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);
249 extern struct cfjails cfjails;
250 extern struct cfjails ready;
251 extern struct cfjails depend;
253 extern int note_remove;
254 extern int paralimit;