summaryrefslogtreecommitdiffstats
path: root/upstream/archlinux/man8/xfs_info.8
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/archlinux/man8/xfs_info.8')
-rw-r--r--upstream/archlinux/man8/xfs_info.897
1 files changed, 97 insertions, 0 deletions
diff --git a/upstream/archlinux/man8/xfs_info.8 b/upstream/archlinux/man8/xfs_info.8
new file mode 100644
index 00000000..429356a8
--- /dev/null
+++ b/upstream/archlinux/man8/xfs_info.8
@@ -0,0 +1,97 @@
+.\" Verbatim blocks taken from openssl req manpage content
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+
+.TH xfs_info 8
+.SH NAME
+xfs_info \- display XFS filesystem geometry information
+.SH SYNOPSIS
+.B xfs_info
+[
+.B \-t
+.I mtab
+]
+[
+.I mount-point
+|
+.I block-device
+|
+.I file-image
+]
+.br
+.B xfs_info \-V
+.SH DESCRIPTION
+.B xfs_info
+displays geometry information about an existing XFS filesystem.
+The
+.I mount-point
+argument is the pathname of a directory where the filesystem
+is mounted.
+The
+.I block-device
+or
+.I file-image
+contain a raw XFS filesystem.
+The existing contents of the filesystem are undisturbed.
+.SH OPTIONS
+.TP
+.B \-t
+Specifies an alternate mount table file (default is
+.I /proc/mounts
+if it exists, else
+.IR /etc/mtab ).
+This is used when working with filesystems mounted without writing to
+.I /etc/mtab
+file - refer to
+.BR mount (8)
+for further details.
+This option has no effect with the
+.IR block-device " or " file-image
+parameters.
+.TP
+.B \-V
+Prints the version number and exits. The
+.I mount-point
+argument is not required with
+.BR \-V .
+.SH "EXAMPLES"
+
+Understanding xfs_info output.
+.PP
+Suppose one has the following "xfs_info /dev/sda" output:
+.PP
+.RS 2
+.Vb
+\&meta-data=/dev/pmem0 isize=512 agcount=8, agsize=5974144 blks
+\& = sectsz=512 attr=2, projid32bit=1
+\& = crc=1 finobt=1, sparse=1, rmapbt=1
+\& = reflink=1
+\&data = bsize=4096 blocks=47793152, imaxpct=25
+\& = sunit=32 swidth=128 blks
+\&naming =version 2 bsize=4096 ascii-ci=0, ftype=1
+\&log =internal log bsize=4096 blocks=23336, version=2
+\& = sectsz=512 sunit=0 blks, lazy-count=1
+\&realtime =none extsz=4096 blocks=0, rtextents=0
+.Ve
+.RE
+.PP
+
+Here, the data section of the output indicates "bsize=4096",
+meaning the data block size for this filesystem is 4096 bytes.
+This section also shows "sunit=32 swidth=128 blks", which means
+the stripe unit is 32*4096 bytes = 128 kibibytes and the stripe
+width is 128*4096 bytes = 512 kibibytes.
+A single stripe of this filesystem therefore consists
+of four stripe units (128 blocks / 32 blocks per unit).
+.SH SEE ALSO
+.BR mkfs.xfs (8),
+.BR md (4),
+.BR lvm (8),
+.BR mount (8).