dbus/introspection/nm-agent-manager.xml

0001 <?xml version="1.0" encoding="UTF-8" ?>
0002
0003 <node name="/org/freedesktop/NetworkManager/AgentManager" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
0004   <interface name="org.freedesktop.NetworkManager.AgentManager">
0005
0006     <method name="Register">
0007       <tp:docstring>
0008         Called by secret Agents to register their ability to provide and save
0009         network secrets.
0010       </tp:docstring>
0011       <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_agent_manager_register"/>
0012       <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
0013       <arg name="identifier" type="s" direction="in">
0014         <tp:docstring>
0015           Identifies this agent; only one agent in each user session may use the
0016           same identifier.  Identifier formatting follows the same rules as
0017           D-Bus bus names with the exception that the ':' character is not
0018           allowed.  The valid set of characters is "[A-Z][a-z][0-9]_-." and the
0019           identifier is limited in length to 255 characters with a minimum
0020           of 3 characters.  An example valid identifier is 'org.gnome.nm-applet'
0021           (without quotes).
0022         </tp:docstring>
0023       </arg>
0024     </method>
0025
0026     <method name="RegisterWithCapabilities">
0027       <tp:docstring>
0028         Like Register() but indicates agent capabilities to NetworkManager.
0029       </tp:docstring>
0030       <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_agent_manager_register_with_capabilities"/>
0031       <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
0032       <arg name="identifier" type="s" direction="in">
0033         <tp:docstring>
0034             See the Register() method's identifier argument.
0035         </tp:docstring>
0036       </arg>
0037       <arg name="capabilities" type="u" direction="in" tp:type="NM_SECRET_AGENT_CAPABILITIES">
0038         <tp:docstring>
0039             Indicates various agent capabilities to NetworkManager.
0040         </tp:docstring>
0041       </arg>
0042     </method>
0043
0044     <method name="Unregister">
0045       <tp:docstring>
0046         Called by secret Agents to notify NetworkManager that they will no
0047         longer handle requests for network secrets.  Agents are automatically
0048         unregistered when they disconnect from D-Bus.
0049       </tp:docstring>
0050       <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_agent_manager_unregister"/>
0051       <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
0052     </method>
0053
0054   </interface>
0055 </node>
0056