opensolaris man page for lumake

lumake(1M)                                                System Administration Commands                                                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 destroyed. 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 specified 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 conjunction 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 attributes:

       +-----------------------------+-----------------------------+
       |      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), lure-
       name(1M), lustatus(1M), luupgrade(1M), lutab(4), attributes(5), live_upgrade(5)

SunOS 5.10                                                          24 Jan 2002                                                         lumake(1M)