doc/mgr: edit telemetry.rst

Edit doc/mgr/telemetry.rst.

The English in this file is unacceptably demotic and exhibits a curious
but all-too-familiar lack here and there of definite articles.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit be67afcfcb51d07251f8a2be86de8dd7f45c713f)

Merge pull request #63657 from zdover23/wip-doc-2025-06-03-backport-63633-to-squid

squid: doc/mgr: edit progress.rst

Merge pull request #63660 from zdover23/wip-doc-2025-06-03-backport-63632-to-squid

squid: doc/dev/cephfs-mirroring: edit file 4 of x

Merge pull request #63663 from zdover23/wip-doc-2025-06-03-backport-63631-to-squid

squid: doc/mgr: edit nfs.rst

Merge pull request #63666 from zdover23/wip-doc-2025-06-03-backport-63630-to-squid

squid: doc/mgr: edit modules.rst

Merge pull request #63669 from zdover23/wip-doc-2025-06-03-backport-63629-to-squid

squid: doc/mgr: edit localpool.rst

doc/mgr: edit localpool.rst

Remove "only" where it was extraneous.

This commit was made in response to a request made by Anthony D'Atri
here: https://github.com/ceph/ceph/pull/63419#discussion_r2102803276.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit e43de826ca5ba122e900ad986db2be8edbac0982)

doc/mgr: edit modules.rst

s/called/named/ as requested by Anthony D'Atri in
https://github.com/ceph/ceph/pull/63451#discussion_r2104487962.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 02621f7683b9296dccf943326cc555052aa5a2ab)

doc/mgr: edit nfs.rst

Edit the "Updating an NFS Cluster" section of doc/mgr/nfs.rst. This
commit includes changes requested by Anthony D'Atri in
https://github.com/ceph/ceph/pull/63452.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit a4a29fe23fe721c9a3f8d4efc746d0250df4db58)

doc/dev/cephfs-mirroring: edit file 4 of x

Add prompts (and perform necessary corrections to glaring grammatical
errors) to doc/dev/cephfs-mirroring.rst, as requested by Jos Collin in
https://github.com/ceph/ceph/pull/63237/files#r2085886075.

This commit edits the fourth (and final) quarter of the
doc/dev/cephfs-mirroring.rst file.

Further refinements to the English in this file are possible.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 26dabda592f8fa2e3a388a474860eb3966aaaac8)

doc/mgr: edit progress.rst

Edit doc/mgr/progress.rst. Make the changes suggested by Anthony D'Atri
in https://github.com/ceph/ceph/pull/63470.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 37ceacc49a8f63499c9729afc7e09b7b8a386880)

Merge pull request #62650 from aaSharma14/wip-70777-squid

squid: mgr/dashboard: add prometheus read permission to cluster_mgr role

Reviewed-by: Afreen Misbah <afreen@ibm.com>

Merge pull request #63477 from rhcs-dashboard/wip-71364-squid

squid: mgr/dashboard: accept dot(.) in user_id & restrict tenant validation in user form

Reviewed-by: Aashish Sharma <aasharma@redhat.com>

Merge pull request #63625 from zdover23/wip-doc-2025-06-02-backport-63481-to-squid

squid: doc/mgr: Small improvements in rgw.rst

doc/mgr: Small improvements in rgw.rst

Use double backticks consistently for module name, CLI commands and
parameters etc.

Use title case in section titles and underline them only until end of
title text.

Use "command line" instead of "cmd line" in text.

Capitalize RGW consistently.

Delete one paragraph that included a strange out of place text fragment.

Call it "Manager" consistently instead of "MGR" in text one time.

Improve language in CA cert upgrade.

Signed-off-by: Ville Ojamo <14869000+bluikko@users.noreply.github.com>
(cherry picked from commit 7a3c6b563bb39e2adde4d3211cb603161fd46f02)

Merge pull request #63589 from zdover23/wip-doc-2025-05-29-backport-63471-to-squid

squid: doc/mgr: edit prometheus.rst

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

