showfile(8)						      System Manager's Manual						       showfile(8)

NAME

       showfile - displays the attributes of AdvFS directories and files

SYNOPSIS

       /usr/sbin/showfile [-i] [-h  | -x] filename...

OPTIONS

       Displays  the  raw  extent  map for an AdvFS file (including any holes). You cannot use both the -h and the -x options in the same command.
       When a filename is a directory, displays attributes for the directory's index file.  Displays the full storage allocation map (extent  map)
       for AdvFS files. You cannot use both the -h and the -x options in the same command.

OPERAND

       One  or more directory or file names.  If you do not supply filename arguments, you can use an asterisk (*) to display all the files in the
       current directory.

DESCRIPTION

       The showfile command displays the attributes of one or more AdvFS files.  The command also displays the extent map of each file.  An extent
       is  a  contiguous  area	of  disk  space that the file system allocates to a file.  Simple files have one extent map; striped files have an
       extent map for every stripe segment.

       You can list AdvFS attributes for an individual file or the contents of a directory.  Although the showfile command lists  both	AdvFS  and
       non-AdvFS files, the command displays meaningful information for AdvFS files only.

       The showfile command displays the following file attributes: Id

	      The unique number (in hexadecimal format) that identifies the file.  Digits to the left of the dot (.) character are equivalent to a
	      UFS inode.  Vol

	      The location of primary metadata for the file, expressed as a number.  The data extents of the file can reside  on  another  volume.
	      PgSz

	      The page size in 512-byte blocks Pages

	      The number of pages allocated to the file XtntType

	      The  extent  type  can  be  simple, which is a regular AdvFS file without special extents; stripe, which is a striped file; symlink,
	      which is a symbolic link to a file; ufs, nfsv3, and so on. The showfile command cannot display attributes for either symbolic  links
	      or non-AdvFS files Segs

	      The  number  of  stripe  segments  per  striped file, which is the number of volumes a striped file crosses. (Applies only to stripe
	      type.)  SegSz

	      The number of pages per stripe segment. (Applies only to stripe type.)  I/O

	      The type of write requests to this file.	Write requests are buffered (the AdvFS default) Forced synchronous writes as described	in
	      chfile(8) Write requests executed under AdvFS transaction control, which is reserved for metadata files and directories.	Perf

	      The  efficiency of file-extent allocation, expressed as a percentage of the optimal extent layout.  A high percentage, such as 100%,
	      indicates that the AdvFS I/O system has achieved optimal efficiency.  A low percentage indicates the need for file  defragmentation.
	      File

	      The  name  of  the directory or file. If the file is a directory that has an index file associated with it and the -i option has not
	      been specified, the statistics displayed are for the directory.  The term index follows the directory name. If the file is a  direc-
	      tory that has an index file associated with it and the -i option is specified, the statistics displayed are for the index file asso-
	      ciated with the directory.  The name of the directory follows the index.

       Whereas a simple file has one extent map, a striped file has more than one extent map.  An extent map (numbered	extentMap:1,  extentMap:2,
       and so on) displays the following information: pageOff

	      The starting page number of the extent pageCnt

	      The number of pages in the extent vol

	      The location of the extent, expressed as a number volBlock

	      The starting block number of the extent blockCnt

	      The number of blocks in the extent extentCnt

	      The number of extents

EXAMPLES

       The following example displays the AdvFS-specific attributes for all the files in the current working directory: # showfile *

	   Id  Vol  PgSz  Pages XtntType Segs SegSz I/O   Perf File 6.8001   1	 16   427   simple   **    ** async 100% datafile1 7.8001   1	16
       427   simple   **    ** sync  100% datafile2 5.8001   1	 16	1   simple   **    ** ftx   100% quota.group 4.8001   1   16	 1    sim-
       ple    **     **  ftx	100%  quota.user  The  following  example displays the attributes for a directory named dir1 and then displays the
       attributes for an index file for the dir1 directory: # showfile dir1

	    Id Vol PgSz Pages XtntType Segs SegSz I/O Perf File 7b.8001   1   16    48	 simple   **	** ftx 13%  dir1  (index)  #  showfile	-i
       dir1

	      Id Vol PgSz Pages XtntType Segs SegSz I/O Perf File 5511.8001   1   16	43   simple   **    ** ftx 15%	index (dir1) The following
       example shows the attributes and extent information for the mail file, which is a simple file: # showfile -x mail

	      Id Vol PgSz Pages XtntType Segs SegSz I/O  Perf File 4198.800d   2   16	 27   simple   **    ** async 66% tutor

	     extentMap: 1
		 pageOff    pageCnt    vol    volBlock	  blockCnt
		       0	  5	 2	781552		80
		       5	 12	 2	785776	       192
		      17	 10	 2	786800	       160
		 extentCnt: 3

SEE ALSO

       advfs(4)

																       showfile(8)