Print this page
5700 add zlogin -d option to allow graceful disconnect when zone is halted
Reviewed by: Andrew Gabriel <illumos@cucumber.demon.co.uk>
Reviewed by: Jerry Jelinek <jerry.jelinek@joyent.com>
   1 ZLOGIN(1)                        User Commands                       ZLOGIN(1)
   2 
   3 
   4 
   5 NAME
   6        zlogin - enter a zone
   7 
   8 SYNOPSIS
   9        zlogin [-CEQ] [-e c] [-l username] zonename
  10 
  11 
  12        zlogin [-nEQS] [-e c] [-l username] zonename utility
  13             [argument]...
  14 
  15 
  16 DESCRIPTION
  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 
  21 
  22        zlogin operates in one of three modes:
  23 
  24        Interactive Mode
  25                                If no utility argument is given and the stdin
  26                                file descriptor for the zlogin process is a tty
  27                                device, zlogin operates in interactive mode. In
  28                                this mode, zlogin creates a new pseudo terminal
  29                                for use within the login session. Programs


  47                                interpreted by a shell running in the non-global
  48                                zone. See rsh(1).
  49 
  50 
  51        Console Mode
  52                                If the -C option is specified, the user is
  53                                connected to the zone console device and zlogin
  54                                operates in console mode. The zone console is
  55                                available once the zone is in the installed
  56                                state. Connections to the console are
  57                                persistent across reboot of the zone.
  58 
  59 
  60 OPTIONS
  61        The following options are supported:
  62 
  63        -C
  64                       Connects to the zone console.
  65 
  66 





  67        -e c
  68                       Specifies a different escape character, c, for the key
  69                       sequence used to access extended functions and to
  70                       disconnect from the login. The default escape character
  71                       is the tilde (~).
  72 
  73 
  74        -E
  75                       Disables the ability to access extended functions or to
  76                       disconnect from the login by using the escape sequence
  77                       character.
  78 
  79 
  80        -l username
  81                       Specifies a different username for the zone login. If
  82                       you do not use this option, the zone username used is
  83                       "root". This option is invalid if the -C option is
  84                       specified.
  85 
  86 


 173 
 174 
 175 
 176        +--------------------+-----------------+
 177        |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
 178        +--------------------+-----------------+
 179        |Interface Stability | Evolving        |
 180        +--------------------+-----------------+
 181 
 182 SEE ALSO
 183        login(1), rsh(1), vi(1), su(1M), zoneadm(1M), zonecfg(1M),
 184        attributes(5), zones(5)
 185 
 186 NOTES
 187        zlogin fails if its open files or any portion of its address space
 188        corresponds to an NFS file. This includes the executable itself or the
 189        shared libraries.
 190 
 191 
 192 
 193                                January 22, 2014                      ZLOGIN(1)
   1 ZLOGIN(1)                        User Commands                       ZLOGIN(1)
   2 
   3 
   4 
   5 NAME
   6        zlogin - enter a zone
   7 
   8 SYNOPSIS
   9        zlogin [-dCEQ] [-e c] [-l username] zonename
  10 
  11 
  12        zlogin [-nEQS] [-e c] [-l username] zonename utility
  13             [argument]...
  14 
  15 
  16 DESCRIPTION
  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 
  21 
  22        zlogin operates in one of three modes:
  23 
  24        Interactive Mode
  25                                If no utility argument is given and the stdin
  26                                file descriptor for the zlogin process is a tty
  27                                device, zlogin operates in interactive mode. In
  28                                this mode, zlogin creates a new pseudo terminal
  29                                for use within the login session. Programs


  47                                interpreted by a shell running in the non-global
  48                                zone. See rsh(1).
  49 
  50 
  51        Console Mode
  52                                If the -C option is specified, the user is
  53                                connected to the zone console device and zlogin
  54                                operates in console mode. The zone console is
  55                                available once the zone is in the installed
  56                                state. Connections to the console are
  57                                persistent across reboot of the zone.
  58 
  59 
  60 OPTIONS
  61        The following options are supported:
  62 
  63        -C
  64                       Connects to the zone console.
  65 
  66 
  67        -d
  68                       Disconnect from the console when the zone halts. This
  69                       option may only be used if the -C option is specified.
  70 
  71 
  72        -e c
  73                       Specifies a different escape character, c, for the key
  74                       sequence used to access extended functions and to
  75                       disconnect from the login. The default escape character
  76                       is the tilde (~).
  77 
  78 
  79        -E
  80                       Disables the ability to access extended functions or to
  81                       disconnect from the login by using the escape sequence
  82                       character.
  83 
  84 
  85        -l username
  86                       Specifies a different username for the zone login. If
  87                       you do not use this option, the zone username used is
  88                       "root". This option is invalid if the -C option is
  89                       specified.
  90 
  91 


 178 
 179 
 180 
 181        +--------------------+-----------------+
 182        |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
 183        +--------------------+-----------------+
 184        |Interface Stability | Evolving        |
 185        +--------------------+-----------------+
 186 
 187 SEE ALSO
 188        login(1), rsh(1), vi(1), su(1M), zoneadm(1M), zonecfg(1M),
 189        attributes(5), zones(5)
 190 
 191 NOTES
 192        zlogin fails if its open files or any portion of its address space
 193        corresponds to an NFS file. This includes the executable itself or the
 194        shared libraries.
 195 
 196 
 197 
 198                                 March 17, 2015                       ZLOGIN(1)