unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



showfile(8)							  showfile(8)



NAME

  showfile - displays the attributes of	AdvFS directories and files

SYNOPSIS

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

OPTIONS

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

  -i  When a filename is a directory, displays attributes for the directory's
      index file.

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

  filename...
	  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 con-
  tiguous area of disk space that the file system allocates to a file.	Sim-
  ple 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 will also display an informational message if a file
  has DMAPI-enabled regions, which indicate the	possiblility of	migrated-out
  data.	See AdvFS Administration for more information about DMAPI.

  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.

       async   Write requests are buffered (the	AdvFS default)

       sync    Forced synchronous writes as described in chfile(8)

       ftx     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 per-
       centage 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 speci-
       fied, the statistics displayed are for the directory.  The term index
       follows the directory name. If the file is a directory that has an
       index file associated with it and the -i	option is specified, the
       statistics displayed are	for the	index file associated with the direc-
       tory.  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

   1.  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   simple   **	   ** ftx   100% quota.user

   2.  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)

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

   4.  The following example shows an informational message for	a file that
       has DMAPI-enabled regions:
	    # showfile /mnt/file1

		   Id Vol PgSz Pages XtntType Segs SegSz   I/O	Perf  File
	       6.8006	1   16	   4   simple	**    ** async	100%  file1
	    DMAPI regions present on this file.






SEE ALSO

  advfs(4)