lustatus(1M)						  System Administration Commands					      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(1M) 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 incomplete.

       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 attributes:

       +-----------------------------+-----------------------------+
       |      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)

SunOS 5.10							    23 Apr 2003 						      lustatus(1M)