fstab(4) fstab(4)NAME fstab - file system table SYNOPSIS #include <mntent.h> DESCRIPTION fstab contains the mount options you wish to have associated with A/UX file systems. The fstab file helps simplify administrative actions that involve groups of file systems. Selected commands read the specifications in fstab when they are entered with the -a option, which you may equate to the ``all in fstab'' option. By running the mount command along with the -a option, you cause all the currently unmounted file systems that have fstab entries to be mounted. Similarly, by running the swap command along with the -a option, you cause all the currently unrecognized swap areas that have fstab entries to be added to the swap space. (The default swap partition is established by disk partitioning utilities such as Apple HD SC Setup in A/UX. Similarly, file system partitions are established using resources other than fstab.) The fstab file is read by commands that mount, unmount, and check the consistency of file systems, as well as a command that configures swap areas beyond the default swap area. Because the startup file /etc/rc issues a mount -a command, each of the file systems specified in /etc/fstab are mounted automatically whenever A/UX enters multi-user mode. Exceptions include file systems described as type ignore, and file systems for which the mount option noauto has been specified. The /etc/fstab file can be modified with a text editor by the system administrator. This file consists of a number of lines in the following format: fs-device-file mountdir type option[,option]... freq passno For example: /dev/xy0a /mnt 5.2 rw,noquota 1 2 Fields are separated by space characters. A comment begins with a number sign (#) and ends with a newline character. Here is a description of each field: March 1993 1
fstab(4) fstab(4)fs-device-file Specifies the block device file for the mount command to mount at mountdir when the value of type is 4.2 or 5.2 and when the mount command is run along with the -a option. fs-device-file (when type is nfs) Specifies the name of a remote system and of a remote directory that it is serving so that the mount command can mount it locally when the value of type is nfs and when the mount command is run along with the -a option. In this case, this field is specified in the following format: server:/directory-path fs-device-file (when type is swap) Specifies a disk partition that the swap command can use to increase swap space when the value of type is swap and when the swap command is run along with its -a option (see swap(1M)). mountdir Specifies the directory where the files in the added-on file system shall appear. This field is ignored if type is specified as swap or ignore. To include a space as part of a filename or directory name in a path, precede it with a backslash (\). type Specifies the manner in which fs-device-file is to be used. Typically, you choose a value that describes the contents of a disk partition as a particular type of file system. Replace type with one of the following values: 4.2 Indicates a Berkeley Software Distribution (BSD) file system. 5.2 Indicates a System V file system (SVFS). ignore Indicates that the entry should be ignored. This value is useful for documenting the mount options for disk partitions that are not currently in use. nfs Indicates that the file system does not reside on a disk drive connected to the local system, but is on a remote computer that is set up to act as an 2 March 1993
fstab(4) fstab(4)NFS server. swap Indicates that the disk partition is intended to be used as storage space for processes as they are swapped to and from main memory. option[,option]... Specify the mount modes that shall apply to a newly mounted file system if the value of type is 4.2, 5.2, or nfs. In this case, you may specify one or more of the following options: cats Enables the Macintosh Toolbox to scan this file system as part of its background processing, improving the speed of the file searches from the Macintosh environment. This is the default for file systems types other than nfs. nocats Prevents the Macintosh Toolbox from scanning this file system as part of background processing. This is the default for file systems of type nfs. ro Specifies read-only. rw Specifies read and write. quota Specifies that disk-usage limits should be enforced. noquota Specifies that disk-usage limits should not be enforced. noauto Causes the mount command to ignore this entry when used along with the -a command option. This option allows the definition of fstab entries for file systems that you do not want mounted automatically. nosuid Does not honor set-user-ID execution mode for files with this permission. option[,option]... (when type is nfs) Specify the mount modes that shall apply to a remote file system. In this case, you may specify one or more of the following options: March 1993 3
fstab(4) fstab(4)bg Causes mount to retry mounting this file system in the background whenever a mount operation fails. fg Causes mount to retry mounting this file system in the foreground whenever a mount operation fails. The effect is that mount takes longer to return control to a shell if the file system cannot be mounted. hard Disallows the reporting of errors and abandonment of file operations if the server is unresponsive. intr Allows keyboard interrupts to stop a process that would otherwise loop forever while waiting for a response from a file system that is mounted with the hard option. port=n Sets the NFS Internet Protocol (IP) port number to n, which must match the parameter setting for the host's file system that you wish to mount. retrans=n Sets the number of retransmissions to n. retry=n Sets the number of mount attempts to n. rsize=n Sets the size of the read buffer to n bytes. soft Allows the reporting of errors and the abandonment of file operations if the server is unresponsive. Data corruption is more of a possibility when this mode of file access is allowed. timeo=n Sets the timeout to n tenths of a second. wsize=n Sets the size of the write buffer to n bytes. freq Specifies a value that helps indicate which file systems need to be backed up. It is used in conjunction with certain forms of the dump.bsd command. This field is ignored if type is specified as swap or ignore. passno Specifies a threshold that is used by fsck to help select which file systems to check. For example, fsck -p2 checks all of the file systems listed in /etc/fstab 4 March 1993
fstab(4) fstab(4)with passno values greater than or equal to 2. This field is ignored if type is specified as swap or ignore. The /etc/fstab file is only read by system-managing programs and never written by them; you as the system administrator have control over its contents (see also fsentry(1M)). The order of records in /etc/fstab is important because fsck, mount, and umount process the file sequentially; file systems are mountable only if their associated mount-point directories have already been mounted. The routine getmntent provides access to the values in the fstab file (see getmntent(3)). It returns a structure of the following form: struct mntent { char *mnt_fsname; /* file system name */ char *mnt_dir; /* file system path prefix */ char *mnt_type; /* 4.2, 5.2, nfs, swap, or ignore */ char *mnt_opts; /* rw, ro, noquota, quota, noauto, hard, soft */ int mnt_freq; /* dump frequency, in days */ int mnt_passno; /* pass # on parallel fsck */ }; FILES /etc/catsearchd Executable daemon that prescans file systems (see cats option) /etc/fstab File describing the file system and swapping partitions SEE ALSO getmntent(3), dump.bsd(4) fsck(1M), mount(1M), swap(1M) in A/UX System Administrator's Reference March 1993 5