mirror of
https://github.com/systemd/systemd.git
synced 2024-12-22 17:35:35 +03:00
man: add more links to systemd-ask-password and systemd-tty-ask-password-agent
Loosely inspired by https://bugzilla.redhat.com/show_bug.cgi?id=1411134.
This commit is contained in:
parent
fc6e082622
commit
c65aafbb33
@ -61,10 +61,9 @@
|
||||
a system password or passphrase from the user, using a question
|
||||
message specified on the command line. When run from a TTY it will
|
||||
query a password on the TTY and print it to standard output. When
|
||||
run with no TTY or with <option>--no-tty</option> it will query
|
||||
the password system-wide and allow active users to respond via
|
||||
several agents. The latter is only available to privileged
|
||||
processes.</para>
|
||||
run with no TTY or with <option>--no-tty</option> it will use the
|
||||
system-wide query mechanism, which allows active users to respond via
|
||||
several agents, listed below.</para>
|
||||
|
||||
<para>The purpose of this tool is to query system-wide passwords
|
||||
— that is passwords not attached to a specific user account.
|
||||
@ -76,25 +75,38 @@
|
||||
<itemizedlist>
|
||||
|
||||
<listitem><para>A boot-time password agent asking the user for
|
||||
passwords using Plymouth</para></listitem>
|
||||
passwords using
|
||||
<citerefentry project='die-net'><refentrytitle>plymouth</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>A boot-time password agent querying the user
|
||||
directly on the console</para></listitem>
|
||||
directly on the console —
|
||||
<citerefentry><refentrytitle>systemd-ask-password-console.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>An agent requesting password input via a
|
||||
<citerefentry
|
||||
project='man-pages'><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
message</para></listitem>
|
||||
|
||||
<listitem><para>A command line agent which can be started
|
||||
temporarily to process queued password
|
||||
requests</para></listitem>
|
||||
<citerefentry project='man-pages'><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
message —
|
||||
<citerefentry><refentrytitle>systemd-ask-password-wall.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>A TTY agent that is temporarily spawned during
|
||||
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
invocations</para></listitem>
|
||||
invocations,</para></listitem>
|
||||
|
||||
<listitem><para>A command line agent which can be started
|
||||
temporarily to process queued password
|
||||
requests — <command>systemd-tty-ask-password-agent --query</command>.
|
||||
</para></listitem>
|
||||
</itemizedlist></para>
|
||||
|
||||
<para>Answering system-wide password queries is a privileged operation, hence
|
||||
all the agents listed above (except for the last one), run as privileged
|
||||
system services. The last one also needs elevated privileges, so
|
||||
should be run through
|
||||
<citerefentry project='die-net'><refentrytitle>sudo</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
||||
or similar.</para>
|
||||
|
||||
<para>Additional password agents may be implemented according to
|
||||
the <ulink
|
||||
url="http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents">systemd
|
||||
@ -217,7 +229,8 @@
|
||||
<title>See Also</title>
|
||||
<para>
|
||||
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-ask-password-console.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-tty-ask-password</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry project='die-net'><refentrytitle>keyctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry project='die-net'><refentrytitle>plymouth</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry project='man-pages'><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
|
@ -50,7 +50,9 @@
|
||||
|
||||
<refsynopsisdiv>
|
||||
<cmdsynopsis>
|
||||
<command>systemd-tty-ask-password-agent <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="opt" rep="repeat">VARIABLE=VALUE</arg></command>
|
||||
<command>systemd-tty-ask-password-agent</command>
|
||||
<arg choice="opt" rep="repeat">OPTIONS</arg>
|
||||
<arg choice="opt" rep="repeat">VARIABLE=VALUE</arg>
|
||||
</cmdsynopsis>
|
||||
</refsynopsisdiv>
|
||||
|
||||
@ -65,8 +67,10 @@
|
||||
|
||||
<para><command>systemd-tty-ask-password-agent</command> implements
|
||||
the <ulink url="http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents">Password
|
||||
Agents Specification</ulink>.</para>
|
||||
|
||||
Agents Specification</ulink>, and is one of many possible response agents which
|
||||
answer to queries formulated with
|
||||
<citerefentry><refentrytitle>systemd-ask-password</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
|
Loading…
Reference in New Issue
Block a user