Debian Codegraph @

upstream/debian-unstable/man8/xfs_bmap.8

raw
1 .TH xfs_bmap 8
2 .SH NAME
3 xfs_bmap \- print block mapping for an XFS file
4 .SH SYNOPSIS
5 .B xfs_bmap
6 [
7 .B \-adelpv
8 ] [
9 .B \-n
10 .I num_extents
11 ]
12 .I file
13 .br
14 .B xfs_bmap \-V
15 .SH DESCRIPTION
16 .B xfs_bmap
17 prints the map of disk blocks used by files in an XFS filesystem.
18 The map lists each
19 .I extent
20 used by the file, as well as regions
21 in the file that do not have any corresponding blocks (holes).
22 Each line of the listings takes the following form:
23 .PP
24 .RS
25 .IR extent ": [" startoffset .. endoffset "]: " startblock .. endblock
26 .RE
27 .PP
28 Holes are marked by replacing the
29 .IR startblock .. endblock " with " hole .
30 All the file offsets and disk blocks are in units of 512-byte blocks,
31 no matter what the filesystem's block size is.
32 .PP
33 .SH OPTIONS
34 .TP
35 .B \-a
36 If this option is specified, information about the file's
37 attribute fork is printed instead of the default data fork.
38 .TP
39 .B \-e
40 If this option is used,
41 .B xfs_bmap
42 obtains all delayed allocation extents, and does not flush dirty pages
43 to disk before querying extent data. With the
44 .B \-v
45 option, the
46 .I flags
47 column will show which extents have not yet been allocated.
48 .TP
49 .B \-l
50 If this option is used, then
51 .IP
52 .RS 1.2i
53 .RI < nblocks "> blocks"
54 .RE
55 .IP
56 will be appended to each line.
57 .I nblocks
58 is the length of the extent described on the line in units of 512-byte blocks.
59 .IP
60 This flag has no effect if the
61 .B \-v
62 option is used.
63 .TP
64 .BI \-n " num_extents"
65 If this option is given,
66 .B xfs_bmap
67 will display at most
68 .I num_extents
69 extents. In the absence of
70 .BR \-n ", " xfs_bmap
71 will display all extents in the file.
72 .TP
73 .B \-p
74 If this option is used,
75 .B xfs_bmap
76 obtains all unwritten (preallocated) extents that do not contain written
77 data. With the
78 .B \-v
79 option, the
80 .I flags
81 column will show which extents are preallocated/unwritten.
82 .TP
83 .B \-v
84 Shows verbose information. When this flag is specified, additional AG
85 specific information is appended to each line in the following form:
86 .IP
87 .RS 1.2i
88 .IR agno " (" startagoffset .. endagoffset ") " nblocks " " flags
89 .RE
90 .IP
91 A second
92 .B \-v
93 option will print out the
94 .I flags
95 legend.
96 .TP
97 .B \-V
98 Prints the version number and exits.
99 .SH SEE ALSO
100 .BR xfs_fsr (8),
101 .BR xfs (5).