org.freedesktop.NetworkManager.AgentManager: NetworkManager Reference Manual

org.freedesktop.NetworkManager.AgentManager

Methods

Register                 (IN  s identifier);
RegisterWithCapabilities (IN  s identifier,
                          IN  u capabilities);
Unregister               ();

Description

Method Details

The Register() method

Register (IN  s identifier);

Called by secret Agents to register their ability to provide and save network secrets.

IN s identifier:

Identifies this agent; only one agent in each user session may use the same identifier. Identifier formatting follows the same rules as D-Bus bus names with the exception that the ':' character is not allowed. The valid set of characters is "[A-Z][a-z][0-9]_-." and the identifier is limited in length to 255 characters with a minimum of 3 characters. An example valid identifier is 'org.gnome.nm-applet' (without quotes).

The RegisterWithCapabilities() method

RegisterWithCapabilities (IN  s identifier,
                          IN  u capabilities);

Like Register() but indicates agent capabilities to NetworkManager.

`IN s identifier`:	See the Register() method's identifier argument.
`IN u capabilities`:	(NMSecretAgentCapabilities) Indicates various agent capabilities to NetworkManager.

The Unregister() method

Unregister ();

Called by secret Agents to notify NetworkManager that they will no longer handle requests for network secrets. Agents are automatically unregistered when they disconnect from D-Bus.