]> git-server-git.apps.pok.os.sepia.ceph.com Git - ceph.git/commit
common/options: document log_to_stderr's conditional default value 66766/head
authorKefu Chai <k.chai@proxmox.com>
Wed, 31 Dec 2025 09:01:43 +0000 (17:01 +0800)
committerKefu Chai <k.chai@proxmox.com>
Wed, 31 Dec 2025 09:20:04 +0000 (17:20 +0800)
commit5f16ba3a17a7fdf1c791b45871bd0998ee8c95ac
treeed1e3c4f77292112830d06b027cfdcdf24c2af68
parent9438aabf3f7481505082b794a2efb10a082e9350
common/options: document log_to_stderr's conditional default value

The default value of `log_to_stderr` varies depending on whether Ceph
runs as a daemon or a library. Previously, this was only documented via
the `default` property, which led to confusion when debugging client
applications.

For example, when debugging a CephFS client, setting `debug <subsystem> = 5`
in the configuration file doesn't produce visible debug logs as expected.
This occurs because `common_preinit()` overrides `log_to_stderr` to `false`
when Ceph runs as a library, preventing logs from appearing on stderr.

This commit adds clarification to the `long_desc` field to document this
conditional behavior and help users understand why debug output may not
appear in client scenarios.

Signed-off-by: Kefu Chai <k.chai@proxmox.com>
src/common/options/global.yaml.in