lumount(1M)




NAME

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


SYNOPSIS

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

     /usr/sbin/luumount [-f] { [-n] BE_name |  [-m] mount_point |
     block_device}  [-l error_log] [-o outfile] [-X]


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.BE_name,  where
     BE_name  is  the name of the BE whose file systems are being
     mounted. See NOTES.

     The lumount and luumount commands require root privileges.


OPTIONS

     The  lumount  and  luumount  commands  have  the   following
     options:

     -f    For luumount only, forcibly unmount a BE's  file  sys-
           tems   after  attempting  (and  failing)  an  unforced
           unmount. This option is analogous to the umount(1M) -f
           option.

     -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
           luumount unmounts the file systems of the BE that owns
           mount_point.  See  description  of  mount_point  under
           OPERANDS, below. The use of -m is optional when speci-
           fying a mount point for luumount.

     -n BE_name
           Name of the BE whose file systems will  be  unmounted.
           See  description of BE_name under OPERANDS, below. The
           use of -n is optional when specifying a  BE  name  for
           luumount.

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

     For luumount, if you supply an argument and specify  neither
     -m nor -n, the command determines whether your argument is a
     BE name, a mount point, or a block device. If it is  one  of
     these  three  and  the argument is associated with a BE that
     has mounted file systems, luumount unmounts the file systems
     of that BE. Otherwise, luumount returns an error.


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, a mount  point  to  use  instead  of  the
           default  /.alt.BE_name. If mount_point does not exist,
           lumount creates it. For luumount,  the  BE  associated
           with mount_point will have its file systems unmounted.
           Note  that  default  mount  points  are  automatically
           deleted  upon  unmounting  with luumount. Mount points
           that you specify are not deleted.

     block_device
           For luumount only, block_device is the root slice of a
           BE,  such  as /dev/dsk/c0t4d0s0. luumount unmounts the
           file systems of the BE associated with block_device.


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.  If you did not specify /test as a mount point,
     lumount  would  create   a   default   mount   point   named
     /.alt.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
     #

     If /dev/dsk/c0t4d0s0 were the root  slice  for  second_disk,
     you could enter the following command to match the effect of
     the preceding command.

     # cd /
     # luumount /dev/dsk/c0t4d0s0
     #


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


NOTES

     If a BE name contains slashes (/),  lumount  replaces  those
     slashes  with  colons  in  a  default  mount point name. For
     example:

     # lumount 'first/disk'
     /.alt.first:disk


Man(1) output converted with man2html