nm-settings.xml 3.42 KB
Newer Older
1 2
<?xml version="1.0" encoding="UTF-8" ?>

Dan Williams's avatar
Dan Williams committed
3
<node name="/org/freedesktop/NetworkManager/Settings" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
4
  <interface name="org.freedesktop.NetworkManager.Settings">
Dan Williams's avatar
Dan Williams committed
5
    <tp:docstring>
6
      The Settings interface allows clients to view and administrate the connections stored and used by NetworkManager.
Dan Williams's avatar
Dan Williams committed
7 8 9 10 11 12 13 14
    </tp:docstring>

    <method name="ListConnections">
      <tp:docstring>
        List the connections stored by this Settings object.
      </tp:docstring>
      <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_settings_list_connections"/>
      <arg name="connections" type="ao" direction="out">
15
        <tp:docstring>
Dan Williams's avatar
Dan Williams committed
16
          List of connections.
17
        </tp:docstring>
Dan Williams's avatar
Dan Williams committed
18 19
      </arg>
    </method>
20

21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37
    <method name="GetConnectionByUuid">
      <tp:docstring>
        Retrieve the object path of a connection, given that connection's UUID.
      </tp:docstring>
      <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_settings_get_connection_by_uuid"/>
      <arg name="uuid" type="s" direction="in">
        <tp:docstring>
          The UUID to find the connection object path for.
        </tp:docstring>
      </arg>
      <arg name="connection" type="o" direction="out">
        <tp:docstring>
          The connection's object path.
        </tp:docstring>
      </arg>
    </method>

38 39 40 41 42 43 44 45 46 47 48
    <method name="AddConnection">
      <tp:docstring>
        Add new connection.
      </tp:docstring>
      <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_settings_add_connection"/>
      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
      <arg name="connection" type="a{sa{sv}}" direction="in">
        <tp:docstring>
          Connection settings and properties.
        </tp:docstring>
      </arg>
49 50 51 52 53
      <arg name="path" type="o" direction="out">
        <tp:docstring>
          Object path of the new connection that was just added.
        </tp:docstring>
      </arg>
54 55
    </method>

56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88
    <method name="SaveHostname">
      <tp:docstring>
        Save the hostname to persistent configuration.
      </tp:docstring>
      <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_settings_save_hostname"/>
      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
      <arg name="hostname" type="s" direction="in">
        <tp:docstring>
          The hostname to save to persistent configuration.  If blank, the persistent hostname is cleared.
        </tp:docstring>
      </arg>
    </method>

    <property name="Hostname" type="s" access="read">
      <tp:docstring>
        The machine hostname stored in persistent configuration.
      </tp:docstring>
    </property>

    <property name="CanModify" type="b" access="read">
      <tp:docstring>
        If true, adding and modifying connections is supported.
      </tp:docstring>
    </property>

    <signal name="PropertiesChanged">
        <arg name="properties" type="a{sv}" tp:type="String_Variant_Map">
            <tp:docstring>
                A dictionary mapping property names to variant boxed values
            </tp:docstring>
        </arg>
    </signal>

Dan Williams's avatar
Dan Williams committed
89 90
    <signal name="NewConnection">
      <tp:docstring>
91
        Emitted when a new connection has been added.
Dan Williams's avatar
Dan Williams committed
92 93 94 95 96 97 98
      </tp:docstring>
      <arg name="connection" type="o">
        <tp:docstring>
          Object path of the new connection.
        </tp:docstring>
      </arg>
    </signal>
Dan Williams's avatar
Dan Williams committed
99

Dan Williams's avatar
Dan Williams committed
100
  </interface>
101
</node>
Dan Williams's avatar
Dan Williams committed
102