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 by the administrator to enter an
operating system zone. Only a superuser operating in the
global system zone can use this utility.
zlogin operates in one of three modes:
Interactive Mode If no utility argument is given and
the stdin file descriptor for the
zlogin process is a tty device, zlo-
gin operates in interactive mode. In
this 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 upon
termination. In this mode, zlogin
invokes su(1M) in order to set up
the user's environment and to pro-
vide a login environment.
The specified command is passed as a
string and interpreted by a shell
running 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
SunOS 5.11 Last change: 18 Dec 2006 1
User Commands zlogin(1)
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.
-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 is
invalid if the -C option is specified.
-S "Safe" login mode. zlogin does minimal pro-
cessing and does not invoke login(1) or
su(1M). The -S option can not be used if a
username is specified 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.
Escape Sequences
Lines that you type that start with the tilde character (~)
are "escape sequences". The escape character can be changed
using 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.
SunOS 5.11 Last change: 18 Dec 2006 2
User Commands zlogin(1)
SECURITY
Once 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 STATUS
In 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 is
not 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, or
the user is lacking sufficient privilege to perform the
requested 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 operating
in non-interactive mode.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 18 Dec 2006 3
User Commands zlogin(1)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWzoneu
Interface Stability Evolving
SEE ALSO
login(1), rsh(1), vi(1), su(1M), zoneadm(1M), zonecfg(1M),
attributes(5), zones(5)
NOTES
zlogin 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: 18 Dec 2006 4
|
