This section details the architectural and D-Bus API changes in NetworkManager 0.9.

Previously there were two "settings services", or D-Bus services that provided and saved network configuration information. NetworkManager @@ -74,7 +74,7 @@ Elimination of the user settings service provides the following advantages for clients of NetworkManager:

Simpler discovery of network configuration and change tracking
Simpler storage of user-level network secrets by control applets
Correct operation of fast-user switching and multi-seat configurations

-User Secret Agents

+User Secret Agents

Even with the elimination of the user settings service, in some cases it is still desirable to store secrets in the user's session and not in @@ -152,7 +152,7 @@

With the elimination of the user settings service, the old org.freedesktop.NetworkManagerUserSettings and @@ -190,7 +190,7 @@

Consistent with the interface changes to the Settings object, the Connection object's D-Bus interface has changed to @@ -224,13 +224,13 @@

Previously there were two D-Bus method calls to retrieve the list of operations that a user client could perform, and two signals notifying callers that they should recheck permissions. Those two calls were:

org.freedesktop.NetworkManagerSettings.System.GetPermissions which returned a bitfield of operations the caller was allowed to @@ -256,7 +256,7 @@ are now string-based permissions. The mapping is as follows:

Table 23.

@@ -307,7 +307,7 @@

-AddConnection Returns Object Path of New Connection

+AddConnection Returns Object Path of New Connection

The org.freedesktop.NetworkManager.Settings.AddConnection @@ -325,7 +325,7 @@

-Support for WiMAX Devices

+Support for WiMAX Devices

NetworkManager now supports Intel WiMAX mobile broadband devices. A corresponding device type (NM_DEVICE_TYPE_WIMAX) and @@ -348,7 +348,7 @@

-New Device States

+New Device States

A few new device states have been added, and all device states have been renumbered for flexibility. @@ -363,7 +363,7 @@

-New Active Connection State

+New Active Connection State

Along with the new device states, an additional @@ -379,7 +379,7 @@

-Consolidated Modem Devices

+Consolidated Modem Devices

Many new mobile broadband devices support multiple access families, like Qualcomm Gobi cards (CDMA/EVDO and GSM/UMTS), or multi-mode EVDO/LTE @@ -415,7 +415,7 @@

-Secret Property Flags

+Secret Property Flags

In the Connection object's configuration properties, each setting's secret properties (like WiFi passphrases, or public key passwords, etc) now has @@ -424,7 +424,7 @@ following values:

Table 24.

@@ -486,7 +486,7 @@

-Deprecated Methods Removed

+Deprecated Methods Removed

A few methods and signals of the org.freedesktop.NetworkManager interface deprecated in version 0.7 have been removed. All the @@ -496,7 +496,7 @@ their replacements:

Table 25.

@@ -536,6 +536,6 @@ + Generated by GTK-Doc V1.19 \ No newline at end of file diff --git a/docs/api/html/ref-settings.html b/docs/api/html/ref-settings.html index a70f8150..28b89a23 100644 --- a/docs/api/html/ref-settings.html +++ b/docs/api/html/ref-settings.html @@ -3,12 +3,12 @@ Network Configuration Setting Specification - + - + @@ -20,10 +20,10 @@

-Network Configuration Setting Specification

Configuration Settings

Table 1. 802-1x setting

@@ -178,7 +178,7 @@ - + @@ -190,7 +190,7 @@ - + @@ -235,6 +235,18 @@ + + + + + + + + + + + + @@ -246,7 +258,7 @@

Table 2. adsl setting

password	string		Password used for EAP authentication methods.	UTF-8 encoded password used for EAP authentication methods.
password-flags	password-raw	byte array	[]	Password used for EAP authentication methods as a byte array	Password used for EAP authentication methods, given as a byte array to allow passwords in other encodings than UTF-8 to be used. If both 'password' and 'password-raw' are given, 'password' is preferred.
password-raw-flags	Flags indicating how to handle the 802.1x phase2 private key password. (see the section called “Secret flag types” for flag values)
pin	string		PIN used for EAP authentication methods.
pin-flags	uint32	0	Flags indicating how to handle the 802.1x PIN. (see the section called “Secret flag types” for flag values)
system-ca-certs	boolean	FALSE

