envsubst(1)

envsubst1

Substitutes environment variables in shell format strings

Usage

envsubst [OPTION] [SHELL-FORMAT]

Overview

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.

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.

Releases

12 releases since Debian 3.1 (Sarge); the text changed 9 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0–7
  5. 8
  6. 9–10
  7. 11
  8. 12
  9. 13
  10. Arch

Author

Written by Bruno Haible.

Reporting bugs

Report bugs in the bug tracker at <https://savannah.gnu.org/projects/gettext> or by email to <[email protected]>.

From gettext 1.0-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.