Debian Codegraph @

upstream/debian-unstable/man8/xfs_info.8

raw
1 .\" Verbatim blocks taken from openssl req manpage content
2 .de Vb \" Begin verbatim text
3 .ft CW
4 .nf
5 .ne \\$1
6 ..
7 .de Ve \" End verbatim text
8 .ft R
9 .fi
10 ..
11
12 .TH xfs_info 8
13 .SH NAME
14 xfs_info \- display XFS filesystem geometry information
15 .SH SYNOPSIS
16 .B xfs_info
17 [
18 .B \-t
19 .I mtab
20 ]
21 [
22 .I mount-point
23 |
24 .I block-device
25 |
26 .I file-image
27 ]
28 .br
29 .B xfs_info \-V
30 .SH DESCRIPTION
31 .B xfs_info
32 displays geometry information about an existing XFS filesystem.
33 The
34 .I mount-point
35 argument is the pathname of a directory where the filesystem
36 is mounted.
37 The
38 .I block-device
39 or
40 .I file-image
41 contain a raw XFS filesystem.
42 The existing contents of the filesystem are undisturbed.
43 .SH OPTIONS
44 .TP
45 .B \-t
46 Specifies an alternate mount table file (default is
47 .I /proc/mounts
48 if it exists, else
49 .IR /etc/mtab ).
50 This is used when working with filesystems mounted without writing to
51 .I /etc/mtab
52 file - refer to
53 .BR mount (8)
54 for further details.
55 This option has no effect with the
56 .IR block-device " or " file-image
57 parameters.
58 .TP
59 .B \-V
60 Prints the version number and exits. The
61 .I mount-point
62 argument is not required with
63 .BR \-V .
64 .SH "EXAMPLES"
65
66 Understanding xfs_info output.
67 .PP
68 Suppose one has the following "xfs_info /dev/sda" output:
69 .PP
70 .RS 2
71 .Vb
72 \&meta-data=/dev/pmem0 isize=512 agcount=8, agsize=5974144 blks
73 \& = sectsz=512 attr=2, projid32bit=1
74 \& = crc=1 finobt=1, sparse=1, rmapbt=1
75 \& = reflink=1
76 \&data = bsize=4096 blocks=47793152, imaxpct=25
77 \& = sunit=32 swidth=128 blks
78 \&naming =version 2 bsize=4096 ascii-ci=0, ftype=1
79 \&log =internal log bsize=4096 blocks=23336, version=2
80 \& = sectsz=512 sunit=0 blks, lazy-count=1
81 \&realtime =none extsz=4096 blocks=0, rtextents=0
82 .Ve
83 .RE
84 .PP
85
86 Here, the data section of the output indicates "bsize=4096",
87 meaning the data block size for this filesystem is 4096 bytes.
88 This section also shows "sunit=32 swidth=128 blks", which means
89 the stripe unit is 32*4096 bytes = 128 kibibytes and the stripe
90 width is 128*4096 bytes = 512 kibibytes.
91 A single stripe of this filesystem therefore consists
92 of four stripe units (128 blocks / 32 blocks per unit).
93 .SH SEE ALSO
94 .BR mkfs.xfs (8),
95 .BR md (4),
96 .BR lvm (8),
97 .BR mount (8).