* [PATCH 0/2] btrfs: a new tool to manage a btrfs filesystem
@ 2010-02-12 19:01 Goffredo Baroncelli
2010-02-12 19:32 ` Mike Fedyk
2010-08-29 18:38 ` btrfs-progs: error in manage Andreas Philipp
0 siblings, 2 replies; 3+ messages in thread
From: Goffredo Baroncelli @ 2010-02-12 19:01 UTC (permalink / raw)
To: linux-btrfs, Chris Mason
Hi all,
enclosed in the next two emails you can find two patches which introduc=
e a new program called=20
"btrfs". This program has the ambitious to replace the utilities of the=
btrfs-prog package, like:
- btrfsctl
- btrfs-show
- btrfs-volume
- btrfs
The goals are:
- improve the usability of the tools=20
- add a man page which documents all the commands
- correct the btrfsctl return codes
I put a lot of attentions in order to avoid regression respect the old =
tools.
A clone of my git repository is available at
http://cassiopea.homelinux.net/git/btrfs-command.git
Comments are welcome.
BR
Goffredo
---
Example of use:
$ ./btrfs
ERROR: no command passed
Usage:
btrfs snapshot|-s <source> [<dest>/]<name>
Create a writeble snapshot of the subvolume
<source> with the name <name> in the <dest>
directory.
btrfs delete|-D <subvolume>
Delete the subvolume <subvolume>.
btrfs create|-S [<dest>/]<name>
Create a subvolume in <dest> (or the current directory =
if not
passed.
btrfs defrag|-d <file>|<dir> [<file>|<dir>...]
Defragment a file or a directory.
btrfs fssync|-c <path>
Force a fs sync on the filesystem <path>
btrfs resize|-r [+/-]<newsize>[gkm]|max <filesystem>
Resize the file system. If 'max' is passed, the filesys=
tem
will occupe all available space on the device.
btrfs scan|-a [<device> [<device>..]
Scan all device for or the passed device for a
btrfs filesystem.
btrfs show|-l <dev>|<label> [<dev>|<label>...]
Show the btrfs devices
btrfs balance|-b <path>
Balance the chunk across the device
btrfs add-dev|-A <dev> [<dev>..] <path>
Add a device to a filesystem
btrfs rem-dev|-R <dev> [<dev>..] <path>
Remove a device to a filesystem
btrfs help|--help|-h
Show the help.
Btrfs v0.19-5-ge9e04d6-dirty
$ man btrfs | cat
BTRFS(8) btrfs B=
TRFS(8)
NAME
btrfs - control a btrfs filesystem
SYNOPSIS
btrfs snapshot|-s <source> [<dest>/]<name>
btrfs delete|-D <subvolume>
btrfs create|-S [<dest>/]<name>
btrfs defrag|-d <file>|<dir> [<file>|<dir>...]
btrfs fssync|-c <path>
btrfs resize|-r [+/-]<size>[gkm]|max <filesystem>
btrfs scan|-a [<device> [<device>..]]
btrfs show|-l <dev>|<label> [<dev>|<label>...]
btrfs balance|-b <path>
btrfs add-dev|-A <dev> [<dev>..] <path>
btrfs rm-dev|-R <dev> [<dev>..] <path> ]
btrfs help|--help|-h
DESCRIPTION
btrfs is used to control the filesystem and the files and dire=
ctories
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, t=
o flush
the dato to the disk, to resize a filesystem, to scan the devive=
=20
OPTIONS
snapshot|-s <source> [<dest>/]<name>
Create a writeble snapshot of the subvolume <source> wi=
th the
name <name> in the <dest> directory. If <source> is not=
a sub=E2=80=90
volume, btrfs returns an error. =
=20
delete|-D <subvolume>
Delete the subvolume <subvolume>. If <subvolume> is not =
a sub=E2=80=90
volume, btrfs returns an error. =
=20
create|-S [<dest>/]<name>
Create a subvolume in <dest> (or in the current direc=
tory if
<dest> is not passed). =
=20
defrag|-d <file>|<dir> [<file>|<dir>...]
Defragment files and/or directories.
scan|-a [<device> [<device>..]]
Scan devices for a btrfs filesystem. If no devices are =
passed,
btrfs scans all the block devices. =
=20
fssync|-c <path>
Force a sync for the filesystem identified by <path>.
resize|-r [+/-]<size>[gkm]|max <filesystem>
Resize a file system indentified by <path>. The <size> =
parame=E2=80=90
ter specifies the new size of the filesystem. If the pr=
efix +
or - is present the size is increased or decreased by th=
e quan=E2=80=90
tity <size>. If no units are specified, the unit of the =
<size>
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, respecti=
vely. =20
If 'max' is passed, the filesystem will occupe all av=
ailable
space on the volume(s). =
=20
The resize command does not manipulate the size of und=
erlying
partitions. If you wish to enlarge/reduce a filesyst=
em, you
must make sure you can expand/reduce the size of the pa=
rtition
also. =
=20
show|-l [<dev>|<label>...]
Show the btrfs devices with some additional info. If no =
devices
or labels are passed, btrfs scans all the block devices. =
=20
balance|-b <path>
Balance the chunk of the filesystem identified by <path> =
across
the devices. =
=20
add-dev|-A <dev> [<dev>..] <path>
Add device(s) to the filesystem identified by <path>.
rm-dev|-R <dev> [<dev>..] <path>
Remove device(s) to the filesystem identified by <path>.
EXIT STATUS
btrf returns a zero exist status if it succeeds. Non zero is r=
eturned
in case of failure.
AVAILABILITY
btrfs is part of btrfs-progs. Btrfs filesystem is currently unde=
r heavy
development, and not suitable for any uses other than benchmark=
ing and
review. Please refer to the btrfs wiki http://btrfs.wiki.ker=
nel.org
for further details.
SEE ALSO
mkfs.btrfs(8)
btrfs B=
TRFS(8)
--=20
gpg key@ keyserver.linux.it: Goffredo Baroncelli (ghigo) <kreijackATinw=
ind.it>
Key fingerprint =3D 4769 7E51 5293 D36C 814E C054 BF04 F161 3DC5 0512
--
To unsubscribe from this list: send the line "unsubscribe linux-btrfs" =
in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [PATCH 0/2] btrfs: a new tool to manage a btrfs filesystem
2010-02-12 19:01 [PATCH 0/2] btrfs: a new tool to manage a btrfs filesystem Goffredo Baroncelli
@ 2010-02-12 19:32 ` Mike Fedyk
2010-08-29 18:38 ` btrfs-progs: error in manage Andreas Philipp
1 sibling, 0 replies; 3+ messages in thread
From: Mike Fedyk @ 2010-02-12 19:32 UTC (permalink / raw)
To: Goffredo Baroncelli; +Cc: linux-btrfs, Chris Mason
On Fri, Feb 12, 2010 at 11:01 AM, Goffredo Baroncelli
<kreijack@gmail.com> wrote:
> Usage:
> =C2=A0 =C2=A0 =C2=A0 =C2=A0btrfs delete|-D <subvolume>
> =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0Delete the sub=
volume <subvolume>.
> =C2=A0 =C2=A0 =C2=A0 =C2=A0btrfs defrag|-d <file>|<dir> [<file>|<dir>=
=2E..]
> =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0Defragment a f=
ile or a directory.
I think the short options should be removed or else you'll still have
the easy misuses of btrfs -d and btrfs -D.
The best example would be the "ip" command which has commands and
-[a-z] options that do different types of things. for instance, all
of the short options are applicable to all commands and change the
verbosity or format of the output.
--
To unsubscribe from this list: send the line "unsubscribe linux-btrfs" =
in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 3+ messages in thread
* btrfs-progs: error in manage
2010-02-12 19:01 [PATCH 0/2] btrfs: a new tool to manage a btrfs filesystem Goffredo Baroncelli
2010-02-12 19:32 ` Mike Fedyk
@ 2010-08-29 18:38 ` Andreas Philipp
1 sibling, 0 replies; 3+ messages in thread
From: Andreas Philipp @ 2010-08-29 18:38 UTC (permalink / raw)
To: Goffredo Baroncelli; +Cc: linux-btrfs
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Hi,
On the man page for the btrfs command balance is listed as a
subcommand under device instead of file system.
Kind Regards,
Andreas
diff --git a/man/btrfs.8.in b/man/btrfs.8.in
index 26ef982..bd73dc0 100644
- --- a/man/btrfs.8.in
+++ b/man/btrfs.8.in
@@ -21,12 +21,12 @@ btrfs \- control a btrfs filesystem
.PP
\fBbtrfs\fP \fBfilesystem resize\fP\fI [+/\-]<size>[gkm]|max
<filesystem>\fP
.PP
+\fBbtrfs\fP \fBfilesystem balance\fP\fI <path> \fP
+.PP
\fBbtrfs\fP \fBdevice scan\fP\fI [<device> [<device>..]]\fP
.PP
\fBbtrfs\fP \fBdevice show\fP\fI <dev>|<label> [<dev>|<label>...]\fP
.PP
- -\fBbtrfs\fP \fBdevice balance\fP\fI <path> \fP
- -.PP
\fBbtrfs\fP \fBdevice add\fP\fI <dev> [<dev>..] <path> \fP
.PP
\fBbtrfs\fP \fBdevice delete\fP\fI <dev> [<dev>..] <path> \fP]
@@ -143,7 +143,7 @@ Show the btrfs filesystem with some additional
info. If no UUID or label is
passed, \fBbtrfs\fR show info of all the btrfs filesystem.
.TP
- -\fBdevice balance\fR \fI<path>\fR
+\fBfilesystem balance\fR \fI<path>\fR
Balance the chunks of the filesystem identified by \fI<path>\fR
across the devices.
.TP
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (MingW32)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
iQIcBAEBAgAGBQJMeqkcAAoJEJIcBJ3+XkgiRmcP/1RlZw+aJeVwAdhXzrYpoEY5
g7YFjH+o8RnC8sXnb35lDQq/uQ0Kk5VWkNOfhN+G9ZCMcEkA9uRP7rgUTc9OjRmL
0rTOytD/PsPCV8nhy5vJ5krO8lzQA9ChX3BOwmVXumfdl1SMSPjaw/Cp/AK3IP3K
6fCTefT7A5tOSFvTa5b4AdNj+mIn60MwF7d8on0J7OJgzhdw4ZIoQNApJ3hnldYE
kUAbfthO4jlvibEWG+wk5FEeGxkTKthZK5y/4R5PdnutWwY9f0XG5WQsJuPS7qB6
Tzz+EtxRSmTwsDJxt8RKr4k8NH+UOlZQg9VcNvdTAJaP6wkrZi39uRL7zH6bIjfh
9D+Fty2zzvMsXVORrdfL35wHKcx1xH491msn5U925ej9OU9j/tV/rYr/wSDMG3AW
GILKKzuT+9Xsgs5cYpG2ENdIeDI1kEoa/ZdYIyxSSEuo9DXb8+BsOces2kr+a1Fl
NSPIm7vQaIxcY09H9sexyEWz1IC2GnKLbMz8AuOkbNEpxbIYcuPgTdnPZrRY7xbW
K//hf3uDxkxxQ44/24hgK9o9DkVDS37nzHN7mtoGTyvDg1o4RksnFwQGZluAfShi
vfBulYqGkH50HWO25t66XholaQ1WSs4MuUb47/wNO5AocbeAezJB3WvZ+I9zLkWS
kZxFmJKvHkHwj34FxxXb
=OxAs
-----END PGP SIGNATURE-----
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2010-08-29 18:38 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2010-02-12 19:01 [PATCH 0/2] btrfs: a new tool to manage a btrfs filesystem Goffredo Baroncelli
2010-02-12 19:32 ` Mike Fedyk
2010-08-29 18:38 ` btrfs-progs: error in manage Andreas Philipp
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).