Commit Graph

104 Commits

Author SHA1 Message Date
songweibin
7deeef9164 rbd: allow remove all unprotected snapshots
allow remove all unprotected snapshots when exiting
protected snapshots in the same image.
Fixes: http://tracker.ceph.com/issues/23126

Signed-off-by: songweibin <song.weibin@zte.com.cn>
2018-03-01 21:01:24 +08:00
songweibin
034ad878fd rbd: add 'group rename' action to CLI and Python API
Signed-off-by: songweibin <song.weibin@zte.com.cn>
2018-02-26 10:21:58 +08:00
Jason Dillaman
3ac57a7eb7
Merge pull request #19711 from trociny/wip-20762
rbd: unified way to map images using different drivers

Reviewed-by: Jason Dillaman <dillaman@redhat.com>
Reviewed-by: Ilya Dryomov <idryomov@redhat.com>
Reviewed-by: Willem Jan Withagen <wjw@digiware.nl>
2018-02-02 13:56:13 -05:00
songweibin
0e50c352b3 pybind/rbd: fix some typo
Signed-off-by: songweibin <song.weibin@zte.com.cn>
2018-01-31 17:34:35 +08:00
songweibin
a12f9b81cb doc/rbd: update rbd man page
Signed-off-by: songweibin <song.weibin@zte.com.cn>
2018-01-31 12:20:18 +08:00
Mykola Golub
6a57358add rbd: unified way to map images using different drivers
Instead of "rbd map|unmap|showmapped", "rbd ndb map|unmap|list",
"rbd ggate map|unmap|list" commands, provide:

 rbd device -t krbd|nbd|ggate|... map|unmap|list

which gives interface consistent between drivers.

Signed-off-by: Mykola Golub <mgolub@suse.com>
2018-01-29 09:34:11 +02:00
songweibin
0551029242 rbd: add deep cp CLI method
Signed-off-by: songweibin <song.weibin@zte.com.cn>
2018-01-24 09:04:33 +08:00
songweibin
b00047ac25 doc: add missing several commands in rbd CLI man page
fix: http://tracker.ceph.com/issues/14539

Signed-off-by: songweibin <song.weibin@zte.com.cn>
2017-12-24 09:21:08 +08:00
songweibin
a926481cec doc: make rbd commads arranged in alphabetical order
Signed-off-by: songweibin <song.weibin@zte.com.cn>
2017-12-22 16:05:04 +08:00
Jason Dillaman
8e86a43b63 Merge pull request #17461 from PCzhangPC/bench_rw_test
rbd:introduce rbd bench rw(for read and write mix) test

Reviewed-by: Jason Dillaman <dillaman@redhat.com>
2017-10-03 13:16:24 -04:00
PCzhangPC
7ec29ac6db rbd:update some documents of rbd bench
Signed-off-by: PCzhangPC <pengcheng.zhang@easystack.cn>
2017-09-15 14:24:26 +08:00
yonghengdexin735
ad25da3a62 doc/rbd:add info for rbd group
Signed-off-by: yonghengdexin735 <zhang.zezhu@zte.com.cn>
2017-09-11 17:56:25 +08:00
songweibin
f9a94641e5 rbd: modified some commands' description into imperative sentence
Signed-off-by: songweibin <song.weibin@zte.com.cn>
2017-07-31 20:25:30 +08:00
Gregory Farnum
ba03ab92a8 Merge pull request #16629 from johnwilkins/wip-doc-remove-contractions
Remove contractions from the documentation.

Reviewed-by: Greg Farnum <gfarnum@redhat.com>
2017-07-27 10:49:38 -07:00
John Wilkins
ff2eebf88a doc/man: Removed contractions for ESL speakers.
Signed-off-by: John Wilkins <jowilkin@redhat.com>
2017-07-27 09:57:23 -07:00
songweibin
ba01a9462c doc: add rbd new trash cli in rbd.rst
Signed-off-by: songweibin <song.weibin@zte.com.cn>
2017-07-22 16:18:11 +08:00
Ilya Dryomov
c72d8b0409 rbd: recognize exclusive map option
Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2017-04-25 20:15:41 +02:00
Dongsheng Yang
f16899a749 rbd: use the unified --export-format option for rbd export and rbd import
Signed-off-by: Dongsheng Yang <dongsheng.yang@easystack.cn>
2017-02-19 20:42:03 +08:00
Dongsheng Yang
26b858ee1e rbd: introduce --export-format to export command
Signed-off-by: Dongsheng Yang <dongsheng.yang@easystack.cn>
2017-02-19 20:42:03 +08:00
Dongsheng Yang
5e034600a2 rbd: introduce --import-format to import command
Signed-off-by: Dongsheng Yang <dongsheng.yang@easystack.cn>
2017-02-19 20:42:03 +08:00
Ilya Dryomov
620f5e1455 rbd: expose rbd unmap options
Reuse rbd map -o infrastructure to expose rbd unmap options in
a similar fashion.  Currently it's just one bool option, but we may
need more in the future.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2016-10-07 17:21:15 +02:00
Jason Dillaman
7176b61bad Merge pull request #11313 from ceph/wip-krbd-lock-on-read-option
rbd: recognize lock_on_read option

