diff --git a/docs/PORTABILITY_AND_STABILITY.md b/docs/PORTABILITY_AND_STABILITY.md index 4b138b593c..d15bfe117c 100644 --- a/docs/PORTABILITY_AND_STABILITY.md +++ b/docs/PORTABILITY_AND_STABILITY.md @@ -82,7 +82,7 @@ And now, here's the list of (hopefully) all APIs that we have introduced with sy | [hostnamed](https://www.freedesktop.org/wiki/Software/systemd/hostnamed) | D-Bus | yes | yes | GNOME | yes | [Ubuntu](https://launchpad.net/ubuntu/+source/ubuntu-system-service), [Gentoo](http://www.gentoo.org/proj/en/desktop/gnome/openrc-settingsd.xml), [BSD](http://uglyman.kremlin.cc/gitweb/gitweb.cgi?p=systembsd.git;a=summary) | partially | | [localed](https://www.freedesktop.org/wiki/Software/systemd/localed) | D-Bus | yes | yes | GNOME | yes | [Ubuntu](https://launchpad.net/ubuntu/+source/ubuntu-system-service), [Gentoo](http://www.gentoo.org/proj/en/desktop/gnome/openrc-settingsd.xml), [BSD](http://uglyman.kremlin.cc/gitweb/gitweb.cgi?p=systembsd.git;a=summary) | partially | | [timedated](https://www.freedesktop.org/wiki/Software/systemd/timedated) | D-Bus | yes | yes | GNOME | yes | [Gentoo](http://www.gentoo.org/proj/en/desktop/gnome/openrc-settingsd.xml), [BSD](http://uglyman.kremlin.cc/gitweb/gitweb.cgi?p=systembsd.git;a=summary) | partially | -| [initrd interface](https://www.freedesktop.org/wiki/Software/systemd/InitrdInterface) | Environment, flag files | yes | yes | dracut, ArchLinux | yes | ArchLinux | no | +| [initrd interface](https://systemd.io/INITRD_INTERFACE/) | Environment, flag files | yes | yes | dracut, ArchLinux | yes | ArchLinux | no | | [Container interface](https://systemd.io/CONTAINER_INTERFACE) | Environment, Mounts | yes | yes | libvirt/LXC | yes | - | no | | [Boot Loader interface](https://systemd.io/BOOT_LOADER_INTERFACE) | EFI variables | yes | yes | gummiboot | yes | - | no | | [Service bus API](https://www.freedesktop.org/wiki/Software/systemd/dbus) | D-Bus | yes | yes | system-config-services | no | - | no | @@ -94,14 +94,14 @@ And now, here's the list of (hopefully) all APIs that we have introduced with sy | [$XDG_RUNTIME_DIR](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) | Environment | yes | yes | glib, GNOME | yes | - | no | | [$LISTEN_FDS $LISTEN_PID FD Passing](https://www.freedesktop.org/software/systemd/man/sd_listen_fds.html) | Environment | yes | yes | numerous (via sd-daemon.h) | yes | - | no | | [$NOTIFY_SOCKET Daemon Notifications](https://www.freedesktop.org/software/systemd/man/sd_notify.html) | Environment | yes | yes | a few, including udev | yes | - | no | -| [argv[0][0]='@' Logic](https://www.freedesktop.org/wiki/Software/systemd/RootStorageDaemons) | `/proc` marking | yes | yes | mdadm | yes | - | no | +| [argv[0][0]='@' Logic](https://systemd.io/ROOT_STORAGE_DAEMONS/) | `/proc` marking | yes | yes | mdadm | yes | - | no | | [Unit file format](https://www.freedesktop.org/software/systemd/man/systemd.unit.html) | File format | yes | yes | numerous | no | - | no | | [Network](https://www.freedesktop.org/software/systemd/man/systemd.network.html) & [Netdev file format](https://www.freedesktop.org/software/systemd/man/systemd.netdev.html) | File format | yes | yes | no | no | - | no | | [Link file format](https://www.freedesktop.org/software/systemd/man/systemd.link.html) | File format | yes | yes | no | no | - | no | | [Journal File Format](https://systemd.io/JOURNAL_FILE_FORMAT) | File format | yes | yes | - | maybe | - | no | | [Journal Export Format](https://www.freedesktop.org/wiki/Software/systemd/export) | File format | yes | yes | - | yes | - | no | | [Cooperation in cgroup tree](https://www.freedesktop.org/wiki/Software/systemd/PaxControlGroups) | Treaty | yes | yes | libvirt | yes | libvirt | no | -| [Password Agents](https://www.freedesktop.org/wiki/Software/systemd/PasswordAgents) | Socket+Files | yes | yes | - | yes | - | no | +| [Password Agents](https://systemd.io/PASSWORD_AGENTS/) | Socket+Files | yes | yes | - | yes | - | no | | [udev multi-seat properties](https://www.freedesktop.org/wiki/Software/systemd/multiseat) | udev Property | yes | yes | X11, gdm | no | - | no | | udev session switch ACL properties | udev Property | no | no | - | no | - | no | | [CLI of systemctl,...](https://www.freedesktop.org/software/systemd/man/systemctl.html) | CLI | yes | yes | numerous | no | - | no | diff --git a/docs/ROOT_STORAGE_DAEMONS.md b/docs/ROOT_STORAGE_DAEMONS.md index 779044b0d4..e18ac45bd0 100644 --- a/docs/ROOT_STORAGE_DAEMONS.md +++ b/docs/ROOT_STORAGE_DAEMONS.md @@ -108,9 +108,9 @@ to find a different solution to your problem._ The recommended way to distinguish between run-from-initrd and run-from-rootfs for a daemon is to check for `/etc/initrd-release` (which exists on all modern initrd implementations, see the [initrd -Interface](http://www.freedesktop.org/wiki/Software/systemd/InitrdInterface) -for details) which when exists results in `argv[0][0]` being set to `@`, and -otherwise doesn't. Something like this: +Interface](https://systemd.io/INITRD_INTERFACE/) for details) which when exists +results in `argv[0][0]` being set to `@`, and otherwise doesn't. Something like +this: ```c #include diff --git a/man/systemd-ask-password-console.service.xml b/man/systemd-ask-password-console.service.xml index 8c0e8a88f9..ba8fe7e928 100644 --- a/man/systemd-ask-password-console.service.xml +++ b/man/systemd-ask-password-console.service.xml @@ -45,10 +45,9 @@ It is intended to be used after boot to ensure that users are properly notified. - See the - developer documentation for more information about the - system password logic. + See the developer + documentation for more information about the system password logic. + Note that these services invoke systemd-tty-ask-password-agent1 diff --git a/man/systemd-ask-password.xml b/man/systemd-ask-password.xml index 9bb045b943..f696623ee7 100644 --- a/man/systemd-ask-password.xml +++ b/man/systemd-ask-password.xml @@ -81,9 +81,8 @@ or similar. Additional password agents may be implemented according to - the systemd - Password Agent Specification. + the systemd Password Agent + Specification. If a password is queried on a TTY, the user may press TAB to hide the asterisks normally shown for each character typed. diff --git a/man/systemd-cryptsetup@.service.xml b/man/systemd-cryptsetup@.service.xml index 47051b9cef..164fc2ed84 100644 --- a/man/systemd-cryptsetup@.service.xml +++ b/man/systemd-cryptsetup@.service.xml @@ -36,10 +36,9 @@ systemd-cryptsetup@.service will ask for hard disk passwords via the - password agent logic, in order to query the user for the - password using the right mechanism at boot and during - runtime. + url="https://systemd.io/PASSWORD_AGENTS/">password agent logic, in + order to query the user for the password using the right mechanism at boot + and during runtime. At early boot and when the system manager configuration is reloaded, /etc/crypttab is translated into systemd-cryptsetup@.service units by diff --git a/man/systemd-tty-ask-password-agent.xml b/man/systemd-tty-ask-password-agent.xml index 8d9e9e0c1b..36089dff83 100644 --- a/man/systemd-tty-ask-password-agent.xml +++ b/man/systemd-tty-ask-password-agent.xml @@ -39,8 +39,8 @@ runtime. systemd-tty-ask-password-agent implements - the Password - Agents Specification, and is one of many possible response agents which + the Password Agents + Specification, and is one of many possible response agents which answer to queries formulated with systemd-ask-password1. diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index 80057e27e3..23c60d5c01 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -255,9 +255,8 @@ start it even manually. The unit file format is covered by the - Interface - Stability Promise. + Interface + Portability and Stability Promise. diff --git a/man/systemd.xml b/man/systemd.xml index a9040545c2..501faf266d 100644 --- a/man/systemd.xml +++ b/man/systemd.xml @@ -272,8 +272,7 @@ Note that some but not all interfaces provided by systemd are covered by the - Interface - Stability Promise. + Interface Portability and Stability Promise. Units may be generated dynamically at boot and system manager reload time, for example based on other configuration @@ -287,8 +286,8 @@ Systems which invoke systemd in a container or initrd environment should implement the Container Interface or initrd Interface + url="https://systemd.io/CONTAINER_INTERFACE">Container Interface or + initrd Interface specifications, respectively.