extensions/generic-types.xml

   1 <tp:generic-types
   2   xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
   3
   4   <tp:simple-type name="Unix_Timestamp" type="u">
   5     <tp:docstring>An unsigned 32-bit integer representing time as the number
   6       of seconds elapsed since the Unix epoch
   7       (1970-01-01T00:00:00Z)</tp:docstring>
   8   </tp:simple-type>
   9
  10   <tp:simple-type name="Unix_Timestamp64" type="t">
  11     <tp:docstring>An unsigned 64-bit integer representing time as the number
  12       of seconds elapsed since the Unix epoch
  13       (1970-01-01T00:00:00Z)</tp:docstring>
  14
  15     <tp:rationale>The Text interface is the only user of Unix_Timestamp so
  16       far, and we'd like to be Y2038 compatible in future
  17       interfaces.</tp:rationale>
  18   </tp:simple-type>
  19
  20   <tp:simple-type name="DBus_Bus_Name" type="s">
  21     <tp:docstring>A string representing a D-Bus bus name - either a well-known
  22       name like "org.freedesktop.Telepathy.MissionControl" or a unique name
  23       like ":1.123"</tp:docstring>
  24   </tp:simple-type>
  25
  26   <tp:simple-type name="DBus_Well_Known_Name" type="s">
  27     <tp:docstring>A string representing a D-Bus well-known
  28       name like "org.freedesktop.Telepathy.MissionControl".</tp:docstring>
  29   </tp:simple-type>
  30
  31   <tp:simple-type name="DBus_Unique_Name" type="s">
  32     <tp:docstring>A string representing a D-Bus unique name, such as
  33       ":1.123"</tp:docstring>
  34   </tp:simple-type>
  35
  36   <tp:simple-type name="DBus_Interface" type="s">
  37     <tp:docstring>An ASCII string representing a D-Bus interface - two or more
  38       elements separated by dots, where each element is a non-empty
  39       string of ASCII letters, digits and underscores, not starting with
  40       a digit. The maximum total length is 255 characters. For example,
  41       "org.freedesktop.DBus.Peer".</tp:docstring>
  42   </tp:simple-type>
  43
  44   <tp:simple-type name="DBus_Error_Name" type="s">
  45     <tp:docstring>An ASCII string representing a D-Bus error. This is
  46       syntactically the same as a <tp:type>DBus_Interface</tp:type>, but the
  47       meaning is different.</tp:docstring>
  48   </tp:simple-type>
  49
  50   <tp:simple-type name="DBus_Signature" type="s">
  51     <tp:docstring>A string representing a D-Bus signature
  52       (the 'g' type isn't used because of poor interoperability, particularly
  53       with dbus-glib)</tp:docstring>
  54   </tp:simple-type>
  55
  56   <tp:simple-type name="DBus_Member" type="s">
  57     <tp:docstring>An ASCII string representing a D-Bus method, signal
  58       or property name - a non-empty string of ASCII letters, digits and
  59       underscores, not starting with a digit, with a maximum length of 255
  60       characters. For example, "Ping".</tp:docstring>
  61   </tp:simple-type>
  62
  63   <tp:simple-type name="DBus_Qualified_Member" type="s">
  64     <tp:docstring>A string representing the full name of a D-Bus method,
  65       signal or property, consisting of a DBus_Interface, followed by
  66       a dot, followed by a DBus_Member. For example,
  67       "org.freedesktop.DBus.Peer.Ping".</tp:docstring>
  68   </tp:simple-type>
  69
  70   <tp:mapping name="Qualified_Property_Value_Map"
  71     array-name="Qualified_Property_Value_Map_List">
  72     <tp:docstring>A mapping from strings representing D-Bus
  73       properties (by their namespaced names) to their values.</tp:docstring>
  74     <tp:member type="s" name="Key" tp:type="DBus_Qualified_Member">
  75       <tp:docstring>
  76         A D-Bus interface name, followed by a dot and a D-Bus property name.
  77       </tp:docstring>
  78     </tp:member>
  79     <tp:member type="v" name="Value">
  80       <tp:docstring>
  81         The value of the property.
  82       </tp:docstring>
  83     </tp:member>
  84   </tp:mapping>
  85
  86   <tp:mapping name="String_Variant_Map" array-name="String_Variant_Map_List">
  87     <tp:docstring>A mapping from strings to variants representing extra
  88       key-value pairs.</tp:docstring>
  89     <tp:member type="s" name="Key"/>
  90     <tp:member type="v" name="Value"/>
  91   </tp:mapping>
  92
  93   <tp:mapping name="String_String_Map">
  94     <tp:docstring>A mapping from strings to strings representing extra
  95       key-value pairs.</tp:docstring>
  96     <tp:member type="s" name="Key"/>
  97     <tp:member type="s" name="Value"/>
  98   </tp:mapping>
  99
 100 </tp:generic-types>