ZLOGIN(1) User Commands ZLOGIN(1)

NAME


zlogin - enter a zone

SYNOPSIS


zlogin [-dCEINQ] [-e c] [-l username] zonename


zlogin [-inEQS] [-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 four modes:

Interactive Mode
If no utility argument is given or if the -i
option is specified, and the stdin file
descriptor for the zlogin process is a tty
device, zlogin 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 and the -i option is
not 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(8)
in order to set up the user's environment and to
provide 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 console 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.


Standalone-processs Interactive Mode
If the -I option is specified the user is
connected to the zone's stdin, stdout and stderr
zfd(7D) devices.


OPTIONS


The following options are supported:

-C
Connects to the zone console.


-d
Disconnect from the console when the zone halts. This
option may only be used if the -C option is specified.


-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 functions or to
disconnect from the login by using the escape sequence
character.


-i
Forces interactive mode when a utility argument is
specified.


-I
Connects to the zone's zfd(7D) devices.


-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.


-n
Redirect the input of zlogin to /dev/null. This option is
useful when the command running in the local zone and the
shell which invokes zlogin both read from standard input.


-N
Nohup. This may only be used with the -I option to avoid
sending EOF to the zfd device when zlogin's stdin receives
EOF. It can also be toggled by sending SIGUSR1 to an
attached zlogin process.


-Q
Specifies quiet mode operation. In quiet mode, extra
messages indicating the the function of zlogin will not be
displayed, giving the possibility to present the
appearance that the command is running locally rather than
in another zone.


-S
"Safe" login mode. zlogin does minimal processing and does
not invoke login(1) or su(8). 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.


SECURITY


Once a process has been placed in a zone other than the global 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(8) if operating in non-
interactive mode.


ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+

SEE ALSO


login(1), rsh(1), vi(1), attributes(7), zones(7), su(8), zoneadm(8),
zonecfg(8)

NOTES


zlogin fails if its open files or any portion of its address space
corresponds to an NFS file. This includes the executable itself or the
shared libraries.

March 30, 2015 ZLOGIN(1)