mount(8) CLIX mount(8)
NAME
mount, umount - Mounts and unmounts file systems
SYNOPSIS
/etc/mount
/etc/mount [-r] [-f fstype] special directory
/etc/mount [-r] -f NFS[,options] resource directory
/etc/mount [-r] -f CAFS[,odvol=name,options] special directory
/etc/mount -r -f CDFS[,option] special directory
/etc/mount [-r] [-c] -d resource directory
/etc/umount [-b] directory
/etc/umount [-b] -d device
FLAGS
-b Executes umount in the background.
-B Enables blocking on no drive available or on a volume "buried"
by the other side being mounted. Using this flag causes the
mount to sleep while waiting for either the drive or the
volume to become available. Default behavior is to error off
and let the user or application try at will.
-c Disables RFS client caching of file system reads and writes on
resource.
-d When used with mount, mounts a remote resource on directory.
To mount a remote resource, Remote File Sharing (RFS) must be
running, and the resource must be advertised by a remote
system (see rfstart(8) and adv(8)).
When used with umount, unmounts using device name device
rather than a resource's name as listed in /etc/mnttab.
-f fstype Defines the file system type to be mounted as fstype. If the
argument is omitted, the command defaults to the root fstype.
If fstype is Network File System (NFS), cache file system
(CAFS), or CD/ROM file system (CDFS), options may be added
after the fstype, separated by commas. The available NFS
options are as follows:
soft If the server does not respond, this option times
2/94 - Intergraph Corporation 1
mount(8) CLIX mount(8)
out the client, and returns an error to any
locally issued NFS command that was waiting on the
remote file system.
nosuid Ignores setuid and setgid bits during exec.
bg Executes this mount in the background. This is
recommended for automatic mounts done during
system startup.
rsize=n Sets the read buffer size to n bytes.
wsize=n Sets the write buffer size to n bytes.
timeo=n Sets the initial NFS time-out to n tenths of a
second.
retrans=n Sets the number of NFS retransmissions to n.
port=n Sets the server IP port number to n.
special Indicates the block special device to be mounted
on directory. If fstype is NFS, special should
have the form hostname:/pathname.
resource Indicates the remote resource name to be mounted
on a directory.
directory Indicates the directory mount point for special or
resource. (The directory must exist.)
The available CAFS options are as follows:
odvol= Indicates the optical disk volume name.
subfs= Indicates the subordinate file system's file system
type.
par= Indicates the partition ID for multiple-partition
media.
bg Executes this mount in the background. This is
recommended for automatic mounts done during system
startup.
lf Indicates that the first read or write request for
each pre-existing file under this mount point will
cause an asynchronous load of the entire file into
the cache. Each subsequent read or write request
will be loaded synchronously, if it has not already
been satisfied by the asynchronous load process.
2 Intergraph Corporation - 2/94
mount(8) CLIX mount(8)
lfs Indicates that the first read or write request for
each pre-existing file under this mount point will
cause a synchronous load of the entire file into the
cache. The requesting process waits for the entire
file to be loaded before the first request
completes. All future requests for this file can be
satisfied from the cache.
The available CDFS options are as follows:
lowercase Provides an alternate display format for files on
ISO 9660 format CD/ROM media. Filenames are
displayed in lowercase, with no version number
extension (for example, file.ext instead of
FILE.EXT;1).
notraildot Similar to the lowercase option, for example
filenames are displayed in lowercase with no
version number and additionally with no trailing
dot (for example, ilename instead of filename.).
If the file system is on an optical volume in a jukebox, the
file system option odvol= is required. If the file system is
a CAFS subordinate jukebox mount, a special of /dev/dsk/cache
is required. Jukebox mounts other than CAFS must use a
special of /dev/dsk/@.
The optical disk volume specified by odvol= will be loaded
into an optical disk drive, and the wildcard character @ will
be replaced to reflect the drive that was selected. The
resulting special must exist.
-r Mounts special or resource as read-only. If special or
resource is write-protected, this flag must be used.
-R Specifies the number of attempts to contact a server for NFS
mounts.
DESCRIPTION
The mount command makes a file system available to users. The umount
command makes a file system unavailable to users.
The umount command announces to the system that the file system previously
mounted special or resource is to be unavailable. If invoked with an
incomplete argument list, umount searches /etc/fstab for the missing
arguments. The mount command can be used by any user to list mounted file
systems and resources.
File systems other than root are removable in the sense that they can be
available or unavailable to users. The mount command announces to the
2/94 - Intergraph Corporation 3
mount(8) CLIX mount(8)
system that special, a block special device, or resource, a remote
resource, is available to users from the mount point directory. The
directory parameter must exist; it becomes the name of the root of the
newly-mounted special or resource.
When entered with arguments, mount adds an entry to the table of mounted
devices, /etc/mnttab. The umount command removes the entry. If invoked
with no arguments, mount displays the entire mount table. If invoked with
an incomplete argument list, mount searches /etc/fstab for the missing
arguments.
EXAMPLES
1. To mount s0u0p7.4 as /usr2, enter the following /etc/mount command:
/etc/mount /dev/dsk/s0u0p7.4 /usr2
2. To use NFS to soft-mount the /usr/ip32/sysvdoc file system on the
remote machine doc as /usr/ip32/sysvdoc on the local machine, enter
the following /etc/mount command:
/etc/mount -r -f NFS,soft doc:/usr/ip32/sysvdoc /usr/ip32/sysvdoc
3. You can also perform NFS mounts using entries in your /etc/fstab file,
as shown in the following generic example:
remotenode:/path /localpath NFS soft,timeo=20
4. To have the erasable optical volume project_x loaded into a disk drive
and the file system on partition 7.4 mounted as /jukebox/project_x,
enter the following /etc/mount command:
/etc/mount -f FFS,odvol=project_x,par=7.4 /dev/dsk/@ /jukebox/project_x
5. To have the WORM optical volume project_x loaded into a disk drive and
the file system mounted as /jukebox/project_x, enter the following
/etc/mount command:
/etc/mount -f ODFS,odvol=project_x /dev/dsk/@ /jukebox/project_x
6. To mount the cache root as /project_root, enter the following
/etc/mount command:
/etc/mount -f CAFS /dev/dsk/cache /project_root
4 Intergraph Corporation - 2/94
mount(8) CLIX mount(8)
7. To have the optical volume project_x loaded under cache control as a
subordinate file system that will load an entire file into the cache
asynchronously and have the mount be a background mount, enter the
following /etc/mount command:
/etc/mount -f CAFS,odvol=project_x,subfs=FFS,par=7.4,lf,bg \
/dev/dsk/cache /project_root/project_x
8. To mount a CD/ROM disc as CDFS with lowercase filename display, enter
the following /etc/mount command:
/etc/mount -r -f CDFS,lowercase /dev/dsk/cdrom /cdfs
9. To mount a CD/ROM disc as /cdfs with the alternate format of file
display with no trailing dots, filename display, enter the following
/etc/mount command:
/etc/mount -r -f CDFS,notraildot /dev/dsk/cdrom /cdfs
FILES
/etc/mnttab Mount table.
/etc/fstab File system table.
NOTES
The mount and umount commands require superuser privileges.
An NFS file system can be hard-mounted (the default) or soft-mounted.
When an NFS file system is hard-mounted, any command issued on the client
system that affects the mounted file system continues to try until the
command completes. When an NFS file system is soft-mounted, the client
system times out if the remote system does not respond, and an error is
returned to any locally issued NFS command that was waiting on a response
from the remote system. If the remote system goes down, a hard-mounted
client may hang until the remote system comes back up, while a soft-
mounted client will time out. In both cases, the mount is automatically
re-established when the remote system comes back up.
CAFS subordinate file system mount points must be located under the CAFS
root mount point. Subordinate file system mount points will be created
and removed by the system during mount and umount procedures.
CAUTIONS
Physically removing a mounted file system floppy disk from the disk drive
before issuing the umount command damages the file system.
2/94 - Intergraph Corporation 5
mount(8) CLIX mount(8)
When an NFS file system is soft-mounted, data can be corrupted if an NFS
time-out occurs while working in the soft-mounted file system. Soft
mounting should be used when the availability of the NFS-mounted file
system is not critical, such as in read-only file systems.
Problems may occur if a file system or directory whose complete pathname
is longer than 32 characters is not mounted using /etc/fstab.
DIAGNOSTICS
If the mount function fails, mount displays an appropriate diagnostic.
The mount command issues a warning if the file system to be mounted is
currently mounted under another name. A remote resource mount will fail
if the resource is not available or if RFS is not running.
The umount command fails if special or resource is not mounted, or if it
is busy. Special or resource is busy if it contains an open file or some
user's working directory. In such a case, fuser can be used to list and
kill processes using special or resource.
EXIT VALUES
The mount command exits with 0 for success. If an error occurs, it exits
with a value of 100 for EBUSY, 128 for "JIMS volume conflict," 129 for "No
drives available," or 2 for other errors.
RELATED INFORMATION
Commands: mountd(8), nfsd(8), showmount(8), adv(8), fuser(8), rfstart(8),
setmnt(8), unadv(8)
Files: fstab(4), mnttab(4)
Functions: mount(2), umount(2)
6 Intergraph Corporation - 2/94