1zlogin(1) User Commands zlogin(1)
2
6 zlogin - enter a zone
7
9 zlogin [-CE] [-e c] [-l username] zonename
10 zlogin [-ES] [-e c] [-l username] zonename utility
13 [argument]...
14
17 The zlogin utility is used by the administrator to enter an operating
18 system zone. Only a superuser operating in the global system zone can
19 use this utility.
20 zlogin operates in one of three modes:
23 Interactive Mode If no utility argument is given and the stdin
25 file descriptor for the zlogin process is a tty
26 device, zlogin operates in interactive mode. In
27 this mode, zlogin creates a new pseudo terminal
28 for use within the login session. Programs
29 requiring a tty device, for example, vi(1),
30 work properly in this mode. In this mode, zlo‐
31 gin invokes login(1) to provide a suitable
32 login session.
33 Non-Interactive Mode If a utility is specified, zlogin operates in
36 non-interactive mode. This mode can be useful
37 for script authors since stdin, stdout, and
38 stderr are preserved and the exit status of
39 utility is returned upon termination. In this
40 mode, zlogin invokes su(1M) in order to set up
41 the user's environment and to provide a login
42 environment.
43 The specified command is passed as a string and
45 interpreted by a shell running in the non-
46 global zone. See rsh(1).
47 Console Mode If the -C option is specified, the user is con‐
50 nected to the zone console device and zlogin
51 operates in console mode. The zone console is
52 available once the zone is in the installed
53 state. Connections to the console are persis‐
54 tent across reboot of the zone.
55
58 The following options are supported:
59 -C Connects to the zone console.
61 -e c Specifies a different escape character, c, for the key
64 sequence used to access extended functions and to dis‐
65 connect from the login. The default escape character is
66 the tilde (~).
67 -E Disables the ability to access extended functions or to
70 disconnect from the login by using the escape sequence
71 character.
72 -l username Specifies a different username for the zone login. If
75 you do not use this option, the zone username used is
76 "root". This option is invalid if the -C option is spec‐
77 ified.
78 -S "Safe" login mode. zlogin does minimal processing and
81 does not invoke login(1) or su(1M). The -S option can
82 not be used if a username is specified through the -l
83 option, and cannot be used with console logins. This
84 mode should only be used to recover a damaged zone when
85 other forms of login have become impossible.
86 Escape Sequences
89 Lines that you type that start with the tilde character (~) are "escape
90 sequences". The escape character can be changed using the -e option.
91 ~. Disconnects from the zone. This is not the same as a logout,
93 because the local host breaks the connection with no warning to
94 the zone's end.
95
98 Once a process has been placed in a zone other than the global zone,
99 the process cannot change zone again, nor can any of its children.
100
102 The following operands are supported:
103 zonename The name of the zone to be entered.
105 utility The utility to be run in the specified zone.
108 argument... Arguments passed to the utility.
111
114 In interactive and non-interactive modes, the zlogin utility exits when
115 the command or shell in the non-global zone exits. In non-interactive
116 mode, the exit status of the remote program is returned as the exit
117 status of zlogin. In interactive mode and console login mode, the exit
118 status is not returned. zlogin returns a 0 exit status as long as no
119 connection-related error occurred.
120 In all modes, in the event that a connection to the zone cannot be
123 established, the connection fails unexpectedly, or the user is lacking
124 sufficient privilege to perform the requested operation, zlogin exits
125 with status 1.
126 To summarize, the following exit values are returned:
129 0 Successful entry.
131 1 Permission denied, or failure to enter the zone.
134 Any Return code from utility, or from su(1M) if operating in non-
137 interactive mode.
138
141 See attributes(5) for descriptions of the following attributes:
142 ┌─────────────────────────────┬─────────────────────────────┐
147 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
148 ├─────────────────────────────┼─────────────────────────────┤
149 │Availability │SUNWzoneu │
150 ├─────────────────────────────┼─────────────────────────────┤
151 │Interface Stability │Evolving │
152 └─────────────────────────────┴─────────────────────────────┘
153
155 login(1), rsh(1), vi(1), su(1M), zoneadm(1M), zonecfg(1M),
156 attributes(5), zones(5)
157
159 zlogin fails if its open files or any portion of its address space cor‐
160 responds to an NFS file. This includes the executable itself or the
161 shared libraries.
162SunOS 5.11 18 Dec 2006 zlogin(1)