dbus/introspection/org.freedesktop.ModemManager1.Modem.Time.xml

0001 <?xml version="1.0" encoding="UTF-8" ?>
0002
0003 <!--
0004  ModemManager 1.0 Interface Specification
0005
0006    Copyright (C) 2011-2013 Red Hat, Inc.
0007    Copyright (C) 2011-2013 Google, Inc.
0008    Copyright (C) 2011-2013 Lanedo GmbH
0009 -->
0010
0011 <node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">
0012
0013   <!--
0014       org.freedesktop.ModemManager1.Modem.Time:
0015       @short_description: The ModemManager Time interface.
0016
0017       This interface allows clients to receive network time and timezone
0018       updates broadcast by mobile networks.
0019   -->
0020   <interface name="org.freedesktop.ModemManager1.Modem.Time">
0021
0022     <!--
0023         GetNetworkTime:
0024         @time: If the network time is known, a string containing local date,
0025         time, and (if available) UTC offset in ISO 8601 format. If the network
0026         time is unknown, the empty string.
0027
0028         Gets the current network time in local time.
0029
0030         This method will only work if the modem tracks, or can request, the
0031         current network time; it will not attempt to use previously-received
0032         network time updates on the host to guess the current network time.
0033     -->
0034     <method name="GetNetworkTime">
0035       <arg name="time" type="s" direction="out" />
0036     </method>
0037
0038     <!--
0039         NetworkTimezone:
0040
0041         The timezone data provided by the network. It may include one or more
0042         of the following fields:
0043
0044         <variablelist>
0045           <varlistentry><term><literal>"offset"</literal></term>
0046             <listitem>
0047               Offset of the timezone from UTC, in minutes (including DST, if applicable),
0048               given as a signed integer value (signature <literal>"i"</literal>).
0049             </listitem>
0050           </varlistentry>
0051           <varlistentry><term><literal>"dst-offset"</literal></term>
0052             <listitem>
0053               Amount of offset that is due to DST (daylight saving time),
0054               given as a signed integer value (signature <literal>"i"</literal>).
0055             </listitem>
0056           </varlistentry>
0057           <varlistentry><term><literal>"leap-seconds"</literal></term>
0058             <listitem>
0059               Number of leap seconds included in the network time,
0060               given as a signed integer value (signature <literal>"i"</literal>).
0061             </listitem>
0062           </varlistentry>
0063         </variablelist>
0064     -->
0065     <property name="NetworkTimezone" type="a{sv}" access="read">
0066     <annotation name="org.qtproject.QtDBus.QtTypeName" value="QVariantMap"/>
0067     </property>
0068
0069     <!--
0070         NetworkTimeChanged:
0071         @time: A string containing date and time in ISO 8601 format.
0072
0073         Sent when the network time is updated.
0074     -->
0075     <signal name="NetworkTimeChanged">
0076       <arg name="time" type="s" />
0077     </signal>
0078
0079   </interface>
0080 </node>