diff options
Diffstat (limited to 'upstream/debian-unstable/man5/org.freedesktop.hostname1.5')
| -rw-r--r-- | upstream/debian-unstable/man5/org.freedesktop.hostname1.5 | 48 |
1 files changed, 46 insertions, 2 deletions
diff --git a/upstream/debian-unstable/man5/org.freedesktop.hostname1.5 b/upstream/debian-unstable/man5/org.freedesktop.hostname1.5 index b0d8da1f..fb7782bc 100644 --- a/upstream/debian-unstable/man5/org.freedesktop.hostname1.5 +++ b/upstream/debian-unstable/man5/org.freedesktop.hostname1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.HOSTNAME1" "5" "" "systemd 255" "org.freedesktop.hostname1" +.TH "ORG\&.FREEDESKTOP\&.HOSTNAME1" "5" "" "systemd 256~rc3" "org.freedesktop.hostname1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -93,6 +93,8 @@ node /org/freedesktop/hostname1 { readonly ay MachineID = [\&.\&.\&.]; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly ay BootID = [\&.\&.\&.]; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") + readonly u VSockCID = \&.\&.\&.; }; interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. }; @@ -138,6 +140,7 @@ node /org/freedesktop/hostname1 { + .PP Whenever the hostname or other metadata is changed via the daemon, \fBPropertyChanged\fR @@ -260,6 +263,42 @@ and \fIHOME_URL=\fR fields from \fBos-release\fR(5)\&. The purpose of those properties is to allow remote clients to access this information over D\-Bus\&. Local clients can access the information directly\&. +.PP +\fIMachineID\fR +expose the 128bit machine ID, see +\fBmachine-id\fR(5) +for details\&. +.PP +\fIBootID\fR +expose the 128bit boot ID, as per +/proc/sys/kernel/random/boot_id\&. +.PP +\fIVSockCID\fR +exposes the system\*(Aqs local +\fBAF_VSOCK\fR +CID (Context Identifier, i\&.e\&. address) for the system, if one is available in the virtual machine environment\&. Set to +\fBUINT32_MAX\fR +otherwise\&. See +\fBvsock\fR(7) +for details\&. +.PP +\fIOperatingSystemSupportEnd\fR +exposes when the OS\*(Aq vendor support ends, if this information is known\&. It\*(Aqs an unsigned 64bit value, in \(mcs since the UNIX epoch, UTC\&. If this information is not known carries the value 2^64\-1, i\&.e\&. +\fBUINT64_MAX\fR\&. +.PP +\fIHardwareVendor\fR +and +\fIHardwareModel\fR +expose information about the vendor of the hardware of the system\&. If no such information can be determined these properties are set to empty strings\&. +.PP +\fIFirmwareVersion\fR +and +\fIFirmwareVendor\fR +expose information about the system\*(Aqs firmware, i\&.e\&. a version string and a vendor name\&. If no such information can be determined these properties are set to empty strings\&. +.PP +\fIFirmwareDate\fR +exposes the firmware build date, if that information is known\&. It\*(Aqs an unsigned 64bit value, in \(mcs since the UNIX epoch, UTC\&. If not known +\fBUNIT64_MAX\fR\&. .SS "Methods" .PP \fBSetHostname()\fR @@ -307,6 +346,9 @@ for the semantics of those settings\&. returns the "product UUID" as exposed by the kernel based on DMI information in /sys/class/dmi/id/product_uuid\&. Reading the file directly requires root privileges, and this method allows access to unprivileged clients through the polkit framework\&. .PP +\fBGetHardwareSerial()\fR +returns the "hardware serial" as exposed by the kernel based on DMI information\&. Reading the file directly requires root privileges, and this method allows access to unprivileged clients through the polkit framework\&. +.PP \fBDescribe()\fR returns a JSON representation of all properties in one\&. .SS "Security" @@ -597,8 +639,10 @@ were added in version 251\&. \fIFirmwareDate\fR were added in version 253\&. .PP -\fIMachineID\fR, and +\fIMachineID\fR, \fIBootID\fR +and +\fIVSockCID\fR were added in version 256\&. .SH "NOTES" .IP " 1." 4 |