ncheck_vxfs

NAME

ncheck_vxfs - generate path names from inode numbers for a VxFS file system

SYNOPSIS

AVAILABILITY

VRTSvxfs

DESCRIPTION

ncheck generates a list of path names corresponding to inode numbers for files in a specified VxFS file system.

You can specify a range for some options. A range can be a single number, or two numbers separated by a hyphen (-). The range is inclusive. If you enter a hyphen and omit the first number (- number), the range begins at zero. If you omit the second number, the range ends at the end of the file system.

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

CLUSTER FILE SYSTEM ISSUES

No cluster issues; command operates the same on cluster file systems.

OPTIONS

generic_options

Supported by the generic ncheck command. See the ncheck (1M) manual page.

-F vxfs

Specifies the VxFS file system type.

-o specific_options

Specifies options specific to the VxFS file system type. specific_options is a list of suboptions or keyword/attribute pairs.

b=block

Prints the path name containing file system block number block .

block=block_range

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

ckpt=ckpt_name

Lists the files residing in the specified Storage Checkpoint.

m

Prints mode information (used in conjunction with -i generic option).

sector=sector_range

Reports on all inodes containing or referencing the sectors in sector_range . The output includes the inode number, fileset index of the inode, sectors contained, and the path name or inode type. Inodes searched include structural inodes and attribute inodes, so a path name is only generated when the sector is contained by a file. If the sector is not contained in any file, ''<free>'' is displayed for the inode type. Multiple -o sector= options accumulate.

surface= [ sector_range]

Performs a surface analysis. If a sector_range is specified, performs 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 sectors as input to the -o sector=sector_range option and produces a list containing or referencing inodes.

-V

Prints the completed command, but does not perform any action.

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 

Report on a specified range of block numbers (partial output shown):

List the files in the Storage Checkpoint named checkpoint1 on the device /dev/vx/rdsk/dg1/vol1:

DIAGNOSTICS

When the file system structure is not correct, ncheck prints three question marks ( ??? ) to denote the ''parent'' of a parentless file. A path name beginning with dot dot dot (...) indicates a loop. A path name beginning with three asterisks ( *** ) denotes a directory entry whose dot dot (..) entry does not correspond with the directory in which it was found.

SEE ALSO

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