man/btrfsctl.8.in

   1 .TH BTRFSCTL 8
   2 .SH NAME
   3 btrfsctl \- control a btrfs filesystem
   4 .SH SYNOPSIS
   5 .B btrfsctl
   6 [ \fB\-d\fP\fI file|directory \fP ]
   7 [ \fB\-s\fP\fI snapshot-name directory\fP ]
   8 [ \fB \-S\fP\fI subvolume-name directory\fP ]
   9 [ \fB \-r\fP\fI [+-]size\fP ]
  10 [ \fB \-A\fP\fI device\fP ]
  11 [ \fB \-a\fP ]
  12 [ \fB \-c\fP ]
  13 .SH DESCRIPTION
  14 .B btrfsctl
  15 is used to control the filesystem and the files and directories stored. It is the tool to create a new snapshot for the filesystem.
  16 .SH OPTIONS
  17 .TP
  18 \fB\-d\fR \fIfile|directory\fR
  19 Defragment a file or a directory. If the argument is a directory, the entire b-tree under the directory is defragged.
  20 .TP
  21 \fB\-s\fR \fIsnapshot-name directory\fR
  22 Creates a new \fIsnapshot\fP of the \fIdirectory\fP specified.
  23 .TP
  24 \fB\-S\fR \fIsubvolume-name directory\fR
  25 Creates a new subvolume.
  26 .TP
  27 \fB\-r\fR \fI[+|-]size\fR
  28 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.
  29 .TP
  30 \fB\-A\fR \fIdevice\fR
  31 Scans the \fIdevice\fR for btrfs filesystem.
  32 .TP
  33 \fB\-a\fR
  34 Scans all devices present in the system for btrfs filesystem.
  35 .TP
  36 \fB\-c\fR
  37 Forces a filesystem sync.
  38 .SH AVAILABILITY
  39 .B btrfsctl
  40 is part of btrfs-progs. Btrfs is currently under heavy development,
  41 and not suitable for any uses other than benchmarking and review.
  42 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
  43 further details.
  44 .SH SEE ALSO
  45 .BR mkfs.btrfs (8)