diff options
author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2020-04-10 15:07:03 +0200 |
---|---|---|
committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2020-04-16 19:46:40 +0200 |
commit | 4fb222c4b29ec2a1a451a1e0e99c5d3c520395ab (patch) | |
tree | 3e6aa4abceca3f4b93070d71e5c902828c28bbdd /man/org.freedesktop.machine1.xml | |
parent | 08fe1b6cdc32505321a47cf1f9b4d748d2d09953 (diff) | |
download | systemd-4fb222c4b29ec2a1a451a1e0e99c5d3c520395ab.tar.gz |
man: run dbus api docs through the updater
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.
Diffstat (limited to 'man/org.freedesktop.machine1.xml')
-rw-r--r-- | man/org.freedesktop.machine1.xml | 108 |
1 files changed, 75 insertions, 33 deletions
diff --git a/man/org.freedesktop.machine1.xml b/man/org.freedesktop.machine1.xml index f26829ee45..1c9c41f04c 100644 --- 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> |