CHECKLIST(4) — HP-UX

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 important because fsck(1M), mount(1M), and umount(2) 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) and swapon[HFS](1M) commands.

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

directory is the name of the root of the mounted file system that 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", the file system whose name is given in the block special file name field is mounted read-write or read-only on the specified directory by the command mount -a. If type is "sw", the special file name, which must be a block special file, is made available as a piece of swap space by the swapon[HFS](1M) command. The fields block special file name, directory, 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) and fsck(1M) commands.

pass number 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 is reserved for possible use by future backup utilities.

comment is an optional field that 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

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

For systems that support only the special file name field:

/dev/rdsk/0s0

For systems that support 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 name fields 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

Related Articles