From 7df46b2af58d171665fe99073188f91d567f2696 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Wed, 27 Jun 2012 01:32:15 +0200 Subject: [PATCH] man: document systemd-ask-password-console.service and friends --- Makefile.am | 11 ++- man/systemd-ask-password-console.service.xml | 91 +++++++++++++++++++ units/systemd-ask-password-console.path | 2 +- units/systemd-ask-password-console.service.in | 2 +- units/systemd-ask-password-wall.path | 2 +- units/systemd-ask-password-wall.service.in | 2 +- 6 files changed, 104 insertions(+), 6 deletions(-) create mode 100644 man/systemd-ask-password-console.service.xml diff --git a/Makefile.am b/Makefile.am index 215e88d9b..04ae77519 100644 --- a/Makefile.am +++ b/Makefile.am @@ -494,7 +494,8 @@ MANPAGES = \ man/systemd-shutdownd.service.8 \ man/systemd-suspend.service.8 \ man/systemd-halt.service.8 \ - man/systemd-fsck@.service.8 + man/systemd-fsck@.service.8 \ + man/systemd-ask-password-console.service.8 MANPAGES_ALIAS = \ man/reboot.8 \ @@ -517,7 +518,10 @@ MANPAGES_ALIAS = \ man/systemd-poweroff.service.8 \ man/systemd-reboot.service.8 \ man/systemd-kexec.service.8 \ - man/systemd-fsck-root.service.8 + man/systemd-fsck-root.service.8 \ + man/systemd-ask-password-console.path.8 \ + man/systemd-ask-password-wall.service.8 \ + man/systemd-ask-password-wall.path.8 man/reboot.8: man/halt.8 man/poweroff.8: man/halt.8 @@ -540,6 +544,9 @@ man/systemd-poweroff.service.8: man/systemd-halt.service.8 man/systemd-reboot.service.8: man/systemd-halt.service.8 man/systemd-kexec.service.8: man/systemd-halt.service.8 man/systemd-fsck-root.service.8: man/systemd-fsck@.service.8 +man/systemd-ask-password-console.path.8: man/systemd-ask-password-console.service.8 +man/systemd-ask-password-wall.service.8: man/systemd-ask-password-console.service.8 +man/systemd-ask-password-wall.path.8: man/systemd-ask-password-console.service.8 XML_FILES = \ ${patsubst %.1,%.xml,${patsubst %.3,%.xml,${patsubst %.5,%.xml,${patsubst %.7,%.xml,${patsubst %.8,%.xml,$(MANPAGES)}}}}} diff --git a/man/systemd-ask-password-console.service.xml b/man/systemd-ask-password-console.service.xml new file mode 100644 index 000000000..5a9e240f5 --- /dev/null +++ b/man/systemd-ask-password-console.service.xml @@ -0,0 +1,91 @@ + + + + + + + + systemd-ask-password-console.service + systemd + + + + Developer + Lennart + Poettering + lennart@poettering.net + + + + + + systemd-ask-password-console.service + 8 + + + + systemd-ask-password-console.service + systemd-ask-password-console.path + systemd-ask-password-wall.service + systemd-ask-password-wall.path + Query the user for system passwords on the + console and via + wall1 + + + + systemd-ask-password-console.service + systemd-ask-password-console.path + systemd-ask-password-wall.service + systemd-ask-password-wall.path + + + + Description + + systemd-ask-password-console.service + is a system service that queries the user for system + passwords (such as hard disk encryption keys and SSL + certificate passphrases) on the console. It is + intended to be used during boot to ensure proper + handling of passwords necessary for + boot. systemd-ask-password-wall.service + is a system service that informs all logged in users + for system passwords via + wall1. 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 Also + + systemd1, + systemd-ask-password-agent1, + wall1 + + + + diff --git a/units/systemd-ask-password-console.path b/units/systemd-ask-password-console.path index a0a3631b2..80f6cc4c1 100644 --- a/units/systemd-ask-password-console.path +++ b/units/systemd-ask-password-console.path @@ -7,7 +7,7 @@ [Unit] Description=Dispatch Password Requests to Console Directory Watch -Documentation=http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents +Documentation=man:systemd-ask-password-console.service(8) DefaultDependencies=no Conflicts=shutdown.target After=plymouth-start.service diff --git a/units/systemd-ask-password-console.service.in b/units/systemd-ask-password-console.service.in index 85e739fd8..4bcb30be0 100644 --- a/units/systemd-ask-password-console.service.in +++ b/units/systemd-ask-password-console.service.in @@ -7,7 +7,7 @@ [Unit] Description=Dispatch Password Requests to Console -Documentation=http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents +Documentation=man:systemd-ask-password-console.service(8) DefaultDependencies=no Conflicts=shutdown.target After=plymouth-start.service diff --git a/units/systemd-ask-password-wall.path b/units/systemd-ask-password-wall.path index 3890a7412..62dee8055 100644 --- a/units/systemd-ask-password-wall.path +++ b/units/systemd-ask-password-wall.path @@ -7,7 +7,7 @@ [Unit] Description=Forward Password Requests to Wall Directory Watch -Documentation=http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents +Documentation=man:systemd-ask-password-console.service(8) DefaultDependencies=no Conflicts=shutdown.target Before=basic.target shutdown.target diff --git a/units/systemd-ask-password-wall.service.in b/units/systemd-ask-password-wall.service.in index 9305fca6f..b2ca03949 100644 --- a/units/systemd-ask-password-wall.service.in +++ b/units/systemd-ask-password-wall.service.in @@ -7,7 +7,7 @@ [Unit] Description=Forward Password Requests to Wall -Documentation=http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents +Documentation=man:systemd-ask-password-console.service(8) After=systemd-user-sessions.service [Service] -- 2.30.2