showfile - displays the attributes of AdvFS directories
and files
/usr/sbin/showfile [-i] [-h | -x] filename...
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.
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.
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 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. 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 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
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.
Files: advfs(4)
showfile(8)
[ Back ] |