@@ -315,7 +327,7 @@

Table 3. bluetooth setting

@@ -354,7 +366,7 @@

Table 4. bond setting

@@ -393,7 +405,7 @@

Table 5. bridge setting

@@ -462,7 +474,7 @@

Table 6. bridge-port setting

@@ -507,7 +519,7 @@

Table 7. cdma setting

@@ -558,7 +570,7 @@

Table 8. connection setting

@@ -651,7 +663,7 @@

Table 9. gsm setting

@@ -744,7 +756,7 @@

Table 10. infiniband setting

@@ -789,7 +801,7 @@

Table 11. ipv4 setting

@@ -888,7 +900,7 @@

Table 12. ipv6 setting

@@ -913,7 +925,7 @@ - + @@ -981,7 +993,7 @@

Table 13. 802-11-olpc-mesh setting

method	string		IPv6 configuration method. If 'auto' is specified then the appropriate automatic method (PPP, router advertisement, etc) is used for the device and most other properties can be left unset. To force the use of DHCP only, specify 'dhcp'; this method is only valid for ethernet-based hardware. If 'link-local' is specified, then an IPv6 link-local address will be assigned to the interface. If 'manual' is specified, static IP addressing is used and at least one IP address must be given in the 'addresses' property. If 'ignored' is specified, IPv6 configuration is not done. This property must be set. NOTE: the 'shared' methodis not yet supported.	IPv6 configuration method. If 'auto' is specified then the appropriate automatic method (PPP, router advertisement, etc) is used for the device and most other properties can be left unset. To force the use of DHCP only, specify 'dhcp'; this method is only valid for ethernet-based hardware. If 'link-local' is specified, then an IPv6 link-local address will be assigned to the interface. If 'manual' is specified, static IP addressing is used and at least one IP address must be given in the 'addresses' property. If 'ignore' is specified, IPv6 configuration is not done. This property must be set. NOTE: the 'shared' methodis not yet supported.
dhcp-hostname

@@ -1026,7 +1038,7 @@

Table 14. ppp setting

@@ -1161,7 +1173,7 @@

Table 15. pppoe setting

@@ -1212,7 +1224,7 @@

Table 16. serial setting

@@ -1269,7 +1281,7 @@

Table 17. vlan setting

@@ -1332,7 +1344,7 @@

Table 18. vpn setting

@@ -1383,7 +1395,7 @@

Table 19. wimax setting

@@ -1422,7 +1434,7 @@

Table 20. 802-3-ethernet setting

@@ -1515,7 +1527,7 @@

Table 21. 802-11-wireless setting

@@ -1594,7 +1606,7 @@ - + @@ -1626,7 +1638,7 @@

Table 22. 802-11-wireless-security setting

mac-address-blacklist	array of string	[]	If specified, this connection will never apply to the WiFi device whose permanent MAC address matches an address in the list. Each MAC address is in the standard hex-digits-and-colons notation (00:11:22:33:44:55).	A list of permanent MAC addresses of Wi-Fi devices to which this connection should never apply. Each MAC address should be given in the standard hex-digits-and-colons notation (eg '00:11:22:33:44:55').
mtu

@@ -1675,13 +1687,13 @@ - + - + @@ -1758,6 +1770,6 @@ + Generated by GTK-Doc V1.19 \ No newline at end of file diff --git a/docs/api/html/secrets-flags.html b/docs/api/html/secrets-flags.html index 23f90ec7..4948a0a4 100644 --- a/docs/api/html/secrets-flags.html +++ b/docs/api/html/secrets-flags.html @@ -3,12 +3,12 @@ Secret flag types - + - + @@ -30,7 +30,7 @@

