/etc/os-release
/usr/lib/os-release
描述
/etc/os-release 與 /usr/lib/os-release
文件包含了操作系統識別數據。
os-release
文件的基本格式是
一系列換行符分隔的
VAR=VALUE 行(每行一個變量),
可以直接嵌入到 shell
腳本中使用。
注意,此文件並不支持變量替換之類的任何高級
shell 特性,
以便於應用程序無須支持這些高級
shell 特性,
即可直接使用此文件。
如果 VALUE
值中包含任何非字母數字字符(也就是
A–Z, a–z, 0–9
之外的字符),
那麼必須使用引號(單雙皆可)界定,
並且任何在Shell中具有特殊含義的字符,
包括:美元符,
單雙引號, 反斜線,
反引號 ...
等等,都必須使用shell風格的反斜線進行轉義。
所有字符串都必須使用UTF-8編碼,
並且禁止使用一切非打印字符。
以"#"開頭的行將被作爲註釋忽略。
應用程序應該只讀取
/etc/os-release 文件, 僅在 /etc/os-release
不存在的情況下,
纔可以讀取 /usr/lib/os-release
文件。
絕對禁止應用程序同時讀取兩個文件。
操作系統發行商應該將操作系統識別數據存放在
/usr/lib/os-release 文件中,
同時將 /etc/os-release
作爲一個軟連接,
以相對路徑的方式指向
/usr/lib/os-release 文件,
以提供應用程序讀取
/etc 的兼容性。
軟連接使用相對路徑是爲了避免在
chroot 或 initrd 環境中失效。
os-release
的內容應當僅由發行版的供應商設置,
系統管理員一般不應該修改此文件。
因爲此文件僅用於操作系統識別,
所以必須禁止包含任何需要本地化的內容(也就是禁止包含非ASCII字符)。
/etc/os-release 與 /usr/lib/os-release
可以是軟連接,
但是必須全部位於根文件系統上,
以確保在系統剛啓動時即可讀取其內容。
更多有關 os-release
的理解, 請參閱 Announcement of
/etc/os-release[1]
選項
可以在 os-release
中使用下列操作系統識別字段:
NAME=
不帶版本號且適合人類閱讀的操作系統名稱。這是必填字段。例如:
"NAME=Fedora" 或 "NAME="Debian GNU/Linux""
。 默認值是 "NAME=Linux"
。
VERSION=
操作系統的版本號。
禁止包含操作系統名稱,但是可以包含適合人類閱讀的發行代號。
這是可選字段。
例如: "VERSION=17" 或
"VERSION="17 (Beefy Miracle)""
ID=
小寫字母表示的操作系統名稱,
禁止包含 0–9, a–z, ".",
"_", "-"
以外的字符,禁止包含任何版本信息。
該字段適合被程序或腳本解析,也可用於生成文件名。
這是必填字段。例如:
"ID=fedora" 或 "ID=debian" 。
默認值是 "ID=linux" 。
ID_LIKE=
一系列空格分隔的字符串,
其中的每一項都符合
ID= 字段的規範,
也就是僅包含 0–9, a–z,
".", "_", "-" 字符。
此字段用於表明當前的操作系統
是從哪些"父發行版"派生而來,
切勿列出從此發行版派生的"子發行版",
排列順序由近到遠,
關係最近的發行版名稱排在最前,
緊密度依次遞減。
應用程序如果不能識別
ID= 字段的內容,
那麼可以參考此字段。
這是可選字段。
比如對於 "ID=centos"來說,
"ID_LIKE="rhel fedora""
就是一個合理的設置。
而對於 "ID=ubuntu" 來說,
"ID_LIKE=debian" 也很合理。
VERSION_CODENAME=
小寫字母表示的操作系統發行代號,
禁止包含 0–9, a–z, ".",
"_", "-" 以外的字符,
禁止包含任何版本信息以及操作系統名稱。
該字段適合被程序或腳本解析,
也可用於生成文件名。
這是可選字段,
並且某些發行版可能不存在此字段。例如:
"VERSION_CODENAME=buster", "VERSION_CODENAME=xenial"
VERSION_ID=
小寫字母表示的操作系統版本號,
禁止包含 0–9, a–z, ".",
"_", "-" 以外的字符,
禁止包含操作系統名稱與發行代號。
該字段適合被程序或腳本解析,
也可用於生成文件名。
這是可選字段。例如:
"VERSION_ID=17" 或 "VERSION_ID=11.04"
PRETTY_NAME=
適合人類閱讀的比較恰當的發行版名稱,
可選的包含發行代號與系統版本之類的信息,內容比較隨意。
這是必填字段。
例如: "PRETTY_NAME="Fedora 17 (Beefy
Miracle)"" 。 默認值是
"PRETTY_NAME="Linux"" 。
ANSI_COLOR=
在控制檯上顯示操作系統名稱的文字顏色。
必須設爲符合 ESC [ m ANSI/ECMA-48
轉義代碼規範的字符串。
這是可選字段。
例如:
"ANSI_COLOR="0;31""(紅色) 或
"ANSI_COLOR="1;34""(淡藍)
CPE_NAME=
操作系統的"CPE名稱"(URI綁定語法),
詳見 Common Platform Enumeration Specification[2]
文檔。
這是可選字段。例如:
"CPE_NAME="cpe:/o:fedoraproject:fedora:17""
HOME_URL=, SUPPORT_URL=, BUG_REPORT_URL=,
PRIVACY_POLICY_URL=
與操作系統相關的互聯網地址。
HOME_URL=
操作系統的主頁地址,
或者特定於此版本操作系統的頁面地址。
SUPPORT_URL=
操作系統的支持頁面(若存在),
主要用於發行商提供技術支持的頁面。
BUG_REPORT_URL=
故障彙報頁面(若存在),
主要用於基於社區互動的發行版。
PRIVACY_POLICY_URL=
隱私條款頁面(若存在)。
上述URL應該分別出現在"About
this system"界面下的 "About this Operating
System", "Obtain Support", "Report a Bug",
"Privacy Policy" 子界面中。
這些字段的值必須符合
RFC3986[3] 規範, 通常以
"http:" 或 "https:" 開頭,
但也可能以 "mailto:" 或
"tel:" 開頭。 例如:
"HOME_URL="https://fedoraproject.org/"" 與
"BUG_REPORT_URL="https://bugzilla.redhat.com/""
BUILD_ID=
用於區分同一版本操作系統的不同編譯次序的唯一標示符(不會被系統更新所修改)。
該字段在不同的 VERSION_ID
之間有可能是相同的,
因爲 BUILD_ID
僅在同一版本號內部保持唯一。
每當發佈新版本的操作系統時,
只需要更新 VERSION_ID
字段即可,並不一定必須更新
BUILD_ID 字段。
這是可選字段。
例如: "BUILD_ID="2013-03-20.3""
或 "BUILD_ID=201303203"
VARIANT=
適合人類閱讀的發行版分支標識符。
用於向用戶表明
此係統的默認配置是專門面向特定應用場景的。
這是可選字段,
並且某些發行版可能不存在此字段。
例如: "VARIANT="Server Edition"",
"VARIANT="Smart Refrigerator Edition""
注意,此字段僅用於顯示目的,
程序應該使用 VARIANT_ID
字段進行可靠的判斷。
VARIANT_ID=
小寫字母表示的發行版分支標識符,
禁止包含 0–9, a–z, ".",
"_", "-" 以外的字符。
該字段適合被程序或腳本解析,
也可用於生成文件名。
這是可選字段,
並且某些發行版可能不存在此字段。
例如: "VARIANT_ID=server",
"VARIANT_ID=embedded"
如果要在程序中檢測發行版名稱及其變種,
那麼可以使用 ID 與
VERSION_ID 字段, 並將 ID_LIKE
用作 ID 的替補。
如果想要向用戶顯示發行版的名稱,
那麼可以使用 PRETTY_NAME
字段。
注意,
滾動發佈的發行版可能不會提供版本信息,
也就程序不能假定
VERSION 與 VERSION_ID
字段必然存在。
操作系統的發行商可能爲此文件引入新的字段,
強烈建議爲新引入的字段使用特別的前綴以避免衝突。
讀取此文件的程序應該能夠安全的忽略不理解的字段。
例如:
"DEBIAN_BTS="debbugs://bugs.debian.org/""
例子
NAME=Fedora
VERSION="24 (Workstation Edition)"
ID=fedora
VERSION_ID=24
PRETTY_NAME="Fedora 24 (Workstation Edition)"
ANSI_COLOR="0;34"
CPE_NAME="cpe:/o:fedoraproject:fedora:24"
HOME_URL="https://fedoraproject.org/"
BUG_REPORT_URL="https://bugzilla.redhat.com/"
REDHAT_BUGZILLA_PRODUCT="Fedora"
REDHAT_BUGZILLA_PRODUCT_VERSION=24
REDHAT_SUPPORT_PRODUCT="Fedora"
REDHAT_SUPPORT_PRODUCT_VERSION=24
PRIVACY_POLICY_URL=https://fedoraproject.org/wiki/Legal:PrivacyPolicy
VARIANT="Workstation Edition"
VARIANT_ID=workstation
- 1.
- Announcement of /etc/os-release
http://0pointer.de/blog/projects/os-release
- 2.
- Common Platform Enumeration Specification
http://scap.nist.gov/specifications/cpe/
- 3.
- RFC3986
https://tools.ietf.org/html/rfc3986
跋
本頁面中文版由中文
man 手冊頁計劃提供。
翻譯人員:金步國
金步國作品集:http://www.jinbuguo.com
中文 man
手冊頁計劃:https://github.com/man-pages-zh/manpages-zh