NAME

appjail-run — Run user-defined stages

SYNOPSIS

DESCRIPTION

The appjail run utility runs user-defined stages, that is, the cmd stage and any other custom stages.

The options are as follows:

-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.

-p parameter=value ...

Parameters for pre-, post- and cmd functions passed with syntax such as parameter1=value1, parameter2=value=2, ..., parameterN=valueN. If no parameters are provided from the command-line, they will be obtained via appjail-enabled(1).

-V name=value

Environment variables. Environment variables are defined internally 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_]*(=.*)?$.

-s name

By default, the cmd stage is executed; this parameter runs name instead.

EXIT STATUS

The appjail run utility exits 0 on success, and >0 if an error occurs. 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.
• EX_NOINPUT: jail cannot be found.

SEE ALSO

appjail-disable(1) appjail-enable(1) appjail-enabled(1) sysexits(3) appjail-initscript(5)

AUTHORS

Jesús Daniel Colmenares Oviedo <DtxdF@disroot.org>