From: Ilya Dryomov Date: Fri, 7 Nov 2025 19:05:22 +0000 (+0100) Subject: doc/rbd/rbd-config-ref: add clone settings section X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=ee5c6fdfa43797b53591255cf52b0f4a961849b4;p=ceph.git doc/rbd/rbd-config-ref: add clone settings section Expose rbd_default_clone_format option which has a fairly comprehensive description (much more verbose than most other options, anyway). This should help with understanding the difference between clone v1 and v2. Signed-off-by: Ilya Dryomov --- diff --git a/doc/rbd/rbd-config-ref.rst b/doc/rbd/rbd-config-ref.rst index c21731adca8..d6d5b68c57a 100644 --- a/doc/rbd/rbd-config-ref.rst +++ b/doc/rbd/rbd-config-ref.rst @@ -212,6 +212,11 @@ creating images or the default features can be configured via :KRBD support: no +Clone Settings +============== + +.. confval:: rbd_default_clone_format + QoS Settings ============ diff --git a/src/common/options/rbd.yaml.in b/src/common/options/rbd.yaml.in index a86a2e97304..b12e2edc44e 100644 --- a/src/common/options/rbd.yaml.in +++ b/src/common/options/rbd.yaml.in @@ -514,12 +514,12 @@ options: type: str level: advanced desc: default internal format for handling clones - long_desc: This sets the internal format for tracking cloned images. The setting - of '1' requires attaching to protected snapshots that cannot be removed until - the clone is removed/flattened. The setting of '2' will allow clones to be attached + long_desc: This sets the internal format for tracking cloned images. The value + of ``1`` requires attaching to protected snapshots that cannot be removed until + the clone is removed or flattened. The value of ``2`` will allow clones to be attached to any snapshot and permits removing in-use parent snapshots but requires Mimic - or later clients. The default setting of 'auto' will use the v2 format if the - cluster is configured to require mimic or later clients. + or later clients. The default value of ``auto`` will use the v2 format if the + cluster is configured to require Mimic or later clients. default: auto services: - rbd