man: run dbus api docs through the updater

[thirdparty/systemd.git] / man / org.freedesktop.machine1.xml

diff --git a/man/org.freedesktop.machine1.xml b/man/org.freedesktop.machine1.xml
index f26829ee45abf291a8bdbffea43d7cf36c493f06..1c9c41f04c13153722418d53a9bc3f0cf17cfb6d 100644 (file)
--- a/man/org.freedesktop.machine1.xml
+++ b/man/org.freedesktop.machine1.xml
@@ -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>