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.
This commit is contained in:
Zbigniew Jędrzejewski-Szmek
parent
08fe1b6cdc
commit
4fb222c4b2
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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>,
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
||||
|
|
|
|||
|
|
@ -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'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'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>
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue