ncheck_vxfs(1M)						       ncheck_vxfs(1M)

NAME
       ncheck_vxfs  -  generate	 path names from inode numbers for a VxFS file
       system

SYNOPSIS
       [ generic_options ]

DESCRIPTION
       generates a list of path names 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 num‐
       ber or two numbers separated by a hyphen (-).  The range is  inclusive.
       If  you	enter  a hyphen and omit the first 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
       generic_options
		 Supported by the generic command.  See ncheck(1M).

       Specifies the VxFS file system type.

		 Allow printing of the names dot
			   and dot dot which are ordinarily suppressed.

		 Limit the report to the files on the inode list,
			   ilist,  that	 follows.  The ilist must be separated
			   by commas without spaces.

		 Specifies options specific to the VxFS file system type.
			   specific_options is a list of  suboptions  or  key‐
			   word/attribute pairs.

			   Prints  the	path name containing file system block
			   number
				     block.

			   Prints information on all inodes containing or ref‐
			   erencing block numbers
				     in	 the specified range.  The output for‐
				     mat is the same as that for but the units
				     used  are	file  system blocks instead of
				     sectors.

			   Lists the files residing in the  specified  Storage
			   Checkpoint.

			   Specifies the device ID.
				     Used  for	multi-volume file systems.  If
				     the option is not specified,  is  run  on
				     all  available devices.  If is specified,
				     all subsequent block or sector ranges are
				     scanned   for  the	 device	 specified  by
				     devid.

			   Prints mode information (used in  conjunction  with
			   the
				     generic option).

			   Reports on all inodes containing or referencing the
			   sectors in
				     sector_range.  The	 output	 includes  the
				     inode number, fileset index of the inode,
				     sectors contained, and the path  name  or
				     inode   type.   Inodes  searched  include
				     structural inodes and  attribute  inodes,
				     so a path name is only generated when the
				     sector is contained by a  file.   If  the
				     sector  is	 not contained in any file, is
				     displayed for the inode  type.   Multiple
				     options accumulate.

			   Performs a surface analysis.
				     If	 a sector_range is specified, performs
				     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,
				     treats the list of bad sectors  as	 input
				     to	 the  option  and produces a list con‐
				     taining or referencing inodes.

		 Report only on special files and regular files with set-user-
		 ID mode.
				This  option  may be used to detect violations
				of security policy.

		 Report on files containing or referencing the specified  sec‐
		 tor(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 Sectors
				not part of the file system  are  reported  as
				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 options accumu‐
				late.

		 Prints the  completed	command,  but  does  not  perform  any
		 action.

EXAMPLES
       Report  on all inodes or file system structures containing or referenc‐
       ing sector 20 through 35 (inclusive) in the file system

       The following command is same as above, but reports on  all  inodes  or
       file system structures referencing any sector in the file system:

       Report on a specified range of block numbers (partial output shown):

	      ncheck -F vxfs -oblock=- /dev/vx/rdsk/vset5

	      /dev/vx/rdsk/vset5:

	      sectors(50331648)	      blocks(0)
	      -----------------	      -----------------
	      0/0-0/16777215	      0/0-0/8388608
	      1/0-1/16777215	      1/0-1/8388608
	      2/0-2/16777215	      2/0-2/8388608

	      fileset	 fset	     mtch  match devid/
	      name	 indx  inode indx  inode blocks	       name
	      ---------- ---- ------ ---- ------ ------------- ------------------
	      STRUCTURAL    1	   3	-     35 0/9-0/10      <fileset_header>
	      STRUCTURAL    1	   4	1      - 0/11-0/14     <inode_alloc_unit>
	      STRUCTURAL    1	   5	1     37 0/7440-0/7447 <inode_list>
	      STRUCTURAL    1	   5	1     37 0/24-0/31     <inode_list>
	      STRUCTURAL    1	   5	1     37 0/7432-0/7439 <inode_list>
	      STRUCTURAL    1	   5	1     37 0/16-0/23     <inode_list>
	      STRUCTURAL    1	   6	-      - 0/15	       <current_usage_tbl>

						      .
						      .
						      .

	      UNNAMED	  999	  25	-      - 2/80-2/84     /exec.h
	      UNNAMED	  999	  26	-      - 2/86-2/87     /exechdr.h
	      -		    -	   -	-      - 0/6808	       <free>
	      -		    -	   -	-      - 0/6823-0/6975 <free>

       List the files in the Storage Checkpoint named on the device

       Report  all inodes and file system structures referencing any sector in
       the device with devid 2 in the file system

DIAGNOSTICS
       When the file system structure is not correct,  prints  three  question
       marks  (???)  to denote the "parent" of a parentless file.  A path name
       beginning with dot dot dot indicates a loop.   A	 path  name  beginning
       with three asterisks denotes a directory entry whose dot dot entry does
       not correspond with the directory in which it was found.

SEE ALSO
       sort(1), fsckptadm(1M), fsck_vxfs(1M), ncheck(1M), fs_vxfs(4).

							       ncheck_vxfs(1M)

Vote for polarhome