marko10_000
/
btrfs-progs
forked from Mirrors/btrfs-progs
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

btrfs-progs: Update the usage strings of some cmds 

Update the usage strings of some cmds to keep the them consistent with
the source.

Also some minor changes are done to fit the man page syntax.

Signed-off-by: Qu Wenruo <quwenruo@cn.fujitsu.com>
Signed-off-by: David Sterba <dsterba@suse.cz>
Signed-off-by: Chris Mason <chris.mason@fusionio.com>
master
Qu Wenruo 2013-07-23 10:43:21 +08:00 committed by David Sterba
parent 2b2201bd09
commit 3ca706a6ee
9 changed files with 30 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
btrfs.c
View File

@ -188,7 +188,7 @@ const struct cmd_group btrfs_cmd_group;
static const char * const cmd_help_usage[] = { static const char * const cmd_help_usage[] = {
"btrfs help [--full]", "btrfs help [--full]",
"Dislay help information", "Display help information",
"", "",
"--full display detailed help on every command", "--full display detailed help on every command",
NULL NULL

2
cmds-chunk.c
View File

@ -1780,7 +1780,7 @@ fail_rc:
const char * const cmd_chunk_recover_usage[] = { const char * const cmd_chunk_recover_usage[] = {
"btrfs chunk-recover [options] <device>", "btrfs chunk-recover [options] <device>",
"Recover the chunk tree by scaning the devices one by one.", "Recover the chunk tree by scanning the devices one by one.",
"", "",
"-y Assume an answer of `yes' to all questions", "-y Assume an answer of `yes' to all questions",
"-v Verbose mode", "-v Verbose mode",

2
cmds-filesystem.c
View File

@ -485,7 +485,7 @@ static int cmd_resize(int argc, char **argv)
} }
static const char * const cmd_label_usage[] = { static const char * const cmd_label_usage[] = {
"btrfs filesystem label [<device>|<mountpoint>] [<newlabel>]", "btrfs filesystem label [<device>|<mount_point>] [<newlabel>]",
"Get or change the label of a filesystem", "Get or change the label of a filesystem",
"With one argument, get the label of filesystem on <device>.", "With one argument, get the label of filesystem on <device>.",
"If <newlabel> is passed, set the filesystem label to <newlabel>.", "If <newlabel> is passed, set the filesystem label to <newlabel>.",

2
cmds-inspect.c
View File

@ -84,6 +84,8 @@ out:
static const char * const cmd_inode_resolve_usage[] = { static const char * const cmd_inode_resolve_usage[] = {
"btrfs inspect-internal inode-resolve [-v] <inode> <path>", "btrfs inspect-internal inode-resolve [-v] <inode> <path>",
"Get file system paths for the given inode", "Get file system paths for the given inode",
"",
"-v verbose mode",
NULL NULL
}; };

22
cmds-replace.c
View File

@ -97,27 +97,27 @@ static int dev_replace_handle_sigint(int fd)
} }
static const char *const cmd_start_replace_usage[] = { static const char *const cmd_start_replace_usage[] = {
"btrfs replace start srcdev|devid targetdev [-Bfr] mount_point", "btrfs replace start [-Bfr] <srcdev>|<devid> <targetdev> <mount_point>",
"Replace device of a btrfs filesystem.", "Replace device of a btrfs filesystem.",
"On a live filesystem, duplicate the data to the target device which", "On a live filesystem, duplicate the data to the target device which",
"is currently stored on the source device. If the source device is not", "is currently stored on the source device. If the source device is not",
"available anymore, or if the -r option is set, the data is built", "available anymore, or if the -r option is set, the data is built",
"only using the RAID redundancy mechanisms. After completion of the", "only using the RAID redundancy mechanisms. After completion of the",
"operation, the source device is removed from the filesystem.", "operation, the source device is removed from the filesystem.",
"If the srcdev is a numerical value, it is assumed to be the device id", "If the <srcdev> is a numerical value, it is assumed to be the device id",
"of the filesystem which is mounted at mount_point, otherwise it is", "of the filesystem which is mounted at <mount_point>, otherwise it is",
"the path to the source device. If the source device is disconnected,", "the path to the source device. If the source device is disconnected,",
"from the system, you have to use the devid parameter format.", "from the system, you have to use the <devid> parameter format.",
"The targetdev needs to be same size or larger than the srcdev.", "The <targetdev> needs to be same size or larger than the <srcdev>.",
"", "",
"-r only read from srcdev if no other zero-defect mirror exists", "-r only read from <srcdev> if no other zero-defect mirror exists",
" (enable this if your drive has lots of read errors, the access", " (enable this if your drive has lots of read errors, the access",
" would be very slow)", " would be very slow)",
"-f force using and overwriting targetdev even if it looks like", "-f force using and overwriting <targetdev> even if it looks like",
" containing a valid btrfs filesystem. A valid filesystem is", " containing a valid btrfs filesystem. A valid filesystem is",
" assumed if a btrfs superblock is found which contains a", " assumed if a btrfs superblock is found which contains a",
" correct checksum. Devices which are currently mounted are", " correct checksum. Devices which are currently mounted are",
" never allowed to be used as the targetdev", " never allowed to be used as the <targetdev>",
"-B do not background", "-B do not background",
NULL NULL
}; };
@ -351,11 +351,11 @@ leave_with_error:
} }
static const char *const cmd_status_replace_usage[] = { static const char *const cmd_status_replace_usage[] = {
"btrfs replace status mount_point [-1]", "btrfs replace status [-1] <mount_point>",
"Print status and progress information of a running device replace", "Print status and progress information of a running device replace",
"operation", "operation",
"", "",
"-1 print once instead of print continously until the replace", "-1 print once instead of print continuously until the replace",
" operation finishes (or is canceled)", " operation finishes (or is canceled)",
NULL NULL
}; };
@ -522,7 +522,7 @@ progress2string(char *buf, size_t s, int progress_1000)
} }
static const char *const cmd_cancel_replace_usage[] = { static const char *const cmd_cancel_replace_usage[] = {
"btrfs replace cancel mount_point", "btrfs replace cancel <mount_point>",
"Cancel a running device replace operation.", "Cancel a running device replace operation.",
NULL NULL
}; };

