unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 ncheck_vxfs(1M)					     ncheck_vxfs(1M)




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



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 ncheck_vxfs(1M)					     ncheck_vxfs(1M)




			       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 <&lt&lt&lt;free>&gt&gt&gt;.	 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 <&lt&lt&lt;free>&gt&gt&gt;.  Sectors not part of the file system
			  are reported as <&lt&lt&lt;unused>&gt&gt&gt;.  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



 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 ncheck_vxfs(1M)					     ncheck_vxfs(1M)




			  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 -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	    <&lt&lt&lt;fileset_header>&gt&gt&gt;
	   STRUCTURAL	 1	4    1	    - 11-14	    <&lt&lt&lt;inode_alloc_unit>&gt&gt&gt;
	   STRUCTURAL	 1	5    1	   37 1296-1303	    <&lt&lt&lt;inode_list>&gt&gt&gt;
	   STRUCTURAL	 1	5    1	   37 24-31	    <&lt&lt&lt;inode_list>&gt&gt&gt;
	   STRUCTURAL	 1	5    1	   37 1288-1295	    <&lt&lt&lt;inode_list>&gt&gt&gt;
	   STRUCTURAL	 1	5    1	   37 16-23	    <&lt&lt&lt;inode_list>&gt&gt&gt;
	   STRUCTURAL	 1	6    -	    - 15	    <&lt&lt&lt;current_usage_tbl>&gt&gt&gt;
	   STRUCTURAL	 1	7    -	   39 33	    <&lt&lt&lt;object_loc_tbl>&gt&gt&gt;
	   STRUCTURAL	 1	8    -	   40 34	    <&lt&lt&lt;device_config>&gt&gt&gt;
	   STRUCTURAL	 1	9    -	   41 40-1063	    <&lt&lt&lt;intent_log>&gt&gt&gt;
	   STRUCTURAL	 1     10    -	   42 1144-1151	    <&lt&lt&lt;extent_map>&gt&gt&gt;
	   STRUCTURAL	 1     10    -	   42 1072-1143	    <&lt&lt&lt;extent_map>&gt&gt&gt;
	   STRUCTURAL	 1     10    -	   42 1064-1071	    <&lt&lt&lt;extent_map>&gt&gt&gt;
	   STRUCTURAL	 1     32    -	    - 32	    <&lt&lt&lt;state_alloc_bitmap>&gt&gt&gt;
	   STRUCTURAL	 1     33    -	    - 1284	    <&lt&lt&lt;device_label>&gt&gt&gt;
	   STRUCTURAL	 1     33    -	    - 0-8	    <&lt&lt&lt;device_label>&gt&gt&gt;
	   STRUCTURAL	 1     34    -	    - 35	    <&lt&lt&lt;extent_au_summary>&gt&gt&gt;
	   STRUCTURAL	 1     35    -	    3 1280-1281	    <&lt&lt&lt;fileset_header>&gt&gt&gt;
	   STRUCTURAL	 1     37    1	    5 1296-1303	    <&lt&lt&lt;inode_list>&gt&gt&gt;
	   STRUCTURAL	 1     37    1	    5 24-31	    <&lt&lt&lt;inode_list>&gt&gt&gt;
	   STRUCTURAL	 1     37    1	    5 1288-1295	    <&lt&lt&lt;inode_list>&gt&gt&gt;
	   STRUCTURAL	 1     37    1	    5 16-23	    <&lt&lt&lt;inode_list>&gt&gt&gt;
	   STRUCTURAL	 1     39    -	    7 1282	    <&lt&lt&lt;object_loc_tbl>&gt&gt&gt;
	   STRUCTURAL	 1     40    -	    8 1283	    <&lt&lt&lt;device_config>&gt&gt&gt;



 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 ncheck_vxfs(1M)					     ncheck_vxfs(1M)




	   STRUCTURAL	 1     41    -	    9 40-1063	    <&lt&lt&lt;intent_log>&gt&gt&gt;
	   STRUCTURAL	 1     42    -	   10 1144-1151	    <&lt&lt&lt;extent_map>&gt&gt&gt;
	   STRUCTURAL	 1     42    -	   10 1072-1143	    <&lt&lt&lt;extent_map>&gt&gt&gt;
	   STRUCTURAL	 1     42    -	   10 1064-1071	    <&lt&lt&lt;extent_map>&gt&gt&gt;
	   STRUCTURAL	 1     64  999	    - 36-39	    <&lt&lt&lt;inode_alloc_unit>&gt&gt&gt;
	   STRUCTURAL	 1     65  999	   97 59072-59135   <&lt&lt&lt;inode_list>&gt&gt&gt;
	   STRUCTURAL	 1     65  999	   97 1152-1159	    <&lt&lt&lt;inode_list>&gt&gt&gt;
	   STRUCTURAL	 1     69  999	    - 1160-1167	    <&lt&lt&lt;bsd_quota>&gt&gt&gt;
	   STRUCTURAL	 1     97  999	   65 59072-59135   <&lt&lt&lt;inode_list>&gt&gt&gt;
	   STRUCTURAL	 1     97  999	   65 1152-1159	    <&lt&lt&lt;inode_list>&gt&gt&gt;
	   UNNAMED     999     96    -	    - 4861	    /file1
	   UNNAMED     999   1807    -	    - 344387	    /file1000
	   UNNAMED     999   1822    -	    - 328082	    /file2
	   -		 -	-    -	    - 19766-19769   <&lt&lt&lt;free>&gt&gt&gt;
	   -		 -	-    -	    - 347192-347194 <&lt&lt&lt;free>&gt&gt&gt;

 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.

 SEE ALSO
      sort(1), fsck(1M), fsck_vxfs(1M), ncheck(1M).


























 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000