SYSTEMD-MACHINE-ID-SETUP(1)

NAME
systemd-machine-id-setup - 初始化 /etc/machine-id 檔案

SYNOPSIS

systemd-machine-id-setup

描述

systemd-machine-id-setup 可被作業系統安裝程式用來初始化 /etc/machine-id 中的"machine ID"值， 可以設為一個指定值，也可以設為一個隨機生成的值。詳見 machine-id(5) 手冊。

如果沒有明確使用 --commit 選項並且 /etc/machine-id 不存在或其中的值不合格， 那麼將初始化一個新的"machined ID"。 此新"machine ID"將依次使用下列方法獲得：

    1. 如果已經存在一個有效的 D-Bus "machine ID"， 那麼就使用此 D-Bus "machine ID" 來初始化 /etc/machine-id 檔案。

    2. 如果執行在已經配置了UUID(通過 -uuid 選項)的KVM虛擬機器中， 那麼就使用此UUID來初始化 /etc/machine-id 檔案。 KVM虛擬機器的建立者 必須確保UUID的唯一性。

    3. 如果執行在已經配置了UUID的Linux容器中， 那麼就使用此UUID來初始化 /etc/machine-id 檔案。 詳見 Container Interface[1] 文件。

    4. 如果上述方法都不可用， 那麼隨機生成一個新的"machine ID"來初始化 /etc/machine-id 檔案。

可以使用 --commit 選項將新生成的臨時"machine ID"寫入到磁碟中永久儲存。 詳見下文。

可以使用 systemd-firstboot(1) 初始化已掛載(但未啟動)的系統映象的"machine ID"。

選項

能夠識別的命令列選項如下：

--root=root
    指定一個"根目錄"， 包括配置檔案在內的所有路徑都將加上 root 字首，包括 /etc/machine-id 自身。

--commit
    將生成的臨時"machine ID"寫入到磁碟中永久儲存。 所謂"臨時"的意思是指在 系統啟動的早期繫結掛載的 "tmpfs" 檔案系統中的 /etc/machine-id 檔案。 這可能是由於在系統啟動的早期， /etc 依然處於只讀狀態 並且其中並不包含合格的 /etc/machine-id 檔案。

    如果 /etc/machine-id 未被繫結掛載到 "tmpfs" 檔案系統， 或者 /etc 處於只讀狀態， 那麼此選項將不執行任何操作。 否則，此命令將會把臨時生成的"machine ID"寫入到磁碟中， 然後解除安裝 /etc/machine-id 所在的檔案系統， 以確保"machine ID"確實被永久儲存。

    此選項主要被系統啟動早期的 systemd-machine-id-commit.service(8) 使用。

--print
    操作完成之後打印出"machine ID"的值

-h, --help
    顯示簡短的幫助資訊並退出。

--version
    顯示簡短的版本資訊並退出。

退出狀態

返回值為 0 表示成功， 非零返回值表示失敗程式碼。

參見

systemd(1), machine-id(5), systemd-machine-id-commit.service(8), dbus-uuidgen(1), systemd-firstboot(1)

NOTES

1.  Container Interface
    http://www.freedesktop.org/wiki/Software/systemd/ContainerInterface

跋
本頁面中文版由中文 man 手冊頁計劃提供。

翻譯人員：金步國
金步國作品集：http://www.jinbuguo.com
中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh