btrfs-progs/man/btrfsctl.8.in

46 lines
1.5 KiB
Groff
Raw Normal View History

.TH BTRFSCTL 8
.SH NAME
btrfsctl \- control a btrfs filesystem
.SH SYNOPSIS
.B btrfsctl
[ \fB\-d\fP\fI file|directory \fP ]
[ \fB\-s\fP\fI snapshot-name directory\fP ]
[ \fB \-S\fP\fI subvolume-name directory\fP ]
[ \fB \-r\fP\fI [+-]size\fP ]
[ \fB \-A\fP\fI device\fP ]
[ \fB \-a\fP ]
[ \fB \-c\fP ]
.SH DESCRIPTION
.B btrfsctl
is used to control the filesystem and the files and directories stored. It is the tool to create a new snapshot for the filesystem.
.SH OPTIONS
.TP
\fB\-d\fR \fIfile|directory\fR
Defragment a file or a directory. If the argument is a directory, the entire b-tree under the directory is defragged.
.TP
\fB\-s\fR \fIsnapshot-name directory\fR
Creates a new \fIsnapshot\fP of the \fIdirectory\fP specified.
.TP
\fB\-S\fR \fIsubvolume-name directory\fR
Creates a new subvolume.
.TP
\fB\-r\fR \fI[+|-]size\fR
Resizes the filesystem with the \fIsize\fP specified. If the value is preceded with a signed symbol, the filesystem is resized with respect to the current filesystem size. \fIsize\fP can be suffixed by k,m or g to represent kilobytes, megabytes, or gigabytes respectively.
.TP
\fB\-A\fR \fIdevice\fR
Scans the \fIdevice\fR for btrfs filesystem.
.TP
\fB\-a\fR
Scans all devices present in the system for btrfs filesystem.
.TP
\fB\-c\fR
Forces a filesystem sync.
.SH AVAILABILITY
.B btrfsctl
is part of btrfs-progs. Btrfs is currently under heavy development,
and not suitable for 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)