diff --git a/man/file-hierarchy.xml b/man/file-hierarchy.xml
index 9c208dba74..47f93a3234 100644
--- a/man/file-hierarchy.xml
+++ b/man/file-hierarchy.xml
@@ -24,17 +24,21 @@
Description
Operating systems using the
- systemd1 system and service
- manager are organized based on a file system hierarchy inspired by UNIX, more specifically the hierarchy described
- in the File System Hierarchy
- specification and hier7, with various
- extensions, partially documented in the systemd1 system and
+ service manager are organized based on a file system hierarchy inspired by UNIX, more specifically the
+ hierarchy described in the File
+ System Hierarchy specification and hier7, with
+ various extensions, partially documented in the XDG Base Directory
Specification and XDG User
- Directories. This manual page describes a more generalized, though minimal and modernized subset of these
- specifications that defines more strictly the suggestions and restrictions systemd makes on the file system
- hierarchy.
+ Directories. This manual page describes a more generalized, though minimal and modernized subset
+ of these specifications that defines more strictly the suggestions and restrictions systemd makes on the
+ file system hierarchy. Note that this document makes no attempt to define the directory structure
+ comprehensively, it only documents a skeleton of a directory tree, that downstreams can extend. Because
+ of that traditional directories such as /usr/include/ or
+ /var/spool/ are not covered, even though it might (or might not) make a lot of sense
+ to include them in the structure of an actually deployed OS.
Many of the paths described here can be queried
with the
@@ -182,11 +186,6 @@
subdirectory of /usr/lib/ instead.
-
- /usr/include/
- C and C++ API header files of system libraries.
-
-
/usr/lib/
Static, private vendor data that is compatible with all architectures (though not
@@ -282,11 +281,6 @@
calls.
-
- /var/spool/
- Persistent system spool data, such as printer or mail queues.
-
-
/var/tmp/
The place for larger and persistent temporary files. In contrast to
@@ -579,6 +573,9 @@
Similarly, /run/ shall be the only location to
place sockets and FIFOs. Regular files, directories and symlinks
may be used in all directories.
+
+ Applications should expect that a security policy might be enforced on a system that enforces these
+ rules.
@@ -616,10 +613,6 @@
/usr/lib/arch-id/package/
Private other vendor resources of the package that are architecture-specific and cannot be shared between architectures. Note that this generally does not include private executables since binaries of a specific architecture may be freely invoked from any other supported system architecture.
-
- /usr/include/package/
- Public C/C++ APIs of public shared libraries of the package.
-
@@ -667,10 +660,6 @@
/var/log/package/
Persistent log data of the package. As above, the package should make sure to create this directory if necessary, possibly using tmpfiles.d5 or LogsDirectory= (see systemd.exec5), as it might be missing.
-
- /var/spool/package/
- Persistent spool/queue data of the package. As above, the package should make sure to create this directory if necessary, as it might be missing.
-