chkdosfs

Check a DOS (FAT-12/16/32) filesystem for consistency (QNX Neutrino)

Syntax:

chkdosfs [-cnpuy] [-x clean,fixed,unfixed] device | mountpoint | file

Runs on:

QNX Neutrino

Options:

-c: (QNX Neutrino 7.0 or later) Validate short and long filename characters.
-n: Answer “no” to all repair questions and prompts.
-p: Check and fix the filesystem non-interactively (i.e., “preen” mode).
-u: Perform unconditional check of the filesystem (regardless of the on-disk/dirty status).
-x clean,fixed,unfixed: (QNX Neutrino 7.0 or later) Override the default exit codes, which are 0, 0, and 1, respectively.
-y: Answer “yes” to all repair questions and prompts.
device: The device name hosting the DOS filesystem (e.g., /dev/hd0t6).
mountpoint: The mountpoint of the DOS filesystem (e.g., /fs/hd0-dos).
file: A regular file containing a DOS filesystem image.

Description:

The chkdosfs utility performs a consistency check on the specified DOS filesystem. This check consists of multiple passes over the filesystem.

If an error occurs, the action taken depends on the command-line options used. If -p was specified (typically to auto-check the filesystem at startup), no message is displayed and the default repair action is silently made. If either -n or -y was specified, a descriptive message is displayed and a “no” or “yes” response to the suggested action is automatically generated. Otherwise the user interactively decides on the repair action to make (the suggested default is indicated).

In order to perform repairs, chkdosfs requires write access to the device hosting the DOS filesystem. Normally, only root has permission for write access; if chkdosfs does not have such access, it will still check the filesystem but will operate as if the -n option had been specified.

By default, the chkdosfs utility checks an on-disk flag that's maintained by the filesystem that indicates to chkdosfs whether or not anything needs to be checked. This flag is usually updated when mounting or unmounting the filesystem. The -u option can be used to force the chkdosfs to run regardless of the state of this flag.

Summary of filesystem commands

The following table shows the shared objects and related commands for the filesystems:

Partition type	Filesystem	Shared object	Initialize with:	Check with:
1, 4, or 6	DOS	fs-dos.so	mkdosfs	chkdosfs
7	Windows NT^a	fs-nt.so	N/A	N/A
11, 12, or 14	FAT32	fs-dos.so	mkdosfs	chkdosfs
77, 78, or 79	QNX 4	N/A	N/A	N/A
131	Linux (Ext2)	fs-ext2.so	N/A	N/A
175	Apple Macintosh HFS or HFS Plus^a	fs-mac.so	N/A	N/A
177, 178, or 179	Power-Safe	fs-qnx6.so	mkqnx6fs	chkqnx6fs^b
185	QNX Trusted Disk	fs-qtd.so	mkqfs	N/A

^a Read-only.

^b Not usually necessary.

For more information, see the Filesystems chapter of the System Architecture guide.

Examples:

Check the filesystem on the DOS partition of a hard disk:

# chkdosfs /dev/hd0t11
Phase 1 - Read and compare FATs
Phase 2 - Check cluster chains
Phase 3 - Check directories
Phase 4 - Check for lost files

1476784 kb used, 1010088 kb free, 24932 files, 2921 directories
Filesystem is clean.

Exit status:

0: The filesystem was checked and either no errors were detected or all such errors were repaired.
1: The filesystem was not checked. This may be because the user interrupted the operation, a non-recoverable internal error such as insufficient memory occurred, or chkdosfs found an unrepairable error.

Contributing author:

Wolfgang Solfrank, Martin Husemann