Annotation of src/usr.bin/env/env.1, Revision 1.20
1.20 ! deraadt 1: .\" $OpenBSD: env.1,v 1.19 2014/03/08 01:42:17 schwarze 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: .\"
1.20 ! deraadt 33: .Dd $Mdocdate: March 8 2014 $
1.1 deraadt 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
1.11 jmc 43: .Ar name Ns = Ns Ar value ...
1.5 aaron 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.11 jmc 56: .Ar name Ns = 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
1.11 jmc 77: .Ar name Ns = Ns Ar value
1.1 deraadt 78: pair per line.
1.20 ! deraadt 79: .Pp
! 80: .Nm
! 81: doesn't handle commands with equal
! 82: .Pq Sq =
! 83: signs in their
! 84: names, for obvious reasons.
1.18 jmc 85: .Sh EXIT STATUS
86: The
1.5 aaron 87: .Nm
1.18 jmc 88: utility exits with one of the following values:
1.1 deraadt 89: .Bl -tag -width Ds
90: .It 0
1.19 schwarze 91: .Nm
92: completed successfully and, if
1.14 jmc 93: .Ar utility
1.19 schwarze 94: was specified, it was invoked and completed successfully too.
1.14 jmc 95: .It 1
96: An invalid command line option was passed to
1.19 schwarze 97: .Nm
98: and
99: .Ar utility
100: was not invoked, or
101: .Ar utility
102: was invoked but failed with exit status 1.
103: .It 2\(en125, 128\(en255
1.14 jmc 104: .Ar utility
1.19 schwarze 105: was invoked but failed with this exit status;
1.14 jmc 106: see its manual page for more information.
1.1 deraadt 107: .It 126
1.5 aaron 108: .Ar utility
1.19 schwarze 109: was found but could not be invoked, or it was invoked but failed
110: with exit status 126.
1.1 deraadt 111: .It 127
1.5 aaron 112: .Ar utility
1.19 schwarze 113: could not be found, or it was invoked but failed with exit status 127.
1.1 deraadt 114: .El
1.8 aaron 115: .Sh SEE ALSO
116: .Xr execvp 3 ,
117: .Xr environ 7
1.10 jmc 118: .Sh STANDARDS
1.15 jmc 119: The
120: .Nm
121: utility is compliant with the
1.17 jmc 122: .St -p1003.1-2008
1.15 jmc 123: specification.
124: .Pp
1.13 ray 125: The historic
126: .Fl
127: option has been deprecated but is still supported in this implementation.