ludelete(1M)

NAME

     ludelete - delete a boot environment

SYNOPSIS

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

DESCRIPTION

     The ludelete 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 ludelete command deletes all records associated  with  a
     boot  environment  (BE)  on all defined complete BEs. A com-
     plete  BE  is  one  that  is   not   participating   in   an
     lucreate(1M), luupgrade(1M), or lucompare(1M) operation. Use
     lustatus(1M) to determine a BE's status. You can delete nei-
     ther  the  current  BE,  nor the BE that will become current
     upon the next reboot. Also, you cannot delete a BE that  has
     file systems mounted with lumount(1M) or mount(1M).

     ludelete does not alter any files on the BE being deleted.

     The ludelete command requires root privileges.

OPTIONS

     The ludelete 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 to be deleted.

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