doc/radosgw: update aws specification link

Update the link to the AWS specification format.

Fixes: https://tracker.ceph.com/issues/68619
Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit cca1a17d07fd31ccf13acf846ad13e6fad85d5f2)

Merge pull request #64073 from ronen-fr/wip-rf-64048-squid

squid: osd/scrub: clarify that osd_scrub_auto_repair_num_errors counts objects

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

osd/scrub: clarify that osd_scrub_auto_repair_num_errors counts objects

'osd_scrub_auto_repair_num_errors' limits the number of damaged objects
that we will try to auto-repair during a scrub. Its documentation
referred to "number of errors", which did not fit the implementation.

Fixes: https://tracker.ceph.com/issues/71754
Fixes: Red Hat BZ2316244
Signed-off-by: Ronen Friedman <rfriedma@redhat.com>
(cherry picked from commit 680b58ffd0bf5b213ec525f8d783297fb0b14343)
Signed-off-by: Ronen Friedman <rfriedma@redhat.com>

Merge pull request #63363 from cbodley/wip-71375-squid

squid: rgw/rgw_rest: determine the domain uri prefix by rgw_transport_is_secure

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

Merge pull request #63438 from mkogan1/wip-71421-squid

squid: rgw/d3n: fix valgrind invalid read during exit

Merge pull request #63193 from jzhu116-bloomberg/wip-71177-squid

squid: rgw: prefetch data from versioned object instance head

Merge pull request #64058 from zdover23/wip-doc-2025-06-20-backport-63163-to-squid

squid: doc/radosgw: Cosmetic improvements in dynamicresharding.rst

doc/radosgw: Cosmetic improvements in dynamicresharding.rst

Make reference to config section a hyperlink.

Capitalization consistency: use title case in section titles, fix two
invalid capitalizations in text.

Promptify CLI example commands.

A JSON key-value pair is a "property" and not an "object".

Use an ordered list instead of inline code with hardcoded list numbers.

Use the American "canceled" (majority of occurrences in doc/) instead of
"cancelled".

Use admonitions instead of spelling out "Note:".
Clarify language on sharding cleanup for multisite.

Format JSON keys as inline code.

Indent example JSON output from radosgw-admin correctly (same as real
output) with 4 spaces.

Use colon instead of full stop at the end of text that describes the
following example command. Move admonition to after such example
command.

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

Merge pull request #62905 from adk3798/squid-cephadm-rm-cluster-zap-devices

squid: cephadm: check "ceph_device_lvm" field instead of "ceph_device" during zap

Reviewed-by: Adam King adking@redhat.com

Merge pull request #64021 from zdover23/wip-doc-2025-06-19-backport-63983-to-squid

squid: doc/radosgw/admin.rst: explain bucket and uid flags for bucket quota

Merge pull request #64024 from zdover23/wip-doc-2025-06-19-backport-63907-to-squid

squid: doc/radosgw: edit cloud-transition (1 of x)

Merge pull request #64033 from zdover23/wip-doc-2025-06-19-backport-60440-to-squid

squid: doc: mgr/dashboard: add OAuth2 SSO documentation

doc: mgr/dashboard: add OAuth2 SSO documentation

Signed-off-by: Pedro Gonzalez Gomez <pegonzal@redhat.com>
(cherry picked from commit 3e63860433a53d7d92d593beb3a4a02643b6ea98)

doc: mgr/dashboard: add --enable-auth flag

Add an instruction that includes the --enable-auth flag in a "git orch
apply mgmt-gateway" command, in accordance with a request made by
afreen23 here: https://github.com/ceph/ceph/pull/60440#discussion_r1953530599

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

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

squid: doc/rgw: use 'confval' directive to render sts config options

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

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

squid: doc/rados/operations: Additional improvements to placement-groups.rst

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

Merge pull request #63768 from zdover23/wip-doc-2025-06-06-backport-63735-to-squid

squid: doc/mgr: edit telemetry (1 of x)

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

doc/radosgw: edit cloud-transition (1 of x)

Edit the first hundred lines of doc/radosgw/cloud-transition.rst.

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

Merge pull request #63955 from zdover23/wip-doc-2025-06-16-backport-63821-to-squid

squid: doc/src: edit osd.yaml.in (osd_deep_scrub_interval_cv)

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

Merge pull request #63990 from zdover23/wip-doc-2025-06-18-backport-60954-to-squid

