fsmap(1M)fsmap(1M)NAMEfsmap - display VxFS file system extent information
AVAILABILITY
VRTSvxfs
SYNOPSIS
/opt/VRTS/bin/fsmap [ -aHmNq ] { file ... | - }
/opt/VRTS/bin/fsmap [ -aHmq ] [ -n named_stream ] { file ... | - }
DESCRIPTION
The fsvmap command was introduced to verify Dynamic Storage Tiering
allocation policies.
The fsmap command reports extent information for files on a VxFS file
system. fsmap displays a list of devices that hold extents for the
specified files.
The fsmap command reports the following information for each extent:
· Volume on which the extent resides
· Logical offset (for data extents, only)
· Extent size
The fsmap command reports extents for any extended attribute inodes
associated with file.
NOTES
The order in which the extents are displayed is not specified.
Extent information for a directory is limited to the extents associated
with the directory itself, not the files within the directory.
When processing a symbolic link, the link is followed and extent infor‐
mation for the target file is reported.
Hole extents are not reported unless the -a option is specified.
open() permission is required for each file or directory specified.
The fsmap command only operates on VxFS multi-volume file systems.
Unless the -a option is specified, only the first occurrence of a vol‐
ume is reported for a file.
Use the fsvmap command to report extent information for files on a
specified volume. The functionality of fsvmap is the reverse of fsmap.
The fsmap command does not print any information for empty files.
Cluster File System Issues
No cluster issues; command operates the same on cluster file systems.
OPTIONS-a Reports detailed information for all data extents.
-H Reports sizes in a human-readable format.
-m Reports metadata. For individual files, the report includes
the location of the inode and any indirect extents associated
with the file.
-N Reports extent information for all named data streams,
including the main data stream.
-n named_stream
Reports extent information for the specified named data
stream. The extent information for the main data stream is
not reported.
-q Supresses headings.
ARGUMENTS
file The pathname of an input file.
- If - is specified as the only filename, the standard input
will be read to obtain a list of filenames.
EXAMPLES
The find command can be used to descend directories recursively and run
fsmap on the list of files:
# find . | fsmap-
To report the volumes on which the data extents for the file file1
reside:
# fsmap file1
Volume Extent Type File
vol02 Data file1
vol03 Data file1
To report metadata extents in addition to data extents for file1:
# fsmap-m file1
Volume Extent Type File
vol02 Data file1
vol03 Data file1
vol01 Meta file1
To report detailed information for all data and metadata extents for
file1:
# fsmap-am file1
Volume Extent Type File Offset Extent Size File
vol02 Data 0 5038080 file1
vol02 Data 5038080 245760 file1
vol02 Data 5283840 65536 file1
vol02 Data 5349376 32768 file1
vol02 Data 5382144 16384 file1
vol02 Data 5398528 2048 file1
vol02 Data 5400576 1024 file1
vol02 Data 5401600 1024 file1
vol03 Data 5402624 833536 file1
vol01 Meta - 8192 file1
To report detailed information for all data and metadata extents for
file4, which is a file with holes:
# fsmap-am file4
Volume Extent Type File Offset Extent Size File
vol02 Data 0 1024 file4
vol02 Data 1024 1024 file4
- <Hole> 2048 1024 file4
vol02 Data 3072 1024 file4
- <Hole> 4096 2048 file4
vol02 Data 6144 1024 file4
To report data extents for files file1, file2, and file3:
# fsmap file1 file2 file3
Volume Extent Type File
vol02 Data file1
vol03 Data file1
vol02 Data file2
vol03 Data file3
vol04 Data file3
SEE ALSOfsvmap(1M), fsvoladm(1M), vxvset(1M)VxFS 5.0 7 Jan 2008 fsmap(1M)
