CHECKLIST(4)

NAME

checklist − static information about the file systems

SYNOPSIS

#include <checklist.h>

DESCRIPTION

Checklist is an ASCII file that resides in the directory /etc. It is only read by programs, and not written; it is the duty of the system administrator to properly create and maintain this file. The file /etc/checklist contains a list of mountable file system entries. The fields within each entry of a file system are separated by one or more blanks. Each file system entry is contained on a separate line. The order of entries in /etc/checklist is only important for entries without a pass number field. Entries without a pass number will be sequentially checked by fsck(1M) after the entries with a pass number have been checked.

Each file system entry must contain a special file name and may additionally contain all of the following fields, in order:

directory
type
options
backup frequency
pass number (on parallel fsck)
comment

The entries from this file are accessed using the routines in getmntent(3X).

The fields are separated by white space, and a # as the first non-white character indicates a comment.

special file name is a block special file name. This field is used by the fsck(1M), mount(1M) and swapon(1M) and other commands.

directory is the name of the root of the mounted file system that corresponds to the special file name. If type is swapfs, directory can be the name of any directory within a file system. Only one directory should be specified per file system. directory must already exist and must be given as an absolute path name.

type can be hfs, cdfs, nfs, swap, swapfs or ignore. If type is hfs, a local HFS file system is implied. If type is cdfs, a local CD-ROM file system is implied. If type is nfs, a remote NFS file system is implied. (See NETWORKING FEATURES below.) If the type is swap, the special file name, is made available as a piece of swap space by the swapon(1M) command. The fields directory, options, pass number, and backup frequency are ignored for swap entries. If the type is swapfs , the file system which directory resides in is made available as swap space by the swapon(1M) command. The options field is valid. The fields special file name, pass number, and backup frequency are ignored for swapfs entries. Entries marked by the type ignore are ignored by all commands and can be used to mark unused sections. If type is specified as either ignore , swap , or swapfs, the entry is ignored by the mount(1M) and fsck(1M) commands. Fsck will also ignore entries with type specified as cdfs or nfs.

options appear in this entry as a comma-separated list of option keywords as found in mount(1M). mount(1M) or swapon(1M). Which keywords are used depends on the parameter specified in type.

backup frequency is reserved for possible use by future backup utilities.

pass number is used by the fsck(1M) command to determine the order in which file system checks are done. The root file system should be specified with a pass number of 1, and other file systems should have larger numbers. File systems within a drive should have distinct numbers, but file systems on different drives can be checked on the same pass to utilize possible parallelism available in the hardware. A file system with a pass number of zero will be ignored by the fsck(1M) command. If a pass number is not present, fsck will check each such file system sequentially after all eligible file systems with pass numbers have been checked.

comment is an optional field that starts with a pound sign (#) and ends with a newline. Space from the pass number up to the comment field, if present, or the newline is reserved for future use.

There is no limit to the number of special file name fields in /etc/checklist.

NETWORKING FEATURES

NFS

If the field type is nfs, a remote NFS file system is implied. For NFS file systems, the special file name should be the serving machine name followed by ":" followed by the path on the serving machine of the directory to be served. The fields pass number, and backup frequency are ignored for NFS entries.

EXAMPLES

Examples of entries specified in /etc/checklist:

To add an additional file system:

/dev/dsk/c0d1s0 /users hfs defaults 1 0 # /users disk

To add a swap device:

/dev/dsk/c0d1s0 / swap defaults 1 0 # swap device

To add file system swap space:

default /swap swapfs min=10,lim=4500,res=100,pri=0 0 0

(Note that both a file system entry and a swap entry are required for devices providing both services.)

DEPENDENCIES

NFS

EXAMPLES
For systems that support NFS file systems:

server:/mnt /mnt nfs rw,hard 0 0 #mount from server.

AUTHOR

Checklist was developed by HP, AT&T Bell Laboratories, Sun Microsystems, Inc. and the University of California, Berkeley.

Museum

Related Articles