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.