From dcc310e31af7fa88eb51fabe90de7edd374aecc5 Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Sun, 16 Oct 2011 08:47:38 +0200 Subject: Imported Upstream version 0.9.1.90 --- docs/api/html/NetworkManager.devhelp | 28 ++++---- docs/api/html/NetworkManager.devhelp2 | 28 ++++---- docs/api/html/index.html | 32 ++++----- docs/api/html/ix01.html | 2 +- docs/api/html/ref-migrating.html | 58 +++++++-------- docs/api/html/ref-settings.html | 36 +++++----- docs/api/html/spec.html | 132 ++++++++++++++++++++++++++++++++-- 7 files changed, 220 insertions(+), 96 deletions(-) (limited to 'docs/api/html') diff --git a/docs/api/html/NetworkManager.devhelp b/docs/api/html/NetworkManager.devhelp index 225718a4..4a5c1038 100644 --- a/docs/api/html/NetworkManager.devhelp +++ b/docs/api/html/NetworkManager.devhelp @@ -4,23 +4,23 @@ - + - - - - - - - - - - - - - + + + + + + + + + + + + + diff --git a/docs/api/html/NetworkManager.devhelp2 b/docs/api/html/NetworkManager.devhelp2 index e5538797..c67adae7 100644 --- a/docs/api/html/NetworkManager.devhelp2 +++ b/docs/api/html/NetworkManager.devhelp2 @@ -4,23 +4,23 @@ - + - - - - - - - - - - - - - + + + + + + + + + + + + + diff --git a/docs/api/html/index.html b/docs/api/html/index.html index c734b922..bc12bb5c 100644 --- a/docs/api/html/index.html +++ b/docs/api/html/index.html @@ -22,11 +22,11 @@     
  

-

Version 0.9.0 +

Version 0.9.1.90

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 @@ -188,7 +188,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 @@ -222,7 +222,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 @@ -254,7 +254,7 @@ are now string-based permissions. The mapping is as follows:

-

Table 17. 

+

Table 17. 

@@ -305,7 +305,7 @@

-AddConnection Returns Object Path of New Connection

+AddConnection Returns Object Path of New Connection

The org.freedesktop.NetworkManager.Settings.AddConnection @@ -323,7 +323,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 @@ -346,7 +346,7 @@

-New Device States

+New Device States

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

-New Active Connection State

+New Active Connection State

Along with the new device states, an additional @@ -377,7 +377,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 @@ -413,7 +413,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 @@ -422,7 +422,7 @@ following values:

-

Table 18. 

+

Table 18. 

@@ -484,7 +484,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 @@ -494,7 +494,7 @@ their replacements:

-

Table 19. 

+

Table 19. 

diff --git a/docs/api/html/ref-settings.html b/docs/api/html/ref-settings.html index 5db0ccd8..d062b73f 100644 --- a/docs/api/html/ref-settings.html +++ b/docs/api/html/ref-settings.html @@ -23,7 +23,7 @@

Network Configuration Setting Specification

@@ -35,11 +35,11 @@

-Configuration Settings

+Configuration Settings

-

Table 1. 802-1x setting

+

Table 1. 802-1x setting

@@ -228,7 +228,7 @@


-

Table 2. bluetooth setting

+

Table 2. bluetooth setting

@@ -267,7 +267,7 @@


-

Table 3. cdma setting

+

Table 3. cdma setting

@@ -318,7 +318,7 @@


-

Table 4. connection setting

+

Table 4. connection setting

@@ -387,7 +387,7 @@


-

Table 5. gsm setting

+

Table 5. gsm setting

@@ -480,7 +480,7 @@


-

Table 6. ipv4 setting

+

Table 6. ipv4 setting

@@ -579,7 +579,7 @@


-

Table 7. ipv6 setting

+

Table 7. ipv6 setting

@@ -660,7 +660,7 @@


-

Table 8. 802-11-olpc-mesh setting

+

Table 8. 802-11-olpc-mesh setting

@@ -705,7 +705,7 @@


-

Table 9. ppp setting

+

Table 9. ppp setting

@@ -840,7 +840,7 @@


-

Table 10. pppoe setting

+

Table 10. pppoe setting

@@ -891,7 +891,7 @@


-

Table 11. serial setting

+

Table 11. serial setting

@@ -948,7 +948,7 @@


-

Table 12. vpn setting

+

Table 12. vpn setting

@@ -999,7 +999,7 @@


-

Table 13. wimax setting

+

Table 13. wimax setting

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


-

Table 14. 802-3-ethernet setting

+

Table 14. 802-3-ethernet setting

@@ -1131,7 +1131,7 @@


-

Table 15. 802-11-wireless setting

+

Table 15. 802-11-wireless setting

@@ -1236,7 +1236,7 @@


-

Table 16. 802-11-wireless-security setting

+

Table 16. 802-11-wireless-security setting

diff --git a/docs/api/html/spec.html b/docs/api/html/spec.html index c8abf6ca..9f652756 100644 --- a/docs/api/html/spec.html +++ b/docs/api/html/spec.html @@ -1,5 +1,5 @@ -NetworkManager D-Bus Interface Specification version 0.9.0

NetworkManager D-Bus Interface Specification

Version 0.9.0

Copyright (C) 2008 - 2011 Red Hat, Inc.
Copyright (C) 2008 - 2009 Novell, Inc.
+

NetworkManager D-Bus Interface Specification

Version 0.9.1.90

Copyright (C) 2008 - 2011 Red Hat, Inc.
Copyright (C) 2008 - 2009 Novell, Inc.

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.

-

Interfaces

+

Interfaces

org.freedesktop.NetworkManager

Methods:

GetDevices ( ) → @@ -1169,6 +1169,129 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Interface has no signals.

Interface has no properties.

+ +

org.freedesktop.NetworkManager.SecretAgent

+ Private D-Bus interface used by secret agents that store and provide + secrets to NetworkManager. If an agent provides secrets to + NetworkManager as part of connection creation, and the some of those + secrets are "agent owned" the agent should store those secrets + itself and should not expect its SaveSecrets() method to be called. + SaveSecrets() will be called eg if some program other than the + agent itself (like a connection editor) changes the secrets out of + band. +

Methods:

GetSecrets ( + a{sa{sv}}: connection, o: connection_path, s: setting_name, as: hints, u: flags + ) → + a{sa{sv}}

+ Retrieve and return stored secrets, if any, or request new + secrets from the agent's user. +

Parameters

connection - + a{sa{sv}} + (String_String_Variant_Map_Map) +
+ Nested settings maps containing the connection for which + secrets are being requested. This may contain system-owned + secrets if the agent has successfully authenticated to + modify system network settings and the GetSecrets request + flags allow user interaction. +
connection_path - + o
+ Object path of the connection for which secrets are being + requested. +
setting_name - + s
+ Setting name for which secrets are being requested. +
hints - + as
+ Array of strings of key names in the requested setting for + which NetworkManager thinks a secrets may be required, + and/or well-known identifiers and data that may be useful + to the client in processing the secrets request. The Agent + should return any secrets it has, or that it thinks are + required, regardless of what hints NetworkManager sends + in this request. +
flags - + u + (NM_SECRET_AGENT_GET_SECRETS_FLAGS) +
+ Flags which modify the behavior of the secrets request. + If true, new secrets are assumed to be invalid or incorrect, + and the agent should ask the user for new secrets. If false, + existing secrets should be retrieved from storage and + returned without interrupting the user. +

Returns

secrets - + a{sa{sv}} + (String_String_Variant_Map_Map) +
+ Nested settings maps containing secrets. Each setting MUST + contain at least the 'name' field, containing the name of + the setting, and one or more secrets. +

CancelGetSecrets ( + o: connection_path, s: setting_name + ) → + nothing

+ Cancel a pending GetSecrets request for secrets of the given + connection. Any matching 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. +
setting_name - + s
+ Setting name for which secrets for this connection were + originally being requested. +

SaveSecrets ( + a{sa{sv}}: connection, o: connection_path + ) → + nothing

+ Save given secrets to backing storage. +

Parameters

connection - + a{sa{sv}} + (String_String_Variant_Map_Map) +
+ Nested settings maps containing the entire connection + (including secrets), for which the agent should save the + secrets to backing storage. This method will not be called + when the agent itself is the process creating or updating + a connection; in that case the agent is assumed to have + already saved those secrets since it had them already. +
connection_path - + o
+ Object path of the connection for which the agent should + save secrets to backing storage. +

DeleteSecrets ( + a{sa{sv}}: connection, o: connection_path + ) → + nothing

+ Delete secrets from backing storage. +

Parameters

connection - + a{sa{sv}} + (String_String_Variant_Map_Map) +
+ Nested settings maps containing the connection properties + (sans secrets), for which the agent should delete the + secrets from backing storage. +
connection_path - + o
+ Object path of the connection for which the agent should + delete secrets from backing storage. +

Interface has no signals.

Interface has no properties.

Sets of flags:

NM_SECRET_AGENT_GET_SECRETS_FLAGS

+ Flags modifying the behavior of GetSecrets request. +
NM_SECRET_AGENT_GET_SECRETS_FLAG_NONE = 0x0
+ No special behavior; by default no user interaction is allowed and + requests for secrets are fulfilled from persistent storage, or + if no secrets are available an error is returned. +
NM_SECRET_AGENT_GET_SECRETS_FLAG_ALLOW_INTERACTION = 0x1
+ Allows the request to interact with the user, possibly prompting + via UI for secrets if any are required, or if none are found in + persistent storage. +
NM_SECRET_AGENT_GET_SECRETS_FLAG_REQUEST_NEW = 0x2
+ 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. +
+ +

org.freedesktop.NetworkManager.VPN.Connection

Represents an active connection to a Virtual Private Network.

Interface has no methods.

Signals:

PropertiesChanged ( @@ -1379,7 +1502,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.org.freedesktop.NetworkManager.VPN.Error.BadArguments

Invalid arguments were passed with the request. FIXME: too general.

org.freedesktop.NetworkManager.VPN.Error.LaunchFailed

A binary providing the service failed to launch.

org.freedesktop.NetworkManager.VPN.Error.ConnectionInvalid

The request could not be processed because the VPN connection settings were invalid. -

Index

Index of interfaces

Index of types