]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man: run dbus api docs through the updater
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Fri, 10 Apr 2020 13:07:03 +0000 (15:07 +0200)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Thu, 16 Apr 2020 17:46:40 +0000 (19:46 +0200)
This replaces the api export tables with updated versions, and inserts
comments for all "undocumented" items. The slow work of documented them
is left for later ;)

lxml does some formatting changes that are not significant for lxml processing,
but generate spurious difference in the diff (namely: ulinks become one-line,
and double quotes are used instead of single quotes for element attribute
values). This should be a one-time thing: subsequent renegeration should be
idempotent with regards to this.

man/org.freedesktop.hostname1.xml
man/org.freedesktop.import1.xml
man/org.freedesktop.locale1.xml
man/org.freedesktop.login1.xml
man/org.freedesktop.machine1.xml
man/org.freedesktop.resolve1.xml
man/org.freedesktop.timedate1.xml

index a381cb8239e5366db98f5f832cdb0e2d550a356f..b9522a3a080544cdfc03af9f38fe6a2fad404a3f 100644 (file)
@@ -46,33 +46,81 @@ $ gdbus introspect --system \
 node /org/freedesktop/hostname1 {
   interface org.freedesktop.hostname1 {
     methods:
-      SetHostname(in  s name,
-                  in  b user_interaction);
-      SetStaticHostname(in  s name,
-                        in  b user_interaction);
-      SetPrettyHostname(in  s name,
-                        in  b user_interaction);
-      SetIconName(in  s name,
-                  in  b user_interaction);
-      SetChassis(in  s name,
-                 in  b user_interaction);
-    signals:
+      SetHostname(in  s hostname,
+                  in  b interactive);
+      SetStaticHostname(in  s hostname,
+                        in  b interactive);
+      SetPrettyHostname(in  s hostname,
+                        in  b interactive);
+      SetIconName(in  s icon,
+                  in  b interactive);
+      SetChassis(in  s chassis,
+                 in  b interactive);
+      SetDeployment(in  s deployment,
+                    in  b interactive);
+      SetLocation(in  s location,
+                  in  b interactive);
+      GetProductUUID(in  b interactive,
+                     out ay uuid);
     properties:
-      readonly s Hostname = 'dhcp-192-168-47-11';
-      readonly s StaticHostname = 'lennarts-computer';
-      readonly s PrettyHostname = 'Lennart’s Computer';
-      readonly s IconName = 'computer-laptop';
-      readonly s Chassis = 'laptop';
-  };
-  interface org.freedesktop.DBus.Properties {
-  };
-  interface org.freedesktop.DBus.Introspectable {
-  };
-  interface org.freedesktop.DBus.Peer {
+      readonly s Hostname = '...';
+      readonly s StaticHostname = '...';
+      readonly s PrettyHostname = '...';
+      readonly s IconName = '...';
+      readonly s Chassis = '...';
+      readonly s Deployment = '...';
+      readonly s Location = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s KernelName = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s KernelRelease = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s KernelVersion = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s OperatingSystemPrettyName = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s OperatingSystemCPEName = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s HomeURL = '...';
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
     </programlisting>
 
+    <!--method SetDeployment is not documented!-->
+
+    <!--method SetLocation is not documented!-->
+
+    <!--method GetProductUUID is not documented!-->
+
+    <!--property Hostname is not documented!-->
+
+    <!--property StaticHostname is not documented!-->
+
+    <!--property PrettyHostname is not documented!-->
+
+    <!--property IconName is not documented!-->
+
+    <!--property Chassis is not documented!-->
+
+    <!--property Deployment is not documented!-->
+
+    <!--property Location is not documented!-->
+
+    <!--property KernelName is not documented!-->
+
+    <!--property KernelRelease is not documented!-->
+
+    <!--property KernelVersion is not documented!-->
+
+    <!--property OperatingSystemPrettyName is not documented!-->
+
+    <!--property OperatingSystemCPEName is not documented!-->
+
+    <!--property HomeURL is not documented!-->
+
     <para>Whenever the hostname or other meta data is changed via the daemon,
     <function>PropertyChanged</function> signals are sent out to subscribed clients. Changing a hostname
     using this interface is authenticated via PolicyKit.</para>
@@ -84,13 +132,13 @@ node /org/freedesktop/hostname1 {
     <para>The <emphasis>static (configured) host name</emphasis> is the one configured in
     <filename>/etc/hostname</filename>. It is chosen by the local user. It is not always in sync with the
     current hostname as returned by the
-    <citerefentry project='man-pages'><refentrytitle>gethostname</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+    <citerefentry project="man-pages"><refentrytitle>gethostname</refentrytitle><manvolnum>3</manvolnum></citerefentry>
     system call. If no host name is configured this property will be the empty string. Setting this property
     to the empty string will remove <filename>/etc/hostname</filename>. This hostname should be an
     internet-style hostname, 7-bit lowercase ASCII, no special chars/spaces.</para>
 
     <para>The <emphasis>transient (dynamic) host name</emphasis> is the one configured via the kernel's
-    <citerefentry project='man-pages'><refentrytitle>sethostname</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
+    <citerefentry project="man-pages"><refentrytitle>sethostname</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
     It can be different from the static hostname in case DHCP or mDNS have been configured to change the name
     based on network information. <!-- FIXME: it's not DHCP that configures this... -->
     This property is never empty. If no hostname is set this will default to
@@ -134,14 +182,14 @@ node /org/freedesktop/hostname1 {
     assumed to be highly dynamic, and hence should be watched directly, without involving
     <function>PropertyChanged</function> messages from <filename>systemd-hostnamed</filename>. For that, open
     <filename>/proc/sys/kernel/hostname</filename> and
-    <citerefentry project='man-pages'><refentrytitle>poll</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+    <citerefentry project="man-pages"><refentrytitle>poll</refentrytitle><manvolnum>3</manvolnum></citerefentry>
     for <constant>SIGHUP</constant> which is triggered by the kernel every time the hostname changes. Again:
     this is special for the transient (dynamic) hostname, and does not apply to the configured (fixed)
     hostname.</para>
 
     <para>Applications may bypass the daemon to read the hostname data if notifications of host name changes
     are not necessary. Use
-    <citerefentry project='man-pages'><refentrytitle>gethostname</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
+    <citerefentry project="man-pages"><refentrytitle>gethostname</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
     <filename>/etc/hostname</filename> (possibly with per-distribution fallbacks), and
     <citerefentry><refentrytitle>machine-info</refentrytitle><manvolnum>3</manvolnum></citerefentry>
     for that. For more information on these files and syscalls see the respective man pages.</para>
index 9c8498ff7ffad6fab9abfd95d45aa3345109a0c7..6a628f467177c989c63bf5458cfba251ab8136d8 100644 (file)
@@ -66,6 +66,12 @@ node /org/freedesktop/import1 {
                 in  b read_only,
                 out u transfer_id,
                 out o transfer_path);
+      ImportFileSystem(in  h fd,
+                       in  s local_name,
+                       in  b force,
+                       in  b read_only,
+                       out u transfer_id,
+                       out o transfer_path);
       ExportTar(in  s local_name,
                 in  h fd,
                 in  s format,
@@ -88,7 +94,7 @@ node /org/freedesktop/import1 {
               in  b force,
               out u transfer_id,
               out o transfer_path);
-      ListTransfers(out a(usssdo) list);
+      ListTransfers(out a(usssdo) transfers);
       CancelTransfer(in  u transfer_id);
     signals:
       TransferNew(u transfer_id,
@@ -97,14 +103,13 @@ node /org/freedesktop/import1 {
                       o transfer_path,
                       s result);
   };
-  interface org.freedesktop.DBus.Peer {
-  };
-  interface org.freedesktop.DBus.Introspectable {
-  };
-  interface org.freedesktop.DBus.Properties {
-  };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
-</programlisting>
+    </programlisting>
+
+    <!--method ImportFileSystem is not documented!-->
 
     <refsect2>
       <title>Methods</title>
@@ -215,21 +220,26 @@ node /org/freedesktop/import1/transfer/_1 {
       LogMessage(u priority,
                  s line);
     properties:
-      readonly u Id = 1;
-      readonly s Local = 'xenial-server-cloudimg-amd64-root';
-      readonly s Remote = 'https://cloud-images.ubuntu.com/xenial/current/xenial-server-cloudimg-amd64-root.tar.gz';
-      readonly s Type = 'pull-tar';
-      readonly s Verify = 'signature';
-      readonly d Progress = 0.253;
-  };
-  interface org.freedesktop.DBus.Peer {
-  };
-  interface org.freedesktop.DBus.Introspectable {
-  };
-  interface org.freedesktop.DBus.Properties {
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly u Id = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Local = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Remote = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Type = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Verify = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly d Progress = ...;
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
-</programlisting>
+    </programlisting>
+
+    <!--signal LogMessage is not documented!-->
 
     <refsect2>
       <title>Methods</title>
index 7c345acc00e8f9cfd37cb1422f4e638f548c523b..7b2bf2870f117087625bafa3f19a000fc9538a95 100644 (file)
@@ -43,36 +43,46 @@ node /org/freedesktop/locale1 {
   interface org.freedesktop.locale1 {
     methods:
       SetLocale(in  as locale,
-                in  b user_interaction);
+                in  b interactive);
       SetVConsoleKeyboard(in  s keymap,
                           in  s keymap_toggle,
                           in  b convert,
-                          in  b user_interaction);
+                          in  b interactive);
       SetX11Keyboard(in  s layout,
                      in  s model,
                      in  s variant,
                      in  s options,
                      in  b convert,
-                     in  b user_interaction);
-    signals:
+                     in  b interactive);
     properties:
-      readonly as Locale = ['LANG=en_US.UTF-8'];
-      readonly s VConsoleKeymap = 'de';
-      readonly s VConsoleKeymapToggle = '';
-      readonly s X11Layout = 'de';
-      readonly s X11Model = '';
-      readonly s X11Variant = '';
-      readonly s X11Options = '';
-  };
-  interface org.freedesktop.DBus.Properties {
-  };
-  interface org.freedesktop.DBus.Introspectable {
-  };
-  interface org.freedesktop.DBus.Peer {
+      readonly as Locale = ['...', ...];
+      readonly s X11Layout = '...';
+      readonly s X11Model = '...';
+      readonly s X11Variant = '...';
+      readonly s X11Options = '...';
+      readonly s VConsoleKeymap = '...';
+      readonly s VConsoleKeymapToggle = '...';
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
     </programlisting>
 
+    <!--property Locale is not documented!-->
+
+    <!--property X11Layout is not documented!-->
+
+    <!--property X11Model is not documented!-->
+
+    <!--property X11Variant is not documented!-->
+
+    <!--property X11Options is not documented!-->
+
+    <!--property VConsoleKeymap is not documented!-->
+
+    <!--property VConsoleKeymapToggle is not documented!-->
+
     <para>The system locale consists of an array of environment-variable-assignment-like strings. The
     following strings are known: <varname>LANG=</varname>, <varname>LC_CTYPE=</varname>,
     <varname>LC_NUMERIC=</varname>, <varname>LC_TIME=</varname>, <varname>LC_COLLATE=</varname>,
index 2910693865c39ddcbf883e6b97c6b4dd38908c53..1c6134f9a6ccbf0f8f6366d54d3b1863c9334b2f 100644 (file)
@@ -42,6 +42,7 @@
 $ gdbus introspect --system \
         --dest org.freedesktop.login1 \
         --object-path /org/freedesktop/login1
+
 node /org/freedesktop/login1 {
   interface org.freedesktop.login1.Manager {
     methods:
@@ -55,10 +56,10 @@ node /org/freedesktop/login1 {
                    out o object_path);
       GetSeat(in  s seat_id,
               out o object_path);
-      ListSessions(out a(susso) session_list);
-      ListUsers(out a(uso) user_list);
-      ListSeats(out a(so) seat_list);
-      ListInhibitors(out a(ssssuu) inhibitor_list);
+      ListSessions(out a(susso) sessions);
+      ListUsers(out a(uso) users);
+      ListSeats(out a(so) seats);
+      ListInhibitors(out a(ssssuu) inhibitors);
       CreateSession(in  u uid,
                     in  u pid,
                     in  s service,
@@ -91,29 +92,33 @@ node /org/freedesktop/login1 {
       UnlockSessions();
       KillSession(in  s session_id,
                   in  s who,
-                  in  i signo);
+                  in  i signal_number);
       KillUser(in  u uid,
-               in  i signo);
+               in  i signal_number);
       TerminateSession(in  s session_id);
       TerminateUser(in  u uid);
       TerminateSeat(in  s seat_id);
       SetUserLinger(in  u uid,
-                    in  b linger,
+                    in  b enable,
                     in  b interactive);
       AttachDevice(in  s seat_id,
-                   in  s sysfs,
+                   in  s sysfs_path,
                    in  b interactive);
       FlushDevices(in  b interactive);
       PowerOff(in  b interactive);
       Reboot(in  b interactive);
+      Halt(in  b interactive);
       Suspend(in  b interactive);
       Hibernate(in  b interactive);
       HybridSleep(in  b interactive);
+      SuspendThenHibernate(in  b interactive);
       CanPowerOff(out s result);
       CanReboot(out s result);
+      CanHalt(out s result);
       CanSuspend(out s result);
       CanHibernate(out s result);
       CanHybridSleep(out s result);
+      CanSuspendThenHibernate(out s result);
       ScheduleShutdown(in  s type,
                        in  t usec);
       CancelScheduledShutdown(out b cancelled);
@@ -122,8 +127,14 @@ node /org/freedesktop/login1 {
               in  s why,
               in  s mode,
               out h pipe_fd);
+      CanRebootParameter(out s result);
+      SetRebootParameter(in  s parameter);
       CanRebootToFirmwareSetup(out s result);
       SetRebootToFirmwareSetup(in  b enable);
+      CanRebootToBootLoaderMenu(out s result);
+      SetRebootToBootLoaderMenu(in  t timeout);
+      CanRebootToBootLoaderEntry(out s result);
+      SetRebootToBootLoaderEntry(in  s boot_loader_entry);
       SetWallMessage(in  s wall_message,
                      in  b enable);
     signals:
@@ -142,41 +153,202 @@ node /org/freedesktop/login1 {
       PrepareForShutdown(b start);
       PrepareForSleep(b start);
     properties:
-      readwrite b EnableWallMessages = false;
-      readwrite s WallMessage = '';
-      readonly u NAutoVTs = 6;
-      readonly as KillOnlyUsers = [];
-      readonly as KillExcludeUsers = ['root'];
-      readonly b KillUserProcesses = false;
-      readonly b RebootToFirmwareSetup = false;
-      readonly b IdleHint = false;
-      readonly t IdleSinceHint = 0;
-      readonly t IdleSinceHintMonotonic = 0;
-      readonly s BlockInhibited = 'handle-power-key:handle-suspend-key:handle-hibernate-key';
-      readonly s DelayInhibited = 'sleep';
-      readonly t InhibitDelayMaxUSec = 5000000;
-      readonly s HandlePowerKey = 'poweroff';
-      readonly s HandleSuspendKey = 'suspend';
-      readonly s HandleHibernateKey = 'hibernate';
-      readonly s HandleLidSwitch = 'suspend';
-      readonly s HandleLidSwitchDocked = 'ignore';
-      readonly t HoldoffTimeoutUSec = 30000000;
-      readonly s IdleAction = 'ignore';
-      readonly t IdleActionUSec = 1800000000;
-      readonly b PreparingForShutdown = false;
-      readonly b PreparingForSleep = false;
-      readonly (st) ScheduledShutdown = ('', 0);
-      readonly b Docked = false;
-  };
-  interface org.freedesktop.DBus.Peer {
-  };
-  interface org.freedesktop.DBus.Introspectable {
-  };
-  interface org.freedesktop.DBus.Properties {
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      @org.freedesktop.systemd1.Privileged("true")
+      readwrite b EnableWallMessages = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      @org.freedesktop.systemd1.Privileged("true")
+      readwrite s WallMessage = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly u NAutoVTs = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly as KillOnlyUsers = ['...', ...];
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly as KillExcludeUsers = ['...', ...];
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly b KillUserProcesses = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s RebootParameter = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly b RebootToFirmwareSetup = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly t RebootToBootLoaderMenu = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s RebootToBootLoaderEntry = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly as BootLoaderEntries = ['...', ...];
+      readonly b IdleHint = ...;
+      readonly t IdleSinceHint = ...;
+      readonly t IdleSinceHintMonotonic = ...;
+      readonly s BlockInhibited = '...';
+      readonly s DelayInhibited = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t InhibitDelayMaxUSec = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t UserStopDelayUSec = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s HandlePowerKey = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s HandleSuspendKey = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s HandleHibernateKey = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s HandleLidSwitch = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s HandleLidSwitchExternalPower = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s HandleLidSwitchDocked = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t HoldoffTimeoutUSec = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s IdleAction = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t IdleActionUSec = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly b PreparingForShutdown = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly b PreparingForSleep = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly (st) ScheduledShutdown = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly b Docked = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly b LidClosed = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly b OnExternalPower = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly b RemoveIPC = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t RuntimeDirectorySize = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t InhibitorsMax = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly t NCurrentInhibitors = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t SessionsMax = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly t NCurrentSessions = ...;
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
     </programlisting>
 
+    <!--method Halt is not documented!-->
+
+    <!--method SuspendThenHibernate is not documented!-->
+
+    <!--method CanHalt is not documented!-->
+
+    <!--method CanSuspendThenHibernate is not documented!-->
+
+    <!--method ScheduleShutdown is not documented!-->
+
+    <!--method CancelScheduledShutdown is not documented!-->
+
+    <!--method CanRebootParameter is not documented!-->
+
+    <!--method SetRebootParameter is not documented!-->
+
+    <!--method CanRebootToFirmwareSetup is not documented!-->
+
+    <!--method SetRebootToFirmwareSetup is not documented!-->
+
+    <!--method CanRebootToBootLoaderMenu is not documented!-->
+
+    <!--method SetRebootToBootLoaderMenu is not documented!-->
+
+    <!--method CanRebootToBootLoaderEntry is not documented!-->
+
+    <!--method SetRebootToBootLoaderEntry is not documented!-->
+
+    <!--method SetWallMessage is not documented!-->
+
+    <!--signal SessionNew is not documented!-->
+
+    <!--signal SessionRemoved is not documented!-->
+
+    <!--signal UserNew is not documented!-->
+
+    <!--signal UserRemoved is not documented!-->
+
+    <!--signal SeatNew is not documented!-->
+
+    <!--signal SeatRemoved is not documented!-->
+
+    <!--property EnableWallMessages is not documented!-->
+
+    <!--property WallMessage is not documented!-->
+
+    <!--property NAutoVTs is not documented!-->
+
+    <!--property KillOnlyUsers is not documented!-->
+
+    <!--property KillExcludeUsers is not documented!-->
+
+    <!--property KillUserProcesses is not documented!-->
+
+    <!--property RebootParameter is not documented!-->
+
+    <!--property RebootToFirmwareSetup is not documented!-->
+
+    <!--property RebootToBootLoaderMenu is not documented!-->
+
+    <!--property RebootToBootLoaderEntry is not documented!-->
+
+    <!--property BootLoaderEntries is not documented!-->
+
+    <!--property BlockInhibited is not documented!-->
+
+    <!--property DelayInhibited is not documented!-->
+
+    <!--property InhibitDelayMaxUSec is not documented!-->
+
+    <!--property UserStopDelayUSec is not documented!-->
+
+    <!--property HandlePowerKey is not documented!-->
+
+    <!--property HandleSuspendKey is not documented!-->
+
+    <!--property HandleHibernateKey is not documented!-->
+
+    <!--property HandleLidSwitch is not documented!-->
+
+    <!--property HandleLidSwitchExternalPower is not documented!-->
+
+    <!--property HandleLidSwitchDocked is not documented!-->
+
+    <!--property HoldoffTimeoutUSec is not documented!-->
+
+    <!--property IdleAction is not documented!-->
+
+    <!--property IdleActionUSec is not documented!-->
+
+    <!--property PreparingForShutdown is not documented!-->
+
+    <!--property PreparingForSleep is not documented!-->
+
+    <!--property ScheduledShutdown is not documented!-->
+
+    <!--property Docked is not documented!-->
+
+    <!--property LidClosed is not documented!-->
+
+    <!--property OnExternalPower is not documented!-->
+
+    <!--property RemoveIPC is not documented!-->
+
+    <!--property RuntimeDirectorySize is not documented!-->
+
+    <!--property InhibitorsMax is not documented!-->
+
+    <!--property NCurrentInhibitors is not documented!-->
+
+    <!--property SessionsMax is not documented!-->
+
+    <!--property NCurrentSessions is not documented!-->
+
     <refsect2>
       <title>Security</title>
 
@@ -382,6 +554,7 @@ node /org/freedesktop/login1 {
     <programlisting>
 $ gdbus introspect --system --dest org.freedesktop.login1 \
       --object-path /org/freedesktop/login1/seat/seat0
+
 node /org/freedesktop/login1/seat/seat0 {
   interface org.freedesktop.login1.Seat {
     methods:
@@ -391,25 +564,36 @@ node /org/freedesktop/login1/seat/seat0 {
       SwitchToNext();
       SwitchToPrevious();
     properties:
-      readonly s Id = 'seat0';
-      readonly (so) ActiveSession = ('', '/');
-      readonly b CanMultiSession = true;
-      readonly b CanTTY = true;
-      readonly b CanGraphical = true;
-      readonly a(so) Sessions = [('c1', '/org/freedesktop/login1/session/c1')];
-      readonly b IdleHint = true;
-      readonly t IdleSinceHint = 1389368976087311;
-      readonly t IdleSinceHintMonotonic = 48213948;
-  };
-  interface org.freedesktop.DBus.Properties {
-  };
-  interface org.freedesktop.DBus.Peer {
-  };
-  interface org.freedesktop.DBus.Introspectable {
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Id = '...';
+      readonly (so) ActiveSession = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly b CanMultiSession = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly b CanTTY = ...;
+      readonly b CanGraphical = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly a(so) Sessions = [...];
+      readonly b IdleHint = ...;
+      readonly t IdleSinceHint = ...;
+      readonly t IdleSinceHintMonotonic = ...;
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
     </programlisting>
 
+    <!--method SwitchTo is not documented!-->
+
+    <!--method SwitchToNext is not documented!-->
+
+    <!--method SwitchToPrevious is not documented!-->
+
+    <!--property CanTTY is not documented!-->
+
+    <!--property CanGraphical is not documented!-->
+
     <refsect2>
       <title>Methods</title>
 
@@ -457,33 +641,43 @@ node /org/freedesktop/login1/user/_1000 {
   interface org.freedesktop.login1.User {
     methods:
       Terminate();
-      Kill(in  i signo);
+      Kill(in  i signal_number);
     properties:
-      readonly u UID = 1000;
-      readonly u GID = 1000;
-      readonly s Name = 'test';
-      readonly t Timestamp = 1389368964102424;
-      readonly t TimestampMonotonic = 36229061;
-      readonly s RuntimePath = '/run/user/1000';
-      readonly s Service = 'user@1000.service';
-      readonly s Slice = 'user-1000.slice';
-      readonly (so) Display = ('', '/');
-      readonly s State = 'active';
-      readonly a(so) Sessions = [('28', '/org/freedesktop/login1/session/_328'), ('3', '/org/freedesktop/login1/session/_33')];
-      readonly b IdleHint = false;
-      readonly t IdleSinceHint = 0;
-      readonly t IdleSinceHintMonotonic = 0;
-      readonly b Linger = false;
-  };
-  interface org.freedesktop.DBus.Properties {
-  };
-  interface org.freedesktop.DBus.Peer {
-  };
-  interface org.freedesktop.DBus.Introspectable {
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly u UID = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly u GID = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Name = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t Timestamp = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t TimestampMonotonic = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s RuntimePath = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Service = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Slice = '...';
+      readonly (so) Display = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s State = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly a(so) Sessions = [...];
+      readonly b IdleHint = ...;
+      readonly t IdleSinceHint = ...;
+      readonly t IdleSinceHintMonotonic = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly b Linger = ...;
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
     </programlisting>
 
+    <!--property Linger is not documented!-->
+
     <refsect2>
       <title>Methods</title>
 
@@ -547,9 +741,9 @@ node /org/freedesktop/login1/user/_1000 {
 
     <programlisting>
 $ gdbus introspect --system --dest org.freedesktop.login1 \
-        --object-path /org/freedesktop/login1/session/3
+        --object-path /org/freedesktop/login1/session/45
 
-node /org/freedesktop/login1/session/3 {
+node /org/freedesktop/login1/session/45 {
   interface org.freedesktop.login1.Session {
     methods:
       Terminate();
@@ -557,8 +751,9 @@ node /org/freedesktop/login1/session/3 {
       Lock();
       Unlock();
       SetIdleHint(in  b idle);
+      SetLockedHint(in  b locked);
       Kill(in  s who,
-           in  i signo);
+           in  i signal_number);
       TakeControl(in  b force);
       ReleaseControl();
       TakeDevice(in  u major,
@@ -569,6 +764,9 @@ node /org/freedesktop/login1/session/3 {
                     in  u minor);
       PauseDeviceComplete(in  u major,
                           in  u minor);
+      SetBrightness(in  s subsystem,
+                    in  s name,
+                    in  u brightness);
     signals:
       PauseDevice(u major,
                   u minor,
@@ -579,40 +777,65 @@ node /org/freedesktop/login1/session/3 {
       Lock();
       Unlock();
     properties:
-      readonly s Id = '3';
-      readonly (uo) User = (1000, '/org/freedesktop/login1/user/_1000');
-      readonly s Name = 'test';
-      readonly t Timestamp = 1389370644734067;
-      readonly t TimestampMonotonic = 72063381;
-      readonly u VTNr = 0;
-      readonly (so) Seat = ('', '/');
-      readonly s TTY = '';
-      readonly s Display = '';
-      readonly b Remote = true;
-      readonly s RemoteHost = '129.174.150.217';
-      readonly s RemoteUser = '';
-      readonly s Service = 'sshd';
-      readonly s Desktop = '';
-      readonly s Scope = 'session-3.scope';
-      readonly u Leader = 1854;
-      readonly u Audit = 3;
-      readonly s Type = 'tty';
-      readonly s Class = 'user';
-      readonly b Active = true;
-      readonly s State = 'active';
-      readonly b IdleHint = false;
-      readonly t IdleSinceHint = 0;
-      readonly t IdleSinceHintMonotonic = 0;
-  };
-  interface org.freedesktop.DBus.Properties {
-  };
-  interface org.freedesktop.DBus.Peer {
-  };
-  interface org.freedesktop.DBus.Introspectable {
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Id = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly (uo) User = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Name = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t Timestamp = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t TimestampMonotonic = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly u VTNr = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly (so) Seat = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s TTY = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Display = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly b Remote = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s RemoteHost = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s RemoteUser = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Service = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Desktop = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Scope = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly u Leader = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly u Audit = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Type = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Class = '...';
+      readonly b Active = ...;
+      readonly s State = '...';
+      readonly b IdleHint = ...;
+      readonly t IdleSinceHint = ...;
+      readonly t IdleSinceHintMonotonic = ...;
+      readonly b LockedHint = ...;
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
     </programlisting>
 
+    <!--method SetLockedHint is not documented!-->
+
+    <!--method SetBrightness is not documented!-->
+
+    <!--property Desktop is not documented!-->
+
+    <!--property LockedHint is not documented!-->
+
     <refsect2>
       <title>Methods</title>
 
index f26829ee45abf291a8bdbffea43d7cf36c493f06..1c9c41f04c13153722418d53a9bc3f0cf17cfb6d 100644 (file)
@@ -49,7 +49,7 @@ node /org/freedesktop/machine1 {
       GetMachineByPID(in  u pid,
                       out o machine);
       ListMachines(out a(ssso) machines);
-      ListImages(out a(ssbttto) machines);
+      ListImages(out a(ssbttto) images);
       CreateMachine(in  s name,
                     in  ay id,
                     in  s service,
@@ -82,10 +82,11 @@ node /org/freedesktop/machine1 {
                                  in  s root_directory,
                                  in  ai ifindices,
                                  out o path);
+      UnregisterMachine(in  s name);
+      TerminateMachine(in  s id);
       KillMachine(in  s name,
                   in  s who,
-                  in  s signal);
-      TerminateMachine(in  s id);
+                  in  i signal);
       GetMachineAddresses(in  s name,
                           out a(iay) addresses);
       GetMachineOSRelease(in  s name,
@@ -114,6 +115,10 @@ node /org/freedesktop/machine1 {
       CopyToMachine(in  s name,
                     in  s source,
                     in  s destination);
+      OpenMachineRootDirectory(in  s name,
+                               out h fd);
+      GetMachineUIDShift(in  s name,
+                         out u shift);
       RemoveImage(in  s name);
       RenameImage(in  s name,
                   in  s new_name);
@@ -122,16 +127,26 @@ node /org/freedesktop/machine1 {
                  in  b read_only);
       MarkImageReadOnly(in  s name,
                         in  b read_only);
+      GetImageHostname(in  s name,
+                       out s hostname);
+      GetImageMachineID(in  s name,
+                        out ay id);
+      GetImageMachineInfo(in  s name,
+                          out a{ss} machine_info);
+      GetImageOSRelease(in  s name,
+                        out a{ss} os_release);
       SetPoolLimit(in  t size);
       SetImageLimit(in  s name,
                     in  t size);
+      CleanPool(in  s mode,
+                out a(st) images);
       MapFromMachineUser(in  s name,
                          in  u uid_inner,
                          out u uid_outer);
       MapToMachineUser(in  u uid_outer,
                        out s machine_name,
                        out o machine_path,
-                       out u uid_inner;
+                       out u uid_inner);
       MapFromMachineGroup(in  s name,
                           in  u gid_inner,
                           out u gid_outer);
@@ -145,16 +160,16 @@ node /org/freedesktop/machine1 {
       MachineRemoved(s machine,
                      o path);
     properties:
-      readonly s PoolPath = '/var/lib/machines';
-      readonly t PoolUsage = 18446744070652059648;
-      readonly t PoolLimit = 2160721920;
-  };
-  interface org.freedesktop.DBus.Properties {
-  };
-  interface org.freedesktop.DBus.Peer {
-  };
-  interface org.freedesktop.DBus.Introspectable {
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s PoolPath = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly t PoolUsage = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly t PoolLimit = ...;
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
 </programlisting>
 
@@ -317,34 +332,61 @@ $ gdbus introspect --system \
         --dest org.freedesktop.machine1 \
         --object-path /org/freedesktop/machine1/machine/rawhide
 
-node /org/freedesktop/machine1/machine/fedora_2dtree {
+node /org/freedesktop/machine1/machine/rawhide {
   interface org.freedesktop.machine1.Machine {
     methods:
       Terminate();
       Kill(in  s who,
-           in  s signal);
+           in  i signal);
       GetAddresses(out a(iay) addresses);
       GetOSRelease(out a{ss} fields);
-    signals:
+      GetUIDShift(out u shift);
+      OpenPTY(out h pty,
+              out s pty_path);
+      OpenLogin(out h pty,
+                out s pty_path);
+      OpenShell(in  s user,
+                in  s path,
+                in  as args,
+                in  as environment,
+                out h pty,
+                out s pty_path);
+      BindMount(in  s source,
+                in  s destination,
+                in  b read_only,
+                in  b mkdir);
+      CopyFrom(in  s source,
+               in  s destination);
+      CopyTo(in  s source,
+             in  s destination);
+      OpenRootDirectory(out h fd);
     properties:
-      readonly s Name = 'fedora-tree';
-      readonly ay Id = [0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00];
-      readonly t Timestamp = 1374193370484284;
-      readonly t TimestampMonotonic = 128247251308;
-      readonly s Service = 'nspawn';
-      readonly s Unit = 'machine-fedora\\x2dtree.scope';
-      readonly u Leader = 30046;
-      readonly s Class = 'container';
-      readonly s RootDirectory = '/home/lennart/fedora-tree';
-      readonly ai NetworkInterfaces = [7];
-      readonly s State = 'running';
-  };
-  interface org.freedesktop.DBus.Properties {
-  };
-  interface org.freedesktop.DBus.Peer {
-  };
-  interface org.freedesktop.DBus.Introspectable {
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Name = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly ay Id = [...];
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t Timestamp = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t TimestampMonotonic = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Service = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Unit = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly u Leader = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Class = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s RootDirectory = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly ai NetworkInterfaces = [...];
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s State = '...';
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
     </programlisting>
 
index f0cf668f1928a231c122d935e63447a266549fcc..d150ee2a5f97b4256a1663089fc60987fba943d1 100644 (file)
@@ -87,40 +87,100 @@ node /org/freedesktop/resolve1 {
                      out s canonical_type,
                      out s canonical_domain,
                      out t flags);
-      ResetStatistics();
       GetLink(in  i ifindex,
               out o path);
       SetLinkDNS(in  i ifindex,
                  in  a(iay) addresses);
       SetLinkDomains(in  i ifindex,
                      in  a(sb) domains);
+      SetLinkDefaultRoute(in  i ifindex,
+                          in  b enable);
       SetLinkLLMNR(in  i ifindex,
                    in  s mode);
       SetLinkMulticastDNS(in  i ifindex,
                           in  s mode);
+      SetLinkDNSOverTLS(in  i ifindex,
+                        in  s mode);
       SetLinkDNSSEC(in  i ifindex,
                     in  s mode);
       SetLinkDNSSECNegativeTrustAnchors(in  i ifindex,
                                         in  as names);
       RevertLink(in  i ifindex);
+      RegisterService(in  s name,
+                      in  s name_template,
+                      in  s type,
+                      in  q service_port,
+                      in  q service_priority,
+                      in  q serwise_weight,
+                      in  aa{say} txt_datas,
+                      out o service_path);
+      UnregisterService(in  o service_path);
+      ResetStatistics();
+      FlushCaches();
+      ResetServerFeatures();
     properties:
-      readonly s LLMNRHostname = 'delta';
-      readonly a(iiay) DNS = [(0, 2, [0xac, 0x1f, 0x00, 0x01])];
-      readonly a(isb) Domains = [(0, 'fritz.box', false)];
-      readonly (tt) TransactionStatistics = (0, 846);
-      readonly (ttt) CacheStatistics = (55, 406, 439);
-      readonly (tttt) DNSSECStatistics = (0, 0, 0, 0);
-      readonly b DNSSECSupported = false;
-  };
-  interface org.freedesktop.DBus.Peer {
-  };
-  interface org.freedesktop.DBus.Introspectable {
-  };
-  interface org.freedesktop.DBus.Properties {
+      readonly s LLMNRHostname = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s LLMNR = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s MulticastDNS = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s DNSOverTLS = '...';
+      readonly a(iiay) DNS = [...];
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly a(iiay) FallbackDNS = [...];
+      readonly (iiay) CurrentDNSServer = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly a(isb) Domains = [...];
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly (tt) TransactionStatistics = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly (ttt) CacheStatistics = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s DNSSEC = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly (tttt) DNSSECStatistics = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly b DNSSECSupported = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly as DNSSECNegativeTrustAnchors = ['...', ...];
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s DNSStubListener = '...';
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
     </programlisting>
 
+    <!--method SetLinkDefaultRoute is not documented!-->
+
+    <!--method SetLinkDNSOverTLS is not documented!-->
+
+    <!--method RegisterService is not documented!-->
+
+    <!--method UnregisterService is not documented!-->
+
+    <!--method FlushCaches is not documented!-->
+
+    <!--method ResetServerFeatures is not documented!-->
+
+    <!--property LLMNR is not documented!-->
+
+    <!--property MulticastDNS is not documented!-->
+
+    <!--property DNSOverTLS is not documented!-->
+
+    <!--property FallbackDNS is not documented!-->
+
+    <!--property CurrentDNSServer is not documented!-->
+
+    <!--property DNSSEC is not documented!-->
+
+    <!--property DNSSECNegativeTrustAnchors is not documented!-->
+
+    <!--property DNSStubListener is not documented!-->
+
     <refsect2>
       <title>Methods</title>
 
@@ -165,7 +225,7 @@ node /org/freedesktop/resolve1 {
       ANY). Finally, a <varname>flags</varname> field may be passed in to alter behaviour of the look-up (see
       below). On return an array of RR items is returned. Each array entry consists of the network interface
       index the RR was discovered on, the type and class field of the RR found, and a byte array of the raw
-      RR discovered. The raw RR data starts with the RR&#39;s domain name, in the original casing, followed
+      RR discovered. The raw RR data starts with the RR's domain name, in the original casing, followed
       by the RR type, class, TTL and RDATA, in the binary format documented in
       <ulink url="https://www.ietf.org/rfc/rfc1035.txt">RFC 1035</ulink>. For RRs that support name
       compression in the payload (such as MX or PTR), the compression is expanded in the returned
@@ -185,7 +245,7 @@ node /org/freedesktop/resolve1 {
       name, a service type and a service domain. The call may be invoked in three different modes:</para>
 
       <orderedlist>
-        <listitem><para>To resolve a DNS-SD service, specify the service name (e.g. <literal>Lennart&#39;s
+        <listitem><para>To resolve a DNS-SD service, specify the service name (e.g. <literal>Lennart's
         Files</literal>), the service type (e.g. <literal>_webdav._tcp</literal>) and the domain to search in
         (e.g. <literal>local</literal>) in the three service parameters. The service name must be in UTF-8
         format, and no IDNA conversion is applied to it in this mode (as mandated by the DNS-SD
@@ -351,7 +411,7 @@ node /org/freedesktop/resolve1 {
 
       <varname>LLMNRHostname</varname> contains the hostname currently exposed on the network via LLMNR. It
       usually follows the system hostname as may be queried via
-      <citerefentry project='man-pages'><refentrytitle>gethostname</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
+      <citerefentry project="man-pages"><refentrytitle>gethostname</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
       but may differ if a conflict is detected on the network.
 
       <para><varname>DNS</varname> contains an array containing all DNS servers currently used by
@@ -417,33 +477,75 @@ $ gdbus introspect --system \
 node /org/freedesktop/resolve1/link/_34 {
   interface org.freedesktop.resolve1.Link {
     methods:
-      SetDNS(in  a(iay) arg_0);
-      SetDomains(in  a(sb) arg_0);
-      SetLLMNR(in  s arg_0);
-      SetMulticastDNS(in  s arg_0);
-      SetDNSSEC(in  s arg_0);
-      SetDNSSECNegativeTrustAnchors(in  as arg_0);
+      SetDNS(in  a(iay) addresses);
+      SetDomains(in  a(sb) domains);
+      SetDefaultRoute(in  b enable);
+      SetLLMNR(in  s mode);
+      SetMulticastDNS(in  s mode);
+      SetDNSOverTLS(in  s mode);
+      SetDNSSEC(in  s mode);
+      SetDNSSECNegativeTrustAnchors(in  as names);
       Revert();
-    signals:
     properties:
-      readonly t ScopesMask = 6;
-      readonly a(iay) DNS = [];
-      readonly a(sb) Domains = [];
-      readonly s LLMNR = 'yes';
-      readonly s MulticastDNS = 'no';
-      readonly s DNSSEC = '';
-      readonly as DNSSECNegativeTrustAnchors = [];
-      readonly b DNSSECSupported = true;
-  };
-  interface org.freedesktop.DBus.Peer {
-  };
-  interface org.freedesktop.DBus.Introspectable {
-  };
-  interface org.freedesktop.DBus.Properties {
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly t ScopesMask = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly a(iay) DNS = [...];
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly (iay) CurrentDNSServer = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly a(sb) Domains = [...];
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly b DefaultRoute = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s LLMNR = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s MulticastDNS = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s DNSOverTLS = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s DNSSEC = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly as DNSSECNegativeTrustAnchors = ['...', ...];
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly b DNSSECSupported = ...;
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
     </programlisting>
 
+    <!--method SetDomains is not documented!-->
+
+    <!--method SetDefaultRoute is not documented!-->
+
+    <!--method SetLLMNR is not documented!-->
+
+    <!--method SetMulticastDNS is not documented!-->
+
+    <!--method SetDNSOverTLS is not documented!-->
+
+    <!--method SetDNSSEC is not documented!-->
+
+    <!--method SetDNSSECNegativeTrustAnchors is not documented!-->
+
+    <!--method Revert is not documented!-->
+
+    <!--property CurrentDNSServer is not documented!-->
+
+    <!--property DefaultRoute is not documented!-->
+
+    <!--property LLMNR is not documented!-->
+
+    <!--property MulticastDNS is not documented!-->
+
+    <!--property DNSOverTLS is not documented!-->
+
+    <!--property DNSSEC is not documented!-->
+
+    <!--property DNSSECNegativeTrustAnchors is not documented!-->
+
     <para>For each Linux network interface a "Link" object is created, which exposes per-link DNS
     configuration and state. Use <function>GetLink()</function> on the Manager interface to retrieve the
     object path for a link object given the network interface index (see above).</para>
index 65a5f5b2fb16359dfb8c7eb781903c913b12f64c..8852512906915f3ad7b4bd3b9e06b0f379c4f380 100644 (file)
@@ -44,29 +44,50 @@ node /org/freedesktop/timedate1 {
     methods:
       SetTime(in  x usec_utc,
               in  b relative,
-              in  b user_interaction);
+              in  b interactive);
       SetTimezone(in  s timezone,
-                  in  b user_interaction);
+                  in  b interactive);
       SetLocalRTC(in  b local_rtc,
                   in  b fix_system,
-                  in  b user_interaction);
+                  in  b interactive);
       SetNTP(in  b use_ntp,
-             in  b user_interaction);
-    signals:
+             in  b interactive);
+      ListTimezones(out as timezones);
     properties:
-      readonly s Timezone = 'Europe/Berlin';
-      readonly b LocalRTC = false;
-      readonly b NTP = true;
-  };
-  interface org.freedesktop.DBus.Properties {
-  };
-  interface org.freedesktop.DBus.Introspectable {
-  };
-  interface org.freedesktop.DBus.Peer {
+      readonly s Timezone = '...';
+      readonly b LocalRTC = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly b CanNTP = ...;
+      readonly b NTP = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly b NTPSynchronized = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly t TimeUSec = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly t RTCTimeUSec = ...;
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
     </programlisting>
 
+    <!--method ListTimezones is not documented!-->
+
+    <!--property Timezone is not documented!-->
+
+    <!--property LocalRTC is not documented!-->
+
+    <!--property CanNTP is not documented!-->
+
+    <!--property NTP is not documented!-->
+
+    <!--property NTPSynchronized is not documented!-->
+
+    <!--property TimeUSec is not documented!-->
+
+    <!--property RTCTimeUSec is not documented!-->
+
     <refsect2>
       <title>Methods</title>
 
@@ -100,7 +121,7 @@ node /org/freedesktop/timedate1 {
       time settings using this interface is authenticated via PolicyKit.</para>
 
       <para>Note that this service will not inform you about system time changes. Use
-      <citerefentry project='man-pages'><refentrytitle>timerfd</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+      <citerefentry project="man-pages"><refentrytitle>timerfd</refentrytitle><manvolnum>3</manvolnum></citerefentry>
       with <constant>CLOCK_REALTIME</constant> and <constant>TFD_TIMER_CANCEL_ON_SET</constant> for that.
       </para>