xfs_bmap - print block mapping for an XFS file


SYNOPSIS

       xfs_bmap [ -a ] [ -l ] [ -d ] [ -n nnn ] file ...


DESCRIPTION

       xfs_bmap prints the map of disk blocks used by files in an
       XFS filesystem.  The map lists each  extent  used  by  the
       file,  as well as regions in the file that do not have any
       corresponding blocks (holes).  Each line of  the  listings
       takes the following form:

       extent: [startoffset..endoffset]: startblock..endblock

       Holes  are  marked  by  replacing the startblock..endblock
       with hole.  All the file offsets and disk  blocks  are  in
       units  of 512-byte blocks, no matter what the filesystem's
       block size is.

       If portions of the file have been migrated  offline  by  a
       DMAPI application, a DMAPI read event will be generated to
       bring those portions back online before the disk block map
       is  printed.   However  if the -d option is used, no DMAPI
       read event will be generated for a DMAPI file and  offline
       portions will be reported as holes.

       If the -l option is used, then

       <nblocks> blocks

       will  be  appended to each line.  Nblocks is the length of
       the extent described on the  line  in  units  of  512-byte
       blocks.

       If  the  -a  option is given, information about the file's
       attribute fork is printed  instead  of  the  default  data
       fork.

       If the -n nnn option is given, xfs_bmap obtains the extent
       list of the file in groups of nnn extents.  In the absence
       of  -n,  xfs_bmap  queries  the  system  for the number of
       extents in the file and uses that  value  to  compute  the
       group size.


DIAGNOSTICS

       ioctl(XFS_IOC_GETBMAPX) filename: Invalid argument
                 The file filename is not in an XFS filesystem.


SEE ALSO

       xfs(5).


Man(1) output converted with man2html