NetworkManager D-Bus Interface Specification

Version 1.1.90

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or @@ -116,10 +116,22 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

- Get the list of network devices. + Get the list of realized network devices.

Returns

devices - ao: - List of object paths of network devices known to the system. + List of object paths of network devices known to the system. This + list does not include device placeholders (see GetAllDevices()). +

GetAllDevices ( + + ) → + ao

+ Get the list of all network devices. +

Returns

devices - + ao: + List of object paths of network devices and device placeholders + (eg, devices that do not yet exist but which can be automatically + created by NetworkManager if one of their AvailableConnections + was activated).

GetDeviceByIpIface ( s: iface ) → @@ -246,7 +258,13 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
Parameters
`level` - `s`
- One of [ERR, WARN, INFO, DEBUG, TRACE]. + One of [ERR, WARN, INFO, DEBUG, TRACE, OFF, KEEP]. + This level is applied to the domains as specified in the domains + argument. Except for the special level "KEEP", all unmentioned + domains are disabled entirely. "KEEP" is special and allows + not to change the current setting except for the specified + domains. E.g. level=KEEP and domains=PLATFORM:DEBUG will only + touch the platform domain.
`domains` - `s`
A combination of logging domains separated by commas (','), or "NONE" @@ -332,7 +350,16 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Properties:

Devices - ao - (read): - The list of network devices/interfaces NetworkManager knows about. + The list of realized network devices. Realized devices are those which + have backing resources (eg from the kernel or a management daemon like + ModemManager, teamd, etc). +
AllDevices - + ao - + (read): + The list of both realized and un-realized network devices. Un-realized + devices are software devices which do not yet have backing resources, + but for which backing resources can be created if the device is + activated.
NetworkingEnabled - b - (read): @@ -386,8 +413,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.(read) (NM_METERED); - Wheter the connectivity is metered. This is equivalent to the - metered property of the device associated with the primary + Indicates whether the connectivity is metered. This is equivalent + to the metered property of the device associated with the primary connection.
ActivatingConnection - o - @@ -417,6 +444,18 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.NM_CONNECTIVITY): The network connectivity state. +
GlobalDnsConfiguration - + a{sv} - + (readwrite): + Dictionary of global DNS settings where the key is one of + "searches", "options" and "domains". The values for the + "searches" and "options" keys are string arrays describing the + list of search domains and resolver options, respectively. + The value of the "domains" key is a second-level dictionary, + where each key is a domain name, and each key's value is a + third-level dictionary with the keys "servers" and + "options". "servers" is a string array of DNS servers, + "options" is a string array of domain-specific options.

Enumerated types:

NM_STATE

Describes the overall state of the daemon.

NM_STATE_UNKNOWN = 0: @@ -498,7 +537,23 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
NM_802_11_AP_SEC_NONE = 0x0: Null flag.
NM_802_11_AP_SEC_PAIR_WEP40 = 0x1: Access point supports pairwise 40-bit WEP encryption.
NM_802_11_AP_SEC_PAIR_WEP104 = 0x2: Access point supports pairwise 104-bit WEP encryption.
NM_802_11_AP_SEC_PAIR_TKIP = 0x4: Access point supports pairwise TKIP encryption.
NM_802_11_AP_SEC_PAIR_CCMP = 0x8: Access point supports pairwise CCMP encryption.
NM_802_11_AP_SEC_GROUP_WEP40 = 0x10: Access point supports a group 40-bit WEP cipher.
NM_802_11_AP_SEC_GROUP_WEP104 = 0x20: Access point supports a group 104-bit WEP cipher.
NM_802_11_AP_SEC_GROUP_TKIP = 0x40: Access point supports a group TKIP cipher.
NM_802_11_AP_SEC_GROUP_CCMP = 0x80: Access point supports a group CCMP cipher.
NM_802_11_AP_SEC_KEY_MGMT_PSK = 0x100: Access point supports PSK key management.
NM_802_11_AP_SEC_KEY_MGMT_802_1X = 0x200: Access point supports 802.1x key management.

