test veritas logo



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


ncheck [ -t vxfs ] [ -i ilist ] [ -f fsetlist ]

[ -o m,device=devid,b=block, [ block=block_range ], [ generic_options ] special ...




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.


-f fsetlist Limits the generated list to the filesets specified by the fsetlist argument. You must specify the filesets as a comma-separated list with no intervening spaces. The filesets must not be between 2 and 998, inclusive.
-t vxfs Specifies the VxFS file system type.
-i ilist Limits the generated list to the files specified by ilist. The files must be comma-separated with no intervening spaces.
-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.
  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.
  Lists the files residing in the specified Storage Checkpoint.
  Scans the subsequent block/sector ranges for the specified device ID. Used for multi-volume file systems. If no device is specified, the ncheck command is run on all available devices.
m Prints mode information (used in conjunction with -i generic option).
  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.


Report on all inodes or file system structures containing or referencing sector 20 through 35 (inclusive) in the file system /dev/vx/rdsk/dg/vol1:
ncheck -t vxfs -osector=20-35 /dev/vx/rdsk/dg/vol1
Same as above but report on all inodes or file system structures referencing any sector in the file system /dev/vx/rdsk/dg/vol1:
ncheck -t vxfs -osector= /dev/vx/rdsk/dg/vol1
Report on a specified range of block numbers (partial output shown):

# ncheck -t vxfs -oblock=- /dev/vx/rdsk/dg/vset5


sectors(50331648) blocks(0) ----------------- ----------------- 0/0-0/16777215 0/0-0/8388608 1/0-1/16777215 1/0-1/8388608 2/0-2/16777215 2/0-2/8388608

fileset fset mtch match devid/ name indx inode indx inode blocks name ---------- ---- ------ ---- ------ ------------- ------------------ STRUCTURAL 1 3 - 35 0/9-0/10 <fileset_header> STRUCTURAL 1 4 1 - 0/11-0/14 <inode_alloc_unit> STRUCTURAL 1 5 1 37 0/7440-0/7447 <inode_list> STRUCTURAL 1 5 1 37 0/24-0/31 <inode_list> STRUCTURAL 1 5 1 37 0/7432-0/7439 <inode_list> STRUCTURAL 1 5 1 37 0/16-0/23 <inode_list> STRUCTURAL 1 6 - - 0/15 <current_usage_tbl>                                         .                                         .                                         . UNNAMED 999 25 - - 2/80-2/84 /exec.h UNNAMED 999 26 - - 2/86-2/87 /exechdr.h - - - - - 0/6808 <free> - - - - - 0/6823-0/6975 <free>

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

ncheck -t vxfs -o ckpt=checkpoint1 /dev/vx/rdsk/dg1/vol1

Report all inodes and file system structures referencing any sector in the device with devid 2 in the file system /dev/vx/rdsk/dg/vset1:

# ncheck -t vxfs -odevice=2 /dev/vx/rdsk/dg/vset1


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.


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

VxFS 7.4 ncheck_vxfs(1M)