Merge branch 'squid' into wip-doc-2025-05-29-backport-63471-to-squid

Signed-off-by: Zac Dover <zac.dover@proton.me>

Merge pull request #63577 from zdover23/wip-doc-2025-05-29-backport-63451-to-squid

squid: doc/mgr: edit modules.rst.

Merge pull request #63586 from zdover23/wip-doc-2025-05-29-backport-63470-to-squid

squid: doc/mgr: edit progress.rst

Merge pull request #63583 from zdover23/wip-doc-2025-05-29-backport-63469-to-squid

squid: doc/mgr: edit orchestrator.rst

Merge pull request #63611 from zdover23/wip-doc-2025-05-30-backport-63475-to-squid

squid: doc/mgr: edit telegraf.rst

Merge pull request #62930 from zdover23/wip-doc-2025-04-23-backport-62696-to-squid

squid: doc/mgr: Improve prometheus.rst

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

Merge pull request #63448 from zdover23/wip-doc-2025-05-23-backport-63446-to-squid

squid: doc/radosgw: Cosmetic improvements in cloud-transition.rst

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

doc/mgr: edit telegraf.rst

Edit doc/mgr/telegraf.rst.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 1da172872792d797875ee99e97842414d9c2bb5e)

Merge pull request #63580 from zdover23/wip-doc-2025-05-29-backport-63452-to-squid

squid: doc/mgr: edit nfs.rst

Merge pull request #63592 from zdover23/wip-doc-2025-05-29-backport-63472-to-squid

squid: doc/mgr: edit rgw.rst

doc/mgr: edit rgw.rst

Edit doc/mgr/rgw.rst.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit e7f2a4b5b22280b32800930a5707791360e68f59)

doc/mgr: edit prometheus.rst

Edit doc/mgr/prometheus.rst.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 7cae041f46b010694c6c40b31e36719af1f3fb26)

doc/mgr: edit progress.rst

Edit doc/mgr/progress.rst.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 9bada3be2f49377bec06f4a270dea7174777b763)

doc/mgr: edit orchestrator.rst

Edit doc/mgr/orchestrator.rst.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 31ce3058fbc06709759e4c129a1af8678b257a6e)

doc/mgr: edit nfs.rst

Edit doc/mgr/nfs.rst. Improve some of the English.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

This commit and the PR of which it is a part includes the changes made
in https://github.com/ceph/ceph/pull/62782 and some corrections to
glaring grammatical errors. However, this file could use a careful
grammar pass.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 1c2544d8e1df8b9fcd53617f2b5cb1d6a5814f22)

doc/mgr: edit modules.rst.

Edit doc/mgr/modules.rst. Improve some of the English.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

This commit and the PR of which it is a part includes the changes made
in https://github.com/ceph/ceph/pull/62782 and some corrections to
glaring grammatical errors. However, this file could use a careful
grammar pass. As it currently stands, it contains run-on sentences and
English that is acceptable in conversation but not acceptable in written
communication.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 1818e48abbb6853817c626fac4a32cace1b5ebc0)

Merge pull request #63052 from pritha-srivastava/wip-71107-squid

squid: rgw/sts: Implementation of validating JWT using modulus and exponent

Reviewed-by: Adam Emerson <aemerson@redhat.com>

Merge pull request #63030 from soumyakoduri/wip-skoduri-squid

[squid] RGW backports

Reviewed-by: Adam Emerson <aemerson@redhat.com>

Merge pull request #62954 from cbodley/wip-71061-squid

squid: qa/rgw: run verify tests with garbage collection disabled

Reviewed-by: Adam Emerson <aemerson@redhat.com>

Merge pull request #62884 from ivancich/wip-70981-squid

squid: rgw: prevent crash in `radosgw-admin bucket object shard ...`

Reviewed-by: Adam Emerson <aemerson@redhat.com>

Merge pull request #62740 from jzhu116-bloomberg/wip-70637-squid

squid: rgw: revert PR #41897 to allow multiple delete markers to be created

