Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference (Volume 3 of 9): Section 1M: System Administration Commands (A-M) > m

mount_vxfs(1M)

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

mount, umount — mount and unmount a VxFS file system

SYNOPSIS

/usr/sbin/mount [-l] [-v|-p]

/usr/sbin/mount [-F vxfs] [-eQ] -a

/usr/sbin/mount [-F vxfs] [-eQrV] [-o specific_options] {special|directory}

/usr/sbin/mount [-F vxfs] [-eQrV] [-o specific_options] special directory

/usr/sbin/umount [-V] [-v] {special | directory}

/usr/sbin/umount [-F vxfs] [-v] -a

DESCRIPTION

mount attaches special, a removable file system, to directory, a directory on the file tree. (This directory is also known as the mount point). directory, which must already exist, will become the name of the root of the newly mounted file system. If either special or directory is omitted, mount attempts to determine the missing value from an entry in /etc/fstab. mount can be invoked on any removable file system, except /. special and directory must be given as absolute path names.

If mount is invoked with no arguments it lists all the mounted file systems from the mounted file system table, /etc/mnttab.

The umount command unmounts mounted file systems.

Only the superuser can mount and umount file systems. Other users can use mount to list mounted file systems.

Options

mount recognizes the following options:

-a

Attempt to mount all file systems described in /etc/fstab. All optional fields in /etc/fstab must be included and supported. If -F vxfs is specified, all VxFS file systems in /etc/fstab are mounted. If noauto is specified in an entry's option list (in /etc/fstab), that entry is skipped (not mounted). File systems are not necessarily mounted in the order listed in /etc/fstab.

-e

Verbose mode. Write a message to the standard output indicating which file system is being mounted.

-F vxfs

Specify the file system type (vxfs).

-l

Limit actions to local file systems only.

-o specific_options

Specify options specific to the VxFS file system type. specific_options is a list of comma separated suboptions and/or keyword/attribute pairs intended for the VxFS-specific module of the command. Unlike some file system commands, multiple -o options do not accumulate; only the last option is used.

The following specific_options are valid on a VxFS file system:

blkclear

Clear all data extents before allocating them to a file (requires synchronous zeroing, on disk, of certain newly allocated extents). This prevents uninitialized data from being written to a file at the time of a system crash.

convosync=direct|dsync|unbuffered|closesync|delay

Alter the caching behavior of the file system for O_SYNC and O_DSYNC I/O operations.

The direct value handles any reads or writes with the O_SYNC or O_DSYNC flag as if the VX_DIRECT caching advisory is set.

The dsync value handles any writes with the O_SYNC flag as if the VX_DSYNC caching advisory is set. It does not modify behavior for writes with O_DSYNC set.

The unbuffered value handles any reads or writes with the O_SYNC or O_DSYNC flag as if the VX_UNBUFFERED caching advisory is set.

The closesync value delays O_SYNC or O_DSYNC writes so that they do not take effect immediately.

The closesync, dsync, direct, and unbuffered values all run the equivalent of an fsync(2) to be run when any file accessed with the O_SYNC or O_DSYNC flag is closed.

The delay value delays O_SYNC or O_DSYNC writes so that they do not take effect immediately. With this option, VxFS changes O_SYNC or O_DSYNC writes into delayed writes. No special action is performed when closing a file. This option effectively cancels data integrity guarantees normally provided by opening a file with O_SYNC or O_DSYNC.

NOTE: The convosync option is available only with the HP OnLineJFS product.

datainlog|nodatainlog

Generally, VxFS does O_SYNC or O_DSYNC writes by logging the data and the time change to the inode (datainlog). If the nodatainlog option is used, the logging of synchronous writes is disabled; O_SYNC writes the data into the file and updates the inode synchronously before returning to the user.

NOTE: The datainlog option is available only with the HP OnLineJFS product.

largefiles|nolargefiles

These options do not turn largefiles capability on and off (use mkfs_vxfs or fsadm_vxfs to set and clear the largefiles flag), but they do verify whether a file system is largefiles capable. If nolargefiles is specified and the mount succeeds, then the file system does not contain any files whose size is two gigabytes or larger, and such files cannot be created. If largefiles is specified and the mount succeeds, then the file system may contain files whose size is two gigabytes or larger, and large files can be created. For a mount to succeed, the option must match the largefiles flag as specified by mkfs_vxfs or fsadm_vxfs.

NOTE: Large files are supported on HP-UX 10.20 systems and above. Be careful when enabling large file system capability. System administration utilities such as backup may experience problems if they are not large-file aware.

log|delaylog|tmplog|nolog

Control intent logging. To maintain file system integrity after a system failure, logging must be enabled. The default is log. In log mode, file system structural changes are logged to disk before the system call returns to the application. If the system crashes, fsck_vxfs(1M) completes logged operations that did not complete.

