summaryrefslogtreecommitdiffstats
path: root/man/org.freedesktop.hostname1.xml (follow)
Commit message (Collapse)AuthorAgeFilesLines
* man: document the last remaining bits of the hostnamed D-Bus interfaceLennart Poettering2024-04-191-14/+20
|
* hostnamed: expose local AF_VSOCK CID among other host infoLennart Poettering2024-01-081-6/+18
| | | | | This is a host identifier of major relevance, since it is how you connect to this system if it is a VM, hence expose this nicely.
* man: use same version in public and system ident.David Tardon2023-12-251-1/+1
|
* man: capitalize "also" for consistencyDavid Tardon2023-12-231-1/+1
| | | | Almost all our man pages write it that way.
* hostname: expose machine ID and boot ID through DBusYu Watanabe2023-12-061-0/+14
| | | | Fixes #30293.
* man: add version information for dbus interfacesAbderrahim Kitouni2023-09-191-0/+12
| | | | | These only go back to version 250 which is the first version to provide the export-dbus-interfaces build target.
* man: fix references to gethostname/sethostnameAntonio Alvarez Feijoo2023-06-231-2/+2
|
* man: fix typosml2023-02-121-1/+1
|
* hostnamed: expose support end timestamp as property on the busLennart Poettering2023-01-241-0/+6
|
* hostnamed: expose FirmwareDate as timestamp in dbusJelle van der Waa2023-01-191-1/+1
| | | | | | Offer the firmware date as an epoch instead of the literal DMI string. Closes #25679
* hostnamed: expose FirmwareDate dbus propertyJelle van der Waa2022-12-071-0/+6
| | | | Expose /sys/class/dmi/id/bios_date as dbus property in hostnamed.
* hostnamed: expose FirmwareVendor as dbus propertyJelle van der Waa2022-12-071-0/+6
| | | | Expose /sys/class/dmi/id/bios_vendor as dbus property in hostnamed.
* man: deduplicate dbus versioning refZbigniew Jędrzejewski-Szmek2022-05-051-6/+1
|
* hostnamed: display firmware versionSonali Srivastava2022-04-191-0/+6
|
* hostnamed: drop "iteractive" parameter from GetHardwareSerial()Lennart Poettering2022-02-031-2/+1
| | | | | | | | | | | | | | | Since a long time the D-Bus spec knows a special bit in its message header for indicating that "interactive" authentication is OK. The original hostnamed API is before that was added hence most functions expose that boolean as explicit argument. For new added functions let's get rid of it, the message flag is good enough and replaces it with complete functionality. No new APIs should carry the "interactive" boolean flag explicitly as argument anymore. Follow-up for: 9697662915e47a4797b05003cb1970fe2b01e530
* hostname: expose hardware serial through dbusYu Watanabe2022-01-241-0/+6
| | | | Closes #22119.
* tree-wide: fix "the the" and "a a"Yu Watanabe2021-06-301-1/+1
|
* sd-bus: fix vtable named argument logicYu Watanabe2021-04-301-1/+1
| | | | Fixes #19468.
* man: document new dbus methodLennart Poettering2021-04-291-12/+16
|
* hostnamed: rename FallbackHostname to DefaultHostnameZbigniew Jędrzejewski-Szmek2021-02-221-7/+9
| | | | | | | | | This follows the addition of DEFAULT_HOSTNAME= in os-release. The distinction between the value from os-release or the env var and the compile-time setting is not made in the api: HostnameSource is "default" is all cases. I think that this level of detail is not needed, because the users of this mostly care whether the hostname was set by user configuration or not.
* man: update org.freedesktop.hostname1.xmlYu Watanabe2020-12-181-0/+12
|
* hostnamed,shared/hostname-setup: expose the origin of the current hostnameZbigniew Jędrzejewski-Szmek2020-12-161-0/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In hostnamed this is exposed as a dbus property, and in the logs in both places. This is of interest to network management software and such: if the fallback hostname is used, it's not as useful as the real configured thing. Right now various programs try to guess the source of hostname by looking at the string. E.g. "localhost" is assumed to be not the real hostname, but "fedora" is. Any such attempts are bound to fail, because we cannot distinguish "fedora" (a fallback value set by a distro), from "fedora" (received from reverse dns), from "fedora" read from /etc/hostname. /run/systemd/fallback-hostname is written with the fallback hostname when either pid1 or hostnamed sets the kernel hostname to the fallback value. Why remember the fallback value and not the transient hostname in /run/hostname instead? We have three hostname types: "static", "transient", fallback". – Distinguishing "static" is easy: the hostname that is set matches what is in /etc/hostname. – Distingiushing "transient" and "fallback" is not easy. And the "transient" hostname may be set outside of pid1+hostnamed. In particular, it may be set by container manager, some non-systemd tool in the initramfs, or even by a direct call. All those mechanisms count as "transient". Trying to get those cases to write /run/hostname is futile. It is much easier to isolate the "fallback" case which is mostly under our control. And since the file is only used as a flag to mark the hostname as fallback, it can be hidden inside of our /run/systemd directory. For https://bugzilla.redhat.com/show_bug.cgi?id=1892235.
* hostnamed: expose the fallback-hostname setting as a const dbus propertyZbigniew Jędrzejewski-Szmek2020-12-161-0/+7
| | | | | | Various users want to know what the fallback hostname is. Since it was made configurable in 8146c32b9264a6915d467a5cab1a24311fbede7e, we didn't expose this nicely.
* man/hostnamectl,hostaned,hostname1: adjust the docs to match realityZbigniew Jędrzejewski-Szmek2020-12-161-50/+46
| | | | | | | | | | | | | | | | | | | | | The semantics were significantly changed in c779a44222161155c039a7fd2fd304c006590ac7 ("hostnamed: Fix the way that static and transient host names interact", Feb. 2014), but when the dbus api documentation was imported much later, it wasn't properly adjusted to describe those new semantics. 34293dfafd2a81d80727938199769906dab321bd which added systemd.hostname= also added new behaviour. Let's ove various bits and pieces around so that they are in more appropriate places. Drop recommendations to set the hostname for DHCP or mDNS purposes. Nowadays we expect tools that want to expose some different hostname to the outside to manage that internally without affecting visible state. Also drop mentions of DHCP or mDNS directly setting the hostname, since nowadays network management software is expected to (and does) go through hostnamed. Also, add a high-level description of semantics. It glosses over the details of handling of localhost-style names. Later commits will remove this special handling anyway.
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* Update org.freedesktop.hostname1 documentationLuca Weiss2020-10-281-1/+2
| | | This documents the polkit actions for `SetDeployment()` and `SetLocation()` which previously were undocumented.
* man: match parenthesesTopi Miettinen2020-07-071-1/+1
| | | | | | | | | | | Files found with: for f in *; do \ l=`tr -d '[^(]' < $f | wc -c`; \ r=`tr -d '[^)]' < $f | wc -c`; \ if [ $l -ne $r ]; then \ echo $f $l $r; \ fi; \ done
* man: use --bus-introspect to autogenerate dbus api docsZbigniew Jędrzejewski-Szmek2020-05-051-5/+14
| | | | | | This has the advantage that the executables are always in place and we don't need any units to exist on the bus, so we can eventually hook this up into a normal build system. (Probably as a build time check.)
* docs: use "polkit" to refer to PolicyKitZbigniew Jędrzejewski-Szmek2020-04-211-4/+5
| | | | | | See d35f51ea848ca76bd3747db69e8c5dd864e82bc3 for justification. First use in each file is turned into a link to the documentation page.
* man: hostname(5) — add description of methods and propertiesZbigniew Jędrzejewski-Szmek2020-04-211-32/+45
|
* man: reorder hostname1(5)Zbigniew Jędrzejewski-Szmek2020-04-211-20/+29
|
* man: add markers to put all dbus entities in the directives indexZbigniew Jędrzejewski-Szmek2020-04-211-0/+50
| | | | | | | | Follow-up for f92c8d1c67bcdeba097e3203d8aafe3a31230ada. directives.index: - This index contains 3398 entries in 19 sections, referring to 333 individual + This index contains 4316 entries in 19 sections, referring to 333 individual
* man: various tweaks to org.freedesktop.hostname1(5)Zbigniew Jędrzejewski-Szmek2020-04-161-41/+42
| | | | Co-Authored-By: Daan De Meyer <daan.j.demeyer@gmail.com>
* man: run dbus api docs through the updaterZbigniew Jędrzejewski-Szmek2020-04-161-26/+74
| | | | | | | | | | | | 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.
* man: import org.freedesktop.hostname1(3) from the wikiZbigniew Jędrzejewski-Szmek2020-04-121-0/+236