chkqnx6fs

Check an entire Power-Safe filesystem for consistency (QNX Neutrino)

---

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

---

Syntax:

chkqnx6fs [-sv] host

Runs on:

Neutrino

Options:

-s

Display header information from the superblock. The number of -v options controls which fields chkqnx6fs displays.

---

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 performs a consistency check on a Power-Safe (fs-qnx6) filesystem. The check is conducted in these passes:

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

Only a stable filesystem can be checked (i.e. one that isn't going to change or be updated during the scan). A stable filesystem is one of the following:

• unmounted
• mounted read-only
• mounted read-write with snapshots disabled (in which case the stable filesystem, not the working copy, is checked)

---

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:

^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).

See also:

chkdosfs, chkfsys, fs-qnx6.so, mkqnx6fs

Backing Up and Recovering Data in the Neutrino User's Guide

“Power-Safe filesystem” in the Filesystems chapter of the System Architecture guide

“Power-Safe filesystem” in the Filesystems chapter of the Neutrino User's Guide