In delaylog mode, some system calls return before the intent log is written. This improves the performance of the system, but some changes are not guaranteed until a short time later when the intent log is written. This mode approximates traditional UNIX system guarantees for correctness in case of system failures.

In tmplog mode, the intent log is almost always delayed. This improves performance, but recent changes may disappear if the system crashes. This mode is only recommended for temporary file systems.

nolog is an alias for tmplog.

mincache=direct|dsync|unbuffered|closesync|tmpcache

Alter the caching behavior of the file system.

The direct value handles any reads without the O_SYNC flag, or any writes without the O_SYNC flag, VX_DSYNC, VX_DIRECT, and VX_UNBUFFERED caching advisories, as if the VX_DIRECT caching advisory was set.

The dsync value handles any writes without the O_SYNC flag or one of the VX_DIRECT, VX_DSYNC, or VX_UNBUFFERED caching advisories as if the VX_DSYNC caching advisory was set.

The unbuffered value handles any reads without the O_SYNC flag, or any writes without the O_SYNC flag, VX_DSYNC, VX_DIRECT, and VX_UNBUFFERED caching advisories, as if the VX_UNBUFFERED caching advisory was set.

The closesync, dsync, unbuffered, and direct values all cause the equivalent of an fsync(2) to be run when the file is closed.

The tmpcache value disables delayed extending writes, trading off integrity for performance. When this option is chosen, VxFS does not zero out new extents allocated as files are sequentially written. Uninitialized data may appear in files being written at the time of a system crash. See vxfsio(7) for an explanation of VX_DIRECT, VX_DSYNC, and VX_UNBUFFERED.

NOTE: mincache=direct, mincache=dsync, mincache=unbuffered, and mincache=tmpcache are available only with the HP OnLineJFS product.

quota

Enable disk quotas (valid only for rw type file systems). VxFS maintains quota information in a private area of the file system. If the file system is mounted with quotas enabled, and the file system was previously mounted with quotas disabled and was modified, then the quota information is rebuilt. This may take a while.

remount

Change the mount options for a mounted file system. In particular, remount changes the logging and caching policies. It also changes a files system from read-only to read/write.

remount cannot change a file system from read/write to read-only, nor can it set the snapof or snapsize attributes.

rw|ro

Read/write or read-only. The default is rw.

snapof=filesystem

Mount the file system as a snapshot of filesystem, where filesystem is either the directory on which a VxFS file system is mounted, or is the block special file containing a mounted VxFS file system. An explicit -F vxfs option is required to mount a snapshot file system.

NOTE: snapof=filesystem is available only with the HP OnLineJFS product.

snapsize=size

Used in conjunction with snapof. size is the size in sectors of the snapshot file system being mounted. This option is required only when the device driver is incapable of determining the size of special, and defaults to the entire device if not specified.

NOTE: snapsize=size is available only with the HP OnLineJFS product.

suid|nosuid

setuid execution allowed or setuid execution not allowed. The default is suid.

-p

Report the list of mounted file systems in the /etc/fstab format.

-Q

Prevent display of error messages, resulting from an attempt to mount already mounted file systems.

-r

Mount the specified file system as read-only. Physically write-protected file systems must be mounted in this way or errors occur when access times are updated, whether or not any explicit write is attempted.

-v

Reports the regular output with file system type and flags, however, directory and special fields are reversed.

-V

Echo the completed command line, but do not execute the command. The command line is generated by incorporating the user-specified options and other information derived from /etc/fstab. This option allows the user to verify the command line.

umount recognizes the following options:

-a

Attempt to unmount all file systems described in /etc/mnttab. All optional fields in /etc/mnttab must be included and supported. If -F vxfs is specified, all VxFS file systems in /etc/mnttab are unmounted. File systems are not necessarily unmounted in the order listed in /etc/mnttab.

-F vxfs

Specify the file system type (vxfs).

-v

Verbose mode. Write a message to the standard output indicating which file system is being unmounted.

-V

Echo the completed command line, but do not execute the command. The command line is generated by incorporating the user-specified options and other information derived from /etc/fstab. This option allows the user to verify the command line.

EXAMPLES

List the file systems currently mounted:

mount

Mount a VxFS file system /dev/dsk/c1t2d0 at directory /home

mount -F vxfs /dev/dsk/c1t2d0 /home

Unmount the same file system:

umount /dev/dsk/c1t2d0

NOTES

Only a privileged user can mount file systems.

Large files (over two gigabytes) are supported on HP-UX 10.20 systems and above.

FILES

/etc/fstab

Static information about the file systems

/etc/mnttab

Mounted file system table

STANDARDS CONFORMANCE

mount: SVID3

umount: SVID3

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2000 Hewlett-Packard Development Company, L.P.