summaryrefslogtreecommitdiffstats
path: root/tdecore/networkbackends/network-manager/introspection/nm-agent-manager.xml
blob: e26caacf426ebc30514aff390aea7e662ace00a6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
<?xml version="1.0" encoding="UTF-8" ?>

<node name="/org/freedesktop/NetworkManager/AgentManager" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
  <interface name="org.freedesktop.NetworkManager.AgentManager">

    <method name="Register">
      <tp:docstring>
        Called by secret Agents to register their ability to provide and save
        network secrets.
      </tp:docstring>
      <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_agent_manager_register"/>
      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
      <arg name="identifier" type="s" direction="in">
        <tp:docstring>
          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).
        </tp:docstring>
      </arg>
    </method>

    <method name="Unregister">
      <tp:docstring>
        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.
      </tp:docstring>
      <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_agent_manager_unregister"/>
      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
    </method>

  </interface>
</node>