shaba/systemd-stable
1
1
Fork 0
mirror of https://github.com/systemd/systemd-stable.git synced 2025-01-12 09:17:44 +03:00
Code

docs: /etc/os-release → os-release(3)

Browse Source 
It's /usr/lib/os-release now mostly. But let's link to the man page.
This commit is contained in:
Zbigniew Jędrzejewski-Szmek 2022-05-23 14:27:44 +02:00
parent 7bb36d2d7a
commit 14bacc744f
1 changed files with 14 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
docs/BOOT_LOADER_SPECIFICATION.md
View File

@ -139,7 +139,7 @@ freely but should be unique enough to avoid clashes between OS installations.
More specifically, it is suggested to include the machine ID (`/etc/machine-id` More specifically, it is suggested to include the machine ID (`/etc/machine-id`
or the D-Bus machine ID for OSes that lack `/etc/machine-id`), the kernel or the D-Bus machine ID for OSes that lack `/etc/machine-id`), the kernel
version (as returned by `uname -r`) and an OS identifier (the `ID=` field of version (as returned by `uname -r`) and an OS identifier (the `ID=` field of
`/etc/os-release`). [os-release](https://www.freedesktop.org/software/systemd/man/os-release.html)).
Example: `$BOOT/loader/entries/6a9857a393724b7a981ebb5b8495b9ea-3.8.0-2.fc19.x86_64.conf`. Example: `$BOOT/loader/entries/6a9857a393724b7a981ebb5b8495b9ea-3.8.0-2.fc19.x86_64.conf`.
@ -163,10 +163,11 @@ The following keys are recognized:
* `title` is a human-readable title for this menu item to be displayed in the * `title` is a human-readable title for this menu item to be displayed in the
boot menu. It is a good idea to initialize this from the `PRETTY_NAME=` of boot menu. It is a good idea to initialize this from the `PRETTY_NAME=` of
`/etc/os-release`. This name should be descriptive and does not have to be [os-release](https://www.freedesktop.org/software/systemd/man/os-release.html).
unique. If a boot loader discovers two entries with the same title it should This name should be descriptive and does not have to be unique. If a boot
show more than just the raw title in the UI, for example by appending the loader discovers two entries with the same title it should show more than
`version` field. This field is optional. just the raw title in the UI, for example by appending the `version`
field. This field is optional.
Example: `title Fedora 18 (Spherical Cow)` Example: `title Fedora 18 (Spherical Cow)`
@ -190,14 +191,14 @@ The following keys are recognized:
* `sort-key` is a short string used for sorting entries on display. This should * `sort-key` is a short string used for sorting entries on display. This should
typically be initialized from the `IMAGE_ID=` or `ID=` fields of typically be initialized from the `IMAGE_ID=` or `ID=` fields of
`/etc/os-release`, possibly with an additional suffix. This field is [os-release](https://www.freedesktop.org/software/systemd/man/os-release.html),
optional. If set, it is used as primary sorting key for the entries on possibly with an additional suffix. This field is optional. If set, it is
display (lexicographically increasing). It does not have to be unique (and used as primary sorting key for the entries on display (lexicographically
usually is not). If non-unique the the `machine-id` (lexicographically increasing). It does not have to be unique (and usually is not). If
increasing) and `version` (lexicographically decreasing, i.e. newest version non-unique the the `machine-id` (lexicographically increasing) and `version`
first) fields described above are used as secondary/ternary sorting keys. If (lexicographically decreasing, i.e. newest version first) fields described
this field is not set entries are typically sorted by the `.conf` file name above are used as secondary/ternary sorting keys. If this field is not set
of the entry. entries are typically sorted by the `.conf` file name of the entry.
Example: `sort-key fedora` Example: `sort-key fedora`