fsmap - display VxFS file system extent information
fsmap [ -aHmNq ] { file ... | - }
fsmap [ -aHmq ] [ -n named_stream ] { file ... | - }
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:
The fsmap command reports extents for any extended attribute inodes associated with file.
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 information 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 volume 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.
No cluster issues; command operates the same on cluster file systems.
Reports detailed information for all data extents.
Reports sizes in a human-readable format.
Reports metadata. For individual files, the report includes the location of the inode and any indirect extents associated with the file.
Reports extent information for all named data streams, including the main data stream.
Reports extent information for the specified named data stream. The extent information for the main data stream is not reported.
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.
The find command can be used to descend directories recursively and run fsmap on the list of files:
To report the volumes on which the data extents for the file file1 reside:
To report metadata extents in addition to data extents for file1:
To report detailed information for all data and metadata extents for file1:
Volume Extent Type File Offset Extent Size File
vol02 Data 5038080 245760 file1
vol02 Data 5283840 65536 file1
vol02 Data 5349376 32768 file1
vol02 Data 5382144 16384 file1
vol03 Data 5402624 833536 file1
To report detailed information for all data and metadata extents for file4, which is a file with holes:
Volume Extent Type File Offset Extent Size File
To report data extents for files file1, file2, and file3:
fsvmap(1M), fsvoladm(1M), vxvset(1M)