From e74c568b07b50b97873fb4ee1d776dedefbd54d6 Mon Sep 17 00:00:00 2001
From: Michael Biebl NetworkManager-dispatcher — Dispatch user scripts for NetworkManager
+ NetworkManager-dispatcher service is a D-Bus activated service that
+ runs user provided scripts upon certain changes in NetworkManager.
+
+ NetworkManager-dispatcher will execute scripts in the
+
+ Each script receives two arguments, the first being the interface name of the
+ device an operation just happened on, and second the action. For device actions,
+ the interface is the name of the kernel interface suitable for IP configuration.
+ Thus it is either VPN_IP_IFACE, DEVICE_IP_IFACE, or DEVICE_IFACE, as applicable.
+ For the The actions are: The interface is connected to the network but is not
+ yet fully activated. Scripts acting on this event must be placed or
+ symlinked into the The interface has been activated. The interface will be deactivated but has not yet been
+ disconnected from the network. Scripts acting on this event must be
+ placed or symlinked into the
+ The interface has been deactivated.
+ The VPN is connected to the network but is not yet
+ fully activated. Scripts acting on this event must be placed or
+ symlinked into the
+ A VPN connection has been activated.
+ The VPN will be deactivated but has not yet been
+ disconnected from the network. Scripts acting on this event must be
+ placed or symlinked into the
+ A VPN connection has been deactivated.
+
+ The system hostname has been updated. Use gethostname(2) to retrieve it.
+ The interface name (first argument) is empty and no environment variable is
+ set for this action.
+
+ The DHCPv4 lease has changed (renewed, rebound, etc).
+
+ The DHCPv6 lease has changed (renewed, rebound, etc).
+
+ The network connectivity state has changed (no connectivity, went online, etc).
+
+ The environment contains more information about the interface and the connection.
+ The following variables are available for the use in the dispatcher scripts:
+
+ The dispatcher action like "up" or "dhcp4-change", identical to the first
+ command line argument. Since NetworkManager 1.12.0.
+
+ The UUID of the connection profile.
+
+ The name (ID) of the connection profile.
+
+ The NetworkManager D-Bus path of the connection.
+
+ The backing file name of the connection profile (if any).
+
+ If "1", this indicates that the connection describes a
+ network configuration created outside of NetworkManager.
+
+ The interface name of the control interface of the device.
+ Depending on the device type, this differs from
+
+ The IP interface name of the device. This is the network
+ interface on which IP addresses and routes will be configured.
+
+ The IPv4 address in the format "address/prefix gateway", where N is a number
+ from 0 to (# IPv4 addresses - 1). gateway item in this variable is deprecated,
+ use IP4_GATEWAY instead.
+
+ The variable contains the number of IPv4 addresses the script may expect.
+
+ The gateway IPv4 address in traditional numbers-and-dots notation.
+
+ The IPv4 route in the format "address/prefix next-hop metric", where N is a number
+ from 0 to (# IPv4 routes - 1).
+
+ The variable contains the number of IPv4 routes the script may expect.
+
+ The variable contains a space-separated list of the DNS servers.
+
+ The variable contains a space-separated list of the search domains.
+
+ If the connection used DHCP for address configuration, the received DHCP
+ configuration is passed in the environment using standard DHCP
+ option names, prefixed with "DHCP4_", like "DHCP4_HOST_NAME=foobar".
+
+ The same variables as for IPv4 are available for IPv6, but the prefixes are IP6_
+ and DHCP6_ instead.
+ The network connectivity state, which can
+ take the values defined by the NMConnectivityState type,
+ from the org.freedesktop.NetworkManager D-Bus API: unknown,
+ none, portal, limited or full. Note: this variable will only
+ be set for connectivity-change actions.
+
+
+ In case of VPN, VPN_IP_IFACE is set, and IP4_*, IP6_* variables with VPN prefix are
+ exported too, like VPN_IP4_ADDRESS_0, VPN_IP4_NUM_ADDRESSES.
+
+ Dispatcher scripts are run one at a time, but asynchronously from the main
+ NetworkManager process, and will be killed if they run for too long. If your script
+ might take arbitrarily long to complete, you should spawn a child process and have the
+ parent return immediately. Scripts that are symbolic links pointing inside the
+
+ Please report any bugs you find in NetworkManager at the
+ NetworkManager issue tracker.
+
+ NetworkManager does not require any configuration in
- Minimal system settings configuration file looks like this:
+ A simple configuration file looks like this:
+ The firewall backend for configuring masquerading
+ with shared mode.
+ Set to either
+ If the value is "auto" (the default), IWD is queried for its
+ current state directory when it appears on D-Bus -- the
+ directory where IWD keeps its network configuration files --
+ usually /var/lib/iwd. NetworkManager will then attempt to
+ write copies of new or modified Wi-Fi connection profiles,
+ converted into the IWD format, into this directory thus making
+ IWD connection properties editable. NM will overwrite existing
+ files without preserving their contents.
+
+ The path can also be overriden by pointing to a specific
+ existing and writable directory. On the other hand setting
+ this to an empty string or any other value disables the
+ profile conversion mechanism.
+
+ This mechanism allows editing connection profile settings such
+ as the 802.1x configuration using NetworkManager clients.
+ Without it such changes have no effect in IWD.
+ Set devices that should be ignored by
- NetworkManager.
- See the section called “Device List Format” for the syntax on how to
- specify a device.
- Set devices that should be ignored by NetworkManager.
+
- Example:
+ A device unmanaged due to this option is strictly
+ unmanaged and cannot be overruled by using the API like
+ nmcli device set $IFNAME managed yes.
+ Also, a device that is unmanaged for other reasons, like
+ an udev rule, cannot be made managed with this option (e.g. by
+ using an See the section called “Device List Format” for the syntax on how to
+ specify a device.
+ Example:
+
-
+
+
+
+![]()
+![]()
+![]()
+![]()
+
+
+NetworkManager-dispatcher
+
+ Synopsis
+NetworkManager [OPTIONS...] Description
+/{etc,usr/lib}/NetworkManager/dispatcher.d
+ directory or subdirectories in
+ alphabetical order in response to network events. Each script should
+ be a regular executable file owned by root. Furthermore, it must not be
+ writable by group or other, and not setuid.
+ hostname action the device name is always "none"
+ and for connectivity-change it is empty.
+
+
+
+
+pre-up
+/etc/NetworkManager/dispatcher.d/pre-up.d
+ directory, and NetworkManager will wait for script execution to complete before
+ indicating to applications that the interface is fully activated.
+
+
+
+up
+
+
+
+pre-down
+/etc/NetworkManager/dispatcher.d/pre-down.d
+ directory, and NetworkManager will wait for script execution to complete
+ before disconnecting the interface from its network. Note that this
+ event is not emitted for forced disconnections, like when carrier is
+ lost or a wireless signal fades. It is only emitted when there is
+ an opportunity to cleanly handle a network disconnection event.
+
+
+
+down
+
+
+
+vpn-pre-up
+/etc/NetworkManager/dispatcher.d/pre-up.d
+ directory, and NetworkManager will wait for script execution to complete before
+ indicating to applications that the VPN is fully activated.
+
+
+
+vpn-up
+
+
+
+vpn-pre-down
+/etc/NetworkManager/dispatcher.d/pre-down.d
+ directory, and NetworkManager will wait for script execution to complete
+ before disconnecting the VPN from its network. Note that this
+ event is not emitted for forced disconnections, like when the VPN
+ terminates unexpectedly or general connectivity is lost. It is only
+ emitted when there is an opportunity to cleanly handle a VPN
+ disconnection event.
+
+
+
+vpn-down
+
+
+
+hostname
+
+
+
+dhcp4-change
+
+
+
+dhcp6-change
+
+
+
+
+connectivity-change
+
+
+
+
+NM_DISPATCHER_ACTION
+
+
+
+CONNECTION_UUID
+
+
+
+CONNECTION_ID
+
+
+
+CONNECTION_DBUS_PATH
+
+
+
+CONNECTION_FILENAME
+
+
+
+CONNECTION_EXTERNAL
+
+
+
+DEVICE_IFACE
+DEVICE_IP_IFACE. For example for
+ ADSL devices, this could be 'atm0' or for WWAN devices
+ it might be 'ttyUSB0'.
+
+
+
+DEVICE_IP_IFACE
+
+
+
+IP4_ADDRESS_N
+
+
+
+IP4_NUM_ADDRESSES
+
+
+
+IP4_GATEWAY
+
+
+
+IP4_ROUTE_N
+
+
+
+IP4_NUM_ROUTES
+
+
+
+IP4_NAMESERVERS
+
+
+
+IP4_DOMAINS
+
+
+
+DHCP4_<dhcp-option-name>
+
+
+
+IP6_<name> and DHCP6_<name>
+
+
+
+
+CONNECTIVITY_STATE
+/etc/NetworkManager/dispatcher.d/no-wait.d/
+ directory are run immediately, without
+ waiting for the termination of previous scripts, and in parallel. Also beware that
+ once a script is queued, it will always be run, even if a later event renders it
+ obsolete. (Eg, if an interface goes up, and then back down again quickly, it is
+ possible that one or more "up" scripts will be run after the interface has gone down.)
+ Bugs
+![]()
![]()
-![]()
+![]()
![]()
NetworkManager.conf. Depending
+ on your use case, you may remove all files to restore the default configuration (factory reset). But
+ note that your distribution or other packages may drop configuration snippets for NetworkManager, such
+ that they are part of the factory default.
+ File Format
@@ -91,7 +97,7 @@
below.
[main]
@@ -326,7 +332,9 @@ no-auto-default=*
unbound: NetworkManager will talk
to unbound and dnssec-triggerd, using "Conditional Forwarding"
with DNSSEC support. /etc/resolv.conf
- will be managed by dnssec-trigger daemon.none: NetworkManager will not
modify resolv.conf. This implies
rc-manager unmanaged
+
+
+firewall-backend
+iptables, nftables
+ or none.
+ iptables and nftables
+ require iptables and nft
+ application, respectively.
+ none means to skip firewall configuration if
+ the users wish to manage firewall themselves.
+ If unspecified, it will be auto detected.
+
+
+iwd-config-path
+
+
@@ -772,6 +830,10 @@ ipv6.ip6-privacy=0
and 100 for other profiles.unmanaged-devices
-
except: specifier).
+ These two points make it different from the device*.managed
+ option which for that reason may be a better choice.
+
unmanaged-devices=interface-name:em4
unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth2
ipv4.required-timeout
ipv4.route-metric
ipv6.required-timeout
ipv6.route-metric
+
Specify the timeout for waiting for carrier in milliseconds. + The default is 5000 milliseconds. + This setting exists because certain drivers/hardware can take + a long time to detect whether the cable is plugged in. +
+When the device loses carrier, NetworkManager does not react immediately. Instead, it waits for this timeout before considering - the link lost. Also, on startup, NetworkManager considers the + the link lost. +
++ Also, on startup, NetworkManager considers the device as busy for this time, as long as the device has no carrier. This delays startup-complete signal and NetworkManager-wait-online. Configuring this too high means to block NetworkManager-wait-online - longer then necessary. Configuring it too low, means that NetworkManager - will declare startup-complete, although carrier is about to come - and auto-activation to kick in. - The default is 5000 milliseconds. -
+ On startup, NetworkManager tries to not interfere with + interfaces that are already configured. It does so by + generating a in-memory connection based on the interface + current configuration. +
++ If this generated connection matches one of the existing + persistent connections, the persistent connection gets + activated. If there is no match, the generated + connection gets activated as "external", which means + that the connection is considered as active, but + NetworkManager doesn't actually touch the interface. +
+
+ It is possible to disable this behavior by setting
+ keep-configuration to
+ no. In this way, on startup
+ NetworkManager always tries to activate the most
+ suitable persistent connection (the one with highest
+ autoconnect-priority or, in case of a tie, the one
+ activated most recently).
+
+ Note that when NetworkManager gets restarted, it stores
+ the previous state in
+ /run/NetworkManager; in particular
+ it saves the UUID of the connection that was previously
+ active so that it can be activated again after the
+ restart. Therefore,
+ keep-configuration does not have
+ any effect on service restart.
+
+ A list of connections that can be activated on the + device. See the section called “Connection List Format” for the + syntax to specify a connection. If this option is not + specified, all connections can be potentially activated + on the device, provided that the connection type and + other settings match. +
+
+ A notable use case for this is to filter which
+ connections can be activated based on how they were
+ created; see the origin keyword in
+ the section called “Connection List Format”.
+
wifi.scan-rand-mac-address
Configures MAC address randomization of a Wi-Fi device during
@@ -1092,7 +1228,7 @@ managed=1
If wifi.backend is iwd, setting this to
false forces IWD's autoconnect mechanism to be disabled for
this device and connections will only be initiated by NetworkManager whether
- commaned by a client or automatically. Leaving it true (default)
+ commanded by a client or automatically. Leaving it true (default)
stops NetworkManager from automatically initiating connections and allows
IWD to use its network ranking and scanning logic to decide the best networks
to autoconnect to next. Connections' autoconnect-priority,
@@ -1573,6 +1709,66 @@ interface-name:vboxnet*,except:interface-name:vboxnet2
+
+ Connections can be specified using the following format: +
++
+* |
+Matches every connection. |
+
uuid:UUID |
+Match the connection by UUID, for example
+ |
+
id=ID |
+Match the connection by name. |
+
origin:ORIGIN |
+Match the connection by origin, stored in the
+ |
+
except:SPEC |
+
+ Negative match of a connection. A negative match has higher priority then the positive + matches above. +If there is a list consisting only of negative matches, the behavior is the same as if there is also + match-all. That means, if none of all the negative matches is satisfied, the overall result is still a + positive match. + |
+
SPEC[,;]SPEC |
+
+ Multiple specs can be concatenated with commas or semicolons. The order does not matter as
+ matches are either inclusive or negative ( Backslash is supported to escape the separators ';' and ',', and to express special characters such as + newline ('\n'), tabulator ('\t'), whitespace ('\s') and backslash ('\\'). Whitespace is not a separator but + will be trimmed between two specs (unless escaped as '\s'). + |
+
+
+
- NetworkManager will execute scripts in the
- /etc/NetworkManager/dispatcher.d
- directory or subdirectories in
- alphabetical order in response to network events. Each script should
- be a regular executable file owned by root. Furthermore, it must not be
- writable by group or other, and not setuid.
-
- Each script receives two arguments, the first being the interface name of the
- device an operation just happened on, and second the action. For device actions,
- the interface is the name of the kernel interface suitable for IP configuration.
- Thus it is either VPN_IP_IFACE, DEVICE_IP_IFACE, or DEVICE_IFACE, as applicable.
- For the hostname action the device name is always "none"
- and for connectivity-change it is empty.
-
The actions are:
-
|
-The interface is connected to the network but is not
- yet fully activated. Scripts acting on this event must be placed or
- symlinked into the |
-
|
-The interface has been activated. |
-
|
-The interface will be deactivated but has not yet been
- disconnected from the network. Scripts acting on this event must be
- placed or symlinked into the |
-
|
-- The interface has been deactivated. - |
-
|
-The VPN is connected to the network but is not yet
- fully activated. Scripts acting on this event must be placed or
- symlinked into the |
-
|
-- A VPN connection has been activated. - |
-
|
-The VPN will be deactivated but has not yet been
- disconnected from the network. Scripts acting on this event must be
- placed or symlinked into the |
-
|
-- A VPN connection has been deactivated. - |
-
|
-- The system hostname has been updated. Use gethostname(2) to retrieve it. - The interface name (first argument) is empty and no environment variable is - set for this action. - |
-
|
-- The DHCPv4 lease has changed (renewed, rebound, etc). - |
-
|
-- The DHCPv6 lease has changed (renewed, rebound, etc). - |
-
|
-- The network connectivity state has changed (no connectivity, went online, etc). - |
-
- The environment contains more information about the interface and the connection. - The following variables are available for the use in the dispatcher scripts: -
-
|
-- The dispatcher action like "up" or "dhcp4-change", identical to the first - command line argument. Since NetworkManager 1.12.0. - |
-
|
-- The UUID of the connection profile. - |
-
|
-- The name (ID) of the connection profile. - |
-
|
-- The NetworkManager D-Bus path of the connection. - |
-
|
-- The backing file name of the connection profile (if any). - |
-
|
-- If "1", this indicates that the connection describes a - network configuration created outside of NetworkManager. - |
-
|
-
- The interface name of the control interface of the device.
- Depending on the device type, this differs from
- |
-
|
-- The IP interface name of the device. This is the network - interface on which IP addresses and routes will be configured. - |
-
|
-- The IPv4 address in the format "address/prefix gateway", where N is a number - from 0 to (# IPv4 addresses - 1). gateway item in this variable is deprecated, - use IP4_GATEWAY instead. - |
-
|
-- The variable contains the number of IPv4 addresses the script may expect. - |
-
|
-- The gateway IPv4 address in traditional numbers-and-dots notation. - |
-
|
-- The IPv4 route in the format "address/prefix next-hop metric", where N is a number - from 0 to (# IPv4 routes - 1). - |
-
|
-- The variable contains the number of IPv4 routes the script may expect. - |
-
|
-- The variable contains a space-separated list of the DNS servers. - |
-
|
-- The variable contains a space-separated list of the search domains. - |
-
|
-- If the connection used DHCP for address configuration, the received DHCP - configuration is passed in the environment using standard DHCP - option names, prefixed with "DHCP4_", like "DHCP4_HOST_NAME=foobar". - |
-
|
-- The same variables as for IPv4 are available for IPv6, but the prefixes are IP6_ - and DHCP6_ instead. - |
-
|
-The network connectivity state, which can - take the values defined by the NMConnectivityState type, - from the org.freedesktop.NetworkManager D-Bus API: unknown, - none, portal, limited or full. Note: this variable will only - be set for connectivity-change actions. - |
-
-
-- In case of VPN, VPN_IP_IFACE is set, and IP4_*, IP6_* variables with VPN prefix are - exported too, like VPN_IP4_ADDRESS_0, VPN_IP4_NUM_ADDRESSES. -
-
- Dispatcher scripts are run one at a time, but asynchronously from the main
- NetworkManager process, and will be killed if they run for too long. If your script
- might take arbitrarily long to complete, you should spawn a child process and have the
- parent return immediately. Scripts that are symbolic links pointing inside the
- /etc/NetworkManager/dispatcher.d/no-wait.d/
- directory are run immediately, without
- waiting for the termination of previous scripts, and in parallel. Also beware that
- once a script is queued, it will always be run, even if a later event renders it
- obsolete. (Eg, if an interface goes up, and then back down again quickly, it is
- possible that one or more "up" scripts will be run after the interface has gone down.)
+ NetworkManager-dispatcher service can execute scripts for the user
+ in response to network events. See
+ NetworkManager-dispatcher(8) manual.
- NetworkManager home page, + NetworkManager home page, NetworkManager.conf(5), + NetworkManager-dispatcher(8), nmcli(1), nmcli-examples(7), nm-online(1), diff --git a/docs/api/html/gdbus-org.freedesktop.NetworkManager.AccessPoint.html b/docs/api/html/gdbus-org.freedesktop.NetworkManager.AccessPoint.html index 4b3f1a1a..7bd6ac6c 100644 --- a/docs/api/html/gdbus-org.freedesktop.NetworkManager.AccessPoint.html +++ b/docs/api/html/gdbus-org.freedesktop.NetworkManager.AccessPoint.html @@ -16,8 +16,7 @@
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-StateChanged (u state, - u reason); -PropertiesChanged (a{sv} properties); +StateChanged (u state, + u reason);
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
ModemCapabilities readable u CurrentCapabilities readable u @@ -54,27 +47,6 @@
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary containing the FIXME: check changed parameters. |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
| Top + Description |
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
| Top + Description |
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties); -AccessPointAdded (o access_point); -AccessPointRemoved (o access_point); +AccessPointAdded (o access_point); +AccessPointRemoved (o access_point);
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary containing the changed parameters. |
-
AccessPointAdded (o access_point); diff --git a/docs/api/html/gdbus-org.freedesktop.NetworkManager.IP4Config.html b/docs/api/html/gdbus-org.freedesktop.NetworkManager.IP4Config.html index c941c600..9b52d070 100644 --- a/docs/api/html/gdbus-org.freedesktop.NetworkManager.IP4Config.html +++ b/docs/api/html/gdbus-org.freedesktop.NetworkManager.IP4Config.html @@ -16,8 +16,7 @@Top + Properties @@ -34,13 +33,7 @@
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values. |
-
-PropertiesChanged (a{sv} properties); -NewConnection (o connection); -ConnectionRemoved (o connection); +NewConnection (o connection); +ConnectionRemoved (o connection);
-PropertiesChanged (a{sv} properties);
-
-DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
-
|
-A dictionary mapping property names to variant boxed values |
-
NewConnection (o connection); diff --git a/docs/api/html/gdbus-org.freedesktop.NetworkManager.VPN.Connection.html b/docs/api/html/gdbus-org.freedesktop.NetworkManager.VPN.Connection.html index b8945e00..5999eb50 100644 --- a/docs/api/html/gdbus-org.freedesktop.NetworkManager.VPN.Connection.html +++ b/docs/api/html/gdbus-org.freedesktop.NetworkManager.VPN.Connection.html @@ -36,9 +36,8 @@Signals
-PropertiesChanged (a{sv} properties); -VpnStateChanged (u state, - u reason); +VpnStateChanged (u state, + u reason);@@ -56,25 +55,6 @@Signal Details
--The "PropertiesChanged" signal
--PropertiesChanged (a{sv} properties); --DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
---
- -- - - --
a{sv}:properties- A dictionary mapping property names to variant boxed values
-The "VpnStateChanged" signal
VpnStateChanged (u state, diff --git a/docs/api/html/gdbus-org.freedesktop.NetworkManager.html b/docs/api/html/gdbus-org.freedesktop.NetworkManager.html index 8843c3ae..b0e4d095 100644 --- a/docs/api/html/gdbus-org.freedesktop.NetworkManager.html +++ b/docs/api/html/gdbus-org.freedesktop.NetworkManager.html @@ -81,11 +81,10 @@Signals
-CheckPermissions (); -StateChanged (u state); -PropertiesChanged (a{sv} properties); -DeviceAdded (o device_path); -DeviceRemoved (o device_path); +CheckPermissions (); +StateChanged (u state); +DeviceAdded (o device_path); +DeviceRemoved (o device_path);@@ -699,25 +698,6 @@ StateChanged (u state);
--The "PropertiesChanged" signal
--PropertiesChanged (a{sv} properties); --DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0. -
---
- -- - - --
a{sv}:properties- The changed properties.
-The "DeviceAdded" signal
DeviceAdded (o device_path); diff --git a/docs/api/html/index.html b/docs/api/html/index.html index 2bb33b3d..d9fbb4a1 100644 --- a/docs/api/html/index.html +++ b/docs/api/html/index.html @@ -16,7 +16,7 @@
NetworkManager Reference Manual
diff --git a/docs/api/html/nm-initrd-generator.html b/docs/api/html/nm-initrd-generator.html index bef22dca..274c2c41 100644 --- a/docs/api/html/nm-initrd-generator.html +++ b/docs/api/html/nm-initrd-generator.html @@ -91,12 +91,15 @@- for NetworkManager 1.30.6 + for NetworkManager 1.32.12 The latest version of this documentation can be found on-line at https://developer.gnome.org/NetworkManager/stable/. @@ -76,6 +76,9 @@ NetworkManager.conf — NetworkManager configuration file
+NetworkManager-dispatcher — Dispatch user scripts for NetworkManager + +nmcli — command-line tool for controlling NetworkManager diff --git a/docs/api/html/ix01.html b/docs/api/html/ix01.html index 50def762..289ae66a 100644 --- a/docs/api/html/ix01.html +++ b/docs/api/html/ix01.html @@ -28,27 +28,25 @@
- org.freedesktop.NetworkManager.AccessPoint, org.freedesktop.NetworkManager.AccessPoint
-- org.freedesktop.NetworkManager.AccessPoint::PropertiesChanged, The "PropertiesChanged" signal +
- org.freedesktop.NetworkManager.AccessPoint:Flags, The "Flags" property
-- org.freedesktop.NetworkManager.AccessPoint:Flags, The "Flags" property +
- org.freedesktop.NetworkManager.AccessPoint:Frequency, The "Frequency" property
-- org.freedesktop.NetworkManager.AccessPoint:Frequency, The "Frequency" property +
- org.freedesktop.NetworkManager.AccessPoint:HwAddress, The "HwAddress" property
-- org.freedesktop.NetworkManager.AccessPoint:HwAddress, The "HwAddress" property +
- org.freedesktop.NetworkManager.AccessPoint:LastSeen, The "LastSeen" property
-- org.freedesktop.NetworkManager.AccessPoint:LastSeen, The "LastSeen" property +
- org.freedesktop.NetworkManager.AccessPoint:MaxBitrate, The "MaxBitrate" property
-- org.freedesktop.NetworkManager.AccessPoint:MaxBitrate, The "MaxBitrate" property +
- org.freedesktop.NetworkManager.AccessPoint:Mode, The "Mode" property
-- org.freedesktop.NetworkManager.AccessPoint:Mode, The "Mode" property +
- org.freedesktop.NetworkManager.AccessPoint:RsnFlags, The "RsnFlags" property
-- org.freedesktop.NetworkManager.AccessPoint:RsnFlags, The "RsnFlags" property +
- org.freedesktop.NetworkManager.AccessPoint:Ssid, The "Ssid" property
-- org.freedesktop.NetworkManager.AccessPoint:Ssid, The "Ssid" property +
- org.freedesktop.NetworkManager.AccessPoint:Strength, The "Strength" property
-- org.freedesktop.NetworkManager.AccessPoint:Strength, The "Strength" property -
-- org.freedesktop.NetworkManager.AccessPoint:WpaFlags, The "WpaFlags" property +
- org.freedesktop.NetworkManager.AccessPoint:WpaFlags, The "WpaFlags" property
- org.freedesktop.NetworkManager.AgentManager, org.freedesktop.NetworkManager.AgentManager
@@ -62,39 +60,31 @@- org.freedesktop.NetworkManager.Device.Adsl, org.freedesktop.NetworkManager.Device.Adsl
-- org.freedesktop.NetworkManager.Device.Adsl::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.Adsl:Carrier, The "Carrier" property +
- org.freedesktop.NetworkManager.Device.Adsl:Carrier, The "Carrier" property
- org.freedesktop.NetworkManager.Device.Bluetooth, org.freedesktop.NetworkManager.Device.Bluetooth
-- org.freedesktop.NetworkManager.Device.Bluetooth::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.Bluetooth:BtCapabilities, The "BtCapabilities" property +
- org.freedesktop.NetworkManager.Device.Bluetooth:BtCapabilities, The "BtCapabilities" property
-- org.freedesktop.NetworkManager.Device.Bluetooth:HwAddress, The "HwAddress" property +
- org.freedesktop.NetworkManager.Device.Bluetooth:HwAddress, The "HwAddress" property
-- org.freedesktop.NetworkManager.Device.Bluetooth:Name, The "Name" property +
- org.freedesktop.NetworkManager.Device.Bluetooth:Name, The "Name" property
- org.freedesktop.NetworkManager.Device.Bond, org.freedesktop.NetworkManager.Device.Bond
-- org.freedesktop.NetworkManager.Device.Bond::PropertiesChanged, The "PropertiesChanged" signal +
- org.freedesktop.NetworkManager.Device.Bond:Carrier, The "Carrier" property
-- org.freedesktop.NetworkManager.Device.Bond:Carrier, The "Carrier" property +
- org.freedesktop.NetworkManager.Device.Bond:HwAddress, The "HwAddress" property
-- org.freedesktop.NetworkManager.Device.Bond:HwAddress, The "HwAddress" property -
-- org.freedesktop.NetworkManager.Device.Bond:Slaves, The "Slaves" property +
- org.freedesktop.NetworkManager.Device.Bond:Slaves, The "Slaves" property
- org.freedesktop.NetworkManager.Device.Bridge, org.freedesktop.NetworkManager.Device.Bridge
-- org.freedesktop.NetworkManager.Device.Bridge::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.Bridge:Carrier, The "Carrier" property +
- org.freedesktop.NetworkManager.Device.Bridge:Carrier, The "Carrier" property
-- org.freedesktop.NetworkManager.Device.Bridge:HwAddress, The "HwAddress" property +
- org.freedesktop.NetworkManager.Device.Bridge:HwAddress, The "HwAddress" property
-- org.freedesktop.NetworkManager.Device.Bridge:Slaves, The "Slaves" property +
- org.freedesktop.NetworkManager.Device.Bridge:Slaves, The "Slaves" property
- org.freedesktop.NetworkManager.Device.Delete(), The Delete() method
@@ -102,55 +92,47 @@- org.freedesktop.NetworkManager.Device.Dummy, org.freedesktop.NetworkManager.Device.Dummy
-- org.freedesktop.NetworkManager.Device.Dummy::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.Dummy:HwAddress, The "HwAddress" property +
- org.freedesktop.NetworkManager.Device.Dummy:HwAddress, The "HwAddress" property
- org.freedesktop.NetworkManager.Device.Generic, org.freedesktop.NetworkManager.Device.Generic
-- org.freedesktop.NetworkManager.Device.Generic::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.Generic:HwAddress, The "HwAddress" property +
- org.freedesktop.NetworkManager.Device.Generic:HwAddress, The "HwAddress" property
-- org.freedesktop.NetworkManager.Device.Generic:TypeDescription, The "TypeDescription" property +
- org.freedesktop.NetworkManager.Device.Generic:TypeDescription, The "TypeDescription" property
- org.freedesktop.NetworkManager.Device.GetAppliedConnection(), The GetAppliedConnection() method
- org.freedesktop.NetworkManager.Device.Infiniband, org.freedesktop.NetworkManager.Device.Infiniband
-- org.freedesktop.NetworkManager.Device.Infiniband::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.Infiniband:Carrier, The "Carrier" property +
- org.freedesktop.NetworkManager.Device.Infiniband:Carrier, The "Carrier" property
-- org.freedesktop.NetworkManager.Device.Infiniband:HwAddress, The "HwAddress" property +
- org.freedesktop.NetworkManager.Device.Infiniband:HwAddress, The "HwAddress" property
- org.freedesktop.NetworkManager.Device.IPTunnel, org.freedesktop.NetworkManager.Device.IPTunnel
-- org.freedesktop.NetworkManager.Device.IPTunnel::PropertiesChanged, The "PropertiesChanged" signal +
- org.freedesktop.NetworkManager.Device.IPTunnel:EncapsulationLimit, The "EncapsulationLimit" property
-- org.freedesktop.NetworkManager.Device.IPTunnel:EncapsulationLimit, The "EncapsulationLimit" property +
- org.freedesktop.NetworkManager.Device.IPTunnel:Flags, The "Flags" property
-- org.freedesktop.NetworkManager.Device.IPTunnel:Flags, The "Flags" property +
- org.freedesktop.NetworkManager.Device.IPTunnel:FlowLabel, The "FlowLabel" property
-- org.freedesktop.NetworkManager.Device.IPTunnel:FlowLabel, The "FlowLabel" property +
- org.freedesktop.NetworkManager.Device.IPTunnel:InputKey, The "InputKey" property
-- org.freedesktop.NetworkManager.Device.IPTunnel:InputKey, The "InputKey" property +
- org.freedesktop.NetworkManager.Device.IPTunnel:Local, The "Local" property
-- org.freedesktop.NetworkManager.Device.IPTunnel:Local, The "Local" property +
- org.freedesktop.NetworkManager.Device.IPTunnel:Mode, The "Mode" property
-- org.freedesktop.NetworkManager.Device.IPTunnel:Mode, The "Mode" property +
- org.freedesktop.NetworkManager.Device.IPTunnel:OutputKey, The "OutputKey" property
-- org.freedesktop.NetworkManager.Device.IPTunnel:OutputKey, The "OutputKey" property +
- org.freedesktop.NetworkManager.Device.IPTunnel:Parent, The "Parent" property
-- org.freedesktop.NetworkManager.Device.IPTunnel:Parent, The "Parent" property +
- org.freedesktop.NetworkManager.Device.IPTunnel:PathMtuDiscovery, The "PathMtuDiscovery" property
-- org.freedesktop.NetworkManager.Device.IPTunnel:PathMtuDiscovery, The "PathMtuDiscovery" property +
- org.freedesktop.NetworkManager.Device.IPTunnel:Remote, The "Remote" property
-- org.freedesktop.NetworkManager.Device.IPTunnel:Remote, The "Remote" property +
- org.freedesktop.NetworkManager.Device.IPTunnel:Tos, The "Tos" property
-- org.freedesktop.NetworkManager.Device.IPTunnel:Tos, The "Tos" property -
-- org.freedesktop.NetworkManager.Device.IPTunnel:Ttl, The "Ttl" property +
- org.freedesktop.NetworkManager.Device.IPTunnel:Ttl, The "Ttl" property
- org.freedesktop.NetworkManager.Device.Lowpan, org.freedesktop.NetworkManager.Device.Lowpan
@@ -160,149 +142,123 @@- org.freedesktop.NetworkManager.Device.Macsec, org.freedesktop.NetworkManager.Device.Macsec
-- org.freedesktop.NetworkManager.Device.Macsec::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.Macsec:CipherSuite, The "CipherSuite" property +
- org.freedesktop.NetworkManager.Device.Macsec:CipherSuite, The "CipherSuite" property
-- org.freedesktop.NetworkManager.Device.Macsec:EncodingSa, The "EncodingSa" property +
- org.freedesktop.NetworkManager.Device.Macsec:EncodingSa, The "EncodingSa" property
-- org.freedesktop.NetworkManager.Device.Macsec:Encrypt, The "Encrypt" property +
- org.freedesktop.NetworkManager.Device.Macsec:Encrypt, The "Encrypt" property
-- org.freedesktop.NetworkManager.Device.Macsec:Es, The "Es" property +
- org.freedesktop.NetworkManager.Device.Macsec:Es, The "Es" property
-- org.freedesktop.NetworkManager.Device.Macsec:IcvLength, The "IcvLength" property +
- org.freedesktop.NetworkManager.Device.Macsec:IcvLength, The "IcvLength" property
-- org.freedesktop.NetworkManager.Device.Macsec:IncludeSci, The "IncludeSci" property +
- org.freedesktop.NetworkManager.Device.Macsec:IncludeSci, The "IncludeSci" property
-- org.freedesktop.NetworkManager.Device.Macsec:Parent, The "Parent" property +
- org.freedesktop.NetworkManager.Device.Macsec:Parent, The "Parent" property
-- org.freedesktop.NetworkManager.Device.Macsec:Protect, The "Protect" property +
- org.freedesktop.NetworkManager.Device.Macsec:Protect, The "Protect" property
-- org.freedesktop.NetworkManager.Device.Macsec:ReplayProtect, The "ReplayProtect" property +
- org.freedesktop.NetworkManager.Device.Macsec:ReplayProtect, The "ReplayProtect" property
-- org.freedesktop.NetworkManager.Device.Macsec:Scb, The "Scb" property +
- org.freedesktop.NetworkManager.Device.Macsec:Scb, The "Scb" property
-- org.freedesktop.NetworkManager.Device.Macsec:Sci, The "Sci" property +
- org.freedesktop.NetworkManager.Device.Macsec:Sci, The "Sci" property
-- org.freedesktop.NetworkManager.Device.Macsec:Validation, The "Validation" property +
- org.freedesktop.NetworkManager.Device.Macsec:Validation, The "Validation" property
-- org.freedesktop.NetworkManager.Device.Macsec:Window, The "Window" property +
- org.freedesktop.NetworkManager.Device.Macsec:Window, The "Window" property
- org.freedesktop.NetworkManager.Device.Macvlan, org.freedesktop.NetworkManager.Device.Macvlan
-- org.freedesktop.NetworkManager.Device.Macvlan::PropertiesChanged, The "PropertiesChanged" signal +
- org.freedesktop.NetworkManager.Device.Macvlan:Mode, The "Mode" property
-- org.freedesktop.NetworkManager.Device.Macvlan:Mode, The "Mode" property +
- org.freedesktop.NetworkManager.Device.Macvlan:NoPromisc, The "NoPromisc" property
-- org.freedesktop.NetworkManager.Device.Macvlan:NoPromisc, The "NoPromisc" property +
- org.freedesktop.NetworkManager.Device.Macvlan:Parent, The "Parent" property
-- org.freedesktop.NetworkManager.Device.Macvlan:Parent, The "Parent" property -
-- org.freedesktop.NetworkManager.Device.Macvlan:Tap, The "Tap" property +
- org.freedesktop.NetworkManager.Device.Macvlan:Tap, The "Tap" property
- org.freedesktop.NetworkManager.Device.Modem, org.freedesktop.NetworkManager.Device.Modem
-- org.freedesktop.NetworkManager.Device.Modem::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.Modem:Apn, The "Apn" property +
- org.freedesktop.NetworkManager.Device.Modem:Apn, The "Apn" property
-- org.freedesktop.NetworkManager.Device.Modem:CurrentCapabilities, The "CurrentCapabilities" property +
- org.freedesktop.NetworkManager.Device.Modem:CurrentCapabilities, The "CurrentCapabilities" property
-- org.freedesktop.NetworkManager.Device.Modem:DeviceId, The "DeviceId" property +
- org.freedesktop.NetworkManager.Device.Modem:DeviceId, The "DeviceId" property
-- org.freedesktop.NetworkManager.Device.Modem:ModemCapabilities, The "ModemCapabilities" property +
- org.freedesktop.NetworkManager.Device.Modem:ModemCapabilities, The "ModemCapabilities" property
-- org.freedesktop.NetworkManager.Device.Modem:OperatorCode, The "OperatorCode" property +
- org.freedesktop.NetworkManager.Device.Modem:OperatorCode, The "OperatorCode" property
- org.freedesktop.NetworkManager.Device.OlpcMesh, org.freedesktop.NetworkManager.Device.OlpcMesh
-- org.freedesktop.NetworkManager.Device.OlpcMesh::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.OlpcMesh:ActiveChannel, The "ActiveChannel" property +
- org.freedesktop.NetworkManager.Device.OlpcMesh:ActiveChannel, The "ActiveChannel" property
-- org.freedesktop.NetworkManager.Device.OlpcMesh:Companion, The "Companion" property +
- org.freedesktop.NetworkManager.Device.OlpcMesh:Companion, The "Companion" property
-- org.freedesktop.NetworkManager.Device.OlpcMesh:HwAddress, The "HwAddress" property +
- org.freedesktop.NetworkManager.Device.OlpcMesh:HwAddress, The "HwAddress" property
- org.freedesktop.NetworkManager.Device.OvsBridge, org.freedesktop.NetworkManager.Device.OvsBridge
-- org.freedesktop.NetworkManager.Device.OvsBridge::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.OvsBridge:Slaves, The "Slaves" property +
- org.freedesktop.NetworkManager.Device.OvsBridge:Slaves, The "Slaves" property
- org.freedesktop.NetworkManager.Device.OvsInterface, org.freedesktop.NetworkManager.Device.OvsInterface
-- org.freedesktop.NetworkManager.Device.OvsInterface::PropertiesChanged, The "PropertiesChanged" signal -
- org.freedesktop.NetworkManager.Device.OvsPort, org.freedesktop.NetworkManager.Device.OvsPort
-- org.freedesktop.NetworkManager.Device.OvsPort::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.OvsPort:Slaves, The "Slaves" property +
- org.freedesktop.NetworkManager.Device.OvsPort:Slaves, The "Slaves" property
- org.freedesktop.NetworkManager.Device.Ppp, org.freedesktop.NetworkManager.Device.Ppp
-- org.freedesktop.NetworkManager.Device.Ppp::PropertiesChanged, The "PropertiesChanged" signal -
- org.freedesktop.NetworkManager.Device.Reapply(), The Reapply() method
- org.freedesktop.NetworkManager.Device.Statistics, org.freedesktop.NetworkManager.Device.Statistics
-- org.freedesktop.NetworkManager.Device.Statistics::PropertiesChanged, The "PropertiesChanged" signal +
- org.freedesktop.NetworkManager.Device.Statistics:RefreshRateMs, The "RefreshRateMs" property
-- org.freedesktop.NetworkManager.Device.Statistics:RefreshRateMs, The "RefreshRateMs" property +
- org.freedesktop.NetworkManager.Device.Statistics:RxBytes, The "RxBytes" property
-- org.freedesktop.NetworkManager.Device.Statistics:RxBytes, The "RxBytes" property -
-- org.freedesktop.NetworkManager.Device.Statistics:TxBytes, The "TxBytes" property +
- org.freedesktop.NetworkManager.Device.Statistics:TxBytes, The "TxBytes" property
- org.freedesktop.NetworkManager.Device.Team, org.freedesktop.NetworkManager.Device.Team
-- org.freedesktop.NetworkManager.Device.Team::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.Team:Carrier, The "Carrier" property +
- org.freedesktop.NetworkManager.Device.Team:Carrier, The "Carrier" property
-- org.freedesktop.NetworkManager.Device.Team:Config, The "Config" property +
- org.freedesktop.NetworkManager.Device.Team:Config, The "Config" property
-- org.freedesktop.NetworkManager.Device.Team:HwAddress, The "HwAddress" property +
- org.freedesktop.NetworkManager.Device.Team:HwAddress, The "HwAddress" property
-- org.freedesktop.NetworkManager.Device.Team:Slaves, The "Slaves" property +
- org.freedesktop.NetworkManager.Device.Team:Slaves, The "Slaves" property
- org.freedesktop.NetworkManager.Device.Tun, org.freedesktop.NetworkManager.Device.Tun
-- org.freedesktop.NetworkManager.Device.Tun::PropertiesChanged, The "PropertiesChanged" signal +
- org.freedesktop.NetworkManager.Device.Tun:Group, The "Group" property
-- org.freedesktop.NetworkManager.Device.Tun:Group, The "Group" property +
- org.freedesktop.NetworkManager.Device.Tun:HwAddress, The "HwAddress" property
-- org.freedesktop.NetworkManager.Device.Tun:HwAddress, The "HwAddress" property +
- org.freedesktop.NetworkManager.Device.Tun:Mode, The "Mode" property
-- org.freedesktop.NetworkManager.Device.Tun:Mode, The "Mode" property +
- org.freedesktop.NetworkManager.Device.Tun:MultiQueue, The "MultiQueue" property
-- org.freedesktop.NetworkManager.Device.Tun:MultiQueue, The "MultiQueue" property +
- org.freedesktop.NetworkManager.Device.Tun:NoPi, The "NoPi" property
-- org.freedesktop.NetworkManager.Device.Tun:NoPi, The "NoPi" property +
- org.freedesktop.NetworkManager.Device.Tun:Owner, The "Owner" property
-- org.freedesktop.NetworkManager.Device.Tun:Owner, The "Owner" property -
-- org.freedesktop.NetworkManager.Device.Tun:VnetHdr, The "VnetHdr" property +
- org.freedesktop.NetworkManager.Device.Tun:VnetHdr, The "VnetHdr" property
- org.freedesktop.NetworkManager.Device.Veth, org.freedesktop.NetworkManager.Device.Veth
-- org.freedesktop.NetworkManager.Device.Veth::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.Veth:Peer, The "Peer" property +
- org.freedesktop.NetworkManager.Device.Veth:Peer, The "Peer" property
- org.freedesktop.NetworkManager.Device.Vlan, org.freedesktop.NetworkManager.Device.Vlan
-- org.freedesktop.NetworkManager.Device.Vlan::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.Vlan:Carrier, The "Carrier" property +
- org.freedesktop.NetworkManager.Device.Vlan:Carrier, The "Carrier" property
-- org.freedesktop.NetworkManager.Device.Vlan:HwAddress, The "HwAddress" property +
- org.freedesktop.NetworkManager.Device.Vlan:HwAddress, The "HwAddress" property
-- org.freedesktop.NetworkManager.Device.Vlan:Parent, The "Parent" property +
- org.freedesktop.NetworkManager.Device.Vlan:Parent, The "Parent" property
-- org.freedesktop.NetworkManager.Device.Vlan:VlanId, The "VlanId" property +
- org.freedesktop.NetworkManager.Device.Vlan:VlanId, The "VlanId" property
- org.freedesktop.NetworkManager.Device.Vrf, org.freedesktop.NetworkManager.Device.Vrf
@@ -310,41 +266,39 @@- org.freedesktop.NetworkManager.Device.Vxlan, org.freedesktop.NetworkManager.Device.Vxlan
-- org.freedesktop.NetworkManager.Device.Vxlan::PropertiesChanged, The "PropertiesChanged" signal +
- org.freedesktop.NetworkManager.Device.Vxlan:Ageing, The "Ageing" property
-- org.freedesktop.NetworkManager.Device.Vxlan:Ageing, The "Ageing" property +
- org.freedesktop.NetworkManager.Device.Vxlan:DstPort, The "DstPort" property
-- org.freedesktop.NetworkManager.Device.Vxlan:DstPort, The "DstPort" property +
- org.freedesktop.NetworkManager.Device.Vxlan:Group, The "Group" property
-- org.freedesktop.NetworkManager.Device.Vxlan:Group, The "Group" property +
- org.freedesktop.NetworkManager.Device.Vxlan:HwAddress, The "HwAddress" property
-- org.freedesktop.NetworkManager.Device.Vxlan:HwAddress, The "HwAddress" property +
- org.freedesktop.NetworkManager.Device.Vxlan:Id, The "Id" property
-- org.freedesktop.NetworkManager.Device.Vxlan:Id, The "Id" property +
- org.freedesktop.NetworkManager.Device.Vxlan:L2miss, The "L2miss" property
-- org.freedesktop.NetworkManager.Device.Vxlan:L2miss, The "L2miss" property +
- org.freedesktop.NetworkManager.Device.Vxlan:L3miss, The "L3miss" property
-- org.freedesktop.NetworkManager.Device.Vxlan:L3miss, The "L3miss" property +
- org.freedesktop.NetworkManager.Device.Vxlan:Learning, The "Learning" property
-- org.freedesktop.NetworkManager.Device.Vxlan:Learning, The "Learning" property +
- org.freedesktop.NetworkManager.Device.Vxlan:Limit, The "Limit" property
-- org.freedesktop.NetworkManager.Device.Vxlan:Limit, The "Limit" property +
- org.freedesktop.NetworkManager.Device.Vxlan:Local, The "Local" property
-- org.freedesktop.NetworkManager.Device.Vxlan:Local, The "Local" property +
- org.freedesktop.NetworkManager.Device.Vxlan:Parent, The "Parent" property
-- org.freedesktop.NetworkManager.Device.Vxlan:Parent, The "Parent" property +
- org.freedesktop.NetworkManager.Device.Vxlan:Proxy, The "Proxy" property
-- org.freedesktop.NetworkManager.Device.Vxlan:Proxy, The "Proxy" property +
- org.freedesktop.NetworkManager.Device.Vxlan:Rsc, The "Rsc" property
-- org.freedesktop.NetworkManager.Device.Vxlan:Rsc, The "Rsc" property +
- org.freedesktop.NetworkManager.Device.Vxlan:SrcPortMax, The "SrcPortMax" property
-- org.freedesktop.NetworkManager.Device.Vxlan:SrcPortMax, The "SrcPortMax" property +
- org.freedesktop.NetworkManager.Device.Vxlan:SrcPortMin, The "SrcPortMin" property
-- org.freedesktop.NetworkManager.Device.Vxlan:SrcPortMin, The "SrcPortMin" property +
- org.freedesktop.NetworkManager.Device.Vxlan:Tos, The "Tos" property
-- org.freedesktop.NetworkManager.Device.Vxlan:Tos, The "Tos" property -
-- org.freedesktop.NetworkManager.Device.Vxlan:Ttl, The "Ttl" property +
- org.freedesktop.NetworkManager.Device.Vxlan:Ttl, The "Ttl" property
- org.freedesktop.NetworkManager.Device.WireGuard, org.freedesktop.NetworkManager.Device.WireGuard
@@ -432,57 +386,53 @@- org.freedesktop.NetworkManager.IP4Config, org.freedesktop.NetworkManager.IP4Config
-- org.freedesktop.NetworkManager.IP4Config::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.IP4Config:AddressData, The "AddressData" property +
- org.freedesktop.NetworkManager.IP4Config:AddressData, The "AddressData" property
-- org.freedesktop.NetworkManager.IP4Config:Addresses, The "Addresses" property +
- org.freedesktop.NetworkManager.IP4Config:Addresses, The "Addresses" property
-- org.freedesktop.NetworkManager.IP4Config:DnsOptions, The "DnsOptions" property +
- org.freedesktop.NetworkManager.IP4Config:DnsOptions, The "DnsOptions" property
-- org.freedesktop.NetworkManager.IP4Config:DnsPriority, The "DnsPriority" property +
- org.freedesktop.NetworkManager.IP4Config:DnsPriority, The "DnsPriority" property
-- org.freedesktop.NetworkManager.IP4Config:Domains, The "Domains" property +
- org.freedesktop.NetworkManager.IP4Config:Domains, The "Domains" property
-- org.freedesktop.NetworkManager.IP4Config:Gateway, The "Gateway" property +
- org.freedesktop.NetworkManager.IP4Config:Gateway, The "Gateway" property
-- org.freedesktop.NetworkManager.IP4Config:NameserverData, The "NameserverData" property +
- org.freedesktop.NetworkManager.IP4Config:NameserverData, The "NameserverData" property
-- org.freedesktop.NetworkManager.IP4Config:Nameservers, The "Nameservers" property +
- org.freedesktop.NetworkManager.IP4Config:Nameservers, The "Nameservers" property
-- org.freedesktop.NetworkManager.IP4Config:RouteData, The "RouteData" property +
- org.freedesktop.NetworkManager.IP4Config:RouteData, The "RouteData" property
-- org.freedesktop.NetworkManager.IP4Config:Routes, The "Routes" property +
- org.freedesktop.NetworkManager.IP4Config:Routes, The "Routes" property
-- org.freedesktop.NetworkManager.IP4Config:Searches, The "Searches" property +
- org.freedesktop.NetworkManager.IP4Config:Searches, The "Searches" property
-- org.freedesktop.NetworkManager.IP4Config:WinsServerData, The "WinsServerData" property +
- org.freedesktop.NetworkManager.IP4Config:WinsServerData, The "WinsServerData" property
-- org.freedesktop.NetworkManager.IP4Config:WinsServers, The "WinsServers" property +
- org.freedesktop.NetworkManager.IP4Config:WinsServers, The "WinsServers" property
- org.freedesktop.NetworkManager.IP6Config, org.freedesktop.NetworkManager.IP6Config
-- org.freedesktop.NetworkManager.IP6Config::PropertiesChanged, The "PropertiesChanged" signal +
- org.freedesktop.NetworkManager.IP6Config:AddressData, The "AddressData" property
-- org.freedesktop.NetworkManager.IP6Config:AddressData, The "AddressData" property +
- org.freedesktop.NetworkManager.IP6Config:Addresses, The "Addresses" property
-- org.freedesktop.NetworkManager.IP6Config:Addresses, The "Addresses" property +
- org.freedesktop.NetworkManager.IP6Config:DnsOptions, The "DnsOptions" property
-- org.freedesktop.NetworkManager.IP6Config:DnsOptions, The "DnsOptions" property +
- org.freedesktop.NetworkManager.IP6Config:DnsPriority, The "DnsPriority" property
-- org.freedesktop.NetworkManager.IP6Config:DnsPriority, The "DnsPriority" property +
- org.freedesktop.NetworkManager.IP6Config:Domains, The "Domains" property
-- org.freedesktop.NetworkManager.IP6Config:Domains, The "Domains" property +
- org.freedesktop.NetworkManager.IP6Config:Gateway, The "Gateway" property
-- org.freedesktop.NetworkManager.IP6Config:Gateway, The "Gateway" property +
- org.freedesktop.NetworkManager.IP6Config:Nameservers, The "Nameservers" property
-- org.freedesktop.NetworkManager.IP6Config:Nameservers, The "Nameservers" property +
- org.freedesktop.NetworkManager.IP6Config:RouteData, The "RouteData" property
-- org.freedesktop.NetworkManager.IP6Config:RouteData, The "RouteData" property +
- org.freedesktop.NetworkManager.IP6Config:Routes, The "Routes" property
-- org.freedesktop.NetworkManager.IP6Config:Routes, The "Routes" property -
-- org.freedesktop.NetworkManager.IP6Config:Searches, The "Searches" property +
- org.freedesktop.NetworkManager.IP6Config:Searches, The "Searches" property
- org.freedesktop.NetworkManager.SecretAgent, org.freedesktop.NetworkManager.SecretAgent
@@ -520,8 +470,6 @@- org.freedesktop.NetworkManager.Settings.Connection.UpdateUnsaved(), The UpdateUnsaved() method
-- org.freedesktop.NetworkManager.Settings.Connection::PropertiesChanged, The "PropertiesChanged" signal -
- org.freedesktop.NetworkManager.Settings.Connection::Removed, The "Removed" signal
- org.freedesktop.NetworkManager.Settings.Connection::Updated, The "Updated" signal @@ -542,11 +490,9 @@
- org.freedesktop.NetworkManager.Settings.SaveHostname(), The SaveHostname() method
-- org.freedesktop.NetworkManager.Settings::ConnectionRemoved, The "ConnectionRemoved" signal +
- org.freedesktop.NetworkManager.Settings::ConnectionRemoved, The "ConnectionRemoved" signal
-- org.freedesktop.NetworkManager.Settings::NewConnection, The "NewConnection" signal -
-- org.freedesktop.NetworkManager.Settings::PropertiesChanged, The "PropertiesChanged" signal +
- org.freedesktop.NetworkManager.Settings::NewConnection, The "NewConnection" signal
- org.freedesktop.NetworkManager.Settings:CanModify, The "CanModify" property
@@ -559,9 +505,9 @@@@ -881,7 +817,7 @@A
-
- org.freedesktop.NetworkManager.Connection.Active, org.freedesktop.NetworkManager.Connection.Active +
- accept-all-mac-addresses, 802-3-ethernet
-- org.freedesktop.NetworkManager.Connection.Active::PropertiesChanged, The "PropertiesChanged" signal +
- org.freedesktop.NetworkManager.Connection.Active, org.freedesktop.NetworkManager.Connection.Active
- org.freedesktop.NetworkManager.Connection.Active::StateChanged, The "StateChanged" signal
@@ -629,7 +575,7 @@- app-iscsi-priority, dcb
-- assigned-mac-address, 802-3-ethernet, 802-11-wireless +
- assigned-mac-address, 802-3-ethernet, 802-11-wireless
- auth-alg, 802-11-wireless-security
@@ -639,7 +585,7 @@- auto-config, gsm
-- auto-negotiate, 802-3-ethernet +
- auto-negotiate, 802-3-ethernet
- autoconnect, connection
@@ -691,13 +637,11 @@- org.freedesktop.NetworkManager.Checkpoint, org.freedesktop.NetworkManager.Checkpoint
-- org.freedesktop.NetworkManager.Checkpoint::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Checkpoint:Created, The "Created" property +
- org.freedesktop.NetworkManager.Checkpoint:Created, The "Created" property
-- org.freedesktop.NetworkManager.Checkpoint:Devices, The "Devices" property +
- org.freedesktop.NetworkManager.Checkpoint:Devices, The "Devices" property
-- org.freedesktop.NetworkManager.Checkpoint:RollbackTimeout, The "RollbackTimeout" property +
- org.freedesktop.NetworkManager.Checkpoint:RollbackTimeout, The "RollbackTimeout" property
- client-cert, 802-1x
@@ -705,7 +649,7 @@- client-cert-password-flags, 802-1x
-- cloned-mac-address, 802-3-ethernet, 802-11-wireless +
- cloned-mac-address, 802-3-ethernet, 802-11-wireless
- config, team, team-port
@@ -730,17 +674,15 @@- org.freedesktop.NetworkManager.Device.Wired, org.freedesktop.NetworkManager.Device.Wired
-- org.freedesktop.NetworkManager.Device.Wired::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.Device.Wired:Carrier, The "Carrier" property +
- org.freedesktop.NetworkManager.Device.Wired:Carrier, The "Carrier" property
-- org.freedesktop.NetworkManager.Device.Wired:HwAddress, The "HwAddress" property +
- org.freedesktop.NetworkManager.Device.Wired:HwAddress, The "HwAddress" property
-- org.freedesktop.NetworkManager.Device.Wired:PermHwAddress, The "PermHwAddress" property +
- org.freedesktop.NetworkManager.Device.Wired:PermHwAddress, The "PermHwAddress" property
-- org.freedesktop.NetworkManager.Device.Wired:S390Subchannels, The "S390Subchannels" property +
- org.freedesktop.NetworkManager.Device.Wired:S390Subchannels, The "S390Subchannels" property
-- org.freedesktop.NetworkManager.Device.Wired:Speed, The "Speed" property +
- org.freedesktop.NetworkManager.Device.Wired:Speed, The "Speed" property
- org.freedesktop.NetworkManager.Device.Wireless, org.freedesktop.NetworkManager.Device.Wireless
@@ -750,11 +692,9 @@- org.freedesktop.NetworkManager.Device.Wireless.RequestScan(), The RequestScan() method
-- org.freedesktop.NetworkManager.Device.Wireless::AccessPointAdded, The "AccessPointAdded" signal +
- org.freedesktop.NetworkManager.Device.Wireless::AccessPointAdded, The "AccessPointAdded" signal
-- org.freedesktop.NetworkManager.Device.Wireless::AccessPointRemoved, The "AccessPointRemoved" signal -
-- org.freedesktop.NetworkManager.Device.Wireless::PropertiesChanged, The "PropertiesChanged" signal +
- org.freedesktop.NetworkManager.Device.Wireless::AccessPointRemoved, The "AccessPointRemoved" signal
- org.freedesktop.NetworkManager.Device.Wireless:AccessPoints, The "AccessPoints" property
@@ -810,15 +750,11 @@- org.freedesktop.NetworkManager.DHCP4Config, org.freedesktop.NetworkManager.DHCP4Config
-- org.freedesktop.NetworkManager.DHCP4Config::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.DHCP4Config:Options, The "Options" property +
- org.freedesktop.NetworkManager.DHCP4Config:Options, The "Options" property
- org.freedesktop.NetworkManager.DHCP6Config, org.freedesktop.NetworkManager.DHCP6Config
-- org.freedesktop.NetworkManager.DHCP6Config::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.DHCP6Config:Options, The "Options" property +
- org.freedesktop.NetworkManager.DHCP6Config:Options, The "Options" property
- dns, ipv4, ipv6
@@ -834,7 +770,7 @@- driver, match
-- duplex, 802-3-ethernet +
- duplex, 802-3-ethernet
- gateway-ping-timeout, connection
-- generate-mac-address-mask, 802-3-ethernet, 802-11-wireless +
- generate-mac-address-mask, 802-3-ethernet, 802-11-wireless
- group, tun, 802-11-wireless-security
@@ -982,7 +918,7 @@
- mac-address, bridge, infiniband, wimax, 802-3-ethernet, 802-11-wireless, wpan
-- mac-address-blacklist, 802-3-ethernet, 802-11-wireless +
- mac-address-blacklist, 802-3-ethernet, 802-11-wireless
- mac-address-randomization, 802-11-wireless
@@ -1028,11 +964,9 @@- org.freedesktop.NetworkManager::CheckPermissions, The "CheckPermissions" signal
-- org.freedesktop.NetworkManager::DeviceAdded, The "DeviceAdded" signal -
-- org.freedesktop.NetworkManager::DeviceRemoved, The "DeviceRemoved" signal +
- org.freedesktop.NetworkManager::DeviceAdded, The "DeviceAdded" signal
-- org.freedesktop.NetworkManager::PropertiesChanged, The "PropertiesChanged" signal +
- org.freedesktop.NetworkManager::DeviceRemoved, The "DeviceRemoved" signal
- org.freedesktop.NetworkManager::StateChanged, The "StateChanged" signal
@@ -1447,13 +1381,15 @@- require-mppe-128, ppp
-- route-data, ipv4, ipv6 +
- required-timeout, ipv4, ipv6
-- route-metric, ipv4, ipv6 +
- route-data, ipv4, ipv6
-- route-table, ipv4, ipv6 +
- route-metric, ipv4, ipv6
-- routes, ipv4, ipv6 +
- route-table, ipv4, ipv6 +
+- routes, ipv4, ipv6
- rsc, vxlan
@@ -1484,11 +1420,11 @@S
-
- s390-nettype, 802-3-ethernet +
- s390-nettype, 802-3-ethernet
-- s390-options, 802-3-ethernet +
- s390-options, 802-3-ethernet
-- s390-subchannels, 802-3-ethernet +
- s390-subchannels, 802-3-ethernet
- secondaries, connection
@@ -1518,7 +1454,7 @@- source-port-min, vxlan
-- speed, 802-3-ethernet +
- speed, 802-3-ethernet
- ssid, 802-11-olpc-mesh, 802-11-wireless
@@ -1553,7 +1489,7 @@- timestamp, connection
-- token, ipv6 +
- token, ipv6
- tos, ip-tunnel, vxlan
@@ -1607,9 +1543,7 @@- org.freedesktop.NetworkManager.VPN.Connection, org.freedesktop.NetworkManager.VPN.Connection
-- org.freedesktop.NetworkManager.VPN.Connection::PropertiesChanged, The "PropertiesChanged" signal -
-- org.freedesktop.NetworkManager.VPN.Connection::VpnStateChanged, The "VpnStateChanged" signal +
- org.freedesktop.NetworkManager.VPN.Connection::VpnStateChanged, The "VpnStateChanged" signal
- org.freedesktop.NetworkManager.VPN.Connection:Banner, The "Banner" property
@@ -1658,9 +1592,9 @@
- wait-device-timeout, connection
-- wake-on-lan, 802-3-ethernet +
- wake-on-lan, 802-3-ethernet
-- wake-on-lan-password, 802-3-ethernet +
- wake-on-lan-password, 802-3-ethernet
- wake-on-wlan, 802-11-wireless
diff --git a/docs/api/html/manpages.html b/docs/api/html/manpages.html index 7507854b..d12ec76c 100644 --- a/docs/api/html/manpages.html +++ b/docs/api/html/manpages.html @@ -32,6 +32,9 @@ NetworkManager.conf — NetworkManager configuration file- +NetworkManager-dispatcher — Dispatch user scripts for NetworkManager +
+- nmcli — command-line tool for controlling NetworkManager
- diff --git a/docs/api/html/nm-cloud-setup.html b/docs/api/html/nm-cloud-setup.html index fdf78578..b5d6c808 100644 --- a/docs/api/html/nm-cloud-setup.html +++ b/docs/api/html/nm-cloud-setup.html @@ -29,7 +29,7 @@
-Overview
+Overview
When running a virtual machine in a public cloud environment, it is desirable to automatically configure the network of that VM. In simple setups, the VM only has one network interface and the public @@ -44,7 +44,7 @@
Multiple cloud providers are supported. See the section called “Supported Cloud Providers”.
-Use
+Use
The goal of nm-cloud-setup is to be configuration-less and work automatically. All you need is to opt-in to the desired cloud providers (see the section called “Environment Variables”) and run /usr/libexec/nm-cloud-setup.
@@ -53,7 +53,7 @@ and a NetworkManager dispatcher script.-Details
+Details
nm-cloud-setup configures the network by fetching the configuration from the well-known meta data server of the cloud provider. That means, it already @@ -74,7 +74,7 @@ With this approach, the configuration is not persisted and only preserved until the device disconnects.
-/usr/libexec/nm-cloud-setup
+/usr/libexec/nm-cloud-setup
The binary /usr/libexec/nm-cloud-setup does most of the work. It supports no command line arguments but can be configured via environment variables. @@ -94,7 +94,7 @@
-nm-cloud-setup.service systemd unit
+nm-cloud-setup.service systemd unit
Usually /usr/libexec/nm-cloud-setup is not run directly, but only by systemctl restart nm-cloud-setup.service. This ensures that the tool only runs once at any time. It also allows to integrate @@ -105,7 +105,7 @@
-nm-cloud-setup.timer systemd timer
+nm-cloud-setup.timer systemd timer
/usr/libexec/nm-cloud-setup is intended to run whenever an update is necessary. For example, during boot when when changing the network configuration of the virtual machine via the cloud @@ -115,7 +115,7 @@
-/usr/lib/NetworkManager/dispatcher.d/90-nm-cloud-setup.sh
+/usr/lib/NetworkManager/dispatcher.d/90-nm-cloud-setup.sh
There is also a NetworkManager dispatcher script that will run for example when an interface is activated by NetworkManager. Together with the nm-cloud-setup.timer systemd timer this @@ -144,12 +144,45 @@ to
no.- +
NM_CLOUD_SETUP_GCP: boolean, whether Google GCP support is enabled. Defaults tono.
NM_CLOUD_SETUP_ALIYUN: boolean, whether Alibaba Cloud (Aliyun) support is enabled. Defaults + tono.++Example Setup for Configuring and Predeploying nm-cloud-setup
+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. +
++ The following example enables nm-cloud-setup for Amazon EC2 cloud: +
++dnf install -y NetworkManager-cloud-setup + +mkdir -p /etc/systemd/system/nm-cloud-setup.service.d +cat > /etc/systemd/system/nm-cloud-setup.service.d/10-enable-ec2.conf << EOF +[Service] +Environment=NM_CLOUD_SETUP_EC2=yes +EOF + +# systemctl enable nm-cloud-setup.service +mkdir -p /etc/systemd/system/NetworkManager.service.wants/ +ln -s /usr/lib/systemd/system/nm-cloud-setup.service /etc/systemd/system/NetworkManager.service.wants/nm-cloud-setup.service + +# systemctl enable nm-cloud-setup.timer +mkdir -p /etc/systemd/system/timers.target.wants/ +ln -s /etc/systemd/system/timers.target.wants/nm-cloud-setup.timer /usr/lib/systemd/system/nm-cloud-setup.timer + +# systemctl daemon-reload +++
+Supported Cloud Providers
-+Amazon EC2 (AWS)
+Amazon EC2 (AWS)
For AWS, the tools tries to fetch configuration from
http://169.254.169.254/. Currently, it only configures IPv4 and does nothing about IPv6. It will do the following.@@ -167,22 +200,36 @@ Also, if the device is currently not activated in NetworkManager or if the currently activated profile has a user-data
org.freedesktop.nm-cloud-setup.skip=yes, it is skipped. -Then, the tool will change the runtime configuration of the device. +
If only one interface and one address is configured, then the tool does nothing + and leaves the automatic configuration that was obtained via DHCP.
+Otherwise, the tool will change the runtime configuration of the device.
- -
Add static IPv4 addresses for all the configured addresses from
local-ipv4swith prefix length according tosubnet-ipv4-cidr-block. For example, we might have here 2 IP addresses like"172.16.5.3/24,172.16.5.4/24".Choose a route table 30400 + the index of the interface and +
- +
+ example, we might get a routeChoose a route table 30400 + the index of the interface and add a default route
0.0.0.0/0. The gateway is the first IP address in the CIDR subnet block. For - example, we might get a route"0.0.0.0/0 172.16.5.1 10 table=30401"."0.0.0.0/0 172.16.5.1 10 table=30400". +Also choose a route table 30200 + the interface index. This + contains a direct routes to the subnets of this interface.
+- +
Finally, add a policy routing rule for each address. For example -
"priority 30401 from 172.16.5.3/32 table 30401, priority 30401 from 172.16.5.4/32 table 30401"."priority 30200 from 172.16.5.3/32 table 30200, priority 30200 from 172.16.5.4/32 table 30200". + and +"priority 30400 from 172.16.5.3/32 table 30400, priority 30400 from 172.16.5.4/32 table 30400"+ The 30200+ rules select the table to reach the subnet directly, while the 30400+ rules use the + default route. Also add a rule +"priority 30350 table main suppress_prefixlength 0". This has a priority between + the two previous rules and causes a lookup of routes in the main table while ignoring the default + route. The purpose of this is so that other specific routes in the main table are honored over + the default route in table 30400+.With above example, this roughly corresponds for interface
eth0to - nmcli device modify "eth0" ipv4.addresses "172.16.5.3/24,172.16.5.4/24" ipv4.routes "0.0.0.0/0 172.16.5.1 10 table=30401" ipv4.routing-rules "priority 30401 from 172.16.5.3/32 table 30401, priority 30401 from 172.16.5.4/32 table 30401". + nmcli device modify "eth0" ipv4.addresses "172.16.5.3/24,172.16.5.4/24" ipv4.routes "172.16.5.0/24 0.0.0.0 10 table=30200, 0.0.0.0/0 172.16.5.1 10 table=30400" ipv4.routing-rules "priority 30200 from 172.16.5.3/32 table 30200, priority 30200 from 172.16.5.4/32 table 30200, priority 20350 table main suppress_prefixlength 0, priority 30400 from 172.16.5.3/32 table 30400, priority 30400 from 172.16.5.4/32 table 30400". Note that this replaces the previous addresses, routes and rules with the new information. But also note that this only changes the run time configuration of the device. The connection profile on disk is not affected. @@ -192,7 +239,7 @@
-Google Cloud Platform (GCP)
+Google Cloud Platform (GCP)
For GCP, the meta data is fetched from URIs starting with
http://metadata.google.internal/computeMetadata/v1/with a HTTP header"Metadata-Flavor: Google". @@ -220,7 +267,7 @@
-+Microsoft Azure
+Microsoft Azure
For Azure, the meta data is fetched from URIs starting with
http://169.254.169.254/metadata/instancewith a URL parameter"?format=text&api-version=2017-04-02"and a HTTP header"Metadata:true". @@ -238,25 +285,49 @@Then, for each IP address index fetch the address at
http://169.254.169.254/metadata/instance/network/interface/$IFACE_INDEX/ipv4/ipAddress/$ADDR_INDEX/privateIpAddress?format=text&api-version=2017-04-02. - Also fetch the size of the subnet (the netmask) for the interface from + Also fetch the size of the subnet and prefix for the interface from +http://169.254.169.254/metadata/instance/network/interface/$IFACE_INDEX/ipv4/subnet/0/address/?format=text&api-version=2017-04-02. + andhttp://169.254.169.254/metadata/instance/network/interface/$IFACE_INDEX/ipv4/subnet/0/prefix/?format=text&api-version=2017-04-02.- +
At this point, we have a list of all interfaces (by MAC address) and their configured IPv4 addresses.
-For each device, we lookup the currently applied connection in NetworkManager. That implies, that the device is currently activated - in NetworkManager. If no such device was in NetworkManager, or if the profile has user-data
-org.freedesktop.nm-cloud-setup.skip=yes, - we skip the device. Now for each found IP address we add a static address "$ADDR/$SUBNET_PREFIX". Also we configure policy routing - by adding a static route "$ADDR/$SUBNET_PREFIX $GATEWAY 10, table=$TABLE" where $GATEWAY is the first IP address in the subnet and table - is 30400 plus the interface index. Also we add a policy routing rule "priority $TABLE from $ADDR/32 table $TABLE".The effect is not unlike calling - nmcli device modify "$DEVICE" ipv4.addresses "$ADDR/$SUBNET [,...]" ipv4.routes "$ADDR/32 $GATEWAY 10 table=$TABLE" ipv4.routing-rules "priority $TABLE from $ADDR/32 table $TABLE" - for all relevant devices and all found addresses.
+Then the tool configures the system like doing for AWS environment. That is, using source based policy routing + with the tables/rules 30200/30400.
+
++Alibaba Cloud (Aliyun)
+For Aliyun, the tools tries to fetch configuration from
+http://100.100.100.200/. Currently, it only + configures IPv4 and does nothing about IPv6. It will do the following.+
- +
First fetch
http://100.100.100.200/2016-01-01/meta-data/to determine whether the + expected API is present. This determines whether Aliyun environment is detected and whether to proceed + to configure the host using Aliyun meta data.- +
Fetch
http://100.100.100.200/2016-01-01/meta-data/network/interfaces/macs/to get the list + of available interface. Interfaces are identified by their MAC address.- +
Then for each interface fetch
http://100.100.100.200/2016-01-01/meta-data/network/interfaces/macs/$MAC/vpc-cidr-block, +http://100.100.100.200/2016-01-01/meta-data/network/interfaces/macs/$MAC/private-ipv4s, +http://100.100.100.200/2016-01-01/meta-data/network/interfaces/macs/$MAC/netmaskand +http://100.100.100.200/2016-01-01/meta-data/network/interfaces/macs/$MAC/gateway. + Thereby we get a list of private IPv4 addresses, one CIDR subnet block and private IPv4 addresses prefix.- +
Then nm-cloud-setup iterates over all interfaces for which it could fetch IP configuration. + If no ethernet device for the respective MAC address is found, it is skipped. + Also, if the device is currently not activated in NetworkManager or if the currently + activated profile has a user-data
+org.freedesktop.nm-cloud-setup.skip=yes, + it is skipped. Also, there is only one interface and one IP address, the tool does nothing.Then the tool configures the system like doing for AWS environment. That is, using source based policy routing + with the tables/rules 30200/30400. One difference to AWS is that the gateway is also fetched via metadata instead + of using the first IP address in the subnet.
-See Also
+See Also
NetworkManager(8) nmcli(1) diff --git a/docs/api/html/nm-dbus-types.html b/docs/api/html/nm-dbus-types.html index af1ee6c1..4d5580fd 100644 --- a/docs/api/html/nm-dbus-types.html +++ b/docs/api/html/nm-dbus-types.html @@ -4809,6 +4809,21 @@
+ + +NM_DEVICE_INTERFACE_FLAG_PROMISC
+ ++ +=
+ +0x4+ +receive all packets. Corresponds to kernel IFF_PROMISC. Since: 1.32.
+ ++ + +@@ -4822,6 +4837,21 @@ NM_DEVICE_INTERFACE_FLAG_CARRIER
+ + +NM_DEVICE_INTERFACE_FLAG_LLDP_CLIENT_ENABLED
+ ++ +=
+ +0x20000+ +the flag to indicate device LLDP status. Since: 1.32.
+ ++ bondteam+ vlanib.pkeybootdevnameserverrd.peerdns+ rd.bootifrd.ethtoolrd.net.timeout.dhcp+ rd.net.timeout.carrierrd.znetBOOTIFPlease consult the dracut.cmdline(7) @@ -124,6 +127,26 @@ NetworkManager, hostnames from command line have higher precedence over ones from DHCP, and the last that appears in the command line wins.
++ NetworkManager supports the +
ib.pkey=PARENT.PKEY+ argument to set up an Infiniband partition on IPoIB parent + devicePARENTusing the specified + partition keyPKEY. The partition + key must be in hexadecimal notation without leading "0x", for + example "ib.pkey=ib0.8004". +NetworkManager supports the +
rd.ethtool=INTERFACE:AUTONEG:SPEED+ kernel command line option to set up ethtool NIC configuration parameters +AUTONEGandSPEED. + TheINTERFACEbeing configured must be + specified, and the other parameters are optional and can be left blank. + WhenSPEEDis set, duplex mode is + automatically set to 'full'.INTERFACE+ accepts string values,AUTONEGaccepts + boolean values (true and false / on or off / 0 or 1), and +SPEEDaccepts positive integer values. +diff --git a/docs/api/html/nm-openvswitch.html b/docs/api/html/nm-openvswitch.html index 74825fc3..3718e83b 100644 --- a/docs/api/html/nm-openvswitch.html +++ b/docs/api/html/nm-openvswitch.html @@ -29,7 +29,7 @@ -Overview
+Overview
NetworkManager includes basic Open vSwitch support, good enough to be capable of setting up simple Open vSwitch configurations. It is not extensive and does not expose all functionality of Open vSwitch provides. @@ -64,7 +64,7 @@
-Bridges
+Bridges
Bridges are represented by connections of ovs-bridge type. Due to the limitations of OVSDB, "empty" Bridges (with no Ports) can't exist. @@ -74,7 +74,7 @@
-Ports
+Ports
Ports are represented by connections of ovs-port type. Due to the limitations of OVSDB, "empty" Ports (with no Interfaces) can't @@ -84,7 +84,7 @@
-Examples
+Examples
-Example 18. Creating a Bridge with a single internal Interface
+Example 18. Creating a Bridge with a single internal Interface
$nmcli conn add type ovs-bridge conn.interface bridge0Connection 'ovs-bridge-bridge0' (d10fc64d-1d48-4394-a1b8-e1aea72f27d5) successfully added. @@ -113,7 +113,7 @@ Connection 'ovs-interface-iface0' (3640d2a1-a2fd-4718-92f1-cffadb5b6cdc) success-Example 19. Adding a Linux interface to a Bridge
+Example 19. Adding a Linux interface to a Bridge
$nmcli conn add type ovs-port conn.interface port1 master bridge0Connection 'ovs-port-port1' (67d041eb-8e7b-4458-afee-a1d07c9c4552) successfully added. @@ -124,7 +124,7 @@ Connection 'ovs-slave-eth0' (d459c45c-cf78-4c1c-b4b7-505e71379624) successfully-Example 20. Creating a VLAN
+Example 20. Creating a VLAN
$nmcli conn add type ovs-port conn.interface port2 master bridge0 ovs-port.tag 120Connection 'ovs-port-port2' (3994c093-4ef7-4549-a4fd-627b831c3cb8) successfully added. @@ -135,7 +135,7 @@ Connection 'ovs-slave-eth1' (099be06e-71ad-484d-8d5a-fcadc5f207f5) successfully-Example 21. Creating a Bond
+Example 21. Creating a Bond
$nmcli conn add type ovs-port conn.interface bond0 master bridge0Connection 'ovs-port-bond0' (d154ebf9-e999-4e1b-a084-a3de53d25d8a) successfully added. @@ -153,7 +153,7 @@ Connection 'ovs-slave-eth3' (8dedeecb-ed12-482b-b77a-24a4fb835136) successfully
-Bugs
+Bugs
Not all Open vSwitch capabilities are supported.
- @@ -161,7 +161,7 @@ Connection 'ovs-slave-eth3' (8dedeecb-ed12-482b-b77a-24a4fb835136) successfully
Open vSwitch devices don't expose many useful properties on D-Bus.
Probably many more.
-See Also
+See Also
RFC 7047: The Open vSwitch Database Management Protocol, ovs-vsctl(8), diff --git a/docs/api/html/nm-settings-dbus.html b/docs/api/html/nm-settings-dbus.html index bf21733c..2fab4fd2 100644 --- a/docs/api/html/nm-settings-dbus.html +++ b/docs/api/html/nm-settings-dbus.html @@ -94,7 +94,7 @@
-connection setting
+connection setting
General Connection Profile Settings.