Bugzilla – Bug 1212777
[doc] Issue in "Creating drop-in files"
Last modified: 2023-09-25 17:51:20 UTC
Creating drop-in files: https://documentation.suse.com/sles/15-SP5/html/SLES-all/cha-systemd.html#sec-boot-systemd-custom-drop-in The section currently talks about unit files but the concept of drop-in files generalizes to systemd config files too. (I.e. files like /etc/systemd/system.conf that configure systemd itself and not individual units). 1) To make it more useful to readers it should mention usage of `systemd-analyze cat-config` as a way to inspect what drop-ins and in what order are applied for given config file. (Caveat: current version (249.16-150400.8.25.7) of systemd-analyze will show early drop-ins in wrong order. More on them below.) 2) It should mention that SUSE ships systemd-default-settings (and others?) branding packages that modify the defaults. (Corollary: default value may divert from what systemd manpages say.) 3) It may mention special treating of early drop-ins -- drop-in files whose name starts with double underscore and their purpose is to be of lower priority than "fragment" config files (e.g. /etc/systemd/system.conf) that are meant for site-local config values. 4) The docs may discourage usage of "fragment" config files in favor of proper drop-in files for local modifications.
(In reply to Michal Koutný from comment #0) > 3) > It may mention special treating of early drop-ins -- drop-in files whose > name starts with double underscore and their purpose is to be of lower > priority than "fragment" config files (e.g. /etc/systemd/system.conf) that > are meant for site-local config values. If we document early drop-ins then we should emphasize that they're strictly reserved for SUSE usage only and SUSE reserves the right to drop their support at any time.
(In reply to Michal Koutný from comment #0) > priority than "fragment" config files (e.g. /etc/systemd/system.conf) that > are meant for site-local config values. Not sure whether "fragment" is better than "main". The only place where I see the term "fragment" is in the source code of systemd.
Thank you for reporting this bug! It is being tracked and processed as part of our queue.
Tomas, I wrote a similar document and added it to the opensuse wiki: https://en.opensuse.org/Systemd#Configuration. Feel free to reuse it for the SLE documentation. Also I think that it shouldn't be tied to SP5+ but should apply to any older SPs too.
(In reply to Michal Koutný from comment #0) > 3) > It may mention special treating of early drop-ins -- drop-in files whose > name starts with double underscore and their purpose is to be of lower > priority than "fragment" config files (e.g. /etc/systemd/system.conf) that > are meant for site-local config values. Please do not mention early drop-ins. These have been introduced for the sole purpose of SUSE and they're going to removed anyways. I don't want to give to the customers the impression that keeping using main config files is safe.
Progress is tracked in https://github.com/SUSE/doc-sle/pull/1595 @Franck @Michal, can you review pls?
(In reply to Tomáš Bažant from comment #8) > Progress is tracked in https://github.com/SUSE/doc-sle/pull/1595 > @Franck @Michal, can you review pls? Done.
fixed by https://github.com/SUSE/doc-sle/tree/main