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