From 2c032d8f1c6292c1338a615e6ec40252889ba85c Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Thu, 22 Jan 2015 00:29:39 +0100 Subject: Imported Upstream version 1.0.0 --- docs/libnm/html/libnm-nm-errors.html | 844 +++++++++++++++++++++++++++++++++++ 1 file changed, 844 insertions(+) create mode 100644 docs/libnm/html/libnm-nm-errors.html (limited to 'docs/libnm/html/libnm-nm-errors.html') diff --git a/docs/libnm/html/libnm-nm-errors.html b/docs/libnm/html/libnm-nm-errors.html new file mode 100644 index 00000000..79a6365c --- /dev/null +++ b/docs/libnm/html/libnm-nm-errors.html @@ -0,0 +1,844 @@ + + + + +nm-errors + + + + + + + + + + + + + + + + + + + +
+
+
+ + +
+

nm-errors

+

nm-errors

+
+
+

Synopsis

+
enum                NMAgentManagerError;
+GQuark              nm_agent_manager_error_quark        (void);
+#define             NM_AGENT_MANAGER_ERROR
+enum                NMConnectionError;
+#define             NM_CONNECTION_ERROR
+GQuark              nm_connection_error_quark           (void);
+enum                NMCryptoError;
+#define             NM_CRYPTO_ERROR
+GQuark              nm_crypto_error_quark               (void);
+enum                NMDeviceError;
+#define             NM_DEVICE_ERROR
+GQuark              nm_device_error_quark               (void);
+enum                NMManagerError;
+GQuark              nm_manager_error_quark              (void);
+#define             NM_MANAGER_ERROR
+enum                NMSecretAgentError;
+GQuark              nm_secret_agent_error_quark         (void);
+#define             NM_SECRET_AGENT_ERROR
+enum                NMSettingsError;
+GQuark              nm_settings_error_quark             (void);
+#define             NM_SETTINGS_ERROR
+enum                NMVpnPluginError;
+#define             NM_VPN_PLUGIN_ERROR
+GQuark              nm_vpn_plugin_error_quark           (void);
+
+
+
+

Object Hierarchy

+
+  GEnum
+   +----NMAgentManagerError
+
+
+  GEnum
+   +----NMConnectionError
+
+
+  GEnum
+   +----NMCryptoError
+
+
+  GEnum
+   +----NMDeviceError
+
+
+  GEnum
+   +----NMManagerError
+
+
+  GEnum
+   +----NMSecretAgentError
+
+
+  GEnum
+   +----NMSettingsError
+
+
+  GEnum
+   +----NMVpnPluginError
+
+
+
+

Description

+

+

+
+
+

Details

+
+

enum NMAgentManagerError

+
typedef enum {
+	NM_AGENT_MANAGER_ERROR_FAILED = 0,         /*< nick=Failed >*/
+	NM_AGENT_MANAGER_ERROR_PERMISSION_DENIED,  /*< nick=PermissionDenied >*/
+	NM_AGENT_MANAGER_ERROR_INVALID_IDENTIFIER, /*< nick=InvalidIdentifier >*/
+	NM_AGENT_MANAGER_ERROR_NOT_REGISTERED,     /*< nick=NotRegistered >*/
+	NM_AGENT_MANAGER_ERROR_NO_SECRETS,         /*< nick=NoSecrets >*/
+	NM_AGENT_MANAGER_ERROR_USER_CANCELED,      /*< nick=UserCanceled >*/
+} NMAgentManagerError;
+
+

+Errors returned from the secret-agent manager. +

+

+These errors may be returned from operations that could cause secrets to be +requested (such as nm_client_activate_connection()), and correspond to D-Bus +errors in the "org.freedesktop.NetworkManager.AgentManager" namespace. +

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_AGENT_MANAGER_ERROR_FAILED

unknown or unspecified error +

NM_AGENT_MANAGER_ERROR_PERMISSION_DENIED

The caller does not have permission + to register a secret agent, or is trying to register the same secret agent + twice. +

NM_AGENT_MANAGER_ERROR_INVALID_IDENTIFIER

The identifier is not a valid + secret agent identifier. +

NM_AGENT_MANAGER_ERROR_NOT_REGISTERED

The caller tried to unregister an agent + that was not registered. +

NM_AGENT_MANAGER_ERROR_NO_SECRETS

No secret agent returned secrets for this + request +

NM_AGENT_MANAGER_ERROR_USER_CANCELED

The user canceled the secrets request. +
+
+
+
+

nm_agent_manager_error_quark ()

+
GQuark              nm_agent_manager_error_quark        (void);
+

+

+
+
+
+

NM_AGENT_MANAGER_ERROR

+
#define NM_AGENT_MANAGER_ERROR (nm_agent_manager_error_quark ())
+
+

+

+
+
+
+

enum NMConnectionError

+
typedef enum {
+	NM_CONNECTION_ERROR_FAILED = 0,                   /*< nick=Failed >*/
+	NM_CONNECTION_ERROR_SETTING_NOT_FOUND,            /*< nick=SettingNotFound >*/
+	NM_CONNECTION_ERROR_PROPERTY_NOT_FOUND,           /*< nick=PropertyNotFound >*/
+	NM_CONNECTION_ERROR_PROPERTY_NOT_SECRET,          /*< nick=PropertyNotSecret >*/
+	NM_CONNECTION_ERROR_MISSING_SETTING,              /*< nick=MissingSetting >*/
+	NM_CONNECTION_ERROR_INVALID_SETTING,              /*< nick=InvalidSetting >*/
+	NM_CONNECTION_ERROR_MISSING_PROPERTY,             /*< nick=MissingProperty >*/
+	NM_CONNECTION_ERROR_INVALID_PROPERTY,             /*< nick=InvalidProperty >*/
+} NMConnectionError;
+
+

+Describes errors that may result from operations involving a NMConnection +or its NMSettings. +

+

+These errors may be returned directly from NMConnection and NMSetting +methods, or may be returned from D-Bus operations (eg on NMClient or +NMDevice), where they correspond to errors in the +"org.freedesktop.NetworkManager.Settings.Connection" namespace. +

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_CONNECTION_ERROR_FAILED

unknown or unclassified error +

NM_CONNECTION_ERROR_SETTING_NOT_FOUND

the NMConnection object + did not contain the specified NMSetting object +

NM_CONNECTION_ERROR_PROPERTY_NOT_FOUND

the NMConnection did not contain the + requested NMSetting property +

NM_CONNECTION_ERROR_PROPERTY_NOT_SECRET

an operation which requires a secret + was attempted on a non-secret property +

NM_CONNECTION_ERROR_MISSING_SETTING

the NMConnection object is missing an + NMSetting which is required for its configuration. The error message will + always be prefixed with "<setting-name>: ", where "<setting-name>" is the + name of the setting that is missing. +

NM_CONNECTION_ERROR_INVALID_SETTING

the NMConnection object contains an + invalid or inappropriate NMSetting. The error message will always be + prefixed with "<setting-name>: ", where "<setting-name>" is the name of the + setting that is invalid. +

NM_CONNECTION_ERROR_MISSING_PROPERTY

the NMConnection object is invalid + because it is missing a required property. The error message will always be + prefixed with "<setting-name>.<property-name>: ", where "<setting-name>" is + the name of the setting with the missing property, and "<property-name>" is + the property that is missing. +

NM_CONNECTION_ERROR_INVALID_PROPERTY

the NMConnection object is invalid + because a property has an invalid value. The error message will always be + prefixed with "<setting-name>.<property-name>: ", where "<setting-name>" is + the name of the setting with the invalid property, and "<property-name>" is + the property that is invalid. +
+
+
+
+

NM_CONNECTION_ERROR

+
#define NM_CONNECTION_ERROR nm_connection_error_quark ()
+
+

+

+
+
+
+

nm_connection_error_quark ()

+
GQuark              nm_connection_error_quark           (void);
+

+

+
+
+
+

enum NMCryptoError

+
typedef enum {
+	NM_CRYPTO_ERROR_FAILED = 0,
+	NM_CRYPTO_ERROR_INVALID_DATA,
+	NM_CRYPTO_ERROR_INVALID_PASSWORD,
+	NM_CRYPTO_ERROR_UNKNOWN_CIPHER,
+	NM_CRYPTO_ERROR_DECRYPTION_FAILED,
+	NM_CRYPTO_ERROR_ENCRYPTION_FAILED,
+} NMCryptoError;
+
+

+Cryptography-related errors that can be returned from some nm-utils methods, +and some NMSetting8021x operations. +

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_CRYPTO_ERROR_FAILED

generic failure +

NM_CRYPTO_ERROR_INVALID_DATA

the certificate or key data provided + was invalid +

NM_CRYPTO_ERROR_INVALID_PASSWORD

the password was invalid +

NM_CRYPTO_ERROR_UNKNOWN_CIPHER

the data uses an unknown cipher +

NM_CRYPTO_ERROR_DECRYPTION_FAILED

decryption failed +

NM_CRYPTO_ERROR_ENCRYPTION_FAILED

encryption failed +
+
+
+
+

NM_CRYPTO_ERROR

+
#define NM_CRYPTO_ERROR nm_crypto_error_quark ()
+
+

+

+
+
+
+

nm_crypto_error_quark ()

+
GQuark              nm_crypto_error_quark               (void);
+

+

+
+
+
+

enum NMDeviceError

+
typedef enum {
+	NM_DEVICE_ERROR_FAILED = 0,                /*< nick=Failed >*/
+	NM_DEVICE_ERROR_CREATION_FAILED,           /*< nick=CreationFailed >*/
+	NM_DEVICE_ERROR_INVALID_CONNECTION,        /*< nick=InvalidConnection >*/
+	NM_DEVICE_ERROR_INCOMPATIBLE_CONNECTION,   /*< nick=IncompatibleConnection >*/
+	NM_DEVICE_ERROR_NOT_ACTIVE,                /*< nick=NotActive >*/
+	NM_DEVICE_ERROR_NOT_SOFTWARE,              /*< nick=NotSoftware >*/
+	NM_DEVICE_ERROR_NOT_ALLOWED,               /*< nick=NotAllowed >*/
+	NM_DEVICE_ERROR_SPECIFIC_OBJECT_NOT_FOUND, /*< nick=SpecificObjectNotFound >*/
+} NMDeviceError;
+
+

+Device-related errors. +

+

+These errors may be returned directly from NMDevice methods, or may be +returned from D-Bus operations (where they correspond to errors in the +"org.freedesktop.NetworkManager.Device" namespace). +

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_DEVICE_ERROR_FAILED

unknown or unclassified error +

NM_DEVICE_ERROR_CREATION_FAILED

NetworkManager failed to create the device +

NM_DEVICE_ERROR_INVALID_CONNECTION

the specified connection is not valid +

NM_DEVICE_ERROR_INCOMPATIBLE_CONNECTION

the specified connection is not + compatible with this device. +

NM_DEVICE_ERROR_NOT_ACTIVE

the device does not have an active connection +

NM_DEVICE_ERROR_NOT_SOFTWARE

the requested operation is only valid on + software devices. +

NM_DEVICE_ERROR_NOT_ALLOWED

the requested operation is not allowed at + this time. +

NM_DEVICE_ERROR_SPECIFIC_OBJECT_NOT_FOUND

the "specific object" in the + activation request (eg, the NMAccessPoint or NMWimaxNsp) was not + found. +
+
+
+
+

NM_DEVICE_ERROR

+
#define NM_DEVICE_ERROR nm_device_error_quark ()
+
+

+

+
+
+
+

nm_device_error_quark ()

+
GQuark              nm_device_error_quark               (void);
+

+

+
+
+
+

enum NMManagerError

+
typedef enum {
+	NM_MANAGER_ERROR_FAILED = 0,                  /*< nick=Failed >*/
+	NM_MANAGER_ERROR_PERMISSION_DENIED,           /*< nick=PermissionDenied >*/
+	NM_MANAGER_ERROR_UNKNOWN_CONNECTION,          /*< nick=UnknownConnection >*/
+	NM_MANAGER_ERROR_UNKNOWN_DEVICE,              /*< nick=UnknownDevice >*/
+	NM_MANAGER_ERROR_CONNECTION_NOT_AVAILABLE,    /*< nick=ConnectionNotAvailable >*/
+	NM_MANAGER_ERROR_CONNECTION_NOT_ACTIVE,       /*< nick=ConnectionNotActive >*/
+	NM_MANAGER_ERROR_CONNECTION_ALREADY_ACTIVE,   /*< nick=ConnectionAlreadyActive >*/
+	NM_MANAGER_ERROR_DEPENDENCY_FAILED,           /*< nick=DependencyFailed >*/
+	NM_MANAGER_ERROR_ALREADY_ASLEEP_OR_AWAKE,     /*< nick=AlreadyAsleepOrAwake >*/
+	NM_MANAGER_ERROR_ALREADY_ENABLED_OR_DISABLED, /*< nick=AlreadyEnabledOrDisabled >*/
+	NM_MANAGER_ERROR_UNKNOWN_LOG_LEVEL,           /*< nick=UnknownLogLevel >*/
+	NM_MANAGER_ERROR_UNKNOWN_LOG_DOMAIN,          /*< nick=UnknownLogDomain >*/
+} NMManagerError;
+
+

+Errors related to the main "network management" interface of NetworkManager. +These may be returned from NMClient methods that invoke D-Bus operations on +the "org.freedesktop.NetworkManager" interface, and correspond to D-Bus +errors in that namespace. +

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_MANAGER_ERROR_FAILED

unknown or unclassified error +

NM_MANAGER_ERROR_PERMISSION_DENIED

Permission denied. +

NM_MANAGER_ERROR_UNKNOWN_CONNECTION

The requested connection is not known. +

NM_MANAGER_ERROR_UNKNOWN_DEVICE

The requested device is not known. +

NM_MANAGER_ERROR_CONNECTION_NOT_AVAILABLE

The requested connection cannot be + activated at this time. +

NM_MANAGER_ERROR_CONNECTION_NOT_ACTIVE

The request could not be completed + because a required connection is not active. +

NM_MANAGER_ERROR_CONNECTION_ALREADY_ACTIVE

The connection to be activated was + already active on another device. +

NM_MANAGER_ERROR_DEPENDENCY_FAILED

An activation request failed due to a + dependency being unavailable. +

NM_MANAGER_ERROR_ALREADY_ASLEEP_OR_AWAKE

The manager is already in the requested + sleep/wake state. +

NM_MANAGER_ERROR_ALREADY_ENABLED_OR_DISABLED

The network is already + enabled/disabled. +

NM_MANAGER_ERROR_UNKNOWN_LOG_LEVEL

Unknown log level in SetLogging +

NM_MANAGER_ERROR_UNKNOWN_LOG_DOMAIN

Unknown log domain in SetLogging +
+
+
+
+

nm_manager_error_quark ()

+
GQuark              nm_manager_error_quark              (void);
+

+

+
+
+
+

NM_MANAGER_ERROR

+
#define NM_MANAGER_ERROR (nm_manager_error_quark ())
+
+

+

+
+
+
+

enum NMSecretAgentError

+
typedef enum {
+	NM_SECRET_AGENT_ERROR_FAILED = 0,         /*< nick=Failed >*/
+	NM_SECRET_AGENT_ERROR_PERMISSION_DENIED,  /*< nick=PermissionDenied >*/
+	NM_SECRET_AGENT_ERROR_INVALID_CONNECTION, /*< nick=InvalidConnection >*/
+	NM_SECRET_AGENT_ERROR_USER_CANCELED,      /*< nick=UserCanceled >*/
+	NM_SECRET_AGENT_ERROR_AGENT_CANCELED,     /*< nick=AgentCanceled >*/
+	NM_SECRET_AGENT_ERROR_NO_SECRETS,         /*< nick=NoSecrets >*/
+} NMSecretAgentError;
+
+

+NMSecretAgentError values are passed by secret agents back to NetworkManager +when they encounter problems retrieving secrets on behalf of NM. They +correspond to errors in the "org.freedesktop.NetworkManager.SecretManager" +namespace. +

+

+Client APIs such as nm_client_activate_connection() will not see these error +codes; instead, the secret agent manager will translate them to the +corresponding NMAgentManagerError codes. +

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_SECRET_AGENT_ERROR_FAILED

unknown or unclassified error +

NM_SECRET_AGENT_ERROR_PERMISSION_DENIED

the caller (ie, NetworkManager) is + not authorized to make this request +

NM_SECRET_AGENT_ERROR_INVALID_CONNECTION

the connection for which secrets + were requested is invalid +

NM_SECRET_AGENT_ERROR_USER_CANCELED

the request was canceled by the user +

NM_SECRET_AGENT_ERROR_AGENT_CANCELED

the agent canceled the request + because it was requested to do so by NetworkManager +

NM_SECRET_AGENT_ERROR_NO_SECRETS

the agent cannot find any secrets for this + connection +
+
+
+
+

nm_secret_agent_error_quark ()

+
GQuark              nm_secret_agent_error_quark         (void);
+

+

+
+
+
+

NM_SECRET_AGENT_ERROR

+
#define NM_SECRET_AGENT_ERROR         (nm_secret_agent_error_quark ())
+
+

+

+
+
+
+

enum NMSettingsError

+
typedef enum {
+	NM_SETTINGS_ERROR_FAILED = 0,           /*< nick=Failed >*/
+	NM_SETTINGS_ERROR_PERMISSION_DENIED,    /*< nick=PermissionDenied >*/
+	NM_SETTINGS_ERROR_NOT_SUPPORTED,        /*< nick=NotSupported >*/
+	NM_SETTINGS_ERROR_INVALID_CONNECTION,   /*< nick=InvalidConnection >*/
+	NM_SETTINGS_ERROR_READ_ONLY_CONNECTION, /*< nick=ReadOnlyConnection >*/
+	NM_SETTINGS_ERROR_UUID_EXISTS,          /*< nick=UuidExists >*/
+	NM_SETTINGS_ERROR_INVALID_HOSTNAME,     /*< nick=InvalidHostname >*/
+} NMSettingsError;
+
+

+Errors related to the settings/persistent configuration interface of +NetworkManager. +

+

+These may be returned from NMClient methods that invoke D-Bus operations on +the "org.freedesktop.NetworkManager.Settings" interface, and correspond to +D-Bus errors in that namespace. +

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_SETTINGS_ERROR_FAILED

unknown or unclassified error +

NM_SETTINGS_ERROR_PERMISSION_DENIED

permission denied +

NM_SETTINGS_ERROR_NOT_SUPPORTED

the requested operation is not supported by any + active settings backend +

NM_SETTINGS_ERROR_INVALID_CONNECTION

the connection was invalid +

NM_SETTINGS_ERROR_READ_ONLY_CONNECTION

attempted to modify a read-only connection +

NM_SETTINGS_ERROR_UUID_EXISTS

a connection with that UUID already exists +

NM_SETTINGS_ERROR_INVALID_HOSTNAME

attempted to set an invalid hostname +
+
+
+
+

nm_settings_error_quark ()

+
GQuark              nm_settings_error_quark             (void);
+

+

+
+
+
+

NM_SETTINGS_ERROR

+
#define NM_SETTINGS_ERROR (nm_settings_error_quark ())
+
+

+

+
+
+
+

enum NMVpnPluginError

+
typedef enum {
+	NM_VPN_PLUGIN_ERROR_FAILED,                    /*< nick=Failed >*/
+	NM_VPN_PLUGIN_ERROR_STARTING_IN_PROGRESS,      /*< nick=StartingInProgress >*/
+	NM_VPN_PLUGIN_ERROR_ALREADY_STARTED,           /*< nick=AlreadyStarted >*/
+	NM_VPN_PLUGIN_ERROR_STOPPING_IN_PROGRESS,      /*< nick=StoppingInProgress >*/
+	NM_VPN_PLUGIN_ERROR_ALREADY_STOPPED,           /*< nick=AlreadyStopped >*/
+	NM_VPN_PLUGIN_ERROR_WRONG_STATE,               /*< nick=WrongState >*/
+	NM_VPN_PLUGIN_ERROR_BAD_ARGUMENTS,             /*< nick=BadArguments >*/
+	NM_VPN_PLUGIN_ERROR_LAUNCH_FAILED,             /*< nick=LaunchFailed >*/
+	NM_VPN_PLUGIN_ERROR_INVALID_CONNECTION,        /*< nick=InvalidConnection >*/
+	NM_VPN_PLUGIN_ERROR_INTERACTIVE_NOT_SUPPORTED, /*< nick=InteractiveNotSupported >*/
+} NMVpnPluginError;
+
+

+Returned by the VPN service plugin to indicate errors. These codes correspond +to errors in the "org.freedesktop.NetworkManager.VPN.Error" namespace. +

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

NM_VPN_PLUGIN_ERROR_FAILED

unknown or unclassified error +

NM_VPN_PLUGIN_ERROR_STARTING_IN_PROGRESS

the plugin is already starting, + and another connect request was received +

NM_VPN_PLUGIN_ERROR_ALREADY_STARTED

the plugin is already connected, and + another connect request was received +

NM_VPN_PLUGIN_ERROR_STOPPING_IN_PROGRESS

the plugin is already stopping, + and another stop request was received +

NM_VPN_PLUGIN_ERROR_ALREADY_STOPPED

the plugin is already stopped, and + another disconnect request was received +

NM_VPN_PLUGIN_ERROR_WRONG_STATE

the operation could not be performed in + this state +

NM_VPN_PLUGIN_ERROR_BAD_ARGUMENTS

the operation could not be performed as + the request contained malformed arguments, or arguments of unexpected type. + Usually means that one of the VPN setting data items or secrets was not of + the expected type (ie int, string, bool, etc). +

NM_VPN_PLUGIN_ERROR_LAUNCH_FAILED

a child process failed to launch +

NM_VPN_PLUGIN_ERROR_INVALID_CONNECTION

the operation could not be performed + because the connection was invalid. Usually means that the connection's + VPN setting was missing some required data item or secret. +

NM_VPN_PLUGIN_ERROR_INTERACTIVE_NOT_SUPPORTED

the operation could not be + performed as the plugin does not support interactive operations, such as + ConnectInteractive() or NewSecrets() +
+
+
+
+

NM_VPN_PLUGIN_ERROR

+
#define NM_VPN_PLUGIN_ERROR      (nm_vpn_plugin_error_quark ())
+
+

+

+
+
+
+

nm_vpn_plugin_error_quark ()

+
GQuark              nm_vpn_plugin_error_quark           (void);
+

+

+
+
+
+
+
+ Generated by GTK-Doc V1.19
+ + \ No newline at end of file -- cgit 1.3.0-6-gf8a5