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 @@ hostname permissions logging + reload ARGUMENTS @@ -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"