external
external Structure: Description for executing an external process.
external structuretype
external typearguments array of string: optionaluser stringgroup string: optionalroot directory string: optionalworking directory string: optionaladditional environment array of
environment variables: optionalredirect standard out string: optionalredirect standard error string: optionalprocess scheduling priority integer: optionalthrottle disk reads boolean: optionalfile creation mode mask integer: optionalDescription
external describes all the detail needed to execute an external process. The structure provides fine grain control over how an external process should be configured.
Fields
type
Type of external being described.
arguments
Arguments to pass to the executable.
user
User to execute process as.
Short user name.
group
Group to execute process as.
Short group name. If no group is provided, the primary group of the user is used.
root directory
Set the executable's root directory (chroot).
working directory
Set the executable's working directory (chdir).
Relative paths are resolved with respect to any root directory.
additional environment
Set additional environment variables for the executable.
redirect standard out
Redirect the executable's standard output (stdout) to a file.
An absolute path to which the executable's output to appended. The file is created as needed. Removing the file while the executable is running will cause undefined behaviour.
redirect standard error
Redirect the executable's standard error (stderr) to a file.
An absolute path to which the executable's error to appended. The file is created as needed. Removing the file while the executable is running will cause undefined behaviour.
process scheduling priority
Set the executable's scheduling priority (nice).
throttle disk reads
Throttle the executable's disk reads.
file creation mode mask
Set the executable's file creation mode mask (umask).