Reviewed-by: Adam Emerson <aemerson@redhat.com>

Merge pull request #63535 from zdover23/wip-doc-2025-05-28-backport-63530-to-squid

squid: doc/rados/operations: Add settings advice to balancer.rst

Merge pull request #63538 from zdover23/wip-doc-2025-05-28-backport-63255-to-squid

squid: doc/mgr: edit crash.rst

Merge pull request #63541 from zdover23/wip-doc-2025-05-28-backport-63253-to-squid

squid: doc/monitoring: correct list formatting

Merge pull request #63544 from zdover23/wip-doc-2025-05-28-backport-63254-to-squid

squid: doc/cephfs: correct reference structure in fs-volumes.rst

Merge pull request #63547 from zdover23/wip-doc-2025-05-28-backport-63275-to-squid

squid: doc/dev/cephfs-mirroring: edit file 3 of x

Merge pull request #63550 from zdover23/wip-doc-2025-05-28-backport-63419-to-squid

squid: doc/mgr: edit localpool.rst

doc/mgr: edit localpool.rst

Edit doc/mgr/localpool.rst. Improve the English where necessary.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 9e7246b74075da557012b0744167011ca43eedb1)

doc/dev/cephfs-mirroring: edit file 3 of x

Add prompts (and perform necessary corrections to glaring grammatical
errors) to doc/dev/cephfs-mirroring.rst, as requested by Jos Collin in
https://github.com/ceph/ceph/pull/63237/files#r2085886075.

This commit edits the third quarter of the doc/dev/cephfs-mirroring.rst
file. This commit edits down to the line beginning "`Peers` section in
the command output".

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 3915238f21cd82896e6cda9cc90b68fee5d12750)

doc/cephfs: correct reference structure in fs-volumes.rst

Correct the links to cross-references in the cases of the following two
directives:

1. pause-clone-threads
2. pause-purge-threads

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit e59364f152847eabbedfe7fc72dfb66e7378b72b)
(cherry picked from commit 2c76845a2108f449e1295aebce02a97e04a64b6a)

doc/monitoring: correct list formatting

Correct list formatting in doc/monitoring/index.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit b7889dc4f088ce2a5fa8165c21fa2d0a75700f56)

doc/mgr: edit crash.rst

Edit doc/mgr/crash.rst. Add prompts and correct some of the inelegant
English present in the file.

This commit is part of a project to separate out the twenty-five files
that were committed to https://github.com/ceph/ceph/pull/62782.

Credit for this initiative should go to Ville Ojamo.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit aa2d9f98676928df02f898512f6eedc7c2bccd69)

doc/rados/operations: Add settings advice to balancer.rst

Signed-off-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>
(cherry picked from commit f188003530e55f6ac46ab3d56c53fab65cdb7e7c)

Merge pull request #63234 from nbalacha/wip-71240-squid

squid: cls/rbd: write image mirror status if state is CREATING

Reviewed-by: Ilya Dryomov <idryomov@redhat.com>

Merge pull request #63492 from zdover23/wip-doc-2025-05-27-backport-63420-to-squid

squid: doc/mgr: edit mds_autoscaler.rst

Merge pull request #63495 from zdover23/wip-doc-2025-05-27-backport-62600-to-squid

squid: doc/cephadm: improve "Maintenance Mode"

Merge pull request #63498 from zdover23/wip-doc-2025-05-27-backport-63463-to-squid

squid: doc/rados: s/enpty/empty/ in pgcalc doc

Merge pull request #63501 from zdover23/wip-doc-2025-05-27-backport-63464-to-squid

squid: doc/cephfs: correct ill-formatted command

Merge pull request #63504 from zdover23/wip-doc-2025-05-27-backport-63465-to-squid

squid: doc/rados: improve markup in cache-tiering.rst

Merge pull request #63507 from zdover23/wip-doc-2025-05-27-backport-63370-to-squid

squid: doc/mgr: edit hello.rst

Merge pull request #63510 from zdover23/wip-doc-2025-05-27-backport-63417-to-squid

