ncheck_vxfs(1M)


ncheck_vxfs - generate pathnames from inode numbers for a VERITAS File System

Synopsis

ncheck [-F vxfs] [generic options] [-i ilist] [-a] [-s] [-o specific_options] special...

Description

ncheck generates a pathname-vs-inode-number list of files for the specified VxFS file system.

Some options accept a range as a value. A range consists of a single number, or two numbers seperated by a "-", indicating an inclusive range of values. If "-" is specified and the first number is omitted, 0 is assumed. If the second number is omitted, the end of the file system is assumed.

Names of directory files are followed by slash dot (/.).

Options

-F vxfs
Specifies the VxFS file system type.

generic_options
Supported by the generic ncheck command (see ncheck(1M)).

-i ilist
Limits the report to the files on the ilist that follows. The ilist must be separated by commas without spaces.

-a
Allow printing of the names "." and ".." (dot and dot dot), which are ordinarily suppressed.

-s
Report only on special files and regular files with set-user-ID mode. This option may be used to detect violations of security policy.

-o specific_options
Specifies options specific to the VxFS file system type. specific_options is a list of suboptions and/or keyword/attribute pairs intended for the VxFS-specific module of the command.

The available options are

m
Print mode information (used in conjunction with -i option).

b=block
Print pathname containing file system block number block.

sector=sector_range
Report on all inodes containing or referencing the sector(s) in sector_range. The output includes the inode number, fileset index of the inode, sector(s) contained and the pathname or inode type. Inodes searched include structural inodes and attribute inodes, so a pathname is only generated when the sector is contained by a file. If the sector is not contained in any file, the inode type is printed as "<free>". Multiple -o sector= options accumulate.

block=block_range
Print information on all inodes containing or referencing block numbers in the range specified. The output format is the same as that for -o sector=, but the units used are file system blocks rather than sectors.

surface[=sector_range]
Perform a surface analysis. If a sector_range is specified perform a surface analysis only for that range. All the sector are read and if the read of a sector fails, its sector number is printed. If any bad sectors are found, ncheck treats the list of bad sector as input to the -o sector=# option and produces a list of containing or referencing inodes.

Examples

Report on all inodes or file system structures containing or referencing sector 20 through 35 (inclusive) in the file system /dev/vx/rdsk/vol1:

ncheck -F vxfs -osector=20-35 /dev/vx/rdsk/vol1 

Same as above but report on all inodes or file system structures referencing any sector in the file system /dev/vx/rdsk/vol1:

ncheck -F vxfs -osector= /dev/vx/rdsk/vol1

Diagnostics

When the file system structure is improper, "???" denotes the "parent" of a parentless file, a pathname beginning with "..." denotes a loop, and a pathname beginning with "***" denotes a directory entry whose ".." (dot dot) entry is not in accord with the directory in which it was found.

References

sort(1), fsck_vxfs(1M), ncheck(1M), fs_vxfs(4)



© 1997 The Santa Cruz Operation, Inc. All rights reserved.