FreeBSD Manual Pages
APPJAIL-START(1) General Commands Manual APPJAIL-START(1) NAME appjail-start -- Start a stopped jail SYNOPSIS appjail start [-I] [-t template] jail appjail start [-i initscript] [[-c parameter=value] ...] [[-s parameter=value] ...] [-t template] [[-V name=value] ...] jail DESCRIPTION The appjail start utility starts a jail and is responsible for perform- ing many operations: - Lock the jail to avoid starting it twice by a second process while doing this operation on the first. - Start a given jail. - Start other jails on which it depends. - Execute the create and start stages. - Check the template for syntax errors. - Warns the user about required parameters that are not yet config- ured in the template. - Load DEVFS rules that were created using appjail-devfs(1). - Configure parameters that were not defined in the template file, such as exec.consolelog, mount.fstab, host.hostname. - Stop a failed jail. The options are as follows: -c parameter=value ... Parameters for pre-, post- and create functions passed with syntax such as parameter1=value1 , parameter2=value=2 , ..., parameterN=valueN . If no parameters are provided from the com- mand-line, they will be obtained via appjail-enabled(1). -i initscript Pathname to the InitScript. If no InitScript is provided from the command-line, it will be obtained via appjail-enabled(1). If not defined there, the InitScript located in the root directory of the jail is used if it exists and has the execute bit permission. -I Avoid running the InitScript. appjail-enable(1) and appjail-disable(1) affects this parameter when it is not specified explicitly from the command-line. -s parameter=value ... Parameters for pre-, post- and start functions passed with syntax such as parameter1=value1 , parameter2=value=2 , ..., parameterN=valueN . If no parameters are provided from the com- mand-line, they will be obtained via appjail-enabled(1). -t template Pathname to the template file. If not specified, the template is retrieved from appjail-enabled(1) and if it does not have a path- name to the template, the default one found in the root directory of the jail is used, and if it does not exist, the default tem- plate specified in the DEFAULT_TEMPLATE parameter is used. -V name=value Environment variables. Environment variables are defined inter- nally with a syntax such as __APPJAIL_RUN_ENVIRONMENT_VAR__<name>=<value> and validated with a regular expression such as ^__APPJAIL_RUN_ENVIRONMENT_VAR__[a-zA-Z_][a-zA-Z0-9_]*(=.*)?$ . EXIT STATUS The appjail start utility exits 0 on success, and >0 if an error oc- curs. It may fail for one of the following reasons: - EX_USAGE: The command was used incorrectly. - EX_DATAERR: • An invalid environment variable was specified. • jail is invalid. • The log name specified in the CONSOLELOG_NAME parameter is in- valid. - EX_NOINPUT: • jail cannot be found. • The template file specified with -t cannot be found. SEE ALSO appjail-disable(1) appjail-enable(1) appjail-enabled(1) sysexits(3) appjail-initscript(5) appjail-template(5) AUTHORS Jess Daniel Colmenares Oviedo <DtxdF@disroot.org> FreeBSD Ports 14.quarterly March 27, 2024 APPJAIL-START(1)
NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | SEE ALSO | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=appjail-start&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>