lucurr(1M)

NAME

     lucurr - display the name of the active boot environment

SYNOPSIS

     /usr/sbin/lucurr   [-l error_log]   [-m   mount_point]    [-
     o outfile] [-X]

DESCRIPTION

     The lucurr 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 lucurr command displays the name of the  currently  run-
     ning  boot environment (BE). If no BEs are configured on the
     system, lucurr displays the message  "No  Boot  Environments
     are  defined". Note that lucurr reports only the name of the
     current BE, not the BE that will be  active  upon  the  next
     reboot. Use lustatus(1M) or luactivate(1M) for this informa-
     tion.

     The lucurr command requires root privileges.

OPTIONS

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

     -m mount_point
           Returns the name of  the  BE  that  owns  mount_point,
           where  mount_point  is  the mount point of a BE's root
           file system. This can be a mount point of the  current
           BE  or  the mount point of a BE other than the current
           BE. If the latter, the file system of the BE must have
           been  mounted  with  lumount(1M)  or  mount(1M) before
           entering this option.

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

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),    ludelete(1M),   ludesc(1M),   lufslist(1M),
     lumake(1M),   lumount(1M),    lurename(1M),    lustatus(1M),
     luupgrade(1M), lutab(4), attributes(5), live_upgrade(5)