ncheck_vxfs(1M)

NAME

ncheck (vxfs) − generate pathnames from inode numbers for a VxFS file system

SYNOPSIS

/usr/sbin/ncheck [−F vxfs] [-V] [−i ilist] [−a] [−s] [−S sector_list]
[−o specific_options] special ...

DESCRIPTION

The ncheck program 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 separated 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 “/.”.

Options

−F vxfs Specifies the file-system type (vxfs).

−V Echoes the completed command line, but performs no other action. The command line is generated by incorporating the user-specified options and other information derived from /etc/fstab. This option allows the user to verify the command line.

−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 dotdot), 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.

-S sector_list Report on files containing or referencing the specified sector(s). Output consists of the fileset name, fileset index, inode number, and pathname of file or file type if a structural inode or attribute inode. Sectors not allocated to any file or file system structure are reported as <free>. Sectors not part of the file system are reported as <unused>. Unused or irrelevant fields are printed as “-”.

sector_list consists of one or more ranges of sector numbers, separated by commas without intervening spaces. Multiple -S options accumulate.

−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/vg01/rlvol1:

ncheck -F vxfs -S 20-35 /dev/vg01/rlvol1

Same as above but report on all inodes or file system structures referencing any sector in the file system /dev/vg01/rlvol1:

ncheck -F vxfs -S - /dev/vg01/rlvol1

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 “..” (dotdot) entry is not in accord with the directory in which it was found.

FILES

/etc/fstab Static information about the file systems.

Museum

Related Articles