squid: doc/mgr: edit insights.rst

Merge pull request #63513 from zdover23/wip-doc-2025-05-27-backport-63418-to-squid

squid: doc/mgr: edit iostat.rst

mgr/dashboard: add prometheus read permission to cluster_mgr role

Fixes: https://tracker.ceph.com/issues/70768
Signed-off-by: Nizamudeen A <nia@redhat.com>
(cherry picked from commit 69d326f885f24395adae02d5a4b11a8c9c147f8b)

doc/mgr: edit iostat.rst

Edit doc/mgr/iostat.rst. Improve the English where necessary.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 98708a7f7f3c470758063e21e840393440450381)

doc/mgr: edit insights.rst

Edit doc/mgr/insights.rst. Improve the English where necessary.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 31d7dac8ff62ca31ffe86d8ef07a6f16047f2a64)

doc/mgr: edit hello.rst

Edit doc/mgr/hello.rst. This includes the rewriting of sentences so that
they now appear in grammatically-correct English.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 87a375c20fcf2366b5f4b4178e9d89a2fba19585)

doc/rados: improve markup in cache-tiering.rst

Correct ill-formatted markup in cache-tiering.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 2c3815aadb45eb607608e6390a48e1eaa5e4f034)

doc/cephfs: correct ill-formatted command

Correct a command that was broken across two lines, causing the argument
of an option to appear as though it was a command.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit bd4e8d8f03a8c39191ad1b7683e7dd1bea4105f1)

doc/rados: s/enpty/empty/ in pgcalc doc

s/enpty/empty/ in doc/rados/operations/pgcalc/index.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 50dc9f1a04c13faa3d5e7971ec7f0724ddf70709)

doc/cephadm: improve "Maintenance Mode"

Improve the English in the section "Maintenance Mode" in the file
doc/cephadm/host-management.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 2d4ee6aea3a3003eff910feb130110a6588fb384)

Merge pull request #62573 from zdover23/wip-doc-2025-03-31-backport-62572-to-squid

squid: doc/rados/operations: Improve erasure-code.rst

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

Merge pull request #61614 from zdover23/wip-doc-2025-02-02-backport-61613-to-squid

squid: doc/architecture: remove sentence

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

doc/mgr: edit mds_autoscaler.rst

Edit mds_autoscaler.rst. Improve the English where necessary.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit efc438bd9f5753b42c74bf8f53ff94ebba1d4fb8)

mgr/dashboard: accept dot(.) in user_id & (alphanumeric chars, _) in tenant in user form

fixes: https://tracker.ceph.com/issues/71341

Signed-off-by: Naman Munet <naman.munet@ibm.com>
(cherry picked from commit 083d2a14f5da9df9c9142940f151636c466623ae)

Merge pull request #63467 from zdover23/wip-doc-2025-05-26-backport-63371-to-squid

squid: doc/cephfs: Cosmetic changes and small fixes in cephfs-mirroring.rst

doc/cephfs: Cosmetic changes and small fixes in cephfs-mirroring.rst

Don't format an unordered list as preformatted block.

Fix (not linked) reference to a section name that doesn't exist.

Don't call systemd unit files "systemctl unit files", add an "and"
between them.

Clarify by means of inline formatting and whitespace that config value
is "60" and the unit for that is seconds (as opposed to value being
"60s").

Use double backticks consistently when listing commands, file names or
paths, command parameters, syntaxes, etc.

Use star for inline italic instead of single backtick (to differentiate
from the previous).

Don't use double backticks for "cephadm" when talking about the concept.

Don't capitalize a few words that didn't need it.
Capitalize table data for consistency.
All caps for "MDS".

Small updates to language in text.

Call it "cephfs-mirror" everywhere and not "cephfs_mirror" at one place.

Signed-off-by: Ville Ojamo <14869000+bluikko@users.noreply.github.com>
(cherry picked from commit 2a1558a543bd047729c96d6a86232adc6c3ee1c5)

