IPB
>  Man Pages > Unix > Solaris 10 11/06 > Section 1 > zlogin man page

zlogin man page

Section 1 - Solaris 10 11/06 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!





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  [argu-
     ment...]

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 termina-
         tion. In this mode, zlogin invokes su(1M)  in  order  to
         set  up  the  user's  environment and to provide a login
         environment.



     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.



OPTIONS




SunOS 5.10          Last change: 14 May 2004                    1






User Commands                                           zlogin(1)



     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
                     functions 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 dam-
                     aged 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 connec-
              tion with no warning to the zone's end.



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



SunOS 5.10          Last change: 14 May 2004                    2






User Commands                                           zlogin(1)



     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 operat-
              ing in non-interactive mode.



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:






SunOS 5.10          Last change: 14 May 2004                    3






User Commands                                           zlogin(1)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWzoneu                   |
    |_____________________________|_____________________________|
    | Interface Stability         | Evolving                    |
    |_____________________________|_____________________________|


SEE ALSO
     login(1), vi(1), su(1M),  zoneadm(1M),  zonecfg(1M),  attri-
     butes(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.10          Last change: 14 May 2004                    4





Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Wed Sep 12 11:25:43 GMT 2007

Your favourite pages:

No pages logged yet.
Trying to save cookie...

Top 10 most popular pages:

sqlite3 man page (5334 hits)
(openSUSE 10.2)

svn man page (5209 hits)
(FreeBSD 6.2)

adv_cap_autoneg man page (4870 hits)
(Solaris 10 11_06)

CPAN man page (4607 hits)
(Suse Linux 10.1)

ssh man page (4342 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (2884 hits)
(Solaris 10 11_06)

netcat man page (2717 hits)
(Suse Linux 10.1)

pprosetup man page (2492 hits)
(Solaris 10 11_06)

startproc man page (2471 hits)
(Suse Linux 10.1)

signal man page (2408 hits)
(Suse Linux 10.1)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: PYRENEES GOLF HOLIDAYS :: Prototype Assembly Service :: <Link Available>
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum