diff options
author | tjr <tjr@FreeBSD.org> | 2003-06-01 06:29:47 +0000 |
---|---|---|
committer | tjr <tjr@FreeBSD.org> | 2003-06-01 06:29:47 +0000 |
commit | dfd248ebc6ddc3bab804cf6f485c10d2ee0f781f (patch) | |
tree | 64ab85237abd1e25a9e4da550983b04cd7af14ea /usr.bin/printenv/printenv.1 | |
parent | 0c845cdfd3600f71462c21354069c53fedeb9be0 (diff) | |
download | FreeBSD-src-dfd248ebc6ddc3bab804cf6f485c10d2ee0f781f.zip FreeBSD-src-dfd248ebc6ddc3bab804cf6f485c10d2ee0f781f.tar.gz |
Split the env(1) manpage off from printenv(1); there is not much point
in keeping them together. Mention that printenv is obsolescent.
Diffstat (limited to 'usr.bin/printenv/printenv.1')
-rw-r--r-- | usr.bin/printenv/printenv.1 | 109 |
1 files changed, 17 insertions, 92 deletions
diff --git a/usr.bin/printenv/printenv.1 b/usr.bin/printenv/printenv.1 index 35af7df..7c05878 100644 --- a/usr.bin/printenv/printenv.1 +++ b/usr.bin/printenv/printenv.1 @@ -34,19 +34,15 @@ .\" @(#)printenv.1 8.1 (Berkeley) 6/6/93 .\" $FreeBSD$ .\" -.Dd June 6, 1993 +.Dd May 12, 2003 .Dt PRINTENV 1 .Os .Sh NAME -.Nm printenv , env -.Nd print out the environment, set and print environment +.Nm printenv +.Nd print out the environment .Sh SYNOPSIS .Nm .Op Ar name -.Nm env -.Op Fl i -.Op Ar name Ns = Ns Ar value ... -.Op Ar utility Op Ar argument ... .Sh DESCRIPTION The .Nm @@ -63,101 +59,30 @@ command which is similar or identical to this utility. Consult the .Xr builtin 1 manual page. -.Pp -The -.Nm env -utility executes -.Ar utility -after modifying the environment as -specified on the command line. -The option -.Ar name Ns = Ns Ar value -specifies -an environment variable, -.Ar name , -with a value of -.Ar value . -.Pp -The options are as follows: -.Bl -tag -width indent -.It Fl i -Execute the -.Ar utility -with only those environment values specified. -The environment inherited -by -.Nm env -is ignored completely. -.El -.Pp -If no utility is specified, -.Nm env -prints out the names and values -of the variables in the environment, with one name/value pair per line. -.Pp -The -.Nm env -utility is sometimes useful with the -.Dq Li #! -construct (see -.Xr execve 2 ) . -The only difference between -.Dq Li #!/usr/local/bin/foo -and -.Dq Li "#!/usr/bin/env\ /usr/local/bin/foo" -is that the latter works even if -.Pa /usr/local/bin/foo -is itself interpreted. -Using -.Nm env -this way also allows one to reference -.Pa foo -without the path, -as well as set up the environment as desired. -.Sh ENVIRONMENT -The -.Nm env -utility uses the -.Ev PATH -environment variable is used to locate the requested -.Ar utility -if the name contains no -.Ql / -characters. .Sh DIAGNOSTICS .Ex -std printenv -.Pp -.Ex -std env -An exit status of 126 indicates -.Ar utility -was found, but could not be executed. -An exit status of 127 indicates -.Ar utility -could not be found. -.Sh COMPATIBILITY -The -.Nm env -utility accepts the -.Fl -option as a synonym for -.Fl i . .Sh SEE ALSO .Xr csh 1 , +.Xr env 1 , .Xr sh 1 , -.Xr execvp 3 , .Xr environ 7 .Sh STANDARDS The -.Nm env -utility conforms to -.St -p1003.1-2001 . +.Nm +utility is provided for compatibility with earlier +.Bx +and +.Fx +releases and is not specified by any standards. +The functionality of +.Nm +can be duplicated with the +.Xr echo 1 +and +.Xr env 1 +utilities. .Sh HISTORY The .Nm command appeared in .Bx 3.0 . -.Sh BUGS -The -.Nm env -utility doesn't handle utility arguments with equal (``='') signs in their -names, for obvious reasons. |