Development of userspace BTRFS tools
Find a file
Goffredo Baroncelli 002d021c5f Deprecate btrfsctl, btrfs-show, btrfs-vol
Hi all,

the patch below deprecates the following programs

* btrfsctl
* btrfs-vol
* btrfs-show

the reason is simple, these programs are superseded by the btrfs utility,
both in terms of documentation, usability and bug. The goal is to avoid
to duplicate codes and avoid update two programs.

The patch adds a warning in the man pages, in the INSTALL file and in the
programs.

$ ./btrfsctl
**
** WARNING: this program is considered deprecated
** Please consider to switch to the btrfs utility
**
no valid commands given
usage: btrfsctl [ -d file|dir] [ -s snap_name subvol|tree ]
                [-r size] [-A device] [-a] [-c] [-D dir .]
        -d filename: defragments one file
        -d directory: defragments the entire Btree
        -s snap_name dir: creates a new snapshot of dir
        -S subvol_name dir: creates a new subvolume
        -r [+-]size[gkm]: resize the FS by size amount
        -A device: scans the device file for a Btrfs filesystem
        -a: scans all devices for Btrfs filesystems
        -c: forces a single FS sync
        -D: delete snapshot
        -m [tree id] directory: set the default mounted subvolume to the [tree
id] or the
directory

Below the patch, but it is possible to pull the changes from:

 	http://cassiopea.homelinux.net/git/btrfs-progs-unstable.git

branch

	btrfs-deprecated

Comments are welcome.

G.Baroncelli

 INSTALL             |    5 +++++
 btrfs-show.c        |    5 +++++
 btrfs-vol.c         |    5 +++++
 btrfsctl.c          |    5 +++++
 man/btrfs-show.8.in |    3 +++
 man/btrfsctl.8.in   |    3 +++
 6 files changed, 26 insertions(+), 0 deletions(-)

the tool to create a new snapshot for the filesystem.

