Print this page
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1/zlogin.1.man.txt
+++ new/usr/src/man/man1/zlogin.1.man.txt
1 1 ZLOGIN(1) User Commands ZLOGIN(1)
2 2
3 3
4 4
5 5 NAME
6 6 zlogin - enter a zone
7 7
8 8 SYNOPSIS
9 9 zlogin [-dCEINQ] [-e c] [-l username] zonename
10 10
11 11
12 12 zlogin [-inEQS] [-e c] [-l username] zonename utility
13 13 [argument]...
14 14
15 15
16 16 DESCRIPTION
17 17 The zlogin utility is used by the administrator to enter an operating
18 18 system zone. Only a superuser operating in the global system zone can
19 19 use this utility.
20 20
21 21
22 22 zlogin operates in one of four modes:
23 23
24 24 Interactive Mode
25 25 If no utility argument is given or if the -i
26 26 option is specified, and the stdin file
27 27 descriptor for the zlogin process is a tty
28 28 device, zlogin operates in interactive mode. In
29 29 this mode, zlogin creates a new pseudo terminal
30 30 for use within the login session. Programs
31 31 requiring a tty device, for example, vi(1),
32 32 work properly in this mode. In this mode,
33 33 zlogin invokes login(1) to provide a suitable
34 34 login session.
35 35
36 36
37 37 Non-Interactive Mode
38 38 If a utility is specified and the -i option is
39 39 not specified, zlogin operates in non-
40 40 interactive mode. This mode can be useful for
41 41 script authors since stdin, stdout, and stderr
42 42 are preserved and the exit status of utility is
43 43 returned upon termination. In this mode, zlogin
44 44 invokes su(1M) in order to set up the user's
45 45 environment and to provide a login environment.
46 46
47 47 The specified command is passed as a string and
48 48 interpreted by a shell running in the non-
49 49 global zone. See rsh(1).
50 50
51 51
52 52 Console Mode
53 53 If the -C option is specified, the user is
54 54 connected to the zone console device and zlogin
55 55 operates in console mode. The zone console is
56 56 available once the zone is in the installed
57 57 state. Connections to the console are
58 58 persistent across reboot of the zone.
59 59
60 60
61 61 Standalone-processs Interactive Mode
62 62 If the -I option is specified the user is
63 63 connected to the zone's stdin, stdout and
64 64 stderr zfd(7D) devices.
65 65
66 66
67 67 OPTIONS
68 68 The following options are supported:
69 69
70 70 -C
71 71 Connects to the zone console.
72 72
73 73
74 74 -d
75 75 Disconnect from the console when the zone halts. This
76 76 option may only be used if the -C option is specified.
77 77
78 78
79 79 -e c
80 80 Specifies a different escape character, c, for the key
81 81 sequence used to access extended functions and to
82 82 disconnect from the login. The default escape character
83 83 is the tilde (~).
84 84
85 85
86 86 -E
87 87 Disables the ability to access extended functions or to
88 88 disconnect from the login by using the escape sequence
89 89 character.
90 90
91 91
92 92 -i
93 93 Forces interactive mode when a utility argument is
94 94 specified.
95 95
96 96
97 97 -I
98 98 Connects to the zone's zfd(7D) devices.
99 99
100 100
101 101
102 102 -l username
103 103 Specifies a different username for the zone login. If
104 104 you do not use this option, the zone username used is
105 105 "root". This option is invalid if the -C option is
106 106 specified.
107 107
108 108
109 109 -n
110 110 Redirect the input of zlogin to /dev/null. This option
111 111 is useful when the command running in the local zone and
112 112 the shell which invokes zlogin both read from standard
113 113 input.
114 114
115 115
116 116 -N
117 117 Nohup. This may only be used with the -I option to avoid
118 118 sending EOF to the zfd device when zlogin's stdin
119 119 receives EOF. It can also be toggled by sending SIGUSR1
120 120 to an attached zlogin process.
121 121
122 122
123 123 -Q
124 124 Specifies quiet mode operation. In quiet mode, extra
125 125 messages indicating the the function of zlogin will not
126 126 be displayed, giving the possibility to present the
127 127 appearance that the command is running locally rather
128 128 than in another zone.
129 129
130 130
131 131 -S
132 132 "Safe" login mode. zlogin does minimal processing and
133 133 does not invoke login(1) or su(1M). The -S option can
134 134 not be used if a username is specified through the -l
135 135 option, and cannot be used with console logins. This
136 136 mode should only be used to recover a damaged zone when
137 137 other forms of login have become impossible.
138 138
139 139
140 140 Escape Sequences
141 141 Lines that you type that start with the tilde character (~) are "escape
142 142 sequences". The escape character can be changed using the -e option.
143 143
144 144 ~.
145 145 Disconnects from the zone. This is not the same as a logout,
146 146 because the local host breaks the connection with no warning to
147 147 the zone's end.
148 148
149 149
150 150 SECURITY
151 151 Once a process has been placed in a zone other than the global zone,
152 152 the process cannot change zone again, nor can any of its children.
153 153
154 154 OPERANDS
155 155 The following operands are supported:
156 156
157 157 zonename
158 158 The name of the zone to be entered.
159 159
160 160
161 161 utility
162 162 The utility to be run in the specified zone.
163 163
164 164
165 165 argument...
166 166 Arguments passed to the utility.
167 167
168 168
169 169 EXIT STATUS
170 170 In interactive and non-interactive modes, the zlogin utility exits when
171 171 the command or shell in the non-global zone exits. In non-interactive
172 172 mode, the exit status of the remote program is returned as the exit
173 173 status of zlogin. In interactive mode and console login mode, the exit
174 174 status is not returned. zlogin returns a 0 exit status as long as no
175 175 connection-related error occurred.
176 176
177 177
178 178 In all modes, in the event that a connection to the zone cannot be
179 179 established, the connection fails unexpectedly, or the user is lacking
180 180 sufficient privilege to perform the requested operation, zlogin exits
181 181 with status 1.
182 182
183 183
184 184 To summarize, the following exit values are returned:
185 185
186 186 0
187 187 Successful entry.
188 188
189 189
190 190 1
191 191 Permission denied, or failure to enter the zone.
192 192
193 193
194 194 Any
195 195 Return code from utility, or from su(1M) if operating in non-
196 196 interactive mode.
197 197
198 198
199 199 ATTRIBUTES
200 200 See attributes(5) for descriptions of the following attributes:
201 201
202 202
203 203
204 204
205 205 +--------------------+-----------------+
206 206 | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
207 207 +--------------------+-----------------+
208 208 |Interface Stability | Evolving |
209 209 +--------------------+-----------------+
210 210
211 211 SEE ALSO
212 212 login(1), rsh(1), vi(1), su(1M), zoneadm(1M), zonecfg(1M),
213 213 attributes(5), zones(5)
214 214
215 215 NOTES
216 216 zlogin fails if its open files or any portion of its address space
217 217 corresponds to an NFS file. This includes the executable itself or the
218 218 shared libraries.
219 219
220 220
221 221
222 222 March 30, 2015 ZLOGIN(1)
|
↓ open down ↓ |
222 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX