ncheck_vxfs(1M) ncheck_vxfs(1M)
NAME [Toc] [Back]
ncheck_vxfs: ncheck - generate pathnames from inode numbers for a VxFS
file system
SYNOPSIS [Toc] [Back]
ncheck [-a] [-F vxfs] [-i ilist] [-o specific_options] [-s] [-S
sector_list] [-V] special ...
DESCRIPTION [Toc] [Back]
ncheck generates a list of pathnames 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 the range is a single number, the output will refer to
the single sector, block, or surface specified by that number. 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 (/.).
Options [Toc] [Back]
ncheck_vxfs recogizes the following options:
-a Allow printing of the names dot (.) and dot dot
(..), which are ordinarily suppressed.
-F vxfs Specify the file-system type (vxfs).
-i ilist Limit the report to the files on the inode list,
ilist, that follows. The ilist must be separated
by commas without spaces.
-o specific_options
Specify 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
b=block
Print the pathname containing file system
block number block.
block=block_range
Print 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
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
ncheck_vxfs(1M) ncheck_vxfs(1M)
system blocks instead of sectors.
m Print mode information (used in conjunction
with -i option).
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.
surface[=sector_range]
Perform a surface analysis. If a
sector_range is specified, perform a surface
analysis only for that range. All the
sectors 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 of inodes containing or referencing the
bad sectors.
-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.
-V Echo the completed command line, but do not
execute the command. The command line is
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
ncheck_vxfs(1M) ncheck_vxfs(1M)
generated by incorporating the user-specified
options and other information derived from
/etc/fstab. This option allows the user to verify
the command line.
Operands [Toc] [Back]
ncheck_vxfs recogizes the following operand:
special A VxFS file system.
EXAMPLES [Toc] [Back]
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 -osector=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 -osector= /dev/vg01/rlvol1
Report on a specified range of block numbers (partial output shown):
ncheck -F vxfs -oblock=- /dev/vg00/lvol6
/dev/vg00/lvol6:
sectors(348160) blocks(348160)
----------------- -----------------
0-348159 0-348159
fileset fset mtch match
name indx inode indx inode blocks name
---------- ---- ------ ---- ------ ------------- ------------------
STRUCTURAL 1 3 - 35 9-10 <fileset_header>
STRUCTURAL 1 4 1 - 11-14 <inode_alloc_unit>
STRUCTURAL 1 5 1 37 1296-1303 <inode_list>
STRUCTURAL 1 5 1 37 24-31 <inode_list>
STRUCTURAL 1 5 1 37 1288-1295 <inode_list>
STRUCTURAL 1 5 1 37 16-23 <inode_list>
STRUCTURAL 1 6 - - 15 <current_usage_tbl>
STRUCTURAL 1 7 - 39 33 <object_loc_tbl>
STRUCTURAL 1 8 - 40 34 <device_config>
STRUCTURAL 1 9 - 41 40-1063 <intent_log>
STRUCTURAL 1 10 - 42 1144-1151 <extent_map>
STRUCTURAL 1 10 - 42 1072-1143 <extent_map>
STRUCTURAL 1 10 - 42 1064-1071 <extent_map>
STRUCTURAL 1 32 - - 32 <state_alloc_bitmap>
STRUCTURAL 1 33 - - 1284 <device_label>
STRUCTURAL 1 33 - - 0-8 <device_label>
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003
ncheck_vxfs(1M) ncheck_vxfs(1M)
STRUCTURAL 1 34 - - 35 <extent_au_summary>
STRUCTURAL 1 35 - 3 1280-1281 <fileset_header>
STRUCTURAL 1 37 1 5 1296-1303 <inode_list>
STRUCTURAL 1 37 1 5 24-31 <inode_list>
STRUCTURAL 1 37 1 5 1288-1295 <inode_list>
STRUCTURAL 1 37 1 5 16-23 <inode_list>
STRUCTURAL 1 39 - 7 1282 <object_loc_tbl>
STRUCTURAL 1 40 - 8 1283 <device_config>
STRUCTURAL 1 41 - 9 40-1063 <intent_log>
STRUCTURAL 1 42 - 10 1144-1151 <extent_map>
STRUCTURAL 1 42 - 10 1072-1143 <extent_map>
STRUCTURAL 1 42 - 10 1064-1071 <extent_map>
STRUCTURAL 1 64 999 - 36-39 <inode_alloc_unit>
STRUCTURAL 1 65 999 97 59072-59135 <inode_list>
STRUCTURAL 1 65 999 97 1152-1159 <inode_list>
STRUCTURAL 1 69 999 - 1160-1167 <bsd_quota>
STRUCTURAL 1 97 999 65 59072-59135 <inode_list>
STRUCTURAL 1 97 999 65 1152-1159 <inode_list>
UNNAMED 999 96 - - 4861 /file1
UNNAMED 999 1807 - - 344387 /file1000
UNNAMED 999 1822 - - 328082 /file2
- - - - - 19766-19769 <free>
- - - - - 347192-347194 <free>
DIAGNOSTICS [Toc] [Back]
When the file system structure is not correct, ncheck prints ??? to
denote the ``parent'' of a parentless file. A pathname beginning with
... denotes a loop. A pathname beginning with *** denotes a
directory entry whose .. (dotdot) entry does not correspond with the
directory in which it was found.
FILES [Toc] [Back]
/etc/fstab Static information about the file systems.
SEE ALSO [Toc] [Back]
sort(1), fsck_vxfs(1M), ncheck(1M), fs_vxfs(4).
Hewlett-Packard Company - 4 - HP-UX 11i Version 2: August 2003 [ Back ] |
