From e31cc1efd724903b9cfeca5c070978113586ed28 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 16 Sep 2024 20:08:41 +0200 Subject: Adding upstream version 256.1. Signed-off-by: Daniel Baumann --- man/systemd-tmpfiles.xml | 30 ++++++++++++++++++++++++----- man/systemd.xml | 49 ++++++++++++++++++++++++------------------------ 2 files changed, 49 insertions(+), 30 deletions(-) (limited to 'man') diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml index 008bff6..2a494b9 100644 --- a/man/systemd-tmpfiles.xml +++ b/man/systemd-tmpfiles.xml @@ -55,9 +55,11 @@ Description - systemd-tmpfiles creates, deletes, and cleans up volatile and temporary files - and directories, using the configuration file format and location specified in - tmpfiles.d5. It must + systemd-tmpfiles creates, deletes, and cleans up files and directories, using + the configuration file format and location specified in + tmpfiles.d5. + Historically, it was designed to manage volatile and temporary files, as the name suggests, but it provides + generic file management functionality and can be used to manage any kind of files. It must be invoked with one or more commands , , and , to select the respective subset of operations. @@ -149,8 +151,26 @@ - If this option is passed, all files and directories created by a - tmpfiles.d/ entry will be deleted. + + If this option is passed, all files and directories marked for + creation by the tmpfiles.d/ files specified on the command + line will be deleted. Specifically, this acts on all files and directories + marked with f, F, d, D, + v, q, Q, p, + L, c, b, C, + w, e. If this switch is used at least one + tmpfiles.d/ file (or - for standard input) must be + specified on the command line or the invocation will be refused, for safety reasons (as otherwise + much of the installed system files might be removed). + + The primary usecase for this option is to automatically remove files and directories that + originally have been created on behalf of an installed packaged at package removal time. + + It is recommended to first run this command in combination with + (see below) to verify which files and directories will be deleted. + + Warning! This is is usually not the command you want! In most cases + is what you are looking for. diff --git a/man/systemd.xml b/man/systemd.xml index 66db5bb..f4aa7e0 100644 --- a/man/systemd.xml +++ b/man/systemd.xml @@ -62,10 +62,29 @@ user.conf.d directories. See systemd-system.conf5 for more information. + + systemd contains native implementations of various tasks that need to be + executed as part of the boot process. For example, it sets the hostname or configures the loopback + network device. It also sets up and mounts various API file systems, such as /sys/, + /proc/, and /dev/. + + Note that some but not all interfaces provided by systemd are covered by the + Interface Portability and Stability Promise. + + The D-Bus API of systemd is described in + org.freedesktop.systemd15 + and + org.freedesktop.LogControl15. + + + Systems which invoke systemd in a container or initrd environment should implement the Container Interface or + initrd Interface + specifications, respectively. - Concepts + Units systemd provides a dependency system between various entities called "units" of 11 different types. Units encapsulate @@ -261,34 +280,10 @@ example, start jobs for any of those inactive units getting queued as well. - systemd contains native implementations of various tasks - that need to be executed as part of the boot process. For example, - it sets the hostname or configures the loopback network device. It - also sets up and mounts various API file systems, such as - /sys/ or /proc/. - - For more information about the concepts and - ideas behind systemd, please refer to the - Original Design Document. - - Note that some but not all interfaces provided by systemd are covered by the - Interface Portability and Stability Promise. - Units may be generated dynamically at boot and system manager reload time, for example based on other configuration files or parameters passed on the kernel command line. For details, see systemd.generator7. - - The D-Bus API of systemd is described in - org.freedesktop.systemd15 - and - org.freedesktop.LogControl15. - - - Systems which invoke systemd in a container or initrd environment should implement the Container Interface or - initrd Interface - specifications, respectively. @@ -1558,6 +1553,10 @@ bootup7 systemd.directives7 + + For more information about the concepts and + ideas behind systemd, please refer to the + Original Design Document. -- cgit v1.2.3