User Commands zlogin(1)
NAME
zlogin - enter a zone
SYNOPSIS
zlogin [-CE] [-e c] [-l username] zonename
zlogin [-ES] [-e c] [-l username] zonename utility
[argument]...DESCRIPTION
The zlogin utility is used to enter an operating system
zone. Only a user operating in the global system zone can use this utility, and it must be executed with all privileges. In addition, the user must be authorized to use specific options described in the OPTIONS section.zlogin checks for authorization strings which optionally
include the specified zonename as a suffix, preceded by the slash character. When omitted, the authorization matches any zone.zlogin operates in one of three modes:
Interactive Mode If no utility argument is given and the stdin file descriptor for thezlogin process is a tty device, zlo-
gin operates in interactive mode. Inthis mode, zlogin creates a new
pseudo terminal for use within the login session. Programs requiring a tty device, for example, vi(1), work properly in this mode. In this mode,zlogin invokes login(1) to provide a
suitable login session.Non-Interactive Mode If a utility is specified, zlogin
operates in non-interactive mode.
This mode can be useful for script authors since stdin, stdout, and stderr are preserved and the exit status of utility is returned upontermination. In this mode, zlogin
invokes su(1M) in order to set upthe user's environment and to pro-
vide a login environment. The specified command is passed as aSunOS 5.11 Last change: 7 Jun 2010 1
User Commands zlogin(1)
string and interpreted by a shellrunning in the non-global zone. See
rsh(1).Console Mode If the -C option is specified, the
user is connected to the zone con-
sole device and zlogin operates in
console mode. The zone console is available once the zone is in the installed state. Connections to the console are persistent across reboot of the zone. OPTIONS The following options are supported:-C Connects to the zone console. Connects to the
zone console. Access to the zone console requires the authorizationzone.manage/zonename.-e c Specifies a different escape character, c,
for the key sequence used to access extended functions and to disconnect from the login. The default escape character is the tilde (~).-E Disables the ability to access extended func-
tions or to disconnect from the login by using the escape sequence character.-l username Specifies a different username for the zone
login. If you do not use this option, the zone username used is root. This option isinvalid if the -C option is specified.
The username must be valid in the zone. For interactive logins the authorization solaris.zone.login/zonename is required, and password authentication takes place in thezone. For non-interactive logins, or to
bypass password authentication, the authori-
zation solaris.zone.manage/zonename is required.SunOS 5.11 Last change: 7 Jun 2010 2
User Commands zlogin(1)
-S Safe login mode. zlogin does minimal process-
ing and does not invoke login(1) or su(1M).The zone username is set to root. The -S
option cannot be used if a username is speci-
fied through the -l option, and cannot be
used with console logins. This mode should only be used to recover a damaged zone when other forms of login have become impossible. Use of this option requires the authorization solaris.zone.manage/zonename. Escape Sequences Lines that you type that start with the tilde character (~) are "escape sequences". The escape character can be changedusing the -e option.
~. Disconnects from the zone. This is not the same as a logout, because the local host breaks the connection with no warning to the zone's end. SECURITYOnce a process has been placed in a zone other than the glo-
bal zone, the process cannot change zone again, nor can any of its children. OPERANDS The following operands are supported: zonename The name of the zone to be entered. utility The utility to be run in the specified zone. argument... Arguments passed to the utility. EXIT STATUSIn interactive and non-interactive modes, the zlogin utility
exits when the command or shell in the non-global zone
exits. In non-interactive mode, the exit status of the
remote program is returned as the exit status of zlogin. In
interactive mode and console login mode, the exit status isnot returned. zlogin returns a 0 exit status as long as no
connection-related error occurred.
In all modes, in the event that a connection to the zone cannot be established, the connection fails unexpectedly, orSunOS 5.11 Last change: 7 Jun 2010 3
User Commands zlogin(1)
the user is lacking sufficient privilege to perform therequested operation, zlogin exits with status 1.
To summarize, the following exit values are returned: 0 Successful entry. 1 Permission denied, or failure to enter the zone. Any Return code from utility, or from su(1M) if operatingin non-interactive mode.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | system/zones ||_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
SEE ALSO
login(1), rsh(1), vi(1), su(1M), zoneadm(1M), zonecfg(1M), attributes(5), zones(5) NOTESzlogin fails if its open files or any portion of its address
space corresponds to an NFS file. This includes the execut-
able itself or the shared libraries.SunOS 5.11 Last change: 7 Jun 2010 4