org.freedesktop.NetworkManager.Device

Methods:

Disconnect ( +

org.freedesktop.NetworkManager.Device

Methods:

Reapply ( + a{sa{sv}}: connection, u: flags + ) → + nothing

+ Attempts to update the configuration of a device without deactivating it. + You can either modify the configuration by passing the desired setup via "connection" + argument or just omit the argument to bring it in sync with the connection that + has been activated but could have been modified since. +

Parameters

connection - + a{sa{sv}}: + The effective connection settings and properties to use. If empty, the connection + settings from the connection that is active on the device will be used. +
flags - + u: + Flags which would modify the behavior of the Reapply call. + There are no flags defined currently and the users should use the value of 0. +

Disconnect ( ) → nothing

@@ -613,8 +668,12 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Managed - b - - (read)

- Whether or not this device is managed by NetworkManager. + (readwrite)

+ Whether or not this device is managed by NetworkManager. Setting this + property has a similar effect to configuring the device as unmanaged + via the keyfile.unmanaged-devices setting in NetworkManager.conf. + Changes to this value are not persistent and lost after NetworkManager + restart.

Autoconnect - b - (readwrite)

@@ -628,6 +687,11 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.(read)

If TRUE, indicates the device is likely missing firmware necessary for its operation. +

NmPluginMissing - + b - + (read)

+ If TRUE, indicates the NetworkManager plugin for the device is likely + missing or misconfigured.

DeviceType - u - (read) @@ -656,6 +720,17 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Whether the amount of traffic flowing through the device is subject to limitations, for example set by service providers. +

LldpNeighbors - + aa{sv} - + (read)

+ Array of LLDP neighbors; each element is a dictionary mapping + LLDP TLV names to variant boxed values. +

Real - + b - + (read)

+ True if the device exists, or False for placeholder devices that + do not yet exist but could be automatically created by NetworkManager + if one of their AvailableConnections was activated.

Enumerated types:

NM_DEVICE_STATE

NM_DEVICE_STATE_UNKNOWN = 0: The device is in an unknown state.
NM_DEVICE_STATE_UNMANAGED = 10: @@ -883,6 +958,10 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.u - (read); Design speed of the device, in megabits/second (Mb/s). +
S390Subchannels - + as - + (read): + Array of S/390 subchannels for S/390 or z/Architecture devices.
Carrier - b - (read): @@ -1351,7 +1430,13 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.as - (read); A list of domains this address belongs to.
Searches - as - - (read): A list of dns searches.
WinsServers - + (read): A list of dns searches.
DnsOptions - + as - + (read): + A list of DNS options that modify the behavior of the DNS + resolver. See resolv.conf(5) manual page for the list of + supported options. +
WinsServers - au - (read): The Windows Internet Name Service servers associated with the connection. Each address is in network byte order.

@@ -1395,7 +1480,13 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.as - (read)

A list of domains this address belongs to.

Searches - as - - (read)

A list of dns searches.

+ (read)

A list of dns searches.

DnsOptions - + as - + (read)

+ A list of DNS options that modify the behavior of the DNS + resolver. See resolv.conf(5) manual page for the list of + supported options. +

org.freedesktop.NetworkManager.DHCP4Config

Options and configuration returned by the IPv4 DHCP server. -- cgit 1.3.0-6-gf8a5

NetworkManager D-Bus Interface Specification

Version 1.0.10

NetworkManager D-Bus Interface Specification

Version 1.1.90

Returns

GetAllDevices ( + + ) → + ao

Returns

Parameters

Properties:

Enumerated types:

NM_STATE

org.freedesktop.NetworkManager.Device

Methods:

Disconnect ( +

org.freedesktop.NetworkManager.Device

Methods:

Reapply ( + a{sa{sv}}: connection, u: flags + ) → + nothing

Parameters

Disconnect ( ) → nothing

Enumerated types:

NM_DEVICE_STATE

org.freedesktop.NetworkManager.DHCP4Config