Maintenance Commands                                  lumount(1M)

NAME
     lumount, luumount - mount or unmount all file systems  in  a
     boot environment

SYNOPSIS
     lumount [ -l  error_log  ]   [  -o  outfile  ]   BE_name   [
     mount_point ]

     luumount [ -l error_log ]  [ -o outfile ]  BE_name

DESCRIPTION
     The lumount and luumount commands are 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 lumount and luumount commands enable  you  to  mount  or
     unmount  all  of the filesystems in a boot environment (BE).
     This allows you to inspect or modify the files in a BE while
     that  BE  is not active. By default, lumount mounts the file
     systems on a mount point  of  the  form  /.alt.<num>,  where
     <num> is a random number.

     The lumount and luumount commands require root privileges.

OPTIONS
     The  lumount  and  luumount  commands  have  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.

OPERANDS
     BE_name
           Name of the BE whose file systems will be  mounted  or
           unmounted.  This  is  a BE on the current system other
           than the active BE. Note that, for successful  comple-
           tion  of an lumount or luumount command, the status of
           a BE must be complete, as  reported  by  lustatus(1M).
           Also,  none  of  the  BE's  disk slices can be mounted
           (through use of mount(1M)).

     mount_point
           For lumount only, a mount point to use instead of  the
           default  /.alt.<num>.  If  mount_point does not exist,
           lumount creates it.

SunOS 5.8           Last change: 22 Oct 2001                    1

Maintenance Commands                                  lumount(1M)

EXAMPLES
     Example 1: Specifying a Mount Point

     The following command creates  the  mount  point  /test  and
     mounts the file systems of the BE second_disk on /test.

     # lumount second_disk /test
     /test

     You can then cd  to  /test  to  view  the  file  systems  of
     second_disk.

     Example 2: Unmounting File Systems

     The following command unmounts the file systems  of  the  BE
     second_disk.  In  this  example, we cd to / to ensure we are
     not in any of the file systems in second_disk.

     # cd /
     # luumount second_disk
     #

EXIT STATUS
     The following exit values are returned:

     0     Successful completion.

     >0    An error occurred.

FILES
     /etc/lutab
           list of BEs on the system

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

SunOS 5.8           Last change: 22 Oct 2001                    2