squid: doc/dev: update link to backporter manual

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

Merge pull request #63993 from zdover23/wip-doc-2025-06-18-backport-44861-to-squid

squid: doc/dev: Debuggging with gdb

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

Merge pull request #63998 from zdover23/wip-doc-2025-06-18-backport-62804-to-squid

squid: ceph.spec.in: add man/rgw-gap-list

Reviewed-by: J. Eric Ivancich <ivancich@redhat.com>

doc/radosgw/admin.rst: explain bucket and uid flags for bucket quota

Clarify behavior of bucket and uid flags when setting a quota with
quota-scope=bucket.

Signed-off-by: Hyun Jin Kim <hello.hyunjin@gmail.com>
(cherry picked from commit d5c7b4d62c71ca2a57b7d9a552eae03f0f620cef)

Merge pull request #63996 from zdover23/wip-doc-2025-06-18-backport-62749-to-squid

squid: doc/rgw: add man documentation for the rgw-gap-list tool

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

doc/rgw: add man documentation for the rgw-gap-list tool

Signed-off-by: J. Eric Ivancich <ivancich@redhat.com>
(cherry picked from commit 12eb87463cdf952b9d16eac899f1ca40670ca2bc)

Merge pull request #63728 from ivancich/wip-70898-squid

squid: doc/rgw: add man documentation for the rgw-gap-list tool

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
Reviewed-by: Zac Dover <zac.dover@proton.me>

ceph.spec.in: add man/rgw-gap-list

Introduced in https://github.com/ceph/ceph/pull/62749
Centos builds fail with:
```
error: Installed (but unpackaged) file(s) found:
   /usr/share/man/man8/rgw-gap-list.8.gz

RPM build errors:
    Installed (but unpackaged) file(s) found:
   /usr/share/man/man8/rgw-gap-list.8.gz
```

Signed-off-by: Matan Breizman <mbreizma@redhat.com>
(cherry picked from commit 8d0ec7666be7c7eeced525b5772c6be973f54a25)

doc/dev: Debuggging with gdb

Signed-off-by: Matan Breizman <mbreizma@redhat.com>
(cherry picked from commit 682b806efa39784c8ef67b46f4ac628f40aa15d9)

doc/dev: update link to backporter manual

Update the link to the backporter manual, in
doc/dev/development-workflow.rst. Laura Flores requested this change on
04 Dec 2024.

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

Merge pull request #63241 from vshankar/wip-integrate-blockdif-with-mirror-daemon-squid

squid: integrate blockdiff with cephfs-mirror daemon

Reviewed-by: Jos Collin <jcollin@redhat.com>

ceph.spec.in: add man/rgw-gap-list

Introduced in https://github.com/ceph/ceph/pull/62749
Centos builds fail with:
```
error: Installed (but unpackaged) file(s) found:
   /usr/share/man/man8/rgw-gap-list.8.gz

RPM build errors:
    Installed (but unpackaged) file(s) found:
   /usr/share/man/man8/rgw-gap-list.8.gz
```

Signed-off-by: Matan Breizman <mbreizma@redhat.com>
(cherry picked from commit 8d0ec7666be7c7eeced525b5772c6be973f54a25)

doc/rgw: add man documentation for the rgw-gap-list tool

Signed-off-by: J. Eric Ivancich <ivancich@redhat.com>
(cherry picked from commit 12eb87463cdf952b9d16eac899f1ca40670ca2bc)

Merge pull request #63977 from zdover23/wip-doc-2025-06-17-backport-63951-to-squid

squid: doc/cephfs: document first-damage.py

doc/cephfs: document first-damage.py

Document the use of first-damage.py.

Fixes: https://tracker.ceph.com/issues/71628
Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit d88cdf039d02055d3379eb91a5a9bab655d40d2d)

Merge pull request #60396 from neesingh-rh/wip-68592-squid

squid: mgr/vol : shortening the name of helper method

Merge pull request #59005 from neesingh-rh/wip-67300-squid

squid: pybind/ceph_argparse: Fix error message for ceph tell command

Merge pull request #63405 from clwluvw/wip-71172

squid: rgw-admin: report correct error code for non-existent bucket on deletion

Reviewed-by:Alex Wojno <awojno@bloomberg.net>

Merge pull request #62892 from pritha-srivastava/wip-70969-squid

