3.4.0 Matrix Server Command Reference

Chapter 1: PolyServe Matrix Server Commands 24

Check a filesystem

If a filesystem is not unmounted cleanly, the journal will be replayed the next

time the filesystem is mounted to restore consistency. You should seldom

need to check the filesystem. However, if a filesystem was corrupted by a

hardware or software failure, you can repair it with the psfscheck utility.

When psfscheck is running in default mode, it attempts to fix any corruptions

that can be fixed without using --rebuild-tree. The types of corruption that

can be fixed include bad pointers to data blocks, incorrect st_size and

st_blocks in a directory, directory entries pointing to nowhere, incorrect file

sizes and security descriptors, and objectid sharing.

NOTE: The psfscheck utility requires exclusive access to the device. If it

cannot obtain this access, it will forcibly dismount the volume.

The options for checking a filesystem are as follows:

--rebuild-tree

Rebuilds the filesystem tree using leaf nodes found on the device.

Normally you should use this option only if psfscheck reports errors that

can be fixed only by --rebuild-tree. We strongly recommend that you

make a backup copy of the entire partition before you attempt to run

psfscheck with the --rebuild-tree option.

If --rebuild-tree encounters any files that had been open and unlinked,

psfscheck will move the files into the lost+found directory.

--rebuild-sb

Rebuilds the superblock.

--interactive, -i

Stops psfscheck after each pass is completed.

--quiet, -q

Prevents psfscheck from reflecting its progress.

--logfile filename, -l logfilename

Tells psfscheck to place information about any corruption it finds into the

specified logfile.