5
cmds-restore.c
View File

@ -1098,11 +1098,12 @@ const char * const cmd_restore_usage[] = {
"-v verbose", "-v verbose",
"-i ignore errors", "-i ignore errors",
"-o overwrite", "-o overwrite",
"-t tree location", "-t <location> tree location",
"-f <offset> filesystem location", "-f <offset> filesystem location",
"-u <block> super mirror", "-u <block> super mirror",
"-r <rootid> root objectid",
"-d find dir", "-d find dir",
"-l list roots", "-l list tree roots",
"--path-regex <regex>", "--path-regex <regex>",
" restore only filenames matching regex,", " restore only filenames matching regex,",
" you have to use following syntax (possibly quoted):", " you have to use following syntax (possibly quoted):",

5
cmds-scrub.c
View File

@ -1508,13 +1508,14 @@ out:
} }
static const char * const cmd_scrub_start_usage[] = { static const char * const cmd_scrub_start_usage[] = {
"btrfs scrub start [-Bdqr] [-c ioprio_class -n ioprio_classdata] <path>|<device>", "btrfs scrub start [-BdqrR] [-c ioprio_class -n ioprio_classdata] <path>|<device>",
"Start a new scrub", "Start a new scrub",
"", "",
"-B do not background", "-B do not background",
"-d stats per device (-B only)", "-d stats per device (-B only)",
"-q be quiet", "-q be quiet",
"-r read only mode", "-r read only mode",
"-R raw print mode, print full data instead of summary"
"-c set ioprio class (see ionice(1) manpage)", "-c set ioprio class (see ionice(1) manpage)",
"-n set ioprio classdata (see ionice(1) manpage)", "-n set ioprio classdata (see ionice(1) manpage)",
NULL NULL
@ -1569,7 +1570,7 @@ out:
} }
static const char * const cmd_scrub_resume_usage[] = { static const char * const cmd_scrub_resume_usage[] = {
"btrfs scrub resume [-Bdqr] [-c ioprio_class -n ioprio_classdata] <path>|<device>", "btrfs scrub resume [-BdqrR] [-c ioprio_class -n ioprio_classdata] <path>|<device>",
"Resume previously canceled or interrupted scrub", "Resume previously canceled or interrupted scrub",
"", "",
"-B do not background", "-B do not background",

4
cmds-send.c
View File

@ -724,12 +724,12 @@ static const char * const send_cmd_group_usage[] = {
}; };
const char * const cmd_send_usage[] = { const char * const cmd_send_usage[] = {
"btrfs send [-ve] [-p <parent>] [-c <clone-src>] <subvol>", "btrfs send [-ve] [-p <parent>] [-c <clone-src>] [-f <outfile>] <subvol>",
"Send the subvolume to stdout.", "Send the subvolume to stdout.",
"Sends the subvolume specified by <subvol> to stdout.", "Sends the subvolume specified by <subvol> to stdout.",
"By default, this will send the whole subvolume. To do an incremental", "By default, this will send the whole subvolume. To do an incremental",
"send, use '-p <parent>'. If you want to allow btrfs to clone from", "send, use '-p <parent>'. If you want to allow btrfs to clone from",
"any additional local snapshots, use -c <clone-src> (multiple times", "any additional local snapshots, use '-c <clone-src>' (multiple times",
"where applicable). You must not specify clone sources unless you", "where applicable). You must not specify clone sources unless you",
"guarantee that these snapshots are exactly in the same state on both", "guarantee that these snapshots are exactly in the same state on both",
"sides, the sender and the receiver. It is allowed to omit the", "sides, the sender and the receiver. It is allowed to omit the",

11
cmds-subvolume.c
View File

@ -83,7 +83,7 @@ static int cmd_subvol_create(int argc, char **argv)
optind = 1; optind = 1;
while (1) { while (1) {
int c = getopt(argc, argv, "c:i:r"); int c = getopt(argc, argv, "c:i:");
if (c < 0) if (c < 0)
break; break;
@ -287,7 +287,7 @@ out:
* - lowercase for enabling specific items in the output * - lowercase for enabling specific items in the output
*/ */
static const char * const cmd_subvol_list_usage[] = { static const char * const cmd_subvol_list_usage[] = {
"btrfs subvolume list [-agopurts] [-G [+|-]value] [-C [+|-]value] " "btrfs subvolume list [options] [-G [+|-]value] [-C [+|-]value] "
"[--sort=gen,ogen,rootid,path] <path>", "[--sort=gen,ogen,rootid,path] <path>",
"List subvolumes (and snapshots)", "List subvolumes (and snapshots)",
"", "",
@ -476,11 +476,12 @@ out:
} }
static const char * const cmd_snapshot_usage[] = { static const char * const cmd_snapshot_usage[] = {
"btrfs subvolume snapshot [-r] <source> [<dest>/]<name>", "btrfs subvolume snapshot [-r] <source> <dest>|[<dest>/]<name>",
"btrfs subvolume snapshot [-r] [-i <qgroupid>] <source> [<dest>/]<name>", "btrfs subvolume snapshot [-r] [-i <qgroupid>] <source> <dest>|[<dest>/]<name>",
"Create a snapshot of the subvolume", "Create a snapshot of the subvolume",
"Create a writable/readonly snapshot of the subvolume <source> with", "Create a writable/readonly snapshot of the subvolume <source> with",
"the name <name> in the <dest> directory", "the name <name> in the <dest> directory. If only <dest> is given,",
"the subvolume will be named the basename of <source>.",
"", "",
"-r create a readonly snapshot", "-r create a readonly snapshot",
"-i <qgroupid> add the newly created snapshot to a qgroup. This", "-i <qgroupid> add the newly created snapshot to a qgroup. This",