showfile(8)showfile(8)NAMEshowfile - 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 allo‐
cates 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 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 equiva‐
lent 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 vol‐
ume. 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; sym‐
link, which is a symbolic link to a file; ufs, nfsv3, and so on.
The showfile command cannot display attributes for either sym‐
bolic 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 per‐
centage of the optimal extent layout. A high percentage, such
as 100%, indicates that the AdvFS I/O system has achieved opti‐
mal 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 direc‐
tory. 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 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 simple **
** 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 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
Files: advfs(4)showfile(8)