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. -