1xfs_bmap(8)                 System Manager's Manual                xfs_bmap(8)
2
3
4

NAME

6       xfs_bmap - print block mapping for an XFS file
7

SYNOPSIS

9       xfs_bmap [ -adelpv ] [ -n num_extents ] file
10       xfs_bmap -V
11

DESCRIPTION

13       xfs_bmap prints the map of disk blocks used by files in an XFS filesys‐
14       tem.  The map lists each extent used by the file, as well as regions in
15       the  file that do not have any corresponding blocks (holes).  Each line
16       of the listings takes the following form:
17
18              extent: [startoffset..endoffset]: startblock..endblock
19
20       Holes are marked by replacing the startblock..endblock with hole.   All
21       the  file  offsets  and disk blocks are in units of 512-byte blocks, no
22       matter what the filesystem's block size is.
23

OPTIONS

25       -a     If this option is specified, information about the file's attri‐
26              bute fork is printed instead of the default data fork.
27
28       -e     If  this option is used, xfs_bmap obtains all delayed allocation
29              extents, and does not flush dirty pages to disk before  querying
30              extent  data.  With  the  -v  option, the flags column will show
31              which extents have not yet been allocated.
32
33       -l     If this option is used, then
34
35                   <nblocks>  blocks
36
37              will be appended to each line.  nblocks is the length of the ex‐
38              tent described on the line in units of 512-byte blocks.
39
40              This flag has no effect if the -v option is used.
41
42       -n num_extents
43              If  this  option is given, xfs_bmap will display at most num_ex‐
44              tents extents. In the absence of -n, xfs_bmap will  display  all
45              extents in the file.
46
47       -p     If this option is used, xfs_bmap obtains all unwritten (preallo‐
48              cated) extents that do not contain written data. With the -v op‐
49              tion,  the  flags  column  will  show which extents are preallo‐
50              cated/unwritten.
51
52       -v     Shows verbose information. When this flag  is  specified,  addi‐
53              tional  AG  specific information is appended to each line in the
54              following form:
55
56                   agno (startagoffset..endagoffset) nblocks flags
57
58              A second -v option will print out the flags legend.
59
60       -V     Prints the version number and exits.
61

SEE ALSO

63       xfs_fsr(8), xfs(5).
64
65
66
67                                                                   xfs_bmap(8)
Impressum