ncheck_vxfs(1M)

NAME

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

SYNOPSIS

/usr/sbin/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

-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

m: Print mode information (used in conjunction with -i option).
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.
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.

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