lumake(1M)

NAME

     lumake - populate a boot environment

SYNOPSIS

     /usr/sbin/lumake [-l error_log] [-o outfile] [-s  source_BE]
     -n BE_name [-X]

     /usr/sbin/lumake  [-l error_log]  -t time  [-o outfile]  [-s
     source_BE] -n BE_name [-m email_address] [-X]

DESCRIPTION

     The lumake 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 lumake command populates (that is, copies files to)  the
     file systems of a specified boot environment (BE) by copying
     files from the corresponding file systems of the active or a
     source  (-s) BE. Any existing data on the target BE are des-
     troyed. All file systems on the target BE are re-created.

     The target BE must already exist. Use lucreate(1M) to create
     a new BE.

     The lumake command requires root privileges.

OPTIONS

     The lumake command has the following options:

     -n BE_name
           Name of the BE to be populated.

     -s source_BE
           The optional name of a source BE.  If  you  omit  this
           option, lumake uses the current BE as the source. A BE
           must have the status "complete" before  you  can  copy
           from it. Use lustatus(1M) to determine a BE's status.

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

     -t time
           Setup a batch job to populate the specified  BE  at  a
           specified time. The time is given in the format speci-
           fied by the at(1) man page. At any time, you can  have
           only one Live Upgrade operation scheduled. You can use
           lucancel(1M) to cancel a scheduled lumake operation.

     -m email_address
           Allows you to  email  lumake  output  to  a  specified
           address  upon command completion. There is no checking
           of email_address. You can use this option only in con-
           junction with -t.

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