fsmap man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

fsmap(1M)							     fsmap(1M)

NAME
       fsmap - 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 ALSO
       fsvmap(1M), fsvoladm(1M), vxvset(1M)

VxFS 5.0			  7 Jan 2008			     fsmap(1M)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]