env(1) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
ENV(1)                  NetBSD General Commands Manual                  ENV(1)


NAME

     env -- set and print environment


SYNOPSIS

     env [-0i] [-u name] [name=value ...] [utility [argument ...]]


DESCRIPTION

     env executes utility after modifying the environment as specified on the
     command line.  The option name=value specifies an environmental variable,
     name, with a value of value.  The option `-i' causes env to completely
     ignore the environment it inherits.

     The option `-u name' causes removal of the name environment variable if
     it is in the environment.  This is similar to the unset command in sh(1).
     The value for name must not include the `=' character.

     If no utility is specified, env prints out the names and values of the
     variables in the environment.  Each name=value pair is separated by a new
     line unless -0 is specified, in which case name/value pairs are separated
     by NUL.  Both -0 and utility must not be specified together.


EXIT STATUS

     env exits with one of the following values:

     0       utility was invoked and completed successfully.  In this case the
             exit code is returned by the utility itself, not env.  If no
             utility was specified, then env completed successfully and
             returned the exit code itself.

     1       An invalid command line option was passed to env.

     1-125   utility was invoked, but failed in some way; see its manual page
             for more information.  In this case the exit code is returned by
             the utility itself, not env.

     125     utility was specified together with the -0 option.

     126     utility was found, but could not be invoked.

     127     utility could not be found.


COMPATIBILITY

     The historic - option has been deprecated but is still supported in this
     implementation.

     The -u and -0 options are non-standard extensions.


SEE ALSO

     execvp(3), environ(7)


STANDARDS

     The env utility conforms to IEEE Std 1003.2-1992 (``POSIX.2'').


HISTORY

     The env command appeared in 4.4BSD.

     The -u and -0 options first appeared in NetBSD 10.


BUGS

     env doesn't handle commands with equal (``='') signs in their names, for
     obvious reasons.

NetBSD 10.0                    February 8, 2020                    NetBSD 10.0