summaryrefslogtreecommitdiff
path: root/man/nm-settings.xsl
diff options
context:
space:
mode:
authorThomas Haller <thaller@redhat.com>2017-09-28 17:29:45 +0200
committerThomas Haller <thaller@redhat.com>2017-09-28 17:56:49 +0200
commit46dc919e687992aac16d3038fe6b4e8c4474a10d (patch)
tree0a45ead672280a11aa725968fdb37b54f863e1e6 /man/nm-settings.xsl
parenta47c48fd84e2561bad93f9e4f12fece7347ae5b5 (diff)
downloadNetworkManager-46dc919e687992aac16d3038fe6b4e8c4474a10d.tar.gz
man: clearify plain text secrets in keyfile
Diffstat (limited to 'man/nm-settings.xsl')
-rw-r--r--man/nm-settings.xsl9
1 files changed, 7 insertions, 2 deletions
diff --git a/man/nm-settings.xsl b/man/nm-settings.xsl
index 36fb82885f..57d5ce41cf 100644
--- a/man/nm-settings.xsl
+++ b/man/nm-settings.xsl
@@ -87,13 +87,18 @@
<refsect2 id="secrets-flags">
<title>Secret flag types:</title>
<para>
- Each secret property in a setting has an associated <emphasis>flags</emphasis> property
+ Each password or secret property in a setting has an associated <emphasis>flags</emphasis> property
that describes how to handle that secret. The <emphasis>flags</emphasis> property is a bitfield
that contains zero or more of the following values logically OR-ed together.
</para>
<itemizedlist>
<listitem>
- <para>0x0 (none) - the system is responsible for providing and storing this secret.</para>
+ <para>0x0 (none) - the system is responsible for providing and storing this secret. This
+ may be required so that secrets are already available before the user logs in.
+ It also commonly means that the secret will be stored in plain text on disk, accessible
+ to root only. For example via the keyfile settings plugin as described in the "PLUGINS" section
+ in <link linkend='NetworkManager.conf'><citerefentry><refentrytitle>NetworkManager.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry></link>.
+ </para>
</listitem>
<listitem>
<para>0x1 (agent-owned) - a user-session secret agent is responsible for providing and storing