ncheck_vxfs - generate path names from inode numbers for a VxFS file system
[ -V ] ncheck [ -V vxfs ] [ -i ilist ] [ -a ] [ -s ]
[ -o m,device=devid,b=block, [ block=block_range ],
[ sector=sector_range ], [ surface=[ sector_range ],]
| ckpt=ckpt_name ] 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.
-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
ncheck -V 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 ncheck -V 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:
# ncheck -V vxfs -oblock=- /dev/vx/rdsk/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/vset1:
ncheck -V vxfs -o ckpt=checkpoint1 /dev/vx/rdsk/dg1/vol1
# ncheck -V vxfs -odevice=2 /dev/vx/rdsk/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.
ncheck, sort, fsckptadm(1M), fsck_vxfs(1M), fs_vxfs(4)
|VxFS 5.1 SP1||ncheck_vxfs (1M)|