Home > Veritas Storage Foundation™ File System Manual Pages

FSMAP (1)

User Commands

NAME
AVAILABILITY
SYNOPSIS
DESCRIPTION
NOTES
Cluster File System Issues
OPTIONS
ARGUMENTS
EXAMPLES
SEE ALSO

NAME

fsmap - display VxFS file system extent information

AVAILABILITY

VRTSvxfs

SYNOPSIS

fsmap [ -aHmNq ] { file | - }

fsmap [ -aHmq ] [ -n named_stream ] { file | - }

DESCRIPTION

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

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.

-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.

-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

FSMAP (1)

Table of contents