Provided by: xfsprogs_4.9.0+nmu1ubuntu2_amd64 bug

NAME

       xfs_bmap - print block mapping for an XFS file

SYNOPSIS

       xfs_bmap [ -adlpv ] [ -n num_extents ] file
       xfs_bmap -V

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.

OPTIONS

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

       -c     If this option is specified, information about the file's copy  on  write  fork  is
              printed instead of the default data fork.

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

       -e     If this option is used, xfs_bmap obtains all delayed allocation extents,  and  does
              not  flush dirty pages to disk before querying extent data. With the -v option, the
              flags column will show which extents have not yet been allocated.

       -l     If this 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.

              This flag has no effect if the -v option is used.

       -n num_extents
              If  this option is given, xfs_bmap obtains the extent list of the file in groups of
              num_extents 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.

       -p     If  this option is used, xfs_bmap obtains all unwritten (preallocated) extents that
              do not contain written data. With the -v option, the flags column will  show  which
              extents are preallocated/unwritten.

       -v     Shows  verbose  information.  When  this  flag is specified, additional AG specific
              information is appended to each line in the following form:

                   agno (startagoffset..endagoffset) nblocks flags

              A second -v option will print out the flags legend.

       -V     Prints the version number and exits.

SEE ALSO

       xfs_fsr(8), xfs(5).

                                                                                      xfs_bmap(8)