1
<?xml version="1.0" encoding="UTF-8" ?>
4
READ ME! READ ME! READ ME! READ ME! READ ME!
6
This file needs to be kept in sync with nm-manager-client.xml with the exception of
7
the legacy methods at the end of this file.
10
<node name="/" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
11
<interface name="org.freedesktop.NetworkManager">
12
<method name="GetDevices">
14
Get the list of network devices.
16
<annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_manager_get_devices"/>
17
<arg name="devices" type="ao" direction="out">
19
List of object paths of network devices known to the system.
24
<method name="ActivateConnection">
25
<annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_manager_activate_connection"/>
26
<annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
28
Activate a connection using the supplied device.
30
<arg name="service_name" type="s" direction="in">
32
The D-Bus service name of the settings service that provides this connection.
35
<arg name="connection" type="o" direction="in">
37
The connection to activate the devices with.
40
<arg name="device" type="o" direction="in">
42
The device to be activated.
45
<arg name="specific_object" type="o" direction="in">
47
The path of a device-type-specific object this activation should use, for example a WiFi access point.
50
<arg name="active_connection" type="o" direction="out">
52
The path of the active connection object representing this active connection.
56
<tp:error name="org.freedesktop.NetworkManager.Error.UnknownConnection"/>
57
<tp:error name="org.freedesktop.NetworkManager.Error.UnknownDevice"/>
58
<tp:error name="org.freedesktop.NetworkManager.Error.InvalidService"/>
59
<tp:error name="org.freedesktop.NetworkManager.Error.ConnectionActivating">
60
<tp:docstring>Another connection is already activating or the same connection is already active. FIXME: check if the error name is correct. FIXME: split into 2 errors?</tp:docstring>
62
<tp:error name="org.freedesktop.NetworkManager.Error.ConnectionInvalid">
63
<tp:docstring>The connection is invalid for this device.</tp:docstring>
68
<method name="DeactivateConnection">
70
Deactivate an active connection.
72
<annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_manager_deactivate_connection"/>
73
<arg name="active_connection" type="o" direction="in">
75
The currently active connection to deactivate.
81
<annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_manager_sleep"/>
83
Control the NetworkManager daemon's sleep state. When asleep, all interfaces that it manages are deactivated. When awake, devices are available to be activated.
85
<arg name="sleep" type="b" direction="in">
87
Indicates whether the NetworkManager daemon should sleep or wake.
92
<property name="WirelessEnabled" type="b" access="readwrite">
94
Indicates if wireless is currently enabled or not.
98
<property name="WirelessHardwareEnabled" type="b" access="read">
100
Indicates if the wireless hardware is currently enabled, i.e. the state of the RF kill switch.
104
<property name="ActiveConnections" type="ao" access="read">
106
List of active connection object paths.
110
<property name="State" type="u" access="read" tp:type="NM_STATE">
112
The overall state of the NetworkManager daemon.
116
<signal name="StateChanged">
118
NetworkManager's state changed.
120
<arg name="state" type="u" tp:type="NM_STATE">
122
The new state of NetworkManager.
127
<signal name="PropertiesChanged">
129
NetworkManager's properties changed.
131
<arg name="properties" type="a{sv}" tp:type="String_Variant_Map">
133
The changed properties.
138
<signal name="DeviceAdded">
140
A device was added to the system
142
<arg name="device_path" type="o">
144
The object path of the newly added device.
149
<signal name="DeviceRemoved">
151
A device was removed from the system, and is no longer available.
153
<arg name="device_path" type="o">
155
The object path of the device that was just removed.
160
<tp:enum name="NM_STATE" type="u">
162
Describes the overall state of the daemon.
164
<tp:enumvalue suffix="UNKNOWN" value="0">
166
The NetworkManager daemon is in an unknown state.
169
<tp:enumvalue suffix="ASLEEP" value="1">
171
The NetworkManager daemon is asleep and all interfaces managed by it are inactive.
174
<tp:enumvalue suffix="CONNECTING" value="2">
176
The NetworkManager daemon is connecting a device. FIXME: What does this mean when one device is active and another is connecting?
179
<tp:enumvalue suffix="CONNECTED" value="3">
181
The NetworkManager daemon is connected.
184
<tp:enumvalue suffix="DISCONNECTED" value="4">
186
The NetworkManager daemon is disconnected.
191
<!-- Legacy methods to maintain backwards compatibility for 0.6 branch. -->
193
<signal name="StateChange">
195
DEPRECATED. NetworkManager's state changed. Use the 'StateChanged' signal instead.
197
<arg name="state" type="u" tp:type="NM_STATE">
199
The new state of NetworkManager.
204
<method name="sleep">
206
DEPRECATED. Control the NetworkManager daemon's sleep state. When asleep, all interfaces that it manages are deactivated.
208
<annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_manager_legacy_sleep"/>
213
DEPRECATED. Control the NetworkManager daemon's sleep state. When awake, all known interfaces are available to be activated.
215
<annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_manager_legacy_wake"/>
218
<method name="state">
220
DEPRECATED. The overall state of the NetworkManager daemon.
222
<annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_manager_legacy_state"/>
223
<arg name="state" type="u" direction="out" tp:type="NM_STATE"/>