From e80c5eb6e63c394fd90c2d8cf454ee649e59ae21 Mon Sep 17 00:00:00 2001 From: Ryan Brue Date: Mon, 18 Aug 2025 12:12:26 -0500 Subject: [PATCH] man: Clarify usage of /usr/share/factory/ in programs As discussed in this thread: https://github.com/redhat-performance/tuned/issues/798#issuecomment-3197697654 /usr/share/factory/ is not intended to be read from by programs, but the wording in the FHS can be misread to think that programs should be using /usr/share/factory/ as the vendor supplied configuration directory rather than something like /usr/lib/foo/ or /usr/share/foo/. This commit points developers to the UAPI configuration spec for how to make their programs hermetic /usr/ compatible. Signed-off-by: Ryan Brue --- man/file-hierarchy.xml | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/man/file-hierarchy.xml b/man/file-hierarchy.xml index 1c4a33d5977..a61cada6958 100644 --- a/man/file-hierarchy.xml +++ b/man/file-hierarchy.xml @@ -230,7 +230,9 @@ Repository for vendor-supplied default configuration files. This directory should be populated with pristine vendor versions of all configuration files that may be placed in /etc/. This is useful to compare the local configuration of a system with vendor - defaults and to populate the local configuration with defaults. + defaults and to populate the local configuration with defaults. Software should not read configuration + settings directly from /usr/share/factory/. Those files will be copied to + other locations if appropriate, and should only be read from there. @@ -239,7 +241,9 @@ Similar to /usr/share/factory/etc/, but for vendor versions of files in the variable, persistent data directory - /var/. + /var/. The same recommendations as for + /usr/share/factory/etc/ apply here. + -- 2.47.3