Проект OpenNet: MAN lumount (1) Команды и прикладные программы пользовательского уровня (FreeBSD и Linux)

Интерактивная система просмотра системных руководств (man-ов)

lumount (1)

>> lumount (1) ( Solaris man: Команды и прикладные программы пользовательского уровня )

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.