CHECKLIST(4) — HP-UX

NAME

checklist − static information about the file systems

SYNOPSIS

#include <checklist.h>

DESCRIPTION

Checklist is an ASCII file and resides in 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. /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 important because fsck, mount, and umount sequentially iterate through /etc/checklist.

Each file system entry must contain a special file name and may additionally contain all of the following fields, in order:
     block special file name
     directory
     type
     pass number on parallel fsck
     backup frequency
     comment

These additional fields are ignored in an HP-UX system if the set of system administration tools implemented on that system does not support them:

special file name is either a character or block special file name. This field is used by the fsck(1M) command.

block special file name is used by the mount(1M) and other commands.

directory is the name of the root of the mounted file system which corresponds to the block special file name. The directory must already exist and must be given as an absolute path name.

type can be "rw", "ro", "sw" or "xx". If type is "rw" or "ro" then the file system whose name is given in the block special file field is mounted read-write or read-only on the specified directory by mount -a. If type is "sw" then the special file name is made available as a piece of swap space by the swapon(1M) command. The fields pass number and backup frequency are ignored for "sw" entries. Entries marked "xx" are ignored by all commands and can be used to mark unused sections. If type is specified as either "xx" or "sw" the entry is ignored by the mount(1M) command.

pass number field is used by the fsck(1M) command to determine the order in which file system checks are done when using the -p option of fsck. 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.

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

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

Examples of file system entries specified in /etc/checklist:

For system which supports only special file name field:

/dev/rdsk/0s0

For system which supports multi−fields:

/dev/rdsk/0s0 /dev/dsk/0s0 / rw 1 0 #root disk

HARDWARE DEPENDENCIES

Series 200, 300, 800:
There is no limit to the number of special file names in /etc/checklist. However, the commands mount -a and umount -a give an error if the number of mountable file system entries in /etc/checklist exceeds NMOUNT.

AUTHOR

Checklist was developed by the Hewlett-Packard Company, AT&T Bell Laboratories, and the University of California, Berkeley California, Computer Science Division, Department of Electrical Engineering and Computer Science.

Museum