Project

General

Profile

Actions

Bug #4243

closed

rbd cli: usage confusing for snapshot operations

Added by Alex Elder about 11 years ago. Updated almost 9 years ago.

Status:
Resolved
Priority:
Normal
Assignee:
Target version:
-
% Done:

0%

Source:
Development
Tags:
Backport:
Regression:
No
Severity:
3 - minor
Reviewed:
Affected Versions:
ceph-qa-suite:
Pull request ID:
Crash signature (v1):
Crash signature (v2):

Description

The correct usage for creating a snapshot seems to be:

    rbd snap create --snap=<snap_name> <image_name>

But the help message says:
      snap create <snap-name>                     create a snapshot

Also, how about creating a nice "help" command. I.e.,
"rbd help" ought to do what "rbd --help" currently does,
and "rbd help snap" might give you help limited to the
snapshot command. As an added bonus, "rbd snap help"
might provide exactly the same thing (and work for all
commands, though I suspect that's more work...).

    root@plana92:/tmp/cephtest# rbd --version
    ceph version 0.57-404-g8c05af5 (8c05af5dc3c398dda4c196a64f344db7ea69d209)
    root@plana92:/tmp/cephtest# rbd help
    rbd: error parsing command 'help'
    root@plana92:/tmp/cephtest# rbd --help
    usage: rbd [-n <auth user>] [OPTIONS] <cmd> ...
    where 'pool' is a rados pool name (default is 'rbd') and 'cmd' is one of:
      (ls | list) [-l | --long ] [pool-name] list rbd images
        ...
      snap create <snap-name>                     create a snapshot
        ...
    root@plana92:/tmp/cephtest#     
Actions

Also available in: Atom PDF