Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ENV(1)			  BSD General Commands Manual			ENV(1)

NAME
     env -- set	and print environment

SYNOPSIS
     env [-i] [name=value ...] [utility	[argument ...]]

DESCRIPTION
     The env utility executes another utility after modifying the environment
     as	specified on the command line.	The option name=value specifies	an en-
     vironment variable, name, with a value of value.

     The options are as	follows:

     -i	     Execute the utility with only those environment variables speci-
	     fied.  The	environment inherited by env is	ignored	completely.

     If	no utility is specified, env prints out	the names and values of	the
     variables in the environment, with	one name/value pair per	line.

     The env utility is	sometimes useful with the `#!' construct (see
     execve(2)).  The only difference between "#!/usr/local/bin/foo" and
     "#!/usr/bin/env /usr/local/bin/foo" is that the latter works even if
     /usr/local/bin/foo	is itself interpreted.	Using env this way also	allows
     one to reference foo without the path, as well as set up the environment
     as	desired.

ENVIRONMENT
     The env utility uses the PATH environment variable	to locate the re-
     quested utility if	the name contains no `/' characters.

DIAGNOSTICS
     The env utility exits 0 on	success, and >0	if an error occurs.  An	exit
     status of 126 indicates that utility was found, but could not be exe-
     cuted.  An	exit status of 127 indicates that utility could	not be found.

COMPATIBILITY
     The env utility accepts the - option as a synonym for -i.

SEE ALSO
     printenv(1), sh(1), execvp(3), environ(7)

STANDARDS
     The env utility conforms to IEEE Std 1003.1-2001 ("POSIX.1").

BUGS
     The env utility does not handle utility arguments with equal signs	(`=')
     in	their names, for obvious reasons.

BSD				 May 12, 2003				   BSD

NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT | DIAGNOSTICS | COMPATIBILITY | SEE ALSO | STANDARDS | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=env&sektion=1&manpath=FreeBSD+5.3-RELEASE>

home | help