compiled-tools/loadenv.pod

   1 =pod
   2
   3 =head1 NAME
   4
   5 loadenv - Load environment variables from file and run a program in that environment
   6
   7 =head1 SYNOPSIS
   8
   9 loadenv [OPTIONS] <FILE> <COMMAND> [<ARG> [...]]
  10
  11 =head1 OPTIONS
  12
  13 =over 4
  14
  15 =item -0
  16
  17 Read NUL-terminated strings from B<FILE>.
  18 Default is to read newline-terminated strings.
  19
  20 =item -c
  21
  22 Copy current environment, then process B<FILE>.
  23
  24 =back
  25
  26 =head1 FILE FORMAT
  27
  28 There is a series of NUL- or LF-delimited environment variable
  29 declarations in B<FILE> in a format like:
  30 B<NAME>[=B<VALUE>]
  31
  32 If only B<NAME> is given (ie. no '=' part), then variable B<NAME> will
  33 be removed from the environment.
  34 B<NAME> can not have C<=> equal sign in it.
  35
  36 Everything after the C<=> equal sign up to the delimiter char, is part
  37 of B<VALUE>, including an other C<=> equal sign.
  38 B<VALUE> may be empty, and quoting is not needed, not for empty
  39 B<VALUE>, not for spaces.
  40 It's a raw string; no shell-interpolation.
  41
  42 If the delimiter is LF (newline, C<\n>) which is the default, then lines
  43 starting with C<#> hash mark are ignored.
  44 Empty B<NAME> is also ignored.
  45
  46 Later instances of the same B<NAME> overwrite previous ones and also the
  47 inherited ones.
  48
  49 =cut