unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 mount_vxfs(1M)						      mount_vxfs(1M)




 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.




 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 mount_vxfs(1M)						      mount_vxfs(1M)




	   -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



 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 mount_vxfs(1M)						      mount_vxfs(1M)




			    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



 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 mount_vxfs(1M)						      mount_vxfs(1M)




			    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.




 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000






 mount_vxfs(1M)						      mount_vxfs(1M)




			    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.





 Hewlett-Packard Company	    - 5 -   HP-UX Release 11i: November 2000






 mount_vxfs(1M)						      mount_vxfs(1M)




	   -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




 Hewlett-Packard Company	    - 6 -   HP-UX Release 11i: November 2000






 mount_vxfs(1M)						      mount_vxfs(1M)




      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

 SEE ALSO
      fsadm_vxfs(1M), fsck_vxfs(1M), mkfs_vxfs(1M), mount(1M), mount(2),
      fsync(2), fstab(4), mnttab(4), quota(5), vxfsio(7).

 STANDARDS CONFORMANCE
      mount: SVID3

      umount: SVID3
































 Hewlett-Packard Company	    - 7 -   HP-UX Release 11i: November 2000