Print this page
3091 add -n to zlogin so its more compatible with rsh command line
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1/zlogin.1
+++ new/usr/src/man/man1/zlogin.1
1 1 '\" te
2 2 .\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved
3 3 .\" The contents of this file are subject to the terms of the Common
4 4 .\" Development and Distribution License (the "License"). You may not use this
|
↓ open down ↓ |
4 lines elided |
↑ open up ↑ |
5 5 .\" file except in compliance with the License.
6 6 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or
7 7 .\" http://www.opensolaris.org/os/licensing. See the License for the specific
8 8 .\" language governing permissions and limitations under the License.
9 9 .\" When distributing Covered Code, include this CDDL HEADER in each file and
10 10 .\" include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable,
11 11 .\" add the following below this CDDL HEADER, with the fields enclosed by
12 12 .\" brackets "[]" replaced with your own identifying information:
13 13 .\" Portions Copyright [yyyy] [name of copyright owner]
14 14 .\" Copyright 2013 DEY Storage Systems, Inc.
15 -.TH ZLOGIN 1 "Sep 8, 2013"
15 +.\" Copyright (c) 2014 Gary Mills
16 +.TH ZLOGIN 1 "Jan 22, 2014"
16 17 .SH NAME
17 18 zlogin \- enter a zone
18 19 .SH SYNOPSIS
19 20 .LP
20 21 .nf
21 22 \fBzlogin\fR [\fB-CEQ\fR] [\fB-e\fR \fIc\fR] [\fB-l\fR \fIusername\fR] \fIzonename\fR
22 23 .fi
23 24
24 25 .LP
25 26 .nf
26 -\fBzlogin\fR [\fB-EQS\fR] [\fB-e\fR \fIc\fR] [\fB-l\fR \fIusername\fR] \fIzonename\fR \fIutility\fR
27 +\fBzlogin\fR [\fB-nEQS\fR] [\fB-e\fR \fIc\fR] [\fB-l\fR \fIusername\fR] \fIzonename\fR \fIutility\fR
27 28 [\fIargument\fR]...
28 29 .fi
29 30
30 31 .SH DESCRIPTION
31 32 .sp
32 33 .LP
33 34 The \fBzlogin\fR utility is used by the administrator to enter an operating
34 35 system zone. Only a superuser operating in the global system zone can use this
35 36 utility.
36 37 .sp
37 38 .LP
38 39 \fBzlogin\fR operates in one of three modes:
39 40 .sp
40 41 .ne 2
41 42 .na
42 43 \fBInteractive Mode\fR
43 44 .ad
44 45 .RS 24n
45 46 If no utility argument is given and the stdin file descriptor for the
46 47 \fBzlogin\fR process is a tty device, \fBzlogin\fR operates in \fBinteractive
47 48 mode\fR. In this mode, \fBzlogin\fR creates a new pseudo terminal for use
48 49 within the login session. Programs requiring a tty device, for example,
49 50 \fBvi\fR(1), work properly in this mode. In this mode, \fBzlogin\fR invokes
50 51 \fBlogin\fR(1) to provide a suitable login session.
51 52 .RE
52 53
53 54 .sp
54 55 .ne 2
55 56 .na
56 57 \fBNon-Interactive Mode\fR
57 58 .ad
58 59 .RS 24n
59 60 If a utility is specified, \fBzlogin\fR operates in \fBnon-interactive mode\fR.
60 61 This mode can be useful for script authors since stdin, stdout, and stderr are
61 62 preserved and the exit status of \fIutility\fR is returned upon termination. In
62 63 this mode, \fBzlogin\fR invokes \fBsu\fR(1M) in order to set up the user's
63 64 environment and to provide a login environment.
64 65 .sp
65 66 The specified command is passed as a string and interpreted by a shell running
66 67 in the non-global zone. See \fBrsh\fR(1).
67 68 .RE
68 69
69 70 .sp
70 71 .ne 2
71 72 .na
72 73 \fBConsole Mode\fR
73 74 .ad
74 75 .RS 24n
75 76 If the \fB-C\fR option is specified, the user is connected to the zone console
76 77 device and \fBzlogin\fR operates in \fBconsole mode\fR. The zone console is
77 78 available once the zone is in the installed state. Connections to the console
78 79 are persistent across reboot of the zone.
79 80 .RE
80 81
81 82 .SH OPTIONS
82 83 .sp
83 84 .LP
84 85 The following options are supported:
85 86 .sp
86 87 .ne 2
87 88 .na
88 89 \fB\fB-C\fR\fR
89 90 .ad
90 91 .RS 15n
91 92 Connects to the zone console.
92 93 .RE
93 94
94 95 .sp
95 96 .ne 2
96 97 .na
97 98 \fB\fB-e\fR \fIc\fR\fR
98 99 .ad
99 100 .RS 15n
100 101 Specifies a different escape character, \fIc\fR, for the key sequence used to
101 102 access extended functions and to disconnect from the login. The default escape
102 103 character is the tilde (\fB~\fR).
103 104 .RE
104 105
105 106 .sp
106 107 .ne 2
107 108 .na
108 109 \fB\fB-E\fR\fR
109 110 .ad
110 111 .RS 15n
111 112 Disables the ability to access extended functions or to disconnect from the
112 113 login by using the escape sequence character.
113 114 .RE
114 115
115 116 .sp
|
↓ open down ↓ |
79 lines elided |
↑ open up ↑ |
116 117 .ne 2
117 118 .na
118 119 \fB\fB-l\fR \fIusername\fR\fR
119 120 .ad
120 121 .RS 15n
121 122 Specifies a different \fIusername\fR for the zone login. If you do not use this
122 123 option, the zone username used is "root". This option is invalid if the
123 124 \fB-C\fR option is specified.
124 125 .RE
125 126
127 +.sp
128 +.ne 2
129 +.na
130 +\fB-n\fR
131 +.ad
132 +.RS 15n
133 +Redirect the input of \fBzlogin\fR to \fB/dev/null\fR.
134 +This option is useful when the command running in the local zone
135 +and the shell which invokes \fBzlogin\fR both read from standard input.
136 +.RE
137 +
126 138 .sp
127 139 .ne 2
128 140 .na
129 141 \fB-Q\fR
130 142 .ad
131 143 .RS 15n
132 144 Specifies quiet mode operation. In quiet mode, extra messages indicating the
133 145 the function of \fBzlogin\fR will not be displayed, giving the possibility
134 146 to present the appearance that the command is running locally rather than
135 147 in another zone.
136 148 .RE
137 149
138 150 .sp
139 151 .ne 2
140 152 .na
141 153 \fB\fB-S\fR\fR
142 154 .ad
143 155 .RS 15n
144 156 "Safe" login mode. \fBzlogin\fR does minimal processing and does not invoke
145 157 \fBlogin\fR(1) or \fBsu\fR(1M). The \fB-S\fR option can not be used if a
146 158 username is specified through the \fB-l\fR option, and cannot be used with
147 159 console logins. This mode should only be used to recover a damaged zone when
148 160 other forms of login have become impossible.
149 161 .RE
150 162
151 163 .SS "Escape Sequences"
152 164 .sp
153 165 .LP
154 166 Lines that you type that start with the tilde character (\fB~\fR) are "escape
155 167 sequences". The escape character can be changed using the \fB-e\fR option.
156 168 .sp
157 169 .ne 2
158 170 .na
159 171 \fB\fB~.\fR\fR
160 172 .ad
161 173 .RS 6n
162 174 Disconnects from the zone. This is not the same as a logout, because the local
163 175 host breaks the connection with no warning to the zone's end.
164 176 .RE
165 177
166 178 .SH SECURITY
167 179 .sp
168 180 .LP
169 181 Once a process has been placed in a zone other than the global zone, the
170 182 process cannot change zone again, nor can any of its children.
171 183 .SH OPERANDS
172 184 .sp
173 185 .LP
174 186 The following operands are supported:
175 187 .sp
176 188 .ne 2
177 189 .na
178 190 \fB\fIzonename\fR\fR
179 191 .ad
180 192 .RS 15n
181 193 The name of the zone to be entered.
182 194 .RE
183 195
184 196 .sp
185 197 .ne 2
186 198 .na
187 199 \fB\fIutility\fR\fR
188 200 .ad
189 201 .RS 15n
190 202 The utility to be run in the specified zone.
191 203 .RE
192 204
193 205 .sp
194 206 .ne 2
195 207 .na
196 208 \fB\fIargument...\fR\fR
197 209 .ad
198 210 .RS 15n
199 211 Arguments passed to the utility.
200 212 .RE
201 213
202 214 .SH EXIT STATUS
203 215 .sp
204 216 .LP
205 217 In interactive and non-interactive modes, the \fBzlogin\fR utility exits when
206 218 the command or shell in the non-global zone exits. In non-interactive mode, the
207 219 exit status of the remote program is returned as the exit status of
208 220 \fBzlogin\fR. In interactive mode and console login mode, the exit status is
209 221 not returned. \fBzlogin\fR returns a \fB0\fR exit status as long as no
210 222 connection-related error occurred.
211 223 .sp
212 224 .LP
213 225 In all modes, in the event that a connection to the zone cannot be established,
214 226 the connection fails unexpectedly, or the user is lacking sufficient privilege
215 227 to perform the requested operation, \fBzlogin\fR exits with status \fB1\fR.
216 228 .sp
217 229 .LP
218 230 To summarize, the following exit values are returned:
219 231 .sp
220 232 .ne 2
221 233 .na
222 234 \fB\fB0\fR\fR
223 235 .ad
224 236 .RS 7n
225 237 Successful entry.
226 238 .RE
227 239
228 240 .sp
229 241 .ne 2
230 242 .na
231 243 \fB\fB1\fR\fR
232 244 .ad
233 245 .RS 7n
234 246 Permission denied, or failure to enter the zone.
235 247 .RE
236 248
237 249 .sp
238 250 .ne 2
239 251 .na
240 252 \fBAny\fR
241 253 .ad
242 254 .RS 7n
243 255 Return code from utility, or from \fBsu\fR(1M) if operating in non-interactive
244 256 mode.
245 257 .RE
246 258
247 259 .SH ATTRIBUTES
248 260 .sp
249 261 .LP
250 262 See \fBattributes\fR(5) for descriptions of the following attributes:
251 263 .sp
252 264
253 265 .sp
254 266 .TS
255 267 box;
256 268 c | c
257 269 l | l .
258 270 ATTRIBUTE TYPE ATTRIBUTE VALUE
259 271 _
260 272 Interface Stability Evolving
261 273 .TE
262 274
263 275 .SH SEE ALSO
264 276 .sp
265 277 .LP
266 278 \fBlogin\fR(1), \fBrsh\fR(1), \fBvi\fR(1), \fBsu\fR(1M), \fBzoneadm\fR(1M),
267 279 \fBzonecfg\fR(1M), \fBattributes\fR(5), \fBzones\fR(5)
268 280 .SH NOTES
269 281 .sp
270 282 .LP
271 283 \fBzlogin\fR fails if its open files or any portion of its address space
272 284 corresponds to an NFS file. This includes the executable itself or the shared
273 285 libraries.
|
↓ open down ↓ |
138 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX