diff --git a/man/nmcli.xml b/man/nmcli.xml
index b0665efd69..bc72c3110b 100644
--- a/man/nmcli.xml
+++ b/man/nmcli.xml
@@ -356,6 +356,7 @@
hostnamepermissionslogging
+ reloadARGUMENTS
@@ -419,6 +420,66 @@
for available level and domain values.
+
+
+
+ reload
+ flags
+
+
+
+
+ Reload NetworkManager's configuration and perform certain
+ updates, like flushing caches or rewriting external state to
+ disk. This is similar to sending SIGHUP to NetworkManager
+ but it allows for more fine-grained control over what to
+ reload through the flags argument. It also allows non-root
+ access via PolicyKit and contrary to signals it is
+ synchronous. Available flags are:
+
+
+
+
+
+ Reload the NetworkManager.conf configuration from
+ disk. Note that this does not include connections, which
+ can be reloaded through nmcli connection
+ reload instead.
+
+
+
+
+
+
+ Update DNS configuration, which usually involves writing
+ /etc/resolv.conf anew. This is equivalent to sending the
+ SIGUSR1 signal to the NetworkManager process.
+
+
+
+
+
+
+ Restart the DNS plugin. This is for example useful when
+ using dnsmasq plugin, which uses additional
+ configuration in
+ /etc/NetworkManager/dnsmasq.d. If
+ you edit those files, you can restart the DNS
+ plugin. This action shortly interrupts name resolution.
+
+
+
+
+ With no flags, everything that is supported is reloaded,
+ which is identical to sending a SIGHUP. See
+
+ NetworkManager
+ 8
+
+ for more details about signals.
+
+
+
diff --git a/src/nmcli/general.c b/src/nmcli/general.c
index f0b4309e59..e40f39e527 100644
--- a/src/nmcli/general.c
+++ b/src/nmcli/general.c
@@ -344,7 +344,8 @@ usage_general_reload(void)
" can be reloaded through 'nmcli connection reload' instead.\n"
"\n"
" 'dns-rc' Update DNS configuration, which usually involves writing\n"
- " /etc/resolv.conf anew.\n"
+ " /etc/resolv.conf anew. This is equivalent to sending the\n"
+ " SIGUSR1 signal to the NetworkManager process.\n"
"\n"
" 'dns-full' Restart the DNS plugin. This is for example useful when\n"
" using dnsmasq plugin, which uses additional configuration\n"