squid: rgw/iam: correcting the caps for OIDC Provider for a user.

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

Merge pull request #63710 from ceph/dvanders_backport_quotados_squid

squid: rgw: Changed discard buffer size

Reviewed-by: Casey Bodley <cbodley@redhat.com>

Merge pull request #63065 from pritha-srivastava/wip-71113-squid

squid: rgw/sts: correcting authentication in case s3 ops are directed to a primary from secondary after  assumerole.

Reviewed-by: Adam C. Emerson <aemerson@redhat.com>
Reviewed-by: Daniel Gryniewicz <dang@redhat.com>

Merge pull request #62722 from ivancich/wip-70827-squid

squid: rgw: fix bug with rgw-gap-list

Reviewed-by: Casey Bodley <cbodley@redhat.com>

Merge pull request #63948 from zdover23/wip-doc-2025-06-16-backport-63918-to-squid

squid: doc/cephfs: Update deprecation notice in experimental-features.rst

Merge pull request #63958 from zdover23/wip-doc-2025-06-16-backport-63320-to-squid

squid: doc/rados/operations: Fix unordered list in health-checks.rst

doc/rados/operations: Fix unordered list in health-checks.rst

Fix missing empty line before an unordered list that caused it to be
rendered wrong.

Also, the sentences in each list item start with a capital case letter
so add the missing full stop at the end.

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

doc/cephfs: Update deprecation notice in experimental-features.rst

The "inline data" feature was not removed on Quincy so update
deprecation notice to refer to "a future release" instead.

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

doc/src: edit osd.yaml.in (osd_deep_scrub_interval_cv)

Improve the English in the "desc" field of the
"osd_deep_scrub_interval_cv" variable, as suggested by Anthony D'Atri in
https://github.com/ceph/ceph/pull/63490#discussion_r2124893516.

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

Merge pull request #62628 from rhcs-dashboard/wip-70766-squid

squid: mgr/dashboard: upgrading nvmeof doesn't update configuration

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

Merge pull request #63942 from zdover23/wip-doc-2025-06-16-backport-63934-to-squid

squid: doc/rados/configuration: Improve ceph-conf.rst

doc/rados/configuration: Improve ceph-conf.rst

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

Merge pull request #63287 from afreen23/wip-71292-squid

squid: mgr/dashboard: deprecate transifex-i18ntool and support transifex cli

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

Merge pull request #62435 from cbodley/wip-70596-squid

squid: rgw/iam: add policy evaluation for Arn-based Conditions

Reviewed-by: Yuval Lifshitz <ylifshit@ibm.com>

Merge pull request #63915 from zdover23/wip-doc-2025-06-13-backport-63005-to-squid

squid: doc/radosgw: Promptify CLI commands and fix formatting in layout.rst

Merge pull request #63911 from avanthakkar/fix-mypy-squid

squid: python-common: fix mypy errors in earmarking.py

Reviewed-by: John Mulligan <jmulligan@redhat.com>

Merge pull request #63700 from zdover23/wip-doc-2025-06-04-backport-62893-to-squid

squid: doc/radosgw: edit sentence in metrics.rst

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

doc/radosgw: edit sentence in metrics.rst

Change the wording of a sentence in doc/radosgw/metrics.rst so that its
articles read as though they were written by a native speaker of the
English language.

This commit is being raised as part of a diagnostic process aimed at
discovering why the ReadtheDocs check is failing on PR
https://github.com/ceph/ceph/pull/62877.

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

Merge pull request #63774 from zdover23/wip-doc-2025-06-06-backport-63740-to-squid

squid: doc/mgr: edit telemetry (3 of x)

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

squid: python-common: fix mypy errors in earmarking.py

Fix various errors found by running mypy with python 3.12 on the
python-common subtree. Uses a Protocol as a stand-in for actual file
system integration objects.

Part of an effort to get ceph tox environments passing on Python 3.12.

Signed-off-by: John Mulligan <jmulligan@redhat.com>
Signed-off-by: Avan Thakkar <athakkar@redhat.com>
(cherry picked from commit b77829c45e213d3e984789b903d50d9267be5c74)

doc/radosgw: Promptify CLI commands and fix formatting in layout.rst

Move two example CLI command blocks to use a bash prompt
block with the correct privileged prompt instead of
hardcoded unprivileged prompt.

Don't use the directory "bin/" in command "bin/radosgw-admin"
especially when the next commands also don't use it.