Signed-off-by: Chris Mason <chris.mason@oracle.com>
2011-10-25 09:18:31 -04:00
man Deprecate btrfsctl, btrfs-show, btrfs-vol 2011-10-25 09:18:31 -04:00
.hgignore Add .hgignore file to ignore verison.h 2008-07-23 11:36:13 -04:00
.hgtags Added tag v0.16 for changeset 2b26e4f8c71e 2008-08-04 15:46:36 -04:00
bcp bcp updates for single file copies 2008-05-02 16:12:02 -04:00
bit-radix.c Make btrfs-progs compile with -fstrict-aliasing (included in -O2) again. 2007-09-14 10:31:06 -04:00
bit-radix.h add GPLv2 2007-06-12 09:07:11 -04:00
btrfs-defrag.c new util: 'btrfs' 2010-03-11 13:45:47 -05:00
btrfs-image.c Mixed back reference (FORWARD ROLLING FORMAT CHANGE) 2009-06-08 13:30:36 -04:00
btrfs-list.c Improve error handling in the btrfs command 2011-10-25 09:18:31 -04:00
btrfs-map-logical.c Fix the help text for btrfs-map-logical 2011-04-22 14:52:28 -04:00
btrfs-select-super.c Btrfs-progs: add a btrfs-select-super command to overwrite the super 2011-10-25 09:18:31 -04:00
btrfs-show.c Deprecate btrfsctl, btrfs-show, btrfs-vol 2011-10-25 09:18:31 -04:00
btrfs-vol.c Deprecate btrfsctl, btrfs-show, btrfs-vol 2011-10-25 09:18:31 -04:00
btrfs-zero-log.c Add rescue command to zero the log 2010-10-05 10:14:48 -04:00
btrfs.c Update/clean up btrfs help and man page V2 2011-10-25 09:18:31 -04:00
btrfs_cmds.c Update for lzo support 2011-10-25 09:18:31 -04:00
btrfs_cmds.h Add btrfs subvol find-new command 2010-03-18 12:32:32 -04:00
btrfsck.c Add btrfsck option to select the super block copy 2010-10-04 15:41:10 -04:00
btrfsctl.c Deprecate btrfsctl, btrfs-show, btrfs-vol 2011-10-25 09:18:31 -04:00
btrfstune.c update btrfs-progs for seed device support 2008-11-18 10:40:06 -05:00
convert.c Btrfs-progs use safe string manipulation functions 2011-10-25 09:18:31 -04:00
COPYING fix COPYING 2007-06-12 15:41:08 -04:00
crc32c.c CRC32C big endian bugs... 2008-02-15 11:20:02 -05:00
crc32c.h Mixed back reference (FORWARD ROLLING FORMAT CHANGE) 2009-06-08 13:30:36 -04:00
ctree.c Update converter for the new format 2009-06-08 13:31:10 -04:00
ctree.h Update for lzo support 2011-10-25 09:18:31 -04:00
debug-tree.c btrfs-debug-tree: add -d option to print only the device mapping 2010-10-06 09:53:38 -04:00
dir-item.c Btrfs: update converter for the new disk format 2008-12-17 16:10:07 -05:00
dir-test.c Btrfs: add btrfs-debug-tree -b <block number> to print a single block 2010-04-06 09:30:17 -04:00
disk-io.c Btrfs-progs: add a btrfs-select-super command to overwrite the super 2011-10-25 09:18:31 -04:00
disk-io.h Btrfs-progs: add a btrfs-select-super command to overwrite the super 2011-10-25 09:18:31 -04:00
extent-cache.c Add support for multiple devices per filesystem 2008-03-24 15:03:18 -04:00
extent-cache.h Add semantic checks to btrfsck for files and directories 2009-01-07 14:57:12 -05:00
extent-tree.c Check for RAID10 in set_avail_alloc_bits 2011-04-22 14:52:40 -04:00
extent_io.c Mixed back reference (FORWARD ROLLING FORMAT CHANGE) 2009-06-08 13:30:36 -04:00
extent_io.h Verify parent generation number on btree reads 2008-05-13 13:48:58 -04:00
file-item.c Fix isize/nbytes update bugs in btrfs-convert 2009-01-12 12:47:06 -05:00
hash.h Switch btrfs_name_hash() to crc32c 2008-08-20 20:11:23 -04:00
hasher.c Unaligned access fixes 2008-02-15 11:19:58 -05:00
inode-item.c btrfs-progs new dir index support 2008-07-24 12:13:32 -04:00
inode-map.c btrfs-progs: Fix printf format casting errors 2008-04-01 10:52:22 -04:00
INSTALL Update/clean up btrfs help and man page V2 2011-10-25 09:18:31 -04:00
ioctl-test.c Add ioctl-test.c which just prints all the ioctl numbers. 2010-03-15 11:24:20 -04:00
ioctl.h Update for lzo support 2011-10-25 09:18:31 -04:00
kerncompat.h multidevice support for check_mounted 2010-09-23 20:26:49 -04:00
list.h Dynamic chunk allocation 2008-03-24 15:03:58 -04:00
Makefile Btrfs-progs: add a btrfs-select-super command to overwrite the super 2011-10-25 09:18:31 -04:00
mkfs.c Btrfs-progs: add support for mixed data+metadata block groups 2011-10-25 09:18:31 -04:00
print-tree.c only print FIRST_CHUNK_TREE for chunk items in debug-tree 2010-09-23 20:26:49 -04:00
print-tree.h Btrfs: add btrfs-debug-tree -b <block number> to print a single block 2010-04-06 09:30:17 -04:00
quick-test.c Btrfs: add btrfs-debug-tree -b <block number> to print a single block 2010-04-06 09:30:17 -04:00
radix-tree.c Make btrfs-progs compile with -fstrict-aliasing (included in -O2) again. 2007-09-14 10:31:06 -04:00
radix-tree.h i386 fixes from axboe 2007-06-12 11:39:09 -04:00
random-test.c Btrfs: add btrfs-debug-tree -b <block number> to print a single block 2010-04-06 09:30:17 -04:00
rbtree.c Stop using radix trees to record pending allocations 2007-10-15 16:25:04 -04:00
rbtree.h Stop using radix trees to record pending allocations 2007-10-15 16:25:04 -04:00
root-tree.c Btrfs: update converter for the new disk format 2008-12-17 16:10:07 -05:00
show-blocks Fix showblocks to display different colors for different metadata roots 2009-03-09 13:00:44 -04:00
transaction.h Update btrfs-progs to match kernel sources 2008-01-04 10:38:22 -05:00
utils.c Btrfs-progs: add support for mixed data+metadata block groups 2011-10-25 09:18:31 -04:00
utils.h Btrfs-progs: add support for mixed data+metadata block groups 2011-10-25 09:18:31 -04:00
version.sh btrfs-progs v0.19 2009-06-11 12:56:15 -04:00
volumes.c Fill missing devices so degraded filesystems can be read 2011-04-22 14:52:40 -04:00
volumes.h superblock duplication 2008-12-05 12:21:31 -05:00