Annotation of src/usr.bin/env/env.1, Revision 1.10
1.10 ! jmc 1: .\" $OpenBSD: env.1,v 1.9 2003/06/03 02:56:07 millert Exp $
1.1 deraadt 2: .\" Copyright (c) 1980, 1990 The Regents of the University of California.
3: .\" All rights reserved.
4: .\"
5: .\" This code is derived from software contributed to Berkeley by
6: .\" the Institute of Electrical and Electronics Engineers, Inc.
7: .\" Redistribution and use in source and binary forms, with or without
8: .\" modification, are permitted provided that the following conditions
9: .\" are met:
10: .\" 1. Redistributions of source code must retain the above copyright
11: .\" notice, this list of conditions and the following disclaimer.
12: .\" 2. Redistributions in binary form must reproduce the above copyright
13: .\" notice, this list of conditions and the following disclaimer in the
14: .\" documentation and/or other materials provided with the distribution.
1.9 millert 15: .\" 3. Neither the name of the University nor the names of its contributors
1.1 deraadt 16: .\" may be used to endorse or promote products derived from this software
17: .\" without specific prior written permission.
18: .\"
19: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29: .\" SUCH DAMAGE.
30: .\"
31: .\" from: @(#)printenv.1 6.7 (Berkeley) 7/28/91
32: .\"
33: .Dd August 27, 1993
34: .Dt ENV 1
35: .Os
36: .Sh NAME
37: .Nm env
38: .Nd set and print environment
39: .Sh SYNOPSIS
40: .Nm env
41: .Op Fl i
1.5 aaron 42: .Oo
43: .Ar name Ns No = Ns Ar value ...
44: .Oc
1.1 deraadt 45: .Oo
46: .Ar utility
1.4 aaron 47: .Op Ar argument ...
1.1 deraadt 48: .Oc
49: .Sh DESCRIPTION
1.5 aaron 50: .Nm
1.1 deraadt 51: executes
52: .Ar utility
53: after modifying the environment as
1.6 aaron 54: specified on the command line.
55: The option
1.5 aaron 56: .Ar name Ns No = Ns Ar value
1.1 deraadt 57: specifies
1.2 deraadt 58: an environment variable,
1.6 aaron 59: .Ar name ,
1.1 deraadt 60: with a value of
1.6 aaron 61: .Ar value .
62: .Pp
63: The options are as follows:
64: .Bl -tag -width Ds
65: .It Fl i
66: Causes
1.5 aaron 67: .Nm
1.6 aaron 68: to completely ignore the environment it inherits.
69: .El
1.1 deraadt 70: .Pp
1.5 aaron 71: If no
1.1 deraadt 72: .Ar utility
73: is specified,
1.5 aaron 74: .Nm
1.1 deraadt 75: prints out the names and values
1.5 aaron 76: of the variables in the environment, with one
77: .Ar name Ns No = Ns Ar value
1.1 deraadt 78: pair per line.
79: .Sh DIAGNOSTICS
1.5 aaron 80: If the
1.1 deraadt 81: .Ar utility
1.5 aaron 82: is invoked, the exit status of
83: .Nm
1.1 deraadt 84: shall be the exit status of
1.4 aaron 85: .Ar utility ;
1.1 deraadt 86: otherwise, the
1.5 aaron 87: .Nm
1.1 deraadt 88: utility exits with one of the following values:
89: .Bl -tag -width Ds
90: .It 0
1.5 aaron 91: The
92: .Nm
1.4 aaron 93: utility completed successfully.
1.1 deraadt 94: .It 1-125
1.7 deraadt 95: The exit code returned from the
1.10 ! jmc 96: .Ar utility .
1.1 deraadt 97: .It 126
98: The utility specified by
1.5 aaron 99: .Ar utility
1.1 deraadt 100: was found, but could not be invoked.
101: .It 127
102: The utility specified by
1.5 aaron 103: .Ar utility
1.1 deraadt 104: could not be found.
105: .El
1.8 aaron 106: .Sh SEE ALSO
107: .Xr execvp 3 ,
108: .Xr environ 7
1.10 ! jmc 109: .Sh STANDARDS
1.5 aaron 110: The historic
111: .Fl
1.1 deraadt 112: option has been deprecated but is still supported in this implementation.
1.10 ! jmc 113: .Pp
1.1 deraadt 114: The
1.5 aaron 115: .Nm
1.1 deraadt 116: utility conforms to
117: .St -p1003.2-92 .
118: .Sh BUGS
1.5 aaron 119: .Nm
1.1 deraadt 120: doesn't handle commands with equal
1.4 aaron 121: .Pq Sq =
1.1 deraadt 122: signs in their
123: names, for obvious reasons.