Merge pull request #63406 from idryomov/wip-rbd-live-migration-squid

squid: librbd/migration: add external clusters support + NBD stream

Reviewed-by: Ramana Raja <rraja@redhat.com>

Merge pull request #63454 from zdover23/wip-doc-2025-05-23-backport-63415-to-squid

squid: doc/mgr: edit influx.rst.

doc/mgr: edit influx.rst.

Edit doc/mgr/influx.rst.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 32bdcaab3c4cad830fa05d192a35954ce846a9ae)

Merge pull request #63402 from zdover23/wip-doc-2025-05-21-backport-63368-to-squid

squid: doc/mgr: edit motd.inc.rst

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

doc/radosgw: Cosmetic improvements in cloud-transition.rst

Indent text that should belong to list items so they are formatted as
list items.

Add missing full stop for a few sentences.

Move "the" outside of inline preformatted.
Format S3 API operation name with inline preformatted which seems
common.

Signed-off-by: Ville Ojamo <14869000+bluikko@users.noreply.github.com>
(cherry picked from commit 863d57de735b3ad2d22adf065d86a92fc6b57261)

librbd/migration/NBDStream: abstract out libnbd and add unit tests

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 6fd11c0276dc3f0b2349e42d877d7da692161bc9)

qa/suites/rbd: add snippets for migration import from NBD

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 3260b8fbea9257f12eb04a59af2ebb6f46042d82)

librbd/migration/NBDStream: call nbd_shutdown() in close()

Avoid warnings like

  qemu-nbd: Disconnect client, due to: Failed to read request:
  Unexpected end-of-file before all bytes were read

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit e1418e1975753bd3b5fbb7af88e361d3bbf7a1b6)

librbd/migration/NBDStream: switch to NBD URIs

This removes the constraint on the transport being TCP, allowing to
use a Unix domain socket or other options.  It also allows specifying
export names which a) are needed in case of serving different content
on different exports and b) some servers may require regardless.

Additionally, NBD URIs are future proof as all that NBDStream needs to
do is forward the string to libnbd.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 90b55cfdc25e9ad5247f076ff48a80e91d907adb)

librbd/migration/NBDStream: check for nbd_get_size() errors

nbd_get_size() can fail with EOVERFLOW and possibly other errors.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit d6d308003b2c291f28c0c9defd4895c76137f89c)

librbd/migration/NBDStream: introduce from_nbd_errno()

Errors returned by nbd_get_errno() can't be used to complete Contexts
directly because a) these errors are positive while complete() in most
cases expects a negative error and b) nbd_get_errno() can return 0 even
after libnbd call fails (i.e. returns -1).

Introduce a helper with EIO as a default/fallback error.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 1b12f4603e5a5137e48b795565d7d807b73158ec)

librbd/migration/NBDStream: be more thorough around nbd_block_status()

nbd_block_status() is specified to be really loose: it can return
more status (go beyond the requested range), less status (cover only
some part of the requested range) or nothing at all.  The former would
likely violate some assumptions in ObjectCopyRequest, while the latter
would lead to straight data corruption -- parent blocks that weren't
covered would never get copied up into the destination image.

On top of that, the current implementation is very suboptimal.
Because only "nr_entries == 2" responses are effectively processed,
any extent which has a small amount of data and is otherwise zeroed
(e.g. 8K of data in a 4M object) gets listed as DATA.  A copyup for
such an object would write 4M worth of data instead of 8K, consuming
space in the destination image unnecessarily.

Also, it's unclear whether zero-sized entries can be returned.
Currently, if it happens we would hit an assert in interval_map.

This fixes all of these issues.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit d52bd80f1f9daed51e1cdac142b07fcb9dec8615)

librbd/migration: add nbd stream

Co-authored-by: Ilya Dryomov <idryomov@gmail.com>
Signed-off-by: Effi Ofer <effio@il.ibm.com>
Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit dc8eed68ce58077433e38317f20f3a96ec81f467)

