ncheck_vxfs(1M)
ncheck_vxfs - generate pathnames from inode numbers for a VERITAS File System
Synopsis
ncheck [-F vxfs] [generic options] [-i ilist] [-a] [-s] [-o specific_options] special...
Description
ncheck 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 seperated 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 slash dot (/.).
Options
- -F vxfs
- Specify the vxfs file system type.
If -F vxfs is not specified
heuristics similiar to those used by
fstyp(1M)
are used to determine the file system type.
This command executes faster if it is not required
to autodetect file system types. If possible, specify
-F vxfs
- generic_options
- Supported by the generic ncheck command
(see
ncheck(1M)).
- -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 dot dot), 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.
- -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/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
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 ".." (dot dot) entry is not in accord with the directory in which it was found.
References
fstyp(1M),
sort(1),
fsck_vxfs(1M),
ncheck(1M),
fs_vxfs(4)
© 1997 The Santa Cruz Operation, Inc. All rights reserved.