Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free
Documentation License, Version 1.1 or any later
@@ -61,25 +61,25 @@
This section details the architectural and D-Bus API changes in
NetworkManager 0.9.
-Elimination of the User Settings Service
+Elimination of the User Settings Service
Previously there were two "settings services", or D-Bus services that
provided and saved network configuration information. NetworkManager
@@ -103,7 +103,7 @@
-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 @@
-Settings Service Interface Changes
+Settings Service Interface Changes
With the elimination of the user settings service, the old
org.freedesktop.NetworkManagerUserSettings and
@@ -190,7 +190,7 @@
-Connection Object Interface Changes
+Connection Object Interface Changes
Consistent with the interface changes to the Settings object, the
Connection object's D-Bus interface has changed to
@@ -224,7 +224,7 @@
-Permissions Methods Consolidation
+Permissions Methods Consolidation
Previously there were two D-Bus method calls to retrieve the list of
operations that a user client could perform, and two signals notifying
@@ -256,7 +256,7 @@
are now string-based permissions. The mapping is as follows:
-
Table 20.
+
Table 20.
@@ -307,7 +307,7 @@
-AddConnection Returns Object Path of New Connection
+AddConnection Returns Object Path of New Connection
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 21.
+
Table 21.
@@ -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:
If the wireless connection has any security restrictions, like 802.1x, WEP, or WPA, set this property to '802-11-wireless-security' and ensure the connection contains a valid 802-11-wireless-security setting.
+
+
hidden
+
boolean
+
FALSE
+
If TRUE, indicates this network is a non-broadcasting network that hides its SSID. In this case various workarounds may take place, such as probe-scanning the SSID for more reliable network discovery. However, these workarounds expose inherent insecurities with hidden SSID networks, and thus hidden SSID networks should be used with caution.
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
@@ -112,7 +112,7 @@ General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
GetDevices (
) →
@@ -461,6 +461,14 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
s -
(read)
The driver handling the device.
+
DriverVersion -
+ s -
+ (read)
+ The version of the driver handling the device.
+
FirmwareVersion -
+ s -
+ (read)
+ The firmware version for the device.
Capabilities -
u -
(read)
@@ -512,6 +520,13 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
b -
(read)
Whether or not this device is managed by NetworkManager.
+
Autoconnect -
+ b -
+ (readwrite)
+ If TRUE, indicates the device is allowed to autoconnect. If FALSE,
+ manual intervention is required before the device will automatically
+ connect to a known network, such as activating a connection using the
+ device, or setting this property to TRUE.
FirmwareMissing -
b -
(read)
@@ -673,6 +688,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
InfiniBand device does not support connected mode.
NM_DEVICE_STATE_REASON_DEPENDENCY_FAILED = 50
A dependency of the connection failed.
+
NM_DEVICE_STATE_REASON_BR2684_FAILED = 50
+ Problem with the RFC 2684 Ethernet over ADSL bridge.
properties -
@@ -1384,6 +1422,11 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
Explicitly prompt for new secrets from the user. This flag
signals that NetworkManager thinks any existing secrets are
invalid or wrong. This flag implies that interaction is allowed.
+
+ Set if the request was initiated by user-requested action via the
+ D-Bus interface, as opposed to automatically initiated by
+ NetworkManager in response to (for example) scan results or
+ carrier changes.
@@ -1488,7 +1531,17 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
) →
nothing
NM_802_11_MODE
diff --git a/docs/api/settings-spec.xml b/docs/api/settings-spec.xml
index 8d2757d9..d90814d7 100644
--- a/docs/api/settings-spec.xml
+++ b/docs/api/settings-spec.xml
@@ -1279,6 +1279,12 @@
If the wireless connection has any security restrictions, like 802.1x, WEP, or WPA, set this property to '802-11-wireless-security' and ensure the connection contains a valid 802-11-wireless-security setting.
+
+ hidden
+ boolean
+ FALSE
+ If TRUE, indicates this network is a non-broadcasting network that hides its SSID. In this case various workarounds may take place, such as probe-scanning the SSID for more reliable network discovery. However, these workarounds expose inherent insecurities with hidden SSID networks, and thus hidden SSID networks should be used with caution.
+
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
@@ -112,7 +112,7 @@ General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
GetDevices (
) →
@@ -461,6 +461,14 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
s -
(read)
The driver handling the device.
+
DriverVersion -
+ s -
+ (read)
+ The version of the driver handling the device.
+
FirmwareVersion -
+ s -
+ (read)
+ The firmware version for the device.
Capabilities -
u -
(read)
@@ -512,6 +520,13 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
b -
(read)
Whether or not this device is managed by NetworkManager.
+
Autoconnect -
+ b -
+ (readwrite)
+ If TRUE, indicates the device is allowed to autoconnect. If FALSE,
+ manual intervention is required before the device will automatically
+ connect to a known network, such as activating a connection using the
+ device, or setting this property to TRUE.
FirmwareMissing -
b -
(read)
@@ -673,6 +688,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
InfiniBand device does not support connected mode.
NM_DEVICE_STATE_REASON_DEPENDENCY_FAILED = 50
A dependency of the connection failed.
+
NM_DEVICE_STATE_REASON_BR2684_FAILED = 50
+ Problem with the RFC 2684 Ethernet over ADSL bridge.
properties -
@@ -1384,6 +1422,11 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
Explicitly prompt for new secrets from the user. This flag
signals that NetworkManager thinks any existing secrets are
invalid or wrong. This flag implies that interaction is allowed.
+
+ Set if the request was initiated by user-requested action via the
+ D-Bus interface, as opposed to automatically initiated by
+ NetworkManager in response to (for example) scan results or
+ carrier changes.
@@ -1488,7 +1531,17 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
) →
nothing
+Validates a given connection for a given NMDevice object and returns
+whether the connection may be activated with the device. For example if
+device is a WiFi device that supports only WEP encryption, the connection
+will only be valid if it is a WiFi connection which describes a WEP or open
+network, and will not be valid if it describes a WPA network, or if it is
+an Ethernet, Bluetooth, WWAN, etc connection that is incompatible with the
+device.
+
+
+This function does the same as nm_device_connection_valid(), i.e. checking
+compatibility of the given device and connection. But, in addition, it sets
+GError when FALSE is returned.
+
+
+
+
\ No newline at end of file
diff --git a/docs/libnm-glib/html/NMDeviceBt.html b/docs/libnm-glib/html/NMDeviceBt.html
index b41291a5..bc766453 100644
--- a/docs/libnm-glib/html/NMDeviceBt.html
+++ b/docs/libnm-glib/html/NMDeviceBt.html
@@ -45,9 +45,12 @@
+
+
+
\ No newline at end of file
diff --git a/docs/libnm-glib/html/NMDeviceModem.html b/docs/libnm-glib/html/NMDeviceModem.html
index 751da6e3..6dec6b03 100644
--- a/docs/libnm-glib/html/NMDeviceModem.html
+++ b/docs/libnm-glib/html/NMDeviceModem.html
@@ -45,8 +45,11 @@
+
+
+
\ No newline at end of file
diff --git a/docs/libnm-glib/html/NMDeviceWifi.html b/docs/libnm-glib/html/NMDeviceWifi.html
index f08d0b79..e41712f3 100644
--- a/docs/libnm-glib/html/NMDeviceWifi.html
+++ b/docs/libnm-glib/html/NMDeviceWifi.html
@@ -47,12 +47,15 @@
typedef struct {
GObjectClass parent;
+ /* Signals */
+ /* The "object-creation-failed" signal is PRIVATE for libnm-glib and
+ * is not meant for any external usage. It indicates that an error
+ * occured during creation of an object.
+ */
+ void (*object_creation_failed) (NMObject *master_object,
+ GError *error,
+ char *failed_path);
+
/* Padding for future expansion */
void (*_reserved1) (void);
void (*_reserved2) (void);
@@ -113,6 +133,33 @@ NMObject implements
on success, a hash table of
+hash tables, with each inner hash mapping a setting property to a GValue
+containing that property's value. [element-type utf8 GLib.HashTable]
+
@@ -277,6 +280,14 @@ existing secrets are invalid or wrong. This flag implies that interaction
is allowed.
+
+
NM_SECRET_AGENT_GET_SECRETS_FLAG_USER_REQUESTED
+
set if the request was
+initiated by user-requested action via the D-Bus interface, as opposed to
+automatically initiated by NetworkManager in response to (for example) scan
+results or carrier changes.
+
+
@@ -299,7 +310,7 @@ To easily create the hash table to return the WiFi PSK, you could do
something like this:
diff --git a/docs/libnm-glib/html/api-index-full.html b/docs/libnm-glib/html/api-index-full.html
index e07f804b..13330c48 100644
--- a/docs/libnm-glib/html/api-index-full.html
+++ b/docs/libnm-glib/html/api-index-full.html
@@ -27,8 +27,6 @@
|
D
|
- G
- |
I
|
O
@@ -525,299 +523,271 @@
D
-DBUS_GLIB_CLIENT_WRAPPERS_org_freedesktop_NetworkManagerSettings_Connection, macro in nm-exported-connection-bindings
-
-
-
-DBUS_GLIB_CLIENT_WRAPPERS_org_freedesktop_NetworkManagerSettings_Connection_Secrets, macro in nm-exported-connection-bindings
-
-
-
-DBUS_GLIB_CLIENT_WRAPPERS_org_freedesktop_NetworkManagerSettings_System, macro in nm-settings-system-bindings
-
-
-
-DBUS_GLIB_CLIENT_WRAPPERS_org_freedesktop_NetworkManager_Device_Infiniband, macro in nm-device-infiniband-bindings
-
-
-
-dbus_glib_marshal_nm_exported_connection_BOOLEAN__POINTER_POINTER, function in nm-exported-connection-glue
-
-
-
-dbus_glib_marshal_nm_exported_connection_NONE__BOXED_POINTER, macro in nm-exported-connection-glue
-
-
-
-dbus_glib_marshal_nm_exported_connection_NONE__POINTER, macro in nm-exported-connection-glue
-
-
-
-dbus_glib_marshal_nm_exported_connection_NONE__STRING_BOXED_BOOLEAN_POINTER, macro in nm-exported-connection-glue
+NMDevice, struct in NMDevice
-dbus_glib_marshal_nm_exported_connection_VOID__BOXED_POINTER, function in nm-exported-connection-glue
+NMDevice::state-changed, object signal in NMDevice
-dbus_glib_marshal_nm_exported_connection_VOID__POINTER, macro in nm-exported-connection-glue
+NMDevice:active-connection, object property in NMDevice
-dbus_glib_marshal_nm_exported_connection_VOID__STRING_BOXED_BOOLEAN_POINTER, function in nm-exported-connection-glue
+NMDevice:autoconnect, object property in NMDevice
-dbus_glib_marshal_nm_secret_agent_NONE__BOXED_BOXED_POINTER, macro in nm-secret-agent-glue
+NMDevice:capabilities, object property in NMDevice
-dbus_glib_marshal_nm_secret_agent_NONE__BOXED_BOXED_STRING_BOXED_UINT_POINTER, macro in nm-secret-agent-glue
+NMDevice:device-type, object property in NMDevice
-dbus_glib_marshal_nm_secret_agent_NONE__BOXED_STRING_POINTER, macro in nm-secret-agent-glue
+NMDevice:dhcp4-config, object property in NMDevice
-dbus_glib_marshal_nm_secret_agent_VOID__BOXED_BOXED_POINTER, function in nm-secret-agent-glue
+NMDevice:dhcp6-config, object property in NMDevice
-dbus_glib_marshal_nm_secret_agent_VOID__BOXED_BOXED_STRING_BOXED_UINT_POINTER, function in nm-secret-agent-glue
+NMDevice:driver, object property in NMDevice
-dbus_glib_marshal_nm_secret_agent_VOID__BOXED_STRING_POINTER, function in nm-secret-agent-glue
+NMDevice:driver-version, object property in NMDevice
-dbus_glib_nm_exported_connection_object_info, variable in nm-exported-connection-glue
+NMDevice:firmware-missing, object property in NMDevice
-org_freedesktop_NetworkManagerSettings_Connection_delete, function in nm-exported-connection-bindings
-
-
-
-org_freedesktop_NetworkManagerSettings_Connection_delete_async, function in nm-exported-connection-bindings
-
-
-
-org_freedesktop_NetworkManagerSettings_Connection_delete_async_callback, function in nm-exported-connection-bindings
-
-
-
-org_freedesktop_NetworkManagerSettings_Connection_delete_reply, user_function in nm-exported-connection-bindings
-
-
-
-org_freedesktop_NetworkManagerSettings_Connection_get_settings, function in nm-exported-connection-bindings
-
-
-
-org_freedesktop_NetworkManagerSettings_Connection_get_settings_async, function in nm-exported-connection-bindings
-
-
-
-org_freedesktop_NetworkManagerSettings_Connection_get_settings_async_callback, function in nm-exported-connection-bindings
-
-
-
-org_freedesktop_NetworkManagerSettings_Connection_get_settings_reply, user_function in nm-exported-connection-bindings
-
-
-
-org_freedesktop_NetworkManagerSettings_Connection_Secrets_get_secrets, function in nm-exported-connection-bindings
-
-
-
-org_freedesktop_NetworkManagerSettings_Connection_Secrets_get_secrets_async, function in nm-exported-connection-bindings
-
-
-
-org_freedesktop_NetworkManagerSettings_Connection_Secrets_get_secrets_async_callback, function in nm-exported-connection-bindings
-
-
-
-org_freedesktop_NetworkManagerSettings_Connection_Secrets_get_secrets_reply, user_function in nm-exported-connection-bindings
-
-
-
-org_freedesktop_NetworkManagerSettings_Connection_update, function in nm-exported-connection-bindings
-
-
-
-org_freedesktop_NetworkManagerSettings_Connection_update_async, function in nm-exported-connection-bindings
+NMObject::object-creation-failed, object signal in NMObject
-org_freedesktop_NetworkManagerSettings_Connection_update_async_callback, function in nm-exported-connection-bindings
+NMObject:dbus-connection, object property in NMObject
-org_freedesktop_NetworkManagerSettings_Connection_update_reply, user_function in nm-exported-connection-bindings
+NMObject:dbus-path, object property in NMObject
-org_freedesktop_NetworkManagerSettings_System_get_permissions, function in nm-settings-system-bindings
+NMObjectClass, struct in NMObject
-org_freedesktop_NetworkManagerSettings_System_get_permissions_async, function in nm-settings-system-bindings
+NMObjectError, enum in NMObject
-org_freedesktop_NetworkManagerSettings_System_get_permissions_async_callback, function in nm-settings-system-bindings
+NM_OBJECT_DBUS_CONNECTION, macro in NMObject
-org_freedesktop_NetworkManagerSettings_System_get_permissions_reply, user_function in nm-settings-system-bindings
+NM_OBJECT_DBUS_PATH, macro in NMObject
-org_freedesktop_NetworkManagerSettings_System_save_hostname, function in nm-settings-system-bindings
+NM_OBJECT_ERROR, macro in NMObject
-org_freedesktop_NetworkManagerSettings_System_save_hostname_async, function in nm-settings-system-bindings
+nm_object_error_quark, function in NMObject
-org_freedesktop_NetworkManagerSettings_System_save_hostname_async_callback, function in nm-settings-system-bindings
+nm_object_get_connection, function in NMObject
-org_freedesktop_NetworkManagerSettings_System_save_hostname_reply, user_function in nm-settings-system-bindings
+nm_object_get_path, function in NMObject
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free
Documentation License, Version 1.1 or any later
@@ -89,6 +89,18 @@
NMDeviceWimax