ALT Linux Bugzilla
– Attachment 21133 Details for
Bug 45743
/etc/os-release не в едином стиле между продуктами и часто не соответствует действительности
New bug
|
Search
|
[?]
|
Help
Register
|
Log In
[x]
|
Forgot Password
Login:
[x]
|
EN
|
RU
Гайд как заполнить свой os-release
os-release-howto-v1.md (text/markdown), 13.05 KB, created by
Semen Fomchenkov
on 2026-04-13 17:56:51 MSK
(
hide
)
Description:
Гайд как заполнить свой os-release
Filename:
MIME Type:
Creator:
Semen Fomchenkov
Created:
2026-04-13 17:56:51 MSK
Size:
13.05 KB
patch
obsolete
># How-To: ÐÑавилÑное заполнение /etc/os-release в ALT > >Ð ÑководÑÑво по Ð·Ð°Ð¿Ð¾Ð»Ð½ÐµÐ½Ð¸Ñ Ñайла `/etc/os-release` в branding-пакеÑÐ°Ñ ALT в ÑооÑвеÑÑÑвии Ñо ÑпеÑиÑикаÑией [freedesktop os-release(5)](https://www.freedesktop.org/software/systemd/man/latest/os-release.html). > >--- > >## ÐÑалоннÑй пÑимеÑ: ALT Workstation 11.2 > >```ini >NAME=ALT >VERSION="11.2 (Prometheus)" >ID=altlinux >VERSION_ID=11.2 >VERSION_CODENAME=prometheus >PRETTY_NAME="ALT Workstation 11.2 (Prometheus)" >ANSI_COLOR="1;33" >CPE_NAME="cpe:/o:alt:workstation:11.2" >BUILD_ID="Workstation 11.2" >HOME_URL="https://basealt.ru/" >BUG_REPORT_URL="https://bugs.altlinux.org/" >DOCUMENTATION_URL="https://docs.altlinux.org/" >SUPPORT_URL="https://support.basealt.ru/" >VARIANT="Workstation" >VARIANT_ID=workstation >LOGO=alt-distro-logo >ALT_BRANCH_ID=p11 >``` > >--- > >## Ð Ð°Ð·Ð±Ð¾Ñ Ð¿Ð¾Ð»ÐµÐ¹ > >### NAME=ALT > >ÐÐ¼Ñ Ð¾Ð¿ÐµÑаÑионной ÑиÑÑÐµÐ¼Ñ Ð±ÐµÐ· веÑÑии и без ваÑианÑа. Ðдиное Ð´Ð»Ñ Ð²ÑÐµÑ Ð¿ÑодÑкÑов ALT. > >Ðо ÑпеÑиÑикаÑии: *"A string identifying the operating system, without a version component."* ÐналогиÑ: Ñ Fedora Ð´Ð»Ñ Workstation, Server и IoT â вÑегда `NAME=Fedora`. ÐаÑÐ¸Ð°Ð½Ñ Ð²ÑноÑиÑÑÑ Ð² `VARIANT`. > >### VERSION="11.2 (Prometheus)" > >ÐеÑÑÐ¸Ñ ÐС Ð´Ð»Ñ Ð¾ÑобÑÐ°Ð¶ÐµÐ½Ð¸Ñ Ð¿Ð¾Ð»ÑзоваÑелÑ. ÐÐ¾Ð¶ÐµÑ Ð²ÐºÐ»ÑÑаÑÑ ÐºÐ¾Ð´Ð¾Ð²Ð¾Ðµ имÑ. Ðе ÑодеÑÐ¶Ð¸Ñ Ð¸Ð¼ÐµÐ½Ð¸ ÐС. > >Ðо ÑпеÑиÑикаÑии: *"A string identifying the operating system version, excluding any OS name information, possibly including a release code name."* > >ÐÐÐÐÐ! СейÑÐ°Ñ ÑÑа оÑибка Ñ Ð½Ð°Ñ ÑаÑÑаÑ. ÐÑли Ñелиз ÑвлÑеÑÑÑ alpha/beta, не вклеиваÑÑ ÑÑо в VERSION. ÐаÑÐ¸Ð½Ð°Ñ Ñ systemd v257(Ñ Ð½Ð°Ñ Ð² p11 Ñже он) Ð´Ð»Ñ ÑÑого еÑÑÑ Ð¾ÑделÑное поле `RELEASE_TYPE=development`. > >### ID=altlinux > >ÐаÑиноÑиÑаемÑй иденÑиÑикаÑÐ¾Ñ ÐС. СÑÑого lowercase, допÑÑÑимÑе ÑимволÑ: `[0-9a-z._-]`. > >Ðо ÑпеÑиÑикаÑии: *"A lower-case string⦠identifying the operating system⦠suitable for processing by scripts."* ÐÑполÑзÑеÑÑÑ Ð² ÑÑловиÑÑ: `if [ "$ID" = "altlinux" ]; then ...` > >### VERSION_ID=11.2 > >ÐаÑиноÑиÑÐ°ÐµÐ¼Ð°Ñ Ð²ÐµÑÑиÑ. ТолÑко ÑиÑÑÑ, ÑоÑки, деÑиÑÑ. Ðез кодового имени, без имени ÐС. ÐÐ»Ñ Ð¸ÑполÑÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ ÑкÑипÑами. > >### VERSION_CODENAME=prometheus > >Ðодовое Ð¸Ð¼Ñ Ñелиза в lowercase. > >### PRETTY_NAME="ALT Workstation 11.2 (Prometheus)" > >ÐÐ»Ð°Ð²Ð½Ð°Ñ ÑÑÑока Ð´Ð»Ñ Ð¿Ð¾ÐºÐ°Ð·Ð° полÑзоваÑелÑ. ÐÐ¾Ð¶ÐµÑ ÑодеÑжаÑÑ Ð²ÑÑ ÑÑо Ñгодно. > >Ðо ÑпеÑиÑикаÑии: *"A pretty operating system name in a format suitable for presentation to the user."* ÐÑе пÑогÑÐ°Ð¼Ð¼Ñ Ð¾ÑобÑажаÑÑие полÑзоваÑÐµÐ»Ñ Ð¸Ð½ÑоÑмаÑÐ¸Ñ Ð¾ названии в полном ÑоÑмаÑе, желаÑелÑно Ð´Ð¾Ð»Ð¶Ð½Ñ Ð¸ÑполÑзоваÑÑ ÑÑо поле. > >ФоÑмÑла: `NAME VARIANT VERSION`. > >### ANSI_COLOR="1;33" > >Ð¦Ð²ÐµÑ Ð´Ð»Ñ Ð²Ñвода имени ÐС в ÑеÑминале. ÐнаÑение подÑÑавлÑеÑÑÑ Ð² ESC-поÑледоваÑелÑноÑÑÑ `ESC[1;33m` (жÑлÑÑй, жиÑнÑй). > >### CPE_NAME="cpe:/o:alt:workstation:11.2" > >ÐденÑиÑикаÑÐ¾Ñ Ð¿Ð¾ ÑÑандаÑÑÑ NIST Common Platform Enumeration. ÐÑполÑзÑеÑÑÑ ÑканеÑами ÑÑзвимоÑÑей (OpenSCAP, Vulners и Ñ.д.). > >ФоÑмаÑ: `cpe:/o:<vendor>:<product>:<version>`. ÐеÑÑÐ¸Ñ â Ð¿Ð¾Ð»Ð½Ð°Ñ (Ñ Ð¼Ð¸Ð½Ð¾Ñной ÑаÑÑÑÑ). > >### BUILD_ID="Workstation 11.2" > >ÐденÑиÑикаÑÐ¾Ñ Ð¾ÑигиналÑного ÑÑÑановоÑного обÑаза. Ðе менÑеÑÑÑ Ð¿Ñи обновлениÑÑ Ð¿Ð°ÐºÐµÑов. > >Ðо ÑпеÑиÑикаÑии: *"A string uniquely identifying the system image originally used as the installation base⦠BUILD_ID may be used in distributions where the original installation image version is important: VERSION_ID would change during incremental system updates, but BUILD_ID would not."* > >ФоÑмÑла: `VARIANT VERSION_ID`. Ðез `NAME`, Ñ.к. оно одинаково Ð´Ð»Ñ Ð²ÑÐµÑ Ð¿ÑодÑкÑов. Ðоле однознаÑно оÑвеÑÐ°ÐµÑ Ð½Ð° вопÑÐ¾Ñ Â«ÐºÐ°ÐºÐ¾Ð¹ диÑÑÑибÑÑив бÑл ÑÑÑановлен изнаÑалÑно». > >### VARIANT="Workstation" > >ÐÐ¼Ñ ÑедакÑии/ваÑианÑа Ð´Ð»Ñ Ð¾ÑобÑÐ°Ð¶ÐµÐ½Ð¸Ñ Ð¿Ð¾Ð»ÑзоваÑелÑ. Ðез имени ÐС. > >Ðо ÑпеÑиÑикаÑии: *"A string identifying a specific variant or edition⦠suitable for presentation to the user. This field is for display purposes only."* > >### VARIANT_ID=workstation > >ÐаÑиноÑиÑаемÑй иденÑиÑикаÑÐ¾Ñ ÑедакÑии. СÑÑого lowercase, `[0-9a-z._-]`. > >Ðо ÑпеÑиÑикаÑии: *"A lower-case string⦠identifying a specific variant or edition. This may be interpreted by other packages in order to determine a divergent default configuration."* > >### LOGO=alt-distro-logo > >ÐÐ¼Ñ Ð¸ÐºÐ¾Ð½ÐºÐ¸ по ÑпеÑиÑикаÑии freedesktop Icon Theme. ÐÑÐ¸Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ (GNOME, KDE), а Ñакже Tuner OS Info иÑполÑзÑÑÑ Ð´Ð»Ñ Ð¿Ð¾ÐºÐ°Ð·Ð° логоÑипа ÐС. > >### URL-Ð¿Ð¾Ð»Ñ > >`HOME_URL`, `BUG_REPORT_URL`, `DOCUMENTATION_URL`, `SUPPORT_URL` â ÑÑÑлки Ð´Ð»Ñ Ð¿Ð¾Ð»ÑзоваÑÐµÐ»Ñ Ð¸ авÑомаÑизаÑии. Ðо ÑпеÑиÑикаÑии â ÑÑÑого `http:` или `https:`, по одной на поле. > >## Ðод вопÑоÑом? > >### ALT_BRANCH_ID=p11 (добавлÑем ÑейÑÐ°Ñ Ð¸Ð»Ð¸ еÑе ÑÑебÑÐµÑ Ð¾Ð±ÑÑждениÑ?) > >РаÑÑиÑение ALT (не ÑÑандаÑÑ freedesktop). ÐеÑка ÑепозиÑоÑиÑ, из коÑоÑого ÑобÑан branding-пакеÑ. ÐнаÑение беÑÑÑÑÑ Ð¸Ð· `%_priority_distbranch` пÑи ÑбоÑке. > >Ðо ÑпеÑиÑикаÑии, вендоÑам ÑекомендÑеÑÑÑ Ð´Ð°Ð²Ð°ÑÑ ÑаÑÑиÑениÑм OS-ÑпеÑиÑиÑнÑй пÑеÑÐ¸ÐºÑ â оÑÑÑда `ALT_`. > >### ID_LIKE (еÑÑÑ Ð»Ð¸ Ñ Ð½Ð°Ñ Ð²Ð¾Ð¾Ð±Ñе Ñакие ÑодÑÑвеннÑе ÑиÑÑемÑ?) > >ID_LIKE="rhel fedora" >СпиÑок ID ÑодÑÑвеннÑÑ ÐС ÑеÑез пÑобел. ÐÐ¾Ð¼Ð¾Ð³Ð°ÐµÑ ÑÑоÑонним инÑÑÑÑменÑам (ansible, cloud-init, systemd-sysext) вÑбÑаÑÑ Ð¿ÑавилÑнÑÑ Ð²ÐµÑÐºÑ Ð»Ð¾Ð³Ð¸ÐºÐ¸, когда ID=altlinux им незнаком. > >Ðо ÑпеÑиÑикаÑии: "Build scripts and similar should check this variable if they need to identify the local operating system and the value of ID is not recognized." > >ÐеÑеÑиÑлÑÑÑ Ð¾Ñ Ð½Ð°Ð¸Ð±Ð¾Ð»ÐµÐµ близкого к наименее. ALT â RPM-based диÑÑÑибÑÑив Ñ rpm, apt-rpm, gear; ближайÑие оÑиенÑиÑÑ â RHEL и Fedora. > >--- > >## СпеÑиÑикаÑÐ¸Ñ Ð¿Ð¾Ð»ÐµÐ¹ (ÐопÑоÑил нейÑоноÑÐºÑ ÐºÑаÑиво ÑобÑаÑÑ Ð²Ñе мои мÑÑли в ÑаблиÑки) > >### ÐбÑзаÑелÑнÑе Ð¿Ð¾Ð»Ñ > >| Ðоле | Тип | ÐÑо ÑиÑÐ°ÐµÑ | ÐÑавило | ÐÑÐ¸Ð¼ÐµÑ | >|------|-----|------------|---------|--------| >| `NAME` | display | UI, полÑзоваÑÐµÐ»Ñ | ÐÐ¼Ñ ÐС. Ðез веÑÑии, без ваÑианÑа. Ðдиное Ð´Ð»Ñ Ð²ÑÐµÑ Ð¿ÑодÑкÑов. | `ALT` | >| `ID` | machine | ÑкÑипÑÑ, systemd, ansible | Lowercase ID ÐС. `[0-9a-z._-]` | `altlinux` | >| `VERSION_ID` | machine | ÑкÑипÑÑ, имена Ñайлов | ТолÑко веÑÑиÑ, lowercase/numeric. `[0-9a-z._-]` | `11.2` | >| `PRETTY_NAME` | display | kinfocenter, neofetch, hostnamectl | ÐÐ¾Ð»Ð½Ð°Ñ ÑÑÑока Ð´Ð»Ñ Ð¿Ð¾ÐºÐ°Ð·Ð° полÑзоваÑелÑ. ФоÑмÑла: `NAME VARIANT VERSION`. | `ALT Workstation 11.2 (Prometheus)` | > >### РекомендÑемÑе Ð¿Ð¾Ð»Ñ > >| Ðоле | Тип | ÐÑо ÑиÑÐ°ÐµÑ | ÐÑавило | ÐÑÐ¸Ð¼ÐµÑ | >|------|-----|------------|---------|--------| >| `VERSION` | display | полÑзоваÑÐµÐ»Ñ | ÐеÑÑÐ¸Ñ + кодовое имÑ. Ðез имени ÐС. Ðез ÑÑаÑÑÑа (alpha/beta). | `11.2 (Prometheus)` | >| `VERSION_CODENAME` | machine | ÑкÑипÑÑ | Ðодовое имÑ, lowercase. | `prometheus` | >| `VARIANT` | display | UI | ÐÐ¼Ñ ÑедакÑии. Ðез имени ÐС. | `Workstation` | >| `VARIANT_ID` | machine | ÑкÑипÑÑ, пакеÑÑ | Lowercase ID ÑедакÑии. `[0-9a-z._-]`. Ðез пÑеÑикÑов. | `workstation` | >| `CPE_NAME` | machine | ÑканеÑÑ ÑÑзвимоÑÑей | CPE URI по NIST. `cpe:/o:vendor:product:version` | `cpe:/o:alt:workstation:11.2` | >| `BUILD_ID` | machine | ÑиÑÑема | ID оÑигиналÑного обÑаза. Ðе менÑеÑÑÑ Ð¿Ñи обновлениÑÑ. `VARIANT VERSION_ID`. | `Workstation 11.2` | >| `ANSI_COLOR` | display | ÑеÑминал | Ðод ÑвеÑа Ð´Ð»Ñ ESC-поÑледоваÑелÑноÑÑи. | `1;33` | >| `LOGO` | display | DE, Tuner OS Info | ÐÐ¼Ñ Ð¸ÐºÐ¾Ð½ÐºÐ¸ по freedesktop Icon Theme Specification. | `alt-distro-logo` | > >### URL-Ð¿Ð¾Ð»Ñ > >| Ðоле | ÐÑавило | ÐÑÐ¸Ð¼ÐµÑ | >|------|---------|--------| >| `HOME_URL` | ÐомаÑнÑÑ ÑÑÑаниÑа пÑоекÑа | `https://basealt.ru/` | >| `BUG_REPORT_URL` | Ðаг-ÑÑÐµÐºÐµÑ | `https://bugs.altlinux.org/` | >| `DOCUMENTATION_URL` | ÐокÑменÑаÑÐ¸Ñ | `https://docs.altlinux.org/` | >| `SUPPORT_URL` | ÐоддеÑжка | `https://support.basealt.ru/` | > >### ÐÐ¾Ð»Ñ Ð¿Ð¾Ð´ вопÑоÑом > >| Ðоле | Тип | ÐÑавило | ÐÑÐ¸Ð¼ÐµÑ | СÑаÑÑÑ | >|------|-----|---------|--------|--------| >| `ALT_BRANCH_ID` | machine | ÐеÑка ÑепозиÑоÑÐ¸Ñ ÑбоÑки branding-пакеÑа. Ðз `%_priority_distbranch`. | `p11` | ТÑебÑÐµÑ Ð¾Ð±ÑÑÐ¶Ð´ÐµÐ½Ð¸Ñ | >| `ID_LIKE` | machine | ID ÑодÑÑвеннÑÑ ÐС ÑеÑез пÑобел. ÐÐ»Ñ fallback в ansible, cloud-init и Ñ.д. | `rhel fedora` | ТÑебÑÐµÑ Ð¾Ð±ÑÑÐ¶Ð´ÐµÐ½Ð¸Ñ | > >--- > >## ФоÑмÑÐ»Ñ ÑбоÑки полей > >``` >NAME = "ALT" (конÑÑанÑа) >VERSION = VERSION_ID + " (" + VERSION_CODENAME + ")" >PRETTY_NAME = NAME + " " + VARIANT + " " + VERSION >BUILD_ID = VARIANT + " " + VERSION_ID >CPE_NAME = "cpe:/o:alt:" + VARIANT_ID + ":" + VERSION_ID >``` > >--- > >## УнивеÑÑалÑнÑй Ñаблон на макÑоÑÐ°Ñ > >```ini >NAME=ALT >VERSION="@VERSION@ (@VERSION_CODENAME@)" >ID=altlinux >VERSION_ID=@VERSION@ >VERSION_CODENAME=@VERSION_CODENAME_LC@ >PRETTY_NAME="ALT @VARIANT@ @VERSION@ (@VERSION_CODENAME@)" >ANSI_COLOR="1;33" >CPE_NAME="cpe:/o:alt:@VARIANT_ID@:@VERSION@" >BUILD_ID="@VARIANT@ @VERSION@" >HOME_URL="https://basealt.ru/" >BUG_REPORT_URL="https://bugs.altlinux.org/" >DOCUMENTATION_URL="https://docs.altlinux.org/" >SUPPORT_URL="https://support.basealt.ru/" >VARIANT="@VARIANT@" >VARIANT_ID=@VARIANT_ID@ >LOGO=alt-distro-logo ># ÐÐ¾Ð»Ñ Ð½Ð¸Ð¶Ðµ â под вопÑоÑом, Ñм. Ñаздел «Ðод вопÑоÑом?» ># ALT_BRANCH_ID=@BRANCH@ ># ID_LIKE="rhel fedora" >``` > >### ТаблиÑа макÑоÑов > >| ÐакÑÐ¾Ñ | ÐпиÑание | Workstation | Simply Linux | Server | Education | Sisyphus | >|--------|----------|-------------|-------------|--------|-----------|----------| >| `@VERSION@` | ÐажоÑ.Ð¼Ð¸Ð½Ð¾Ñ | `11.2` | `11.0` | `11.0` | `11.0` | â | >| `@VERSION_CODENAME@` | Ðодовое Ð¸Ð¼Ñ (display) | `Prometheus` | `Giuseppe` | `Columba` | `Lycoris` | â | >| `@VERSION_CODENAME_LC@` | Ðодовое Ð¸Ð¼Ñ (lowercase) | `prometheus` | `giuseppe` | `columba` | `lycoris` | â | >| `@VARIANT@` | РедакÑÐ¸Ñ (display) | `Workstation` | `Simply Linux` | `Server` | `Education` | `Sisyphus` | >| `@VARIANT_ID@` | РедакÑÐ¸Ñ (machine) | `workstation` | `simply` | `server` | `education` | `sisyphus` | > >### ÐÑимеÑание по Sisyphus > >ÐÐ»Ñ rolling-release (Sisyphus) Ð¿Ð¾Ð»Ñ `VERSION`, `VERSION_ID` и `VERSION_CODENAME` могÑÑ Ð±ÑÑÑ Ð¾Ð¿ÑÑенÑ. Ðо ÑпеÑиÑикаÑии: *"operating system vendors may choose not to provide version information, for example to accommodate for rolling releases"*. > >```ini >NAME=ALT >ID=altlinux >PRETTY_NAME="ALT Sisyphus" >ANSI_COLOR="1;33" >CPE_NAME="cpe:/o:alt:sisyphus" >HOME_URL="https://basealt.ru/" >BUG_REPORT_URL="https://bugs.altlinux.org/" >DOCUMENTATION_URL="https://docs.altlinux.org/" >SUPPORT_URL="https://support.basealt.ru/" >VARIANT="Sisyphus" >VARIANT_ID=sisyphus >LOGO=alt-distro-logo >RELEASE_TYPE=development >``` > >`RELEASE_TYPE=development` (systemd v257+) â Ñвно ÑказÑваеÑ, ÑÑо ÑÑо неÑÑабилÑÐ½Ð°Ñ Ð²ÐµÑка. > >--- > >## СÑÑлки > >- [os-release(5) â freedesktop.org](https://www.freedesktop.org/software/systemd/man/latest/os-release.html) â ÑпеÑиÑикаÑÐ¸Ñ >- [CPE Specification â NIST](https://csrc.nist.gov/projects/security-content-automation-protocol/specifications/cpe/) â ÑоÑÐ¼Ð°Ñ CPE_NAME >- [Bug #45743 â ALT Bugzilla](https://bugzilla.altlinux.org/show_bug.cgi?id=45743) â обÑÑждение ÑниÑикаÑии os-release
You cannot view the attachment while viewing its details because your browser does not support IFRAMEs.
View the attachment on a separate page
.
View Attachment As Raw
Actions:
View
Attachments on
bug 45743
:
18527
|
18542
|
18939
| 21133