chkqnx6fs

Note: You must be logged in as root to run this utility.

Syntax:

chkqnx6fs [-fpsv] [-S block_number] host

Runs on:

QNX Neutrino

Options:

-f: Fix the filesystem unconditionally. The default is to check only.
-p: Proceed even if one superblock is damaged. This option lets chkqnx6fs repair a corrupted superblock.
-S block_number: Force the display of superblock 0 or 1 (implies -s and -vv).
-s: Display header information from the superblock. The number of -v options controls which fields chkqnx6fs displays.
Note: If you specify -s, chkqnx6fs locates and verifies the active superblock, but doesn't check the filesystem itself.
-v: Increase output verbosity. You can specify multiple -v options.
host: The host of the filesystem. You can specify this as a block-special device or partition (e.g., /dev/hd0t76), as a regular file, or as the root directory of a mounted fs-qnx6 filesystem (which will be resolved to the real host device).

Description:

The chkqnx6fs utility performs a consistency check on a Power-Safe (fs-qnx6.so) filesystem. The check is conducted in these passes:

Locate and verify superblocks and select the newest stable one.
Traverse the system inodes and bitmap files.
Recursively walk the directory hierarchy from the root.

You should run chkqnx6fs only on an unmounted filesystem.

Note: You shouldn't actually need to use chkqnx6fs in a production system (e.g., in a boot script). The design of the fs-qnx6 filesystem should (in the absence of software bugs, physical bad blocks, or malicious data modification on the raw device) make any such check unnecessary.

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:

# chkqnx6fs -v /dev/hd0t76
** Prelude: read and verify superblocks **
** Pass 1 : verify bitmap and inodes **
** Pass 2 : verify directory hierarchy **
** Summary: 20216/8040524 blocks, 142/62816 inodes **

Exit status:

0: The filesystem is consistent/stable.
1: An error occurred checking the filesystem (descriptive messages are written to stderr).