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 (/.).
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. 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. device=devid 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). 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.
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): List the files in the Storage Checkpoint named checkpoint1 on the device /dev/vx/rdsk/dg1/vol1:
# 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>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 -o ckpt=checkpoint1 /dev/vx/rdsk/dg1/vol1
# 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)