Fix 2 instances of double-backtick missing the second
backtick that caused the rendered doc to be jumbled.

Do not use _emphasis_ that renders as underscores, instead
use RST syntax for italic for the word.

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

doc/mgr: edit telemetry (3 of x)

Improve the English and the formatting in doc/mgr/telemetry.rst. This
follows up on https://github.com/ceph/ceph/pull/63476.

This commit edits the third hundred lines in doc/mgr/telemetry.rst.

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

python-common: fix mypy errors in earmarking.py

Fix various errors found by running mypy with python 3.12 on the
python-common subtree. Uses a Protocol as a stand-in for actual file
system integration objects.

Part of an effort to get ceph tox environments passing on Python 3.12.

Signed-off-by: John Mulligan <jmulligan@redhat.com>
(cherry picked from commit b77829c45e213d3e984789b903d50d9267be5c74)

squid: mgr/dashboard: deprecate transifex-i18ntool and support transifex cli

Fixes https://tracker.ceph.com/issues/71292

- backport of https://github.com/ceph/ceph/pull/63039 for squid

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

Merge pull request #63787 from guits/wip-71535-squid

squid: node-proxy: address `ceph orch hardware status` cmd

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

squid: doc/start: edit documenting-ceph.rst

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

Merge pull request #63905 from zdover23/wip-doc-2025-06-12-backport-63875-to-squid

squid: doc/mgr: edit telemetry.rst

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

doc/mgr: edit telemetry.rst

Follow up on the suggestion made by Anthony D'Atri in
https://github.com/ceph/ceph/pull/63826#discussion_r2136820769.

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

mgr/dashboard: upgrading nvmeof doesn't update configuration

Happens from 19.2.0 to any of the latest upgrade

During upgrade I get
```
Failed to set Dashboard config for nvmeof: dashboard nvmeof-gateway-add failed: JSON array/object not allowed {"prefix": "dashboard nvmeof-gateway-add", "name": "nvmeof.rbd", "group": null, "daemon_name": "nvmeof.rbd.ceph-node-01.irpssg"} retval: -22
```

which is fixed by handling the group_name when its not there in spec.

And the other error was
```
Failed to set Dashboard config for nvmeof: dashboard nvmeof-gateway-add failed: Traceback (most recent call last): File "/usr/share/ceph/mgr/mgr_module.py", line 1864, in _handle_command return CLICommand.COMMANDS[cmd['prefix']].call(self, cmd, inbuf) File "/usr/share/ceph/mgr/mgr_module.py", line 499, in call return self.func(mgr, **kwargs) File "/usr/share/ceph/mgr/mgr_module.py", line 535, in check return func(*args, **kwargs) File "/usr/share/ceph/mgr/dashboard/services/nvmeof_cli.py", line 28, in add_nvmeof_gateway NvmeofGatewaysConfig.add_gateway(name, service_url, group, daemon_name) File "/usr/share/ceph/mgr/dashboard/services/nvmeof_conf.py", line 61, in add_gateway gateway['daemon_name'] = daemon_name TypeError: 'str' object does not support item assignment retval: -22
```

which is fixed by properly updating the config to the newer format that
is available in newer version

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

 Conflicts:
src/pybind/mgr/dashboard/tests/test_nvmeof_cli.py
 -  kept test file and only added the relavant test files

Merge pull request #63849 from zdover23/wip-doc-2025-06-10-backport-63836-to-squid

squid: doc/rados/operations: Address suggestions for stretch-mode.rst

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

Merge pull request #63777 from zdover23/wip-doc-2025-06-06-backport-63741-to-squid

squid: doc/mgr: edit telemetry (4 of x)

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

Merge pull request #63771 from zdover23/wip-doc-2025-06-06-backport-63739-to-squid

squid: doc/mgr: edit telemetry (2 of x)

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

Merge pull request #63861 from zdover23/wip-doc-2025-06-11-backport-63842-to-squid

squid: doc/rados: enhance "pools.rst"

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

Merge pull request #63830 from zdover23/wip-doc-2025-06-10-backport-63745-to-squid

squid: doc/rados/ops: edit cache-tiering.rst

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

doc/mgr: edit telemetry (4 of x)

Improve the English and the formatting in doc/mgr/telemetry.rst. This
follows up on https://github.com/ceph/ceph/pull/63476.

