lustatus(1M)

NAME

     lustatus - display status of boot environments

SYNOPSIS

     /usr/sbin/lustatus [-l error_log] [-o outfile] [BE_name]  [-
     X]

DESCRIPTION

     The lustatus command is part of a  suite  of  commands  that
     make  up  the  Live Upgrade feature of the Solaris operating
     environment. See live_upgrade(5) for a  description  of  the
     Live Upgrade feature.

     The lustatus command displays the status information of  the
     boot  environment  (BE)  BE_name. If no BE is specified, the
     status information for all BEs on the system is displayed.

     The  headings  in  the  lustatus  information  display   are
     described as follows:

     Boot Environment Name
           Name of the BE.

     Is Complete
           Indicates whether a BE  is  able  to  be  booted.  Any
           current  activity  or  failure  in  an  lucreate()  or
           luupgrade(1M) operation causes a BE to be  incomplete.
           For  example,  if there is a copy operation proceeding
           on or scheduled for a BE, that BE is considered incom-
           plete.

     Active Now
           Indicates whether the  BE  is  currently  active.  The
           "active" BE is the one currently booted.

     Active On Reboot
           Indicates whether the  BE  becomes  active  upon  next
           reboot of the system.

     Can Delete
           Indicates that no copy, compare, or upgrade operations
           are  being  performed on a BE. Also, none of that BE's
           file systems are currently mounted. With all of  these
           conditions in place, the BE can be deleted.

     Copy Status
           Indicates whether the creation or repopulation of a BE
           is  scheduled  or  active  (that  is,  in progress). A
           status  of  ACTIVE,  COMPARING  (from  lucompare(1M)),
           UPGRADING,  or  SCHEDULED prevents you performing Live
           Upgrade copy, rename, or upgrade operations.

     The following is an example lustatus display:

     Boot Environment     Is       Active Active    Can    Copy
     Name                 Complete Now    On Reboot Delete Status
     -------------------- -------- ------ --------- ------ ----------
     disk_a_S7            yes      yes    yes       no     -
     disk_b_S7db          yes      no     no        no     UPGRADING
     disk_b_S8            no       no     no        no     -
     S9testbed            yes      no     no        yes    -

     Note that you could not perform  copy,  rename,  or  upgrade
     operations  on disk_b_S8, because it is not complete, nor on
     disk_b_S7db, because a Live Upgrade operation is pending.

     The lustatus command requires root privileges.

OPTIONS

     The lustatus command has the following options:

     -l error_log
           Error and status messages are sent  to  error_log,  in
           addition  to  where  they  are  sent  in  your current
           environment.

     -o outfile
           All command output is sent to outfile, in addition  to
           where it is sent in your current environment.

     -X    Enable XML output. Characteristics of XML are  defined
           in  DTD,  in  /usr/share/lib/xml/dtd/lu_cli.dtd.<num>,
           where <num> is the version number of the DTD file.

OPERANDS

     BE_name
           Name of the BE for which to obtain status. If  BE_name
           is  omitted,  lustatus  displays status for all BEs in
           the system.

EXIT STATUS

     The following exit values are returned:

     0     Successful completion.

     >0    An error occurred.

FILES

     /etc/lutab
           list of BEs on the system

     /usr/share/lib/xml/dtd/lu_cli.dtd.<num>
           Live Upgrade DTD (see -X option)

ATTRIBUTES

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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWluu                     |
    |_____________________________|_____________________________|

SEE ALSO

     lu(1M),   luactivate(1M),    lucancel(1M),    lucompare(1M),
     lucreate(1M),    lucurr(1M),    ludesc(1M),    ludelete(1M),
     lufslist(1M),   lumake(1M),    lumount(1M),    lurename(1M),
     luupgrade(1M), lutab(4), attributes(5), live_upgrade(5)