diff --git a/man/org.freedesktop.hostname1.xml b/man/org.freedesktop.hostname1.xml index a381cb8239..b9522a3a08 100644 --- a/man/org.freedesktop.hostname1.xml +++ b/man/org.freedesktop.hostname1.xml @@ -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 { ... }; }; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Whenever the hostname or other meta data is changed via the daemon, PropertyChanged signals are sent out to subscribed clients. Changing a hostname using this interface is authenticated via PolicyKit. @@ -84,13 +132,13 @@ node /org/freedesktop/hostname1 { The static (configured) host name is the one configured in /etc/hostname. It is chosen by the local user. It is not always in sync with the current hostname as returned by the - gethostname3 + gethostname3 system call. If no host name is configured this property will be the empty string. Setting this property to the empty string will remove /etc/hostname. This hostname should be an internet-style hostname, 7-bit lowercase ASCII, no special chars/spaces. The transient (dynamic) host name is the one configured via the kernel's - sethostname3. + sethostname3. It can be different from the static hostname in case DHCP or mDNS have been configured to change the name based on network information. 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 PropertyChanged messages from systemd-hostnamed. For that, open /proc/sys/kernel/hostname and - poll3 + poll3 for SIGHUP 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. Applications may bypass the daemon to read the hostname data if notifications of host name changes are not necessary. Use - gethostname3, + gethostname3, /etc/hostname (possibly with per-distribution fallbacks), and machine-info3 for that. For more information on these files and syscalls see the respective man pages. diff --git a/man/org.freedesktop.import1.xml b/man/org.freedesktop.import1.xml index 9c8498ff7f..6a628f4671 100644 --- a/man/org.freedesktop.import1.xml +++ b/man/org.freedesktop.import1.xml @@ -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 { ... }; }; - + + + Methods @@ -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 { ... }; }; - + + + Methods diff --git a/man/org.freedesktop.locale1.xml b/man/org.freedesktop.locale1.xml index 7c345acc00..7b2bf2870f 100644 --- a/man/org.freedesktop.locale1.xml +++ b/man/org.freedesktop.locale1.xml @@ -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 { ... }; }; + + + + + + + + + + + + + + The system locale consists of an array of environment-variable-assignment-like strings. The following strings are known: LANG=, LC_CTYPE=, LC_NUMERIC=, LC_TIME=, LC_COLLATE=, diff --git a/man/org.freedesktop.login1.xml b/man/org.freedesktop.login1.xml index 2910693865..1c6134f9a6 100644 --- a/man/org.freedesktop.login1.xml +++ b/man/org.freedesktop.login1.xml @@ -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 { ... }; }; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Security @@ -382,6 +554,7 @@ node /org/freedesktop/login1 { $ 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 { ... }; }; + + + + + + + + + + Methods @@ -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 { ... }; }; + + Methods @@ -547,9 +741,9 @@ node /org/freedesktop/login1/user/_1000 { $ 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 { ... }; }; + + + + + + + + Methods 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 { ... }; }; @@ -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 { ... }; }; diff --git a/man/org.freedesktop.resolve1.xml b/man/org.freedesktop.resolve1.xml index f0cf668f19..d150ee2a5f 100644 --- a/man/org.freedesktop.resolve1.xml +++ b/man/org.freedesktop.resolve1.xml @@ -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 { ... }; }; + + + + + + + + + + + + + + + + + + + + + + + + + + + + Methods @@ -165,7 +225,7 @@ node /org/freedesktop/resolve1 { ANY). Finally, a flags 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 RFC 1035. 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: - To resolve a DNS-SD service, specify the service name (e.g. Lennart's + To resolve a DNS-SD service, specify the service name (e.g. Lennart's Files), the service type (e.g. _webdav._tcp) and the domain to search in (e.g. local) 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 { LLMNRHostname contains the hostname currently exposed on the network via LLMNR. It usually follows the system hostname as may be queried via - gethostname3, + gethostname3, but may differ if a conflict is detected on the network. DNS 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 { ... }; }; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + For each Linux network interface a "Link" object is created, which exposes per-link DNS configuration and state. Use GetLink() on the Manager interface to retrieve the object path for a link object given the network interface index (see above). diff --git a/man/org.freedesktop.timedate1.xml b/man/org.freedesktop.timedate1.xml index 65a5f5b2fb..8852512906 100644 --- a/man/org.freedesktop.timedate1.xml +++ b/man/org.freedesktop.timedate1.xml @@ -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 { ... }; }; + + + + + + + + + + + + + + + + Methods @@ -100,7 +121,7 @@ node /org/freedesktop/timedate1 { time settings using this interface is authenticated via PolicyKit. Note that this service will not inform you about system time changes. Use - timerfd3 + timerfd3 with CLOCK_REALTIME and TFD_TIMER_CANCEL_ON_SET for that.