This commit edits the final part of doc/mgr/telemetry.rst.

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

Merge pull request #63864 from zdover23/wip-doc-2025-06-11-backport-63826-to-squid

squid: doc/mgr: edit telemetry.rst

Merge pull request #63867 from zdover23/wip-doc-2025-06-11-backport-63827-to-squid

squid: doc/mgr: edit telemetry.rst (lines 300-400)

Merge pull request #63828 from zdover23/wip-doc-2025-06-10-rados-ops-user-management-58235-followup-squid-only

doc/rados: edit ops/user-management.rst

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

doc/mgr: edit telemetry.rst (lines 300-400)

Edit doc/mgr/telemetry.rst (lines 300-400).

Follow up on the suggestions made by Anthony D'Atri in
https://github.com/ceph/ceph/pull/63741 (except for the one about
including Lovecraftian lore in the dummy user data in this file).

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

doc/mgr: edit telemetry.rst

Edit doc/mgr/telemetry.rst.

Follow up on the suggestions made by Anthony D'Atri in
https://github.com/ceph/ceph/pull/63740.

Make several changes that were not earmarked in that PR, but that
nonetheless improve the quality of the English in telemetry.rst.

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

doc/rados: enhance "pools.rst"

Add a link to the instructions for modifying a user's caps for a given
pool. Add this link where it makes sense to add it. Add this link where
the reader would naturally want to have the link.

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

Merge pull request #63846 from zdover23/wip-doc-2025-06-10-backport-63841-to-squid

squid: doc/rbd: add mirroring troubleshooting info

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

doc/rados/operations: Address suggestions for stretch-mode.rst

Signed-off-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>
fixup

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

doc/rbd: add mirroring troubleshooting info

Add a note to doc/rbd/rbd-mirroring.rst that directs the reader to set
both "site-a" and "site-b" to have the same pool names in the event that
rbd throws the error message "failed to import peer bootstrap token".

This information was reported to the Ceph upstream by Petr Tlapa in June
of 2025, and credit for its development goes to Petr.

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

doc/rados/ops: edit cache-tiering.rst

Remove part of a sentence that might have led readers to think that it
is a good idea to deploy cache tiering on releases prior to Reef.

This incorporates Anthony D'Atri's suggestion from here: https://github.com/ceph/ceph/pull/63614#discussion_r2116020937

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

Merge pull request #62909 from zdover23/wip-doc-2025-04-22-backport-62877-to-squid

squid: doc/radosgw: Improve and more consistent formatting

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

Merge pull request #62502 from zdover23/wip-doc-2025-03-26-backport-62459-to-squid

squid: src/common: add guidance for deep-scrubbing ratio warning

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

doc/rados: edit ops/user-management.rst

Edit an sentence in the imperative mood so that it matches the general
form of imperative sentences immediately preceding commands that contain
replaceable portions.

This commit targets only the Squid release branch.

Follows up on https://github.com/ceph/ceph/pull/58235/.

Tracker: https://tracker.ceph.com/issues/66617

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

Merge pull request #62852 from cbodley/wip-70957-squid

squid: common: CephContext::_refresh_perf_values() checks for null _mempool_perf

Reviewed-by: Laura Flores <lflores@redhat.com>

Merge pull request #62534 from yuvalif/wip-70687-squid

squid: RGW|Bucket Notification: fix for v2 topics rgw-admin list operation

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

Merge pull request #62400 from sajibreadd/wip-67700-squid

squid: OSD: Split osd_recovery_sleep into settings applied to degraded or clean PGs

Reviewed-by: Igor Fedotov <ifedotov@suse.com>

Merge pull request #63815 from zdover23/wip-doc-2025-06-09-backport-62714-to-squid

squid: doc/rados/operations: Improve stretch-mode.rst

doc/rados/operations: Additional improvements to placement-groups.rst

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

doc/rados/operations: Improve stretch-mode.rst

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

Merge PR #58235 into squid

* refs/pull/58235/head:
doc: add documentation for `ceph auth rotate`
PendingReleaseNotes: add note for new `auth rotate`
qa: test `auth rotate`
mon/AuthMonitor: add `ceph auth rotate` command

Reviewed-by: Nitzan Mordechai <nmordech@redhat.com>

node-proxy: address `ceph orch hardware status` cmd

ce360a4a introduced a regression.

`ceph orch hardware status` fails when no hostname is passed (global
cluster hw status report).

Typical failure:

```
Error EINVAL: Traceback (most recent call last):
  File "/usr/share/ceph/mgr/mgr_module.py", line 1928, in _handle_command
    return self.handle_command(inbuf, cmd)
  File "/usr/share/ceph/mgr/orchestrator/_interface.py", line 186, in handle_command
    return dispatch[cmd['prefix']].call(self, cmd, inbuf)
  File "/usr/share/ceph/mgr/mgr_module.py", line 527, in call
    return self.func(mgr, **kwargs)
  File "/usr/share/ceph/mgr/orchestrator/_interface.py", line 122, in <lambda>
    wrapper_copy = lambda *l_args, **l_kwargs: wrapper(*l_args, **l_kwargs)  # noqa: E731
  File "/usr/share/ceph/mgr/orchestrator/_interface.py", line 111, in wrapper
    return func(*args, **kwargs)
  File "/usr/share/ceph/mgr/orchestrator/module.py", line 553, in _hardware_status
    row = [k, v['sn']]
KeyError: 'sn'
```

Only the last node in the list has the `sn`, `host` and `firmwares`
information because of the wrong identation.

Fixes: https://tracker.ceph.com/issues/71472
Signed-off-by: Guillaume Abrioux <gabrioux@ibm.com>
(cherry picked from commit fbcdf571ca11d1b9f504dba64c23fb9f389c0710)

doc/mgr: edit telemetry (2 of x)

Improve the English and the formatting in doc/mgr/telemetry.rst. This
follows up on https://github.com/ceph/ceph/pull/63476.

This commit edits the second hundred lines in doc/mgr/telemetry.rst.

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

doc/mgr: edit telemetry (1 of x)

Improve the English and the formatting in doc/mgr/telemetry.rst. This
follows up on https://github.com/ceph/ceph/pull/63476.

This commit edits down to the line "Note that telemetry must be on for
these commands to take effect.", inclusive.

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

Merge pull request #63704 from zdover23/wip-doc-2025-06-04-backport-63622-to-squid

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

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

doc/radosgw: Improve and more consistent formatting

Use inline code formatting consistently for command
line switches, data, hostnames, etc.
Correctly indent text and child lists in list items.
Remove a mid-sentence double spaces.
Capitalize "RGW" and "API" in text.
Remove unordered lists that are just regular text
everywhere else.
Use correct prompt # instead of $ for privileged
commands.
Use line continuation for multi-line example commands
instead of render them incorrectly as separate
single-line commands.
Use Title Case in few section header text that
missed it.
multisite.rst: Don't repeat "(RGW)" after "RADOS
Gateway" beyond the first instance in the same
paragraph.
multisite.rst: Change one "multisite" to "multi-site"
because all other instances use this spelling (EXCEPT
the title of the document??).
multisite.rst: Fix indentation of continuation lines in
prompted example commands.
Use pre-formatted block, as seen elsewhere in docs,
instead of strange unordered list plus inline code for
syntax example.
Add space before backslash for multi-line command
continuation.

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

doc/rgw: use 'confval' directive to render sts config options

the 'confval' directive reads the config options from
common/options/rgw.yaml and renders them nicely. this keeps
everything consistent between the options and their docs

improve the config option descriptions:

* add existing note about rgw_sts_key length/format
* add example openssl command to generate a conforming sts key
* add notes about sharing sts key between gateways/zones

format the last remaining 'Note' with the 'note' directive

Signed-off-by: Casey Bodley <cbodley@redhat.com>
(cherry picked from commit 6389ff4bcb6562a43b60ccd83e7aa3b150372079)

rgw: fix bug with rgw-gap-list

rgw-gap-list would fail if it it reached the end of the second file
before the first, thereby causing an infinite loop.

Signed-off-by: J. Eric Ivancich <ivancich@redhat.com>
Signed-off-by: Michael J. Kidd <linuxkidd@gmail.com>
(cherry picked from commit 0cfbc57d2c43ea88845561f14e295d0d48e44b32)

doc/start: edit documenting-ceph.rst

Edit the section "Build the Source" in doc/start/documenting-ceph.rst.
Also correct a misuse of the word "presently", which means "in a little
while", not "now".

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

Merge pull request #63683 from zdover23/wip-doc-2025-06-04-backport-63628-to-squid

squid: doc/rados: edit balancer.rst