Merging upstream version 4.23.0.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 46 insertions, 2 deletions

diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.hostname1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.hostname1.5
index b0d8da1f..fb7782bc 100644
--- a/upstream/fedora-rawhide/man5/org.freedesktop.hostname1.5
+++ b/upstream/fedora-rawhide/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