ORG.FREEDESKTOP.HOSTNAME1(5) org.freedesktop.hostname1 (NAME) org.freedesktop.hostname1 - D-Bus systemd-hostnamed (DESCRIPTION) systemd-hostnamed.service(8) . D-Bus . D-BUS (THE D-BUS INTERFACE) : node /org/freedesktop/hostname1 { interface org.freedesktop.hostname1 { methods: 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); SetTags(in as tags); GetProductUUID(in b interactive, out ay uuid); GetHardwareSerial(out s serial); Describe(out s json); GetMachineInfo(in s field, out s value); properties: readonly s Hostname = '...'; readonly s StaticHostname = '...'; readonly s PrettyHostname = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s DefaultHostname = '...'; readonly s HostnameSource = '...'; readonly s IconName = '...'; readonly s Chassis = '...'; readonly s Deployment = '...'; readonly s Location = '...'; readonly as Tags = ['...', ...]; @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 OperatingSystemFancyName = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s OperatingSystemCPEName = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly t OperatingSystemSupportEnd = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s HomeURL = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s OperatingSystemImageID = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s OperatingSystemImageVersion = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s HardwareVendor = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s HardwareModel = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s HardwareSKU = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s HardwareVersion = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s FirmwareVersion = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s FirmwareVendor = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly t FirmwareDate = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly ay MachineID = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly ay BootID = [...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly u VSockCID = ...; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s ChassisAssetTag = '...'; }; interface org.freedesktop.DBus.Peer { ... }; interface org.freedesktop.DBus.Introspectable { ... }; interface org.freedesktop.DBus.Properties { ... }; }; PropertyChanged . polkit[1] . (SEMANTICS) StaticHostname <<>> (static) /etc/hostname . gethostname(3) . . systemd(1) systemd- hostnamed.service(8) . Hostname sethostname(2) . . . PrettyHostname << >> (pretty hostname) UTF-8 . "Lennart's Computer" "lennarts-computer" . . ( ) . DefaultHostname ( os-release(5) ) . HostnameSource "static" ( /etc/hostname) "transient" ( ) "default" ( os-release ). IconName << >> (icon name) XDG . ( ) ( "computer-laptop" "computer-desktop" ). . "computer" . . Chassis << >> (chassis type) : "desktop", "laptop", "server", "tablet", "handset", "vm" "container" . DMI/SMBIOS/ACPI . . . Tags << >> (machine tags) : . (ASCII) "-" "." . TAGS= /etc/machine-info machine-info(5) . . systemd-hostnamed . PropertyChanged ( vi) . : . () Hostname . PropertyChanged systemd-hostnamed . /proc/sys/kernel/hostname SIGHUP poll(3) . : () () . . gethostname(2) /etc/hostname ( ) machine-info(5) . . KernelName KernelRelease KernelVersion ( "Linux") ( "5.0.0-11") ( "#11") uname(2) . OperatingSystemPrettyName OperatingSystemFancyName OperatingSystemCPEName HomeURL PRETTY_NAME= FANCY_NAME= CPE_NAME= HOME_URL= os-release(5) . D-Bus . . MachineID machine-id(5) . BootID /proc/sys/kernel/random/boot_id . VSockCID (CID ) AF_VSOCK . UINT32_MAX . vsock(7) . OperatingSystemSupportEnd . (s) (UNIX epoch) UTC . 2^64-1 UINT64_MAX . OperatingSystemImageID OperatingSystemImageVersion . IMAGE_ID= IMAGE_VERSION= os-release . HardwareVendor HardwareModel HardwareSKU HardwareVersion . (SKU) . SKU . SKU . . FirmwareVersion FirmwareVendor . . FirmwareDate . (s) (UNIX epoch) UTC . UNIT64_MAX . ChassisAssetTag . . (Methods) SetHostname() () . (ASCII) . . SetStaticHostname() StaticHostname . /etc/hostname . Hostname . SetPrettyHostname() PrettyHostname . SetIconName() SetChassis() SetDeployment() SetLocation() IconName ( ) Chassis ( ) Deployment ( ) Location ( ) . SetTags() Tags . ( "-" "."). TAGS= /etc/machine-info . PrettyHostname IconName Chassis Deployment Location Tags /etc/machine-info . machine-info(5) . GetProductUUID() (<>) DMI /sys/class/dmi/id/product_uuid . (root) polkit . GetHardwareSerial() << >> (hardware serial) DMI . (root) polkit . Describe() JSON . GetMachineInfo() /etc/machine-info . (cache) D-Bus /etc/machine-info ( DMI/). () . . (Security) interactive polkit . (action) polkit SetHostname() org.freedesktop.hostname1.set-hostname . SetStaticHostname() SetPrettyHostname() org.freedesktop.hostname1.set-static-hostname . SetIconName() SetChassis() SetDeployment() SetLocation() SetTags() org.freedesktop.hostname1.set-machine-info . (RECOMMENDATIONS) : o DNS-SD: TXT . . WebDAV UPnP . o . o <> . /etc/hosts systemd-hostnamed nss-myhostname(8) . () : o (label) DNS FQDN. "-" . o ASCII DNS . "a-zA-Z0-9" "-" . "a" -> "ae" "-" . o "-" "-" . o DNS . o systemd-hostnamed . o . systemd-hostnamed . systemd-hostnamed "_" DNS-SD . systemd-hostnamed DNS . : o "Lennart's PC" -> "lennarts-pc" o "Mullers Computer" -> "muellers-computer" o "Voran!" -> "voran" o "Es war einmal ein Mannlein" -> "es-war-einmal-ein-maennlein" o "Jawoll. Ist doch wahr!" -> "jawoll-ist-doch-wahr" o "" -> "localhost" o "...zack!!! zack!..." -> "zack-zack" -- . (EXAMPLES) . org.freedesktop.hostname1 $ gdbus introspect --system \ --dest org.freedesktop.hostname1 \ --object-path /org/freedesktop/hostname1 (VERSION COMPATIBILITY) D-Bus [2] . (HISTORY) D-Bus (The D-Bus API) FirmwareVersion GetHardwareSerial() . OperatingSystemSupportEnd FirmwareVendor FirmwareDate . MachineID BootID VSockCID . ChassisAssetTag OperatingSystemImageID OperatingSystemImageVersion HardwareSKU HardwareVersion . OperatingSystemFancyName . GetMachineInfo() Tags SetTags() . (SEE ALSO) systemd(1), systemd-hostnamed.service(8), hostnamectl(1), xdg-hostname[3] (NOTES) 1. polkit https://www.freedesktop.org/software/polkit/docs/latest 2. https://0pointer.de/blog/projects/versioning-dbus.html 3. xdg-hostname https://fedoraproject.org/wiki/Features/BetterHostname systemd 261.2 ORG.FREEDESKTOP.HOSTNAME1(5)