diff options
author | Thomas Haller <thaller@redhat.com> | 2022-08-09 09:42:28 +0200 |
---|---|---|
committer | Thomas Haller <thaller@redhat.com> | 2022-08-09 10:20:58 +0200 |
commit | 55421209e21e67c5439e93146552dec5afc9f51d (patch) | |
tree | 369e5b29342508ee5855210d0cd2fd4ce4c6bece | |
parent | 6f957f2ef8d57de90f3d0be8258872817d7a7d1c (diff) | |
download | NetworkManager-55421209e21e67c5439e93146552dec5afc9f51d.tar.gz |
man: show example how to enable logging in NetworkManager
-rw-r--r-- | man/NetworkManager.conf.xml | 16 | ||||
-rw-r--r-- | man/NetworkManager.xml | 5 |
2 files changed, 19 insertions, 2 deletions
diff --git a/man/NetworkManager.conf.xml b/man/NetworkManager.conf.xml index 1b917c1740..6a0fd7b1c1 100644 --- a/man/NetworkManager.conf.xml +++ b/man/NetworkManager.conf.xml @@ -624,6 +624,18 @@ unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth </para> <para> + The recommended way for enabling logging is with a file <filename>/etc/NetworkManager/conf.d/95-logging.conf</filename> + that contains +<programlisting> +[logging] +level=TRACE +domains=ALL +</programlisting> + and restart the daemon with <command>systemctl restart NetworkManager</command>. Then + reproduce the problem. You can find the logs in syslog (for example <command>journalctl</command>). + </para> + + <para> Any settings here are overridden by the <option>--log-level</option> and <option>--log-domains</option> command-line options. Logging can also be reconfigured at runtime with @@ -645,8 +657,8 @@ unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth NetworkManager's logging aims not to contain private sensitive data and you should be fine sharing the debug logs. Still, there will be IP addresses and your network setup, if you consider that private - then review the log before sharing. Do not mangle the logfile in - a way that distorts the meaning too much. + then review the log before sharing. However, try not to mangle the logfile + in a way that distorts the meaning too much. </para> <para> diff --git a/man/NetworkManager.xml b/man/NetworkManager.xml index 8f8788856d..80c4fbbd32 100644 --- a/man/NetworkManager.xml +++ b/man/NetworkManager.xml @@ -287,6 +287,11 @@ <literal>RateLimitBurst</literal> options of journald (see <link linkend='journald.conf'><citerefentry><refentrytitle>journald.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry></link> manual). </para> + <para> + NetworkManager does not log any secrets. However, you are advised to check whether anything + private sensitive gets logged before posting. When reporting an issue, provide complete + logs and avoid modifications (for privacy) that distort the meaning. + </para> </refsect1> <refsect1> |