envsubst - phpMan

File: gettext.info,  Node: envsubst Invocation,  Next: eval_gettext Invocation,  Prev: ngettext Invocation,  Up: sh
15.5.2.5 Invoking the ‘envsubst’ program
........................................
     envsubst [OPTION] [SHELL-FORMAT]
   The ‘envsubst’ program substitutes the values of environment
variables.
*Operation mode*
‘-v’
‘--variables’
     Output the variables occurring in SHELL-FORMAT.
*Informative output*
‘-h’
‘--help’
     Display this help and exit.
‘-V’
‘--version’
     Output version information and exit.
   In normal operation mode, standard input is copied to standard
output, with references to environment variables of the form ‘$VARIABLE’
or ‘${VARIABLE}’ being replaced with the corresponding values.  If a
SHELL-FORMAT is given, only those environment variables that are
referenced in SHELL-FORMAT are substituted; otherwise all environment
variables references occurring in standard input are substituted.
   These substitutions are a subset of the substitutions that a shell
performs on unquoted and double-quoted strings.  Other kinds of
substitutions done by a shell, such as ‘${VARIABLE-DEFAULT}’ or
‘$(COMMAND-LIST)’ or ‘`COMMAND-LIST`’, are not performed by the
‘envsubst’ program, due to security reasons.
   When ‘--variables’ is used, standard input is ignored, and the output
consists of the environment variables that are referenced in
SHELL-FORMAT, one per line.