about summary refs log tree commit diff
path: root/man/nm-cloud-setup.8
diff options
context:
space:
mode:
authorMichael Biebl <biebl@debian.org>2023-08-09 21:55:35 +0200
committerMichael Biebl <biebl@debian.org>2023-08-09 21:55:35 +0200
commit05e4a733f2141995181a551854d5df929f084adf (patch)
tree83bb937740a6667525ba0df046748ecaa829c269 /man/nm-cloud-setup.8
parent14b0f3a9dc9ea90d60a3b057350fd4d637dc021a (diff)
New upstream version 1.44.0 upstream/1.44.0
Diffstat (limited to 'man/nm-cloud-setup.8')
-rw-r--r--man/nm-cloud-setup.826
1 files changed, 22 insertions, 4 deletions
diff --git a/man/nm-cloud-setup.8 b/man/nm-cloud-setup.8
index da7d1712..3ddd93eb 100644
--- a/man/nm-cloud-setup.8
+++ b/man/nm-cloud-setup.8
@@ -2,12 +2,12 @@
 .\"     Title: nm-cloud-setup
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 06/28/2023
+.\"      Date: 08/09/2023
 .\"    Manual: Automatic Network Configuration in Cloud with NetworkManager
-.\"    Source: NetworkManager 1.42.8
+.\"    Source: NetworkManager 1.44.0
 .\"  Language: English
 .\"
-.TH "NM\-CLOUD\-SETUP" "8" "" "NetworkManager 1\&.42\&.8" "Automatic Network Configuratio"
+.TH "NM\-CLOUD\-SETUP" "8" "" "NetworkManager 1\&.44\&.0" "Automatic Network Configuratio"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -119,7 +119,8 @@ WARN,
 ERR
 or
 OFF\&. The program will print message on stdout and the default level is
-WARN\&.
+WARN\&. When run as systemd service, the log will be collected by journald can can be seen with
+\fBjournalctl\fR\&.
 .RE
 .sp
 .RS 4
@@ -169,6 +170,23 @@ no\&.
 NM_CLOUD_SETUP_ALIYUN: boolean, whether Alibaba Cloud (Aliyun) support is enabled\&. Defaults to
 no\&.
 .RE
+.SH "DEBUGGING"
+.PP
+Enable debug logging by setting
+NM_CLOUD_SETUP_LOG
+environment variable to
+TRACE\&.
+.PP
+In the common case where nm\-cloud\-setup is running as systemd service, this can be done via
+\fBsystemctl edit nm\-cloud\-setup\&.service\fR
+and add
+Environment=NM_CLOUD_SETUP_LOG=TRACE
+to the
+[Service]
+section\&. Afterwards, the log can be found in syslog via
+journalctl\&. You may also want to enable debug logging in NetworkManager as descibed in the DEBUGGING section in
+\fBNetworkManager\fR(5)
+manual\&. When sharing logs, it\*(Aqs best to share complete logs and not preemptively filter for NetworkManager or nm\-cloud\-setup logs\&.
 .SH "EXAMPLE SETUP FOR CONFIGURING AND PREDEPLOYING NM\-CLOUD\-SETUP"
 .PP
 As detailed before, nm\-cloud\-setup needs to be explicitly enabled\&. As it runs as a systemd service and timer, that basically means to enable and configure those\&. This can be done by dropping the correct files and symlinks to disk\&.