Hi Geffredo, On Fri, Feb 12, 2010 at 7:01 PM, Goffredo Baroncelli <kreijack@xxxxxxxxx> wrote: > This is the man page of the btrfs command. > > diff --git a/man/Makefile b/man/Makefile > index 4e8893b..4a90b75 100644 > --- a/man/Makefile > +++ b/man/Makefile > @@ -7,13 +7,16 @@ mandir = $(prefix)/man > man8dir = $(mandir)/man8 > > MANPAGES = mkfs.btrfs.8.gz btrfsctl.8.gz btrfsck.8.gz btrfs-image.8.gz \ > - btrfs-show.8.gz > + btrfs-show.8.gz btrfs.8.gz > > all: $(MANPAGES) > > mkfs.btrfs.8.gz: mkfs.btrfs.8.in > $(GZIP) -n -c mkfs.btrfs.8.in > mkfs.btrfs.8.gz > > +btrfs.8.gz: btrfs.8.in > + $(GZIP) -n -c btrfs.8.in > btrfs.8.gz > + > btrfsctl.8.gz: btrfsctl.8.in > $(GZIP) -n -c btrfsctl.8.in > btrfsctl.8.gz > > diff --git a/man/btrfs.8.in b/man/btrfs.8.in > new file mode 100644 > index 0000000..354faf9 > --- /dev/null > +++ b/man/btrfs.8.in > @@ -0,0 +1,122 @@ > +.TH BTRFS 8 "" "btrfs" "btrfs" > +.\" > +.\" Man page writte by Goffredo Baroncelli <kreijack@xxxxxxxxx> (Feb 2010) > +.\" > +.SH NAME > +btrfs \- control a btrfs filesystem > +.SH SYNOPSIS > +\fBbtrfs\fP \fB snapshot|\-s \fP\fI <source> [<dest>/]<name>\fP > +.PP > +\fBbtrfs\fP \fB delete|\-D \fP\fI <subvolume>\fP > +.PP > +\fBbtrfs\fP \fB create|\-S \fP\fI [<dest>/]<name>\fP > +.PP > +\fBbtrfs\fP \fB defrag|\-d \fP\fI <file>|<dir> [<file>|<dir>...]\fP > +.PP > +\fBbtrfs\fP \fB fssync|\-c \fP\fI <path> \fP > +.PP > +\fBbtrfs\fP \fB resize|\-r \fP\fI [+/\-]<size>[gkm]|max <filesystem>\fP > +.PP > +\fBbtrfs\fP \fB scan|\-a \fP\fI [<device> [<device>..]]\fP > +.PP > +\fBbtrfs\fP \fB show|\-l \fP\fI <dev>|<label> [<dev>|<label>...]\fP > +.PP > +\fBbtrfs\fP \fB balance|\-b \fP\fI <path> \fP > +.PP > +\fBbtrfs\fP \fB add\-dev|\-A \fP\fI <dev> [<dev>..] <path> \fP > +.PP > +\fBbtrfs\fP \fB rm\-dev|\-R \fP\fI <dev> [<dev>..] <path> \fP] > + > +.PP > +\fBbtrfs\fP \fB help|\-\-help|\-h \fP\fI\fP > +.PP > +.SH DESCRIPTION > +.B btrfs > +is used to control the filesystem and the files and directories stored. It is > +the tool to create or destroy a new snapshot or a new subvolume for the > +filesystem, to defrag a file or a directory, to flush the dato to the disk, > +to resize a filesystem, to scan the devive > + > +.SH OPTIONS > +.TP > + > +\fBsnapshot|\-s\fR\fI <source> [<dest>/]<name>\fR > +Create a writeble snapshot of the subvolume \fI<source>\fR with the name > +\fI<name>\fR in the \fI<dest>\fR directory. If \fI<source>\fR is not a > +subvolume, \fBbtrfs\fR returns an error. > +.TP > + > +\fBdelete|\-D\fR\fI <subvolume>\fR > +Delete the subvolume \fI<subvolume>\fR. If \fI<subvolume>\fR is not a > +subvolume, \fBbtrfs\fR returns an error. > +.TP > + > +\fBcreate|\-S\fR\fI [<dest>/]<name>\fR > +Create a subvolume in \fI<dest>\fR (or in the current directory if > +\fI<dest>\fR is not passed). > +.TP > + > +\fBdefrag|\-d\fP\fI <file>|<dir> [<file>|<dir>...]\fR > +Defragment files and/or directories. > +.TP > + > +\fBscan|\-a\fR \fI[<device> [<device>..]]\fR > +Scan devices for a btrfs filesystem. If no devices are passed, \fBbtrfs\fR scans > +all the block devices. > +.TP > + > +\fBfssync|\-c\fR\fI <path> \fR > +Force a sync for the filesystem identified by \fI<path>\fR. > +.TP > + > +.\" > +.\" Some wording are extracted by the resize2fs man page > +.\" > + > +\fBresize|\-r\fR\fI [+/\-]<size>[gkm]|max <filesystem>\fR > +Resize a file system indentified by \fI<path>\fR. > +The \fI<size>\fR parameter specifies the new size of the filesystem. > +If the prefix \fI+\fR or \fI\-\fR is present the size is increased or decreased > +by the quantity \fI<size>\fR. > +If no units are specified, the unit of the \fI<size>\fR parameter is the byte. > +Optionally, the size parameter may be suffixed by one of the following the units > +designators: 'K', 'M', or 'G', kilobytes, megabytes, or gigabytes, respectively. > + > +If 'max' is passed, the filesystem will occupe all available space on the > +volume(s). > + > +The \fBresize\fR command \fBdoes not\fR manipulate the size of underlying > +partitions. If you wish to enlarge/reduce a filesystem, you must make sure you > +can expand/reduce the size of the partition also. > +.TP > + > +\fBshow|\-l\fR [<dev>|<label>...]\fR > +Show the btrfs devices with some additional info. If no devices or labels are > +passed, \fBbtrfs\fR scans all the block devices. > +.TP > + > +\fBbalance|\-b\fR \fI<path>\fR > +Balance the chunk of the filesystem identified by \fI<path>\fR > +across the devices. > +.TP > + > +\fBadd\-dev|\-A \fR\fI <dev> [<dev>..] <path>\fR > +Add device(s) to the filesystem identified by \fI<path>\fR. > +.TP > + > +\fBrm\-dev|\-R \fR\fI <dev> [<dev>..] <path>\fR > +Remove device(s) to the filesystem identified by \fI<path>\fR. > +.PP > + > +.SH EXIT STATUS > +\fBbtrf\fR returns a zero exist status if it succeeds. Non zero is returned in > +case of failure. > + > +.SH AVAILABILITY > +.B btrfs > +is part of btrfs-progs. Btrfs filesystem is currently under heavy development, > +and not suitable for any uses other than benchmarking and review. > +Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for > +further details. > +.SH SEE ALSO > +.BR mkfs.btrfs (8) Great work. A couple of quick tweaks: "dato to the disk, to resize a filesystem, to scan the devive" -> "data to the disk, to resize the filesystem, to scan the device" "indentified by" -> "identified by" "will occupe" -> "will occupy" Thanks, Daniel -- Daniel J Blueman -- To unsubscribe from this list: send the line "unsubscribe linux-btrfs" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
