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
Specify the vxfs file system type. If -F vxfs is not specified heuristics similiar to those used by fstyp(1M) are used to determine the file system type.
This command executes faster if it is not required to autodetect file system types. If possible, specify -F vxfs

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

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



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