0x0 (none) - the system is responsible for providing and storing this secret. @@ -59,6 +59,6 @@

\ No newline at end of file diff --git a/docs/api/html/spec.html b/docs/api/html/spec.html index 5e3559da..25c3f8a9 100644 --- a/docs/api/html/spec.html +++ b/docs/api/html/spec.html @@ -1,5 +1,4 @@ - -NetworkManager D-Bus Interface Specification version 0.9.8.0

NetworkManager D-Bus Interface Specification

Version 0.9.8.0

NetworkManager D-Bus Interface Specification

Version 0.9.8.8

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 @@ -273,6 +272,16 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

domains - s

For available domains see SetLogging() call. +

CheckConnectivity ( + + ) → + u

+ Re-check the network connectivity state. +

Returns

connectivity - + u + (NM_CONNECTIVITY) +: + The current connectivity state.

state ( ) → @@ -352,6 +361,21 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.ao - `(read)`
List of active connection object paths. +
`PrimaryConnection` - + `o` - + `(read)`
+ The object path of the "primary" active connection being used + to access the network. In particular, if there is no VPN + active, or the VPN does not have the default route, then this + indicates the connection that has the default route. If there + is a VPN active with the default route, then this indicates + the connection that contains the route to the VPN endpoint. +
`ActivatingConnection` - + `o` - + `(read)`
+ The object path of an active connection that is currently + being activated and which is expected to become the new + PrimaryConnection when it finishes activating.
`Version` - `s` - `(read)`
@@ -362,6 +386,12 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.NM_STATE)
The overall state of the NetworkManager daemon. +
`Connectivity` - + `u` - + `(read)` + (NM_CONNECTIVITY) +
+ The network connectivity state.

Enumerated types:

NM_STATE

Describes the overall state of the daemon.

NM_STATE_UNKNOWN = 0: @@ -381,6 +411,21 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
NM_STATE_CONNECTED_GLOBAL = 70: A network device is connected, with global network connectivity. +

NM_CONNECTIVITY

+ Describes the network-connectivity state. +

NM_CONNECTIVITY_UNKNOWN = 0: + Network connectivity is unknown. +
NM_CONNECTIVITY_NONE = 1: + The host is not connected to any network. +
NM_CONNECTIVITY_PORTAL = 2: + The host is behind a captive portal and cannot reach the + full Internet. +
NM_CONNECTIVITY_LIMITED = 3: + The host is connected to a network, but does not appear to + be able to reach the full Internet. +
NM_CONNECTIVITY_FULL = 4: + The host is connected to a network, and appears to be able + to reach the full Internet

org.freedesktop.NetworkManager.AccessPoint

Interface has no methods.

Signals:

