NetworkManager/introspection/org.freedesktop.NetworkManager.Device.WiMax.xml

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

110 lines
2.9 KiB
XML
Raw Permalink Normal View History

<?xml version="1.0" encoding="UTF-8"?>
<node name="/">
<!--
org.freedesktop.NetworkManager.Device.WiMax:
@short_description: WiMax Device.
libnm: retire deprecated WiMAX NMObject types WiMAX is deprecated since NetworkManager 1.2.0. Note that also NetworkManager on server side no longer supports this type, hence the server's D-Bus API will never expose devices of this type. Note that NMDeviceWimax and NMWimaxNsp are NMObject types. That means, they are instantiated by NMClient to represent information on the D-Bus interface. As NetworkManager no longer exposes WiMAX devices, such devices are never created. Note that it makes no sense that a user would directly instantiate NMObject types, because they only work together with NMClient. Don't drop the related symbols and definitions from libnm, so that there is no API/ABI change (as far as building and linking is concerned). But make the types defunctional (which of course is a behavioral API change). Calling the API now triggers a g_return_*() warning. Also belatedly mark the WimaxNsp API as deprecated. It should have been done in 1.2. Note that here we deprecate the API and retire it at the same time. Optimally, we would have deprecated it a few releases ago, before retiring it. However, marking something for deprecation is anyway no excuse for anything. I mean, removing or retiring API is usually painful, regardless whether it was marked for deprecation or not. In this case, there is no possibility that a libnm user gets hold on a NMDeviceWimax or NMWimaxNsp instance, because NMClient simply no longer instantiates them. Hence, this change should not affect any user in practice. https://gitlab.freedesktop.org/NetworkManager/NetworkManager/merge_requests/316
2019-10-20 06:10:03 +00:00
DEPRECATED: NetworkManager no longer supports WiMAX since version 1.2. This interface is no longer used.
-->
2009-12-14 11:51:50 +00:00
<interface name="org.freedesktop.NetworkManager.Device.WiMax">
<!--
GetNspList:
@nsps: List of NSP object paths.
2009-12-14 11:51:50 +00:00
Get the list of NSPs visible to this device.
-->
<method name="GetNspList">
<arg name="nsps" type="ao" direction="out"/>
</method>
<!--
Nsps:
2009-12-14 11:51:50 +00:00
List of object paths of Network Service Providers (NSPs) visible to this
WiMAX device.
-->
<property name="Nsps" type="ao" access="read"/>
<!--
HwAddress:
2009-12-14 11:51:50 +00:00
Hardware address of the device.
-->
<property name="HwAddress" type="s" access="read"/>
<!--
CenterFrequency:
2009-12-14 11:51:50 +00:00
Center frequency (in KHz) of the radio channel the device is using to
communicate with the network when connected. Has no meaning when the
device is not connected.
-->
<property name="CenterFrequency" type="u" access="read"/>
<!--
Rssi:
RSSI of the current radio link in dBm. This value indicates how strong the
raw received RF signal from the base station is, but does not indicate the
overall quality of the radio link. Has no meaning when the device is not
connected.
-->
<property name="Rssi" type="i" access="read"/>
<!--
Cinr:
CINR (Carrier to Interference + Noise Ratio) of the current radio link in
dB. CINR is a more accurate measure of radio link quality. Has no meaning
when the device is not connected.
-->
<property name="Cinr" type="i" access="read"/>
<!--
TxPower:
Average power of the last burst transmitted by the device, in units of 0.5
dBm. i.e. a TxPower of -11 represents an actual device TX power of -5.5
dBm. Has no meaning when the device is not connected.
-->
<property name="TxPower" type="i" access="read"/>
<!--
Bsid:
The ID of the serving base station as received from the network. Has no
meaning when the device is not connected.
-->
<property name="Bsid" type="s" access="read"/>
<!--
ActiveNsp:
2009-12-14 11:51:50 +00:00
Object path of the NSP currently used by the WiMax device.
-->
<property name="ActiveNsp" type="o" access="read"/>
<!--
NspAdded:
@nsp: The object path of the newly found NSP.
Emitted when a new NSP is found by the device.
-->
2009-12-14 11:51:50 +00:00
<signal name="NspAdded">
<arg name="nsp" type="o"/>
</signal>
<!--
NspRemoved:
@nsp: The object path of the NSP that has disappeared.
2009-12-14 11:51:50 +00:00
Emitted when an NSP disappears from view of the device.
-->
2009-12-14 11:51:50 +00:00
<signal name="NspRemoved">
<arg name="nsp" type="o"/>
</signal>
2009-12-14 11:51:50 +00:00
</interface>
</node>