qa/workunits/rbd: exercise snap_{name,id} parsing in test_import_native_format()

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 4a6800f1468df5a33802e15c9ea5d7c3ce8ddf2a)

doc/rbd: clarify when image_id is expected for import-only migration

"optional if image in trash" can be easily interpreted as "required if
image not in trash".

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 175ca1e0f0928eed70a735c980c7619214a12cb5)

librbd/migration: add external clusters support

This commit extends NativeFormat (aka migration where the migration
source is an RBD image) to support external Ceph clusters, limited to
import-only mode.

Co-authored-by: Or Ozeri <oro@il.ibm.com>
Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 293d523ea69aaf1fa5c372f058f4426d49a3e196)

librbd/migration: move away from util::create_ioctx() in NativeFormat

This is another step towards supporting migration from external
clusters, where creating an IoCtx from a Rados instance that has
nothing to do with dst_io_ctx would be needed.  It also allows to
get rid of a pool lookup in the middle of parsing code.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 7986662157491419d366de3dd0070553abb9e1c8)

Conflicts:
src/librbd/migration/NativeFormat.cc [ commit 8e58a52a408b
  ("librbd/migration: don't include ImageState.h in formats")
  was backported to squid out of order ]

common/config: export CEPH_CONF_FILE_DEFAULT

It used to be exported until commit 318c62f8ae16 ("common/config:
cleanup remove some unused macros").  Having CEPH_CONF_FILE_DEFAULT
avaialable is handy to prevent parse_config_files() from picking up
CEPH_CONF environment variable.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 57a8c535ccad35a9f6e11e8976bc32f390ad341c)

librbd: RefreshParentRequest::m_parent_snap_id is unused

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit df2189acc5dd10e2741a8bdcb891b4f68bdac6b1)

librbd: assert on parent in ImageCtx destructor

... and switch to in-class initializers while at it.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 23cd20e0d5523efaf6b925df378bb2dd865729aa)

qa/tasks/qemu: remove hard-coding of cluster name

This commit allows running the qemu task on an arbitrary cluster name.

Signed-off-by: Or Ozeri <oro@il.ibm.com>
Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 409d36c7087e1e12dd2ad321c39dc26b3271582f)

qa/tasks/rbd: support non-default ceph clusters

This commit allows running the rbd task on an arbitrary cluster name.

Signed-off-by: Or Ozeri <oro@il.ibm.com>
Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 4f8dc834cc6cfb006a10fe4b3e715df5e720f6fe)

librbd/migration: don't clone when flattening

When the flatten flag is set, instead of creating the
destination image by cloning, create it independently,
as the parent relation is unnecessary in this case.
This will be particularly useful when the migration source
is located in an external Ceph cluster, which will soon be
supported.

Signed-off-by: Or Ozeri <oro@il.ibm.com>
Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 1ee644d97104c9caaa83918b98b388888fc5497b)

Merge pull request #63393 from zdover23/wip-doc-2025-05-21-backport-63365-to-squid

squid: doc/mgr: edit debug.inc.rst

Merge pull request #63396 from zdover23/wip-doc-2025-05-21-backport-63367-to-squid

squid: doc/mgr: edit feature_toggles.inc.rst

doc/mgr: edit motd.inc.rst

Edit doc/mgr/dashboard_plugins/motd.inc.rst.

This commit is part of a project to separate out the twenty-five files
that were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 8661509c16441d60778bc084df8231daa149a04b)

doc/mgr: edit feature_toggles.inc.rst

Edit doc/mgr/dashboard_plugins/features_toggles.inc.rst.

This commit is part of a project to separate out the twenty-five files
that were committed to https://github.com/ceph/ceph/pull/62782.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 18e4ca258194238699649857f5f0ba195b67dea2)

doc/mgr: edit debug.inc.rst

Edit doc/mgr/dashboard_plugins/debug.inc.rst.

This commit is part of a project to separate out the twenty-five files
that were committed to https://github.com/ceph/ceph/pull/63255.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 1e87aa66b9de0a4e74bb4b1fbd806d974e0e8dcf)