PropertiesChanged ( @@ -1162,7 +1207,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- List the connections stored by this Settings object. + List the saved network connections known to NetworkManager.
Returns
`connections` - `ao`
List of connections. @@ -1181,7 +1226,10 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- Add new connection. + Add new connection and save it to disk. This operation does not start + the network connection unless (1) device is idle and able to connect to + the network described by the new connection, and (2) the connection + is allowed to be started automatically.
Parameters
`connection` - `a{sa{sv}}`
Connection settings and properties. @@ -1206,7 +1254,14 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
NewConnection ( o: connection )
- Emitted when a new connection has been added. + Emitted when a new connection has been added after NetworkManager has + started up and initialized. This signal is not emitted for connections + read while starting up, because NetworkManager's D-Bus service is only + available after all connections have been read, and to prevent spamming + listeners with too many signals at one time. To retrieve the initial + connection list, call the ListConnections() method once, and then listen + for individual Settings.NewConnection and Settings.Connection.Deleted + signals for further updates.
Parameters
`connection` - `o`
Object path of the new connection. @@ -1303,7 +1358,11 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.o - `(read)`
The path of the connection.
`SpecificObject` - `o` - - `(read)`
A specific object associated with the active connection.
`Uuid` - + `(read)`
+ A specific object associated with the active connection. This property + reflects the specific object used during connection activation, and will + not change over the lifetime of the ActiveConnection once set. +
`Uuid` - `s` - `(read)`
The UUID of the connection, provided as a convenience so that clients @@ -1373,7 +1432,11 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
Retrieve and return stored secrets, if any, or request new - secrets from the agent's user. + secrets from the agent's user. If user interaction is allowed + and the user enters new secrets, the agent is expected to save + the new secrets to persistent storage (if the secret's flags + include AGENT_OWNED) as NetworkManager will not send these + secrets back to the same agent via a SaveSecrets() call.
Parameters
`connection` - `a{sa{sv}}` (String_String_Variant_Map_Map) @@ -1395,7 +1458,9 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
Cancel a pending GetSecrets request for secrets of the given - connection. Any matching request should be canceled. + connection. Any GetSecrets request with the same + 'connection_path' and 'setting_name' that are given in a + CancelGetSecrets request should be canceled.
Parameters
`connection_path` - `o`
- Object path of the connection for which, if secrets are being - requested, the request should be canceled. + Object path of the connection for which, if secrets for + the given 'setting_name' are being requested, the request + should be canceled.
`setting_name` - `s`
Setting name for which secrets for this connection were @@ -1754,6 +1822,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
`NM_802_11_MODE` - u
`NM_ACTIVE_CONNECTION_STATE` - u
`NM_BT_CAPABILITIES` + - u
`NM_CONNECTIVITY` - u
`NM_DEVICE_CAP` - u
`NM_DEVICE_MODEM_CAPABILITIES` - u
`NM_DEVICE_STATE` @@ -1773,4 +1842,4 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
`String_Variant_Map` - a{ s → v } -
+ \ No newline at end of file -- cgit 1.3.0-6-gf8a5

pairwise	array of string	[]	If specified, will only connect to WPA networks that provide the specified pairwise encryption capabilities. Each element may be one of 'wep40', 'wep104', 'tkip', or 'ccmp'.	A list of pairwise encryption algorithms which prevents connections to Wi-Fi networks that do not utilize one of the algorithms in the list. For maximum compatibility leave this property empty. Each list element may be one of 'wep40', 'wep104', 'tkip' or 'ccmp'.
group	array of string	[]	If specified, will only connect to WPA networks that provide the specified group/multicast encryption capabilities. Each element may be one of 'wep40', 'wep104', 'tkip', or 'ccmp'.	A list of group/broadcast encryption algorithms which prevents connections to Wi-Fi networks that do not utilize one of the algorithms in the list. For maximum compatibility leave this property empty. Each list element may be one of 'wep40', 'wep104', 'tkip', or 'ccmp'.
leap-username

-Index

+Index

-Appendix A. License

+Appendix A. License

-D-Bus API Reference

+D-Bus API Reference

-Migrating from NetworkManager 0.8 to NetworkManager 0.9

+Migrating from NetworkManager 0.8 to NetworkManager 0.9

-Architecture and D-Bus API Changes in 0.9

-Elimination of the User Settings Service

-User Secret Agents

-Settings Service Interface Changes

-Connection Object Interface Changes

-Permissions Methods Consolidation

-AddConnection Returns Object Path of New Connection

-Support for WiMAX Devices

-New Device States

-New Active Connection State

-Consolidated Modem Devices

-Secret Property Flags

-Deprecated Methods Removed

-Network Configuration Setting Specification

+Network Configuration Setting Specification

-Configuration Settings

NetworkManager D-Bus Interface Specification

Version 0.9.8.0

NetworkManager D-Bus Interface Specification

Version 0.9.8.8

CheckConnectivity ( + + ) → + u

Returns

Enumerated types:

NM_STATE

NM_CONNECTIVITY

org.freedesktop.NetworkManager.AccessPoint

Signals:

Returns

Parameters

NewConnection ( o: connection )

Parameters

Parameters

Parameters