jailp.h revision 289677
1214117Sjamie/*- 2223190Sjamie * Copyright (c) 2011 James Gritton. 3214117Sjamie * All rights reserved. 4214117Sjamie * 5214117Sjamie * Redistribution and use in source and binary forms, with or without 6214117Sjamie * modification, are permitted provided that the following conditions 7214117Sjamie * are met: 8214117Sjamie * 1. Redistributions of source code must retain the above copyright 9214117Sjamie * notice, this list of conditions and the following disclaimer. 10214117Sjamie * 2. Redistributions in binary form must reproduce the above copyright 11214117Sjamie * notice, this list of conditions and the following disclaimer in the 12214117Sjamie * documentation and/or other materials provided with the distribution. 13214117Sjamie * 14214117Sjamie * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15214117Sjamie * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16214117Sjamie * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17214117Sjamie * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18214117Sjamie * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19214117Sjamie * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20214117Sjamie * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21214117Sjamie * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22214117Sjamie * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23214117Sjamie * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24214117Sjamie * SUCH DAMAGE. 25214117Sjamie * 26214117Sjamie * $FreeBSD: head/usr.sbin/jail/jailp.h 289677 2015-10-21 05:37:09Z eadler $ 27214117Sjamie */ 28214117Sjamie 29214117Sjamie#include <sys/param.h> 30214117Sjamie#include <sys/types.h> 31214117Sjamie#include <sys/jail.h> 32214117Sjamie#include <sys/queue.h> 33214117Sjamie#include <sys/time.h> 34214117Sjamie 35214117Sjamie#include <jail.h> 36214117Sjamie 37214117Sjamie#define CONF_FILE "/etc/jail.conf" 38214117Sjamie 39214117Sjamie#define DEP_FROM 0 40214117Sjamie#define DEP_TO 1 41214117Sjamie 42214117Sjamie#define DF_SEEN 0x01 /* Dependency has been followed */ 43214117Sjamie#define DF_LIGHT 0x02 /* Implied dependency on jail existence only */ 44289677Seadler#define DF_NOFAIL 0x04 /* Don't propagate failed jails */ 45214117Sjamie 46214117Sjamie#define PF_VAR 0x01 /* This is a variable, not a true parameter */ 47214117Sjamie#define PF_APPEND 0x02 /* Append to existing parameter list */ 48214117Sjamie#define PF_BAD 0x04 /* Unable to resolve parameter value */ 49214117Sjamie#define PF_INTERNAL 0x08 /* Internal parameter, not passed to kernel */ 50214117Sjamie#define PF_BOOL 0x10 /* Boolean parameter */ 51214117Sjamie#define PF_INT 0x20 /* Integer parameter */ 52214423Sjamie#define PF_CONV 0x40 /* Parameter duplicated in converted form */ 53248854Sjamie#define PF_REV 0x80 /* Run commands in reverse order on stopping */ 54285279Shrs#define PF_IMMUTABLE 0x100 /* Immutable parameter */ 55214117Sjamie 56214117Sjamie#define JF_START 0x0001 /* -c */ 57214117Sjamie#define JF_SET 0x0002 /* -m */ 58214117Sjamie#define JF_STOP 0x0004 /* -r */ 59214117Sjamie#define JF_DEPEND 0x0008 /* Operation required by dependency */ 60214117Sjamie#define JF_WILD 0x0010 /* Not specified on the command line */ 61214117Sjamie#define JF_FAILED 0x0020 /* Operation failed */ 62214649Sjamie#define JF_PARAMS 0x0040 /* Parameters checked and imported */ 63214649Sjamie#define JF_RDTUN 0x0080 /* Create-only parameter check has been done */ 64223189Sjamie#define JF_PERSIST 0x0100 /* Jail is temporarily persistent */ 65223189Sjamie#define JF_TIMEOUT 0x0200 /* A command (or process kill) timed out */ 66223189Sjamie#define JF_SLEEPQ 0x0400 /* Waiting on a command and/or timeout */ 67214117Sjamie 68214117Sjamie#define JF_OP_MASK (JF_START | JF_SET | JF_STOP) 69214117Sjamie#define JF_RESTART (JF_START | JF_STOP) 70214117Sjamie#define JF_START_SET (JF_START | JF_SET) 71214117Sjamie#define JF_SET_RESTART (JF_SET | JF_STOP) 72214117Sjamie#define JF_START_SET_RESTART (JF_START | JF_SET | JF_STOP) 73214117Sjamie#define JF_DO_STOP(js) (((js) & (JF_SET | JF_STOP)) == JF_STOP) 74214117Sjamie 75214117Sjamieenum intparam { 76234988Sjamie IP__NULL = 0, /* Null command */ 77234988Sjamie IP_ALLOW_DYING, /* Allow making changes to a dying jail */ 78214117Sjamie IP_COMMAND, /* Command run inside jail at creation */ 79214117Sjamie IP_DEPEND, /* Jail starts after (stops before) another */ 80214117Sjamie IP_EXEC_CLEAN, /* Run commands in a clean environment */ 81214117Sjamie IP_EXEC_CONSOLELOG, /* Redirect optput for commands run in jail */ 82214117Sjamie IP_EXEC_FIB, /* Run jailed commands with this FIB */ 83214117Sjamie IP_EXEC_JAIL_USER, /* Run jailed commands as this user */ 84214117Sjamie IP_EXEC_POSTSTART, /* Commands run outside jail after creating */ 85214117Sjamie IP_EXEC_POSTSTOP, /* Commands run outside jail after removing */ 86214117Sjamie IP_EXEC_PRESTART, /* Commands run outside jail before creating */ 87214117Sjamie IP_EXEC_PRESTOP, /* Commands run outside jail before removing */ 88214117Sjamie IP_EXEC_START, /* Commands run inside jail on creation */ 89214117Sjamie IP_EXEC_STOP, /* Commands run inside jail on removal */ 90214117Sjamie IP_EXEC_SYSTEM_JAIL_USER,/* Get jail_user from system passwd file */ 91214117Sjamie IP_EXEC_SYSTEM_USER, /* Run non-jailed commands as this user */ 92214117Sjamie IP_EXEC_TIMEOUT, /* Time to wait for a command to complete */ 93223351Sjamie#if defined(INET) || defined(INET6) 94214117Sjamie IP_INTERFACE, /* Add IP addresses to this interface */ 95214117Sjamie IP_IP_HOSTNAME, /* Get jail IP address(es) from hostname */ 96223351Sjamie#endif 97214117Sjamie IP_MOUNT, /* Mount points in fstab(5) form */ 98214117Sjamie IP_MOUNT_DEVFS, /* Mount /dev under prison root */ 99256385Shrs IP_MOUNT_FDESCFS, /* Mount /dev/fd under prison root */ 100278323Sjamie IP_MOUNT_PROCFS, /* Mount /proc under prison root */ 101214423Sjamie IP_MOUNT_FSTAB, /* A standard fstab(5) file */ 102214117Sjamie IP_STOP_TIMEOUT, /* Time to wait after sending SIGTERM */ 103214423Sjamie IP_VNET_INTERFACE, /* Assign interface(s) to vnet jail */ 104223351Sjamie#ifdef INET 105214117Sjamie IP__IP4_IFADDR, /* Copy of ip4.addr with interface/netmask */ 106223351Sjamie#endif 107214117Sjamie#ifdef INET6 108214117Sjamie IP__IP6_IFADDR, /* Copy of ip6.addr with interface/prefixlen */ 109214117Sjamie#endif 110214783Sjamie IP__MOUNT_FROM_FSTAB, /* Line from mount.fstab file */ 111223189Sjamie IP__OP, /* Placeholder for requested operation */ 112214423Sjamie KP_ALLOW_CHFLAGS, 113214423Sjamie KP_ALLOW_MOUNT, 114214423Sjamie KP_ALLOW_RAW_SOCKETS, 115214423Sjamie KP_ALLOW_SET_HOSTNAME, 116214423Sjamie KP_ALLOW_SOCKET_AF, 117214423Sjamie KP_ALLOW_SYSVIPC, 118232242Sjamie KP_DEVFS_RULESET, 119214423Sjamie KP_ENFORCE_STATFS, 120214423Sjamie KP_HOST_HOSTNAME, 121223351Sjamie#ifdef INET 122214117Sjamie KP_IP4_ADDR, 123223351Sjamie#endif 124214117Sjamie#ifdef INET6 125214117Sjamie KP_IP6_ADDR, 126214117Sjamie#endif 127214117Sjamie KP_JID, 128214117Sjamie KP_NAME, 129214117Sjamie KP_PATH, 130214117Sjamie KP_PERSIST, 131214423Sjamie KP_SECURELEVEL, 132214117Sjamie KP_VNET, 133214117Sjamie IP_NPARAM 134214117Sjamie}; 135214117Sjamie 136214117SjamieSTAILQ_HEAD(cfvars, cfvar); 137214117Sjamie 138214117Sjamiestruct cfvar { 139214117Sjamie STAILQ_ENTRY(cfvar) tq; 140214117Sjamie char *name; 141214117Sjamie size_t pos; 142214117Sjamie}; 143214117Sjamie 144223188SjamieTAILQ_HEAD(cfstrings, cfstring); 145214117Sjamie 146214117Sjamiestruct cfstring { 147223188Sjamie TAILQ_ENTRY(cfstring) tq; 148214117Sjamie char *s; 149214117Sjamie size_t len; 150214117Sjamie struct cfvars vars; 151214117Sjamie}; 152214117Sjamie 153214117SjamieTAILQ_HEAD(cfparams, cfparam); 154214117Sjamie 155214117Sjamiestruct cfparam { 156214117Sjamie TAILQ_ENTRY(cfparam) tq; 157214117Sjamie char *name; 158214117Sjamie struct cfstrings val; 159214117Sjamie unsigned flags; 160214117Sjamie int gen; 161214117Sjamie}; 162214117Sjamie 163214117SjamieTAILQ_HEAD(cfjails, cfjail); 164214117SjamieSTAILQ_HEAD(cfdepends, cfdepend); 165214117Sjamie 166214117Sjamiestruct cfjail { 167214117Sjamie TAILQ_ENTRY(cfjail) tq; 168214117Sjamie char *name; 169214117Sjamie char *comline; 170214117Sjamie struct cfparams params; 171214117Sjamie struct cfdepends dep[2]; 172214117Sjamie struct cfjails *queue; 173214117Sjamie struct cfparam *intparams[IP_NPARAM]; 174214117Sjamie struct cfstring *comstring; 175214117Sjamie struct jailparam *jp; 176214117Sjamie struct timespec timeout; 177223189Sjamie const enum intparam *comparam; 178214117Sjamie unsigned flags; 179214117Sjamie int jid; 180214117Sjamie int seq; 181214117Sjamie int pstatus; 182214117Sjamie int ndeps; 183214117Sjamie int njp; 184214117Sjamie int nprocs; 185214117Sjamie}; 186214117Sjamie 187214117Sjamiestruct cfdepend { 188214117Sjamie STAILQ_ENTRY(cfdepend) tq[2]; 189214117Sjamie struct cfjail *j[2]; 190214117Sjamie unsigned flags; 191214117Sjamie}; 192214117Sjamie 193214117Sjamieextern void *emalloc(size_t); 194214117Sjamieextern void *erealloc(void *, size_t); 195214117Sjamieextern char *estrdup(const char *); 196223263Sjamieextern int create_jail(struct cfjail *j); 197214117Sjamieextern void failed(struct cfjail *j); 198214117Sjamieextern void jail_note(const struct cfjail *j, const char *fmt, ...); 199214117Sjamieextern void jail_warnx(const struct cfjail *j, const char *fmt, ...); 200214117Sjamie 201223189Sjamieextern int next_command(struct cfjail *j); 202216367Sjamieextern int finish_command(struct cfjail *j); 203214117Sjamieextern struct cfjail *next_proc(int nonblock); 204214117Sjamie 205214117Sjamieextern void load_config(void); 206214117Sjamieextern struct cfjail *add_jail(void); 207214117Sjamieextern void add_param(struct cfjail *j, const struct cfparam *p, 208214423Sjamie enum intparam ipnum, const char *value); 209214117Sjamieextern int bool_param(const struct cfparam *p); 210214117Sjamieextern int int_param(const struct cfparam *p, int *ip); 211214117Sjamieextern const char *string_param(const struct cfparam *p); 212214649Sjamieextern int check_intparams(struct cfjail *j); 213214117Sjamieextern int import_params(struct cfjail *j); 214214117Sjamieextern int equalopts(const char *opt1, const char *opt2); 215214117Sjamieextern int wild_jail_name(const char *wname); 216214117Sjamieextern int wild_jail_match(const char *jname, const char *wname); 217214117Sjamie 218214117Sjamieextern void dep_setup(int docf); 219214117Sjamieextern int dep_check(struct cfjail *j); 220214117Sjamieextern void dep_done(struct cfjail *j, unsigned flags); 221214117Sjamieextern void dep_reset(struct cfjail *j); 222214117Sjamieextern struct cfjail *next_jail(void); 223231238Sjamieextern int start_state(const char *target, int docf, unsigned state, 224231238Sjamie int running); 225214117Sjamieextern void requeue(struct cfjail *j, struct cfjails *queue); 226214117Sjamie 227214117Sjamieextern void yyerror(const char *); 228214117Sjamieextern int yylex(void); 229214117Sjamie 230214117Sjamieextern struct cfjails cfjails; 231214117Sjamieextern struct cfjails ready; 232216367Sjamieextern struct cfjails depend; 233214117Sjamieextern const char *cfname; 234236198Sjamieextern int iflag; 235223263Sjamieextern int note_remove; 236216367Sjamieextern int paralimit; 237214117Sjamieextern int verbose; 238