Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎

lumount


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/lumount


     /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 file systems 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.

     lumount and luumount also mount  or  unmount  all  installed
     non-global  zones  within the BE. For each running, mounted,
     or ready non-global zone in the current BE,  lumount  mounts
     all  file  systems in the mounted BE that belong to the non-
     global zone, at the specified mount point in the  non-global
     zone. This provides the non-global zone administrator access
     to the corresponding file systems that exist in the  mounted
     BE.

     When invoked with no arguments, lumount returns the  name(s)
     of the mounted BEs on a system.

     The lumount and luumount commands require root privileges or
     the Primary Administrator role.

OPTIONS
     The  lumount  and  luumount  commands  have  the   following
     options:

     -f                For luumount only, forcibly unmount a BE's
                       file   systems   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 specifying 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 completion 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.


     If you have installed non-global zones on your system,  this
     command  will also mount all non-global zones in second_disk
     inside their corresponding non-global zones in the currently
     running    system    at    the   mount   point   /test   (or
     /.alt.second_disk if a mount point was not specified).


     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
     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), zones(5)

NOTES

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

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










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments