nm-errors: libnm Reference Manual

- - -

nm-errors

Functions

---- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

-GQuark -	-nm_agent_manager_error_quark () -
-GQuark -	-nm_connection_error_quark () -
-GQuark -	-nm_crypto_error_quark () -
-GQuark -	-nm_device_error_quark () -
-GQuark -	-nm_manager_error_quark () -
-GQuark -	-nm_secret_agent_error_quark () -
-GQuark -	-nm_settings_error_quark () -
-GQuark -	-nm_vpn_plugin_error_quark () -

Types and Values

---- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

enum	NMAgentManagerError
#define	NM_AGENT_MANAGER_ERROR
enum	NMConnectionError
#define	NM_CONNECTION_ERROR
enum	NMCryptoError
#define	NM_CRYPTO_ERROR
enum	NMDeviceError
#define	NM_DEVICE_ERROR
enum	NMManagerError
#define	NM_MANAGER_ERROR
enum	NMSecretAgentError
#define	NM_SECRET_AGENT_ERROR
enum	NMSettingsError
#define	NM_SETTINGS_ERROR
enum	NMVpnPluginError
#define	NM_VPN_PLUGIN_ERROR

Object Hierarchy

    GEnum
-    ├── NMAgentManagerError
-    ├── NMConnectionError
-    ├── NMCryptoError
-    ├── NMDeviceError
-    ├── NMManagerError
-    ├── NMSecretAgentError
-    ├── NMSettingsError
-    ╰── NMVpnPluginError
-

Description

Functions

nm_agent_manager_error_quark ()

GQuark
-nm_agent_manager_error_quark (void);

nm_connection_error_quark ()

GQuark
-nm_connection_error_quark (void);

nm_crypto_error_quark ()

GQuark
-nm_crypto_error_quark (void);

nm_device_error_quark ()

GQuark
-nm_device_error_quark (void);

nm_manager_error_quark ()

GQuark
-nm_manager_error_quark (void);

nm_secret_agent_error_quark ()

GQuark
-nm_secret_agent_error_quark (void);

nm_settings_error_quark ()

GQuark
-nm_settings_error_quark (void);

nm_vpn_plugin_error_quark ()

GQuark
-nm_vpn_plugin_error_quark (void);

Types and Values

enum 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.

Members

----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

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

#define NM_AGENT_MANAGER_ERROR (nm_agent_manager_error_quark())
-

enum 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.

Members

----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

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()
-

enum NMCryptoError

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

Members

----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

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()
-

enum 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).

Members

----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

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_VERSION_ID_MISMATCH	- the version id did not match. -
NM_DEVICE_ERROR_MISSING_DEPENDENCIES	- the requested operation could not -be completed due to missing dependencies. -
NM_DEVICE_ERROR_INVALID_ARGUMENT	- invalid argument. Since: 1.16. -

NM_DEVICE_ERROR

#define NM_DEVICE_ERROR nm_device_error_quark()
-

enum 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.

Members

----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

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_INVALID_ARGUMENTS	- Invalid arguments for D-Bus request -
NM_MANAGER_ERROR_MISSING_PLUGIN	- A plug-in was needed to complete the -activation but is not available. -

NM_MANAGER_ERROR

#define NM_MANAGER_ERROR (nm_manager_error_quark())
-

enum 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.

Members

----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

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

#define NM_SECRET_AGENT_ERROR (nm_secret_agent_error_quark())
-

enum 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.

Members

----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

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_INVALID_ARGUMENTS	- invalid arguments -
NM_SETTINGS_ERROR_VERSION_ID_MISMATCH	- The profile's VersionId mismatched -and the update is rejected. See the "version-id" argument to `Update2()` -method. Since 1.44. -
NM_SETTINGS_ERROR_NOT_SUPPORTED_BY_PLUGIN	- the requested operation is not -supported by the settings plugin currently in use for the specified object. -Since: 1.44. -

NM_SETTINGS_ERROR

#define NM_SETTINGS_ERROR (nm_settings_error_quark())
-

enum NMVpnPluginError

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

Members

----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

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())
-