Reviewed-by: Jason Dillaman <dillaman@redhat.com>
2016-10-05 10:00:29 -04:00
Ilya Dryomov
e857b78965 rbd: recognize lock_on_read option
Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2016-10-04 19:50:32 +02:00
Ilya Dryomov
d38dc29ed5 doc: clarify rbd size units
It wasn't clear from the man page that --size defaults to M.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2016-10-04 10:21:36 +02:00
Kefu Chai
f468c73b6b Merge pull request #10619 from chengweiv5/fix-doc
doc: fix rados/configuration/osd-config-ref.rst

Reviewed-by: Kefu Chai <kchai@redhat.com>
2016-08-15 23:00:02 +08:00
Chengwei Yang
c8c92f8a2c doc: format 2 now is the default image format
Signed-off-by: Chengwei Yang <yangchengwei@qiyi.com>
2016-08-12 17:44:16 +08:00
Chengwei Yang
cb2880a165 doc: replace cluster name with cluster-name to avoid confusing
Signed-off-by: Chengwei Yang <yangchengwei@qiyi.com>
2016-08-12 13:20:04 +08:00
Chengwei Yang
82e928c6a3 doc: fix rbd map format in rbd manpage
Signed-off-by: Chengwei Yang <yangchengwei@qiyi.com>
2016-08-11 09:19:39 +08:00
Dongsheng Yang
0575a9e872 tools/rbd: introduce an option of --force for snap remove
Signed-off-by: Dongsheng Yang <dongsheng.yang@easystack.cn>
2016-07-26 02:23:30 -04:00
Dongsheng Yang
23a135d2a8 tools/rbd: introduce a simple bench for read
Currently, we have a bench-write for in rbd tool, but we don't have
a simple bench for read.

This patch add a new subcommand of bench, with an option of --io-type.
Then we can do a simple bench for write or read.

Signed-off-by: Dongsheng Yang <dongsheng.yang@easystack.cn>
2016-06-20 01:24:44 -04:00
Dongsheng Yang
1dd542d8ce tools/rbd: make bench-write invisible to user
rbd bench-write is going to be deprecated. This patch
makes it invisible in help message and manpage. But it
is still working.

Signed-off-by: Dongsheng Yang <dongsheng.yang@easystack.cn>
2016-06-20 01:24:44 -04:00
Douglas Fuller
653bc453e3 rbd: add methods to set and get snapshot limits
Add a subcommand, rbd snap limit set <image> --limit <integer>, to
limit the number of snapshots that may be made of a given image.
To clear, use rbd snap limit clear <image>. Add an omap
key, 'snap_limit' to the RBD header for implementation. Add object
classes to set and query the limit. Older OSDs will ignore the limit.

Fixes: http://tracker.ceph.com/issues/15706
Signed-off-by: Douglas Fuller <dfuller@redhat.com>
2016-06-07 13:44:24 -07:00
luokexue
6d69636ee9 doc: Fixes all "Qemu" to "QEMU"
Signed-off-by: luokexue <luo.kexue@zte.com.cn>
2016-04-16 11:42:19 +08:00
Jason Dillaman
622748ae15 rbd: deprecate image format 1
The rbd cli will warn about the deprecation when attempting to create
image format 1 images.  librbd will log an error message when opening
a format 1 RBD image.

Signed-off-by: Jason Dillaman <dillaman@redhat.com>
2016-02-29 13:22:32 -05:00
Vikhyat Umrao
71690e707f rbd: add --object-size option
Object size can be specified when creating an image with the --order option,
as a number of bits in the size.

This patch is adding new option --object-size. This new option will specify
object size directly for example --object-size 2M.

It would be easier to use. --order is still present for backwards compatibility.
For simplicity, we are rounding up the object size to the nearest power of 2.

Fixes #12112

Signed-off-by: Vikhyat Umrao <vumrao@redhat.com>
2015-12-08 16:14:03 +05:30
Yunchuan Wen
b0deee4961 Update man page for new rbd nbd command
Signed-off-by: Yunchuan Wen <yunchuan.wen@kylin-cloud.com>
2015-12-02 11:29:41 +08:00
Josh Durgin
46249fe5b2 Merge pull request #6541 from dillaman/wip-11287
librbd: integrate journaling support for IO operations

