test veritas logo


fsmap(1)

NAME

fsmap - display VxFS file system extent information

AVAILABILITY

VRTSvxfs

SYNOPSIS

fsmap [ -aHmNpq ] { file ... | - }

fsmap [ -aHmpq ] [ -n named_stream ] { file ... | - }

fsmap [ -cH ] { file ... | - }

fsmap [ -A|-C ] { file ... | - }

DESCRIPTION

The fsvmap command was introduced to verify file locations in multi-volume file systems, including use with SmartTier 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:

o Volume on which the extent resides
o Logical offset (for data extents, only)
o 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 information for the target file is reported.

Hole extents and delayed allocation range are not reported unless the -a option is specified.

open() permission is required for each file or directory specified.

Unless the -a option is specified, only the first occurrence of a volume is reported for a file.

Use the fsvmap command to list all the files that reside 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, like -a, and it includes the extents device offset and the file’s inode number.
-a Reports detailed information for all data extents.
-C Reports detailed information for all extents that reside on a cache file system for a given file. It includes the extents device offset and the file’s inode number. Similar to -A, for cached file system extents.
-c Reports the total count of data and metadata allocated for the file. The report also includes the count of shared data, shared metadata, private data, and private metadata for the file.
-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.
-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.
-p Reports more detailed information for all data extents. For all extents, fsmap reports both the logical size (the size of the uncompressed data) and the extent size (the size of the compressed data on disk). For compressed extents, these two sizes may differ. If the two sizes are the same, then the second size is displayed as a "-".
The extent type is displayed in two additional columns to the left of the Data column. The first of these columns indicates whether the extent is shared, as represented by an "S", or not shared, as represented by a "-". The second of these columns indicates whether the extent is compressed, as represented by a "C", or not compressed, as represented by a "-".
-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

To report sharing information for files file5 and snapfile5:


# fsmap -c file5 snapfile5 Extent Type Total Size Shared Private File Data 110592 102400 8192 file5 Meta 8192 0 8192 file5 Data 102400 102400 0 snap-file5 Meta 8192 8192 0 snap-file5

To report detailed information for all extents including the delayed allocation range for a file:


# fsmap -a delayedfile Volume Extent Type File Offset Extent Size File - <Delayed> 0 23885 delayedfile

SEE ALSO

fsvmap(1M), fsvoladm(1M), vxvset(1M)


VxFS 7.4 fsmap(1)