Hi all,
enclose you can find a proposal for a man page of the mkfs.btrfs. If you think
that it is usefoul I will improve it on the basis of your suggestions.
As side note, I suggest also to update the help message of the mkfs.btrf help:
"-n --nodesize size of btree leaves" should be "-n --nodesize
size of btree
nodes".
BR
Goffredo
$ ./mkfs.btrfs
usage: mkfs.btrfs [options] dev [ dev ... ]
options:
-b --byte-count total number of bytes in the FS
-l --leafsize size of btree leaves
-n --nodesize size of btree leaves
-s --sectorsize min block allocation
Btrfs v0.16+da35ab2b0b54
BR
Goffredo
$ man -Tutf8 ./mkfs.btrfs.8
MKFS.BTRFS(8) MKFS.BTRFS(8)
NAME
mkfs.btrfs - create a btrfs file system
SYNOPSIS
mkfs.btrfs [ -A|--alloc-start=start-alloc ] [ -d|--data=data-profile ]
[ -l|--leafsize=btree-leaves-size ] [ -L|--label=volume-label ] [
-m|--metadatametadata-profile ] [ -n|--nodesize=node-size ] [ -s|--sec‐
torsize=sector-size ] [ -b|--byte-count=filesystem-size ] device [
device... ]
DESCRIPTION
mkfs.btrfs is used to create a btrfs file system on a device (usually a
disk partition). device is the special file corresponding to the
device (e.g /dev/hdXX).
OPTIONS
-A, --alloc-start=start-alloc
TBD.
-d, --data=data-profile
mkfs.btrfs will accept more than one device on the command line.
This option controls the raid configuration for data. Valid
choices are raid0, raid1, raid10 and single. Single means that
no duplication of metadata is done, which may be desired when
using hardware raid. Raid10 requires at least 4 devices.
-l, --leafsize=btree-leaves-size
Size of btree leaves. A size suffix of K or k for kilobytes, M
or m for megabytes, G or g for gigabytes is optional. Default
unit is byte.
-L, --label=volume-name
Sets the volume name (label) of the file system. The volume
name can be up to 256 characters long. The characters ’\’ and
’/’ aren’t valid. The default is no label.
-m, --metadata=metadata-profile
mkfs.btrfs will accept more than one device on the command line.
This option controls the raid configuration for metadata. Valid
choices are raid0, raid1, raid10 and single. Single means that
no duplication of metadata is done, which may be desired when
using hardware raid. Raid10 requires at least 4 devices.
-n, --nodesize=btree-nodes-size
Size of btree nodes. A size suffix of K or k for kilobytes, M
or m for megabytes, G or g for gigabytes is optional. Default
unit is byte.
-s, --sectorsize=sector-size
Size of the sector. A size suffix of K or k for kilobytes, M or
m for megabytes, G or g for gigabytes is optional. Default unit
is byte.
-b, --byte-contfilesystem-size
Size of the filesystem. A size suffix of K or k for kilobytes,
M or m for megabytes, G or g for gigabytes is optional. Default
unit is byte.
BUGS
May be.
AUTHOR
Chris Mason <chris.mason <at> oracle.com>
SEE ALSO
btrfsctl(8), btrfsck(8), btrf-show(8), btrf-vol(8), mkfs(8)
Version 0.1 20 Aug 2008 MKFS.BTRFS(8)
--
gpg key Goffredo Baroncelli (ghigo) <kreijack_AT_inwind_DOT_it>
Key fingerprint = CE3C 7E01 6782 30A3 5B87 87C0 BB86 505C 6B2A CFF9
diff -r da35ab2b0b54 mkfs.btrfs.8
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/mkfs.btrfs.8 Mon Aug 25 18:59:21 2008 +0200
@@ -0,0 +1,111 @@
+.\" -*- nroff -*-
+.TH MKFS.BTRFS 8 "20 Aug 2008" "Version 0.1"
+.SH NAME
+.B mkfs.btrfs
+\- create a btrfs file system
+.SH SYNOPSIS
+.B mkfs.btrfs
+[
+.BI \-A|--alloc-start= "start-alloc"
+]
+[
+.BI \-d|--data= "data-profile"
+]
+[
+.BI \-l|--leafsize= "btree-leaves-size"
+]
+[
+.BI \-L|--label= "volume-label"
+]
+[
+.BI \-m|--metadata "metadata-profile"
+]
+[
+.BI \-n|--nodesize= "node-size"
+]
+[
+.BI \-s|--sectorsize= "sector-size"
+]
+[
+.BI \-b|--byte-count= "filesystem-size"
+]
+.I device
+[
+.I device...
+]
+.SH DESCRIPTION
+.B mkfs.btrfs
+is used to create a btrfs file system on a device (usually
+a disk partition).
+.I device
+is the special file corresponding to the device (e.g /dev/hdXX).
+.SH OPTIONS
+.TP
+.BI \-A,\ --alloc-start= "start-alloc "
+TBD.
+.TP
+.BI \-d,\ --data= "data-profile"
+.B mkfs.btrfs
+will accept more than one device on the command line.
+This option controls the raid configuration for data.
+Valid choices are
+.B raid0,
+.B raid1,
+.B raid10
+and
+.B single.
+Single means that no duplication of metadata is done, which may be
+desired when using hardware raid.
+.B Raid10
+requires at least 4 devices.
+
+.TP
+.BI \-l,\ --leafsize= "btree-leaves-size"
+Size of btree leaves.
+A size suffix of K or k for kilobytes, M or m for megabytes, G or g for
+gigabytes is optional. Default unit is byte.
+.TP
+.BI \-L,\ --label= "volume-name"
+Sets the volume name (label) of the file system. The volume name can
+be up to 256 characters long. The characters ''\\'' and
''/'' aren''t valid.
+The default is no label.
+.TP
+.BI \-m,\ --metadata= "metadata-profile"
+.B mkfs.btrfs
+will accept more than one device on the command line.
+This option controls the raid configuration for metadata.
+Valid choices are
+.B raid0,
+.B raid1,
+.B raid10
+and
+.B single.
+Single means that no duplication of metadata is done, which may be
+desired when using hardware raid.
+.B Raid10
+requires at least 4 devices.
+.TP
+.BI \-n,\ --nodesize= "btree-nodes-size"
+Size of btree nodes.
+A size suffix of K or k for kilobytes, M or m for megabytes, G or g for
+gigabytes is optional. Default unit is byte.
+.TP
+.BI \-s,\ --sectorsize= "sector-size"
+Size of the sector.
+A size suffix of K or k for kilobytes, M or m for megabytes, G or g for
+gigabytes is optional. Default unit is byte.
+.TP
+.BI \-b,\ --byte-cont "filesystem-size"
+Size of the filesystem.
+A size suffix of K or k for kilobytes, M or m for megabytes, G or g for
+gigabytes is optional. Default unit is byte.
+.SH BUGS
+May be.
+.SH AUTHOR
+Chris Mason <chris.mason <at> oracle.com>
+.SH SEE ALSO
+.BR btrfsctl (8),
+.BR btrfsck (8),
+.BR btrf-show (8),
+.BR btrf-vol (8),
+.BR mkfs (8)