ncheck_vxfs(1M)

NAME

ncheck_vxfs: ncheck — generate pathnames from inode numbers for a VxFS file system

SYNOPSIS

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

DESCRIPTION

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

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-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 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

ncheck_vxfs recogizes the following operand:

special

A VxFS file system.

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 -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

/dev/vg00/lvol6:

sectors(348160) ----------------- 0-348159

fileset    fset name ---------- STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 STRUCTURAL    1 UNNAMED UNNAMED UNNAMED - -

-F vxfs -oblock=- /dev/vg00/lvol6

blocks(348160)          -----------------       0-348159                mtch  match                indx  inode indx  inode blocks        name ---- ------ ---- ------ ------------- ------------------ 3    -     35 9-10          <fileset_header> 4    1      - 11-14         <inode_alloc_unit> 5    1     37 1296-1303     <inode_list> 5    1     37 24-31         <inode_list> 5    1     37 1288-1295     <inode_list> 5    1     37 16-23         <inode_list> 6    -      - 15            <current_usage_tbl> 7    -     39 33            <object_loc_tbl> 8    -     40 34            <device_config> 9    -     41 40-1063       <intent_log> 10    -     42 1144-1151     <extent_map> 10    -     42 1072-1143     <extent_map> 10    -     42 1064-1071     <extent_map> 32    -      - 32            <state_alloc_bitmap> 33    -      - 1284          <device_label> 33    -      - 0-8           <device_label> 34    -      - 35            <extent_au_summary> 35    -      3 1280-1281     <fileset_header> 37    1      5 1296-1303     <inode_list> 37    1      5 24-31         <inode_list> 37    1      5 1288-1295     <inode_list> 37    1      5 16-23         <inode_list> 39    -      7 1282          <object_loc_tbl> 40    -      8 1283          <device_config> 41    -      9 40-1063       <intent_log> 42    -     10 1144-1151     <extent_map> 42    -     10 1072-1143     <extent_map> 42    -     10 1064-1071     <extent_map> 64  999      - 36-39         <inode_alloc_unit> 65  999     97 59072-59135   <inode_list> 65  999     97 1152-1159     <inode_list> 69  999      - 1160-1167     <bsd_quota> 97  999     65 59072-59135   <inode_list> 97  999     65 1152-1159     <inode_list> 999     96    -      - 4861          /file1 999   1807    -      - 344387        /file1000 999   1822    -      - 328082        /file2 -      -    -      - 19766-19769   <free> -      -    -      - 347192-347194 <free>

DIAGNOSTICS

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

/etc/fstab: Static information about the file systems.

ncheck_vxfs(1M)

Technical documentation

» Table of Contents

» Index