Reviewed-by: Josh Durgin <jdurgin@redhat.com>
2015-11-17 11:39:51 -08:00
Ilya Dryomov
f2432e01f2 rbd: recognize cephx_sign_messages option
Signed-off-by: Ilya Dryomov <idryomov@redhat.com>
2015-11-14 16:39:35 +01:00
Jason Dillaman
750771c6ff librbd: add new RBD_FEATURE_JOURNALING feature code
When enabled, all mutable operations against an RBD image
will be recorded to a journal prior to changing the underlying
RBD image.

Signed-off-by: Jason Dillaman <dillaman@redhat.com>
2015-11-12 20:17:52 -05:00
Vikhyat Umrao
b30d1b8d00 doc: Adding --cluster option to rbd man page.
Fixes #13457
Signed-off-by: Vikhyat Umrao <vumrao@redhat.com>
Reviewed-by: Josh Durgin <jdurgin@redhat.com>
2015-11-10 22:05:59 -08:00
Vikhyat Umrao
cd4ac1cae1 rbd: support size suffixes for size-based options
This patch will provide support for size suffixes for
below given options:

--stripe-unit <size in B/K/M>
--io-size <size in B/K/M/G/T>
--io-total <size in B/K/M/G/T>

Signed-off-by: Vikhyat Umrao <vumrao@redhat.com>
2015-08-06 20:40:51 +05:30
Vikhyat Umrao
85cb86d05f doc: change "--keyfile" description in man page of rbd help
"--keyring" has higher priority than "--keyfile".
"--keyfile" option is overridden by "--keyring"
if latter is also specified.

Signed-off-by: Vikhyat Umrao <vumrao@redhat.com>
2015-08-03 22:57:04 +05:30
Ilya Dryomov
17a3e4b969 rbd: rename --object-extents option to --whole-object
--object-extents is a bit confusing - extent is generally something of
a varying length and here the meaning is "diff whole objects".  Rename
it to --whole-object (the name of diff_iterate() parameter).

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2015-07-27 12:22:04 +03:00
Ilya Dryomov
afbf90d5b5 rbd: du command should take spec as an argument
Change du to take <image-spec> | <snap-spec> as an argument instead of
going through --image option.  The new synopsis is

    (du | disk-usage) [<image-spec> | <snap-spec>]

This is to make it look more like the rest of the commands: the only
other command that takes pool as an argument is ls and it can't really
serve as a prototype for du, because the latter has to work on images
and snapshots as well.

Examples:

    # stats for pool rbd
    $ rbd du
    $ rbd -p rbd du

    # stats for pool foo
    $ rbd -p foo du

    # stats for snapshot mysnap of image baz in pool rbd
    $ rbd du baz@mysnap

    # stats for image bar in pool foo
    $ rbd du foo/bar

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2015-07-27 12:22:04 +03:00
Ilya Dryomov
bbc5c71284 rbd: import doesn't require image-spec arg, ditto for export and path
Mark those as such in help and clarify what image-spec defaults to.

Related, all command args in our man page are enclosed into brackets.
I suppose the reason is that they are optional in the sense that you
can have commands like

    $ rbd clone --pool a --image b --snap -c --dest-pool d --dest e

with no args.  Given that we are trying to push people towards

    $ rbd clone a/b@c d/e

undo that so that real optional arguments can be marked optional.
While at it, add synopsis for each command and use backticks for
denoting commands more consistently.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2015-07-27 12:22:04 +03:00
Ilya Dryomov
76989cc4ae doc: use spec syntax in rbd docs
Use spec syntax instead of --pool, --image and --snap to hopefully push
people towards the former.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2015-07-27 12:22:04 +03:00
Vikhyat Umrao
9909388171 rbd: use image-spec and snap-spec in rbd help
This patch changes image-name instances to image-spec and snap-name
instances to snap-spec to try to clarify usage for some commands and
disambiguate the term {image,snap}-name, which has been used to denote
both simple names and compound names (specs).

<image-spec> is [<pool-name>]/<image-name>
<snap-spec> is [<pool-name>]/<image-name>@<snap-name>

This patch also removes duplicate checks for image-name and snap-name.

Signed-off-by: Vikhyat Umrao <vumrao@redhat.com>
[idryomov@gmail.com: some commands take either image-spec or snap-spec,
other fixes, formatting, changelog]
Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2015-07-27 12:22:04 +03:00
Ilya Dryomov
89c2a0b58a rbd: recognize queue_depth option
.. and also stress the difference between libceph and rbd mapping
options.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2015-07-06 16:32:15 +03:00
Vikhyat Umrao
8e56a5b5c4 [rbd] support G/T units in rbd create/resize
Signed-off-by: Vikhyat Umrao <vumrao@redhat.com>
2015-06-16 23:27:52 +05:30
Ilya Dryomov
52440c4b97 rbd: document mount_timeout in the man page
With "rbd: timeout watch teardown on unmap with mount_timeout" going
into kernel 4.2, document its effect in the man page.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2015-05-25 15:41:51 +03:00