命令參考大全，卷 6，v - z
xauth 命令
用途
編輯和顯示用于連接 X 服務(wù)器的授權信息。
語(yǔ)法
xauth [ -f AuthFile ] [ -v | -q ] [ -i ] [ -b ] [ CommandArgument ... ]
描述
xauth 命令通常用于編輯和顯示用于連接 X 服務(wù)器的授權信息。這個(gè)程序從一個(gè)機器抽取授權記錄并把它們合并進(jìn)另外一個(gè)里（例如，當使用遠程登錄或給其它用戶(hù)授予訪(fǎng)問(wèn)權時(shí)）。
下面的命令可以通過(guò)交互方式輸入到 xauth 命令行上或輸入到腳本中。注意：本程序不與 X 服務(wù)器保持聯(lián)系。
| add DisplayName ProtocolName Hexkey | 通過(guò)使用給定協(xié)議和鍵數據，用于指示的顯示的授權條目被添加到授權文件。數據被指定為十六進(jìn)制數字表示的偶數長(cháng)度字符串，每一對代表一個(gè)八位元。每對的第一個(gè)數字給出八位元的最重要的 4 位，該對的第二個(gè)數字給出了最不重要的 4 位。例如，一個(gè) 32 字符的十六進(jìn)制鍵代表 128 位值。僅由單一句點(diǎn)構成的協(xié)議名被看作 MIT-MAGIC-COOKIE-1 的一個(gè)縮寫(xiě)。 |
| extract FileName DisplayName... | 用于每個(gè)指定顯示的授權條目寫(xiě)入顯示的文件。抽取的條目可使用 merge 和 nmerge 命令讀回。如果文件名僅由單一的破折號構成，條目會(huì )寫(xiě)入二進(jìn)制輸出。 |
generate DisplayName ProtocolName
[trusted | untrusted] [timeout seconds]
[group group-id] [data hexdata] | 這個(gè)命令類(lèi)似于 add。主要的不同是，不是要求用戶(hù)提供鍵數據，而是它連接到 displayname 指定的服務(wù)器并使用 SECURITY 擴展來(lái)獲得鍵數據以存儲到授權文件中。如果不能聯(lián)系服務(wù)器，或如果它不支持 SECURITY 擴展，則命令失敗。否則，使用給定協(xié)議表明的顯示的授權條目被添加到授權文件。僅由單一句點(diǎn)構成的協(xié)議名被看作 MIT-MAGIC-COOKIE-1 的一個(gè)縮寫(xiě)。 如果使用可信的選項，那么使用該授權進(jìn)行連接的客戶(hù)機將會(huì )像往常一樣對顯示執行全負荷運行。如果使用不可信的選項，那么用該授權進(jìn)行連接的客戶(hù)機將被認為是不可信的，并被防止偷竊或破壞屬于可信客戶(hù)機的數據。請參閱 SECURITY 擴展規范，以獲取不可信客戶(hù)機上強制的限制的全部詳細信息。缺省值是不可信。 超時(shí)選項指定該權限將會(huì )在多長(cháng)時(shí)間（以秒記）有效。如果該權限保持為未使用（沒(méi)有客戶(hù)機同它連接）超過(guò)了這一時(shí)間周期，服務(wù)器將會(huì )清除該權限，并且將來(lái)試圖用它來(lái)連接也會(huì )失敗。注意：服務(wù)器執行的清除操作不刪除來(lái)自授權文件的授權條目。缺省超時(shí)是 60 秒。 組選項指定使用該權限進(jìn)行連接的客戶(hù)機應當屬于的應用程序組。請參閱應用程序組擴展規范以獲取更多詳細信息。缺省值不屬于一個(gè)應用程序組。 數據選項指定服務(wù)器應當用于生成該權限的數據。注意：這同寫(xiě)入授權文件的數據不同。此數據的解釋依賴(lài)于授權協(xié)議。hexdata 的格式同在 add 命令里描述的 hexkey 的格式相同。缺省值是不發(fā)送數據。 |
| list [DisplayName...] | 用于每個(gè)指定顯示（或如果都沒(méi)有被指定，則為所有顯示）的授權條目以正文格式打印到標準輸出。關(guān)鍵數據總是以 add 命令描述中給出的十六進(jìn)制格式顯示。 |
| merge [FileName...] | 從指定的文件讀取授權條目并將其合并到授權數據庫，取代任何匹配的現有的條目。如果文件名僅由單一的破折號構成，且如果以前尚未讀取二進(jìn)制輸入，則讀取二進(jìn)制輸入。 |
| [n]extract Filename DisplayName... | 用于每個(gè)指定顯示的授權條目寫(xiě)入顯示的文件。條目以一種適合于非二進(jìn)制傳輸（例如安全電子郵件）的數字格式寫(xiě)入。抽取的條目可使用 merge 和 nmerge 命令讀回。如果文件名僅由單一的破折號構成，條目會(huì )寫(xiě)入標準輸出。 |
| [n]list [DisplayName...] | 用于每個(gè)指定顯示（或如果都沒(méi)有被指定，則為所有顯示）的授權條目以 nextract 命令使用的數字格式打印到標準輸出。關(guān)鍵數據總是以 add 命令描述中給出的十六進(jìn)制格式顯示。 |
| [n]merge [FileName...] | 從指定的文件讀取授權條目并將其合并到授權數據庫，取代任何匹配的現有的條目。使用在 extract 命令的描述中給出的數字格式。如果文件名僅由單一的破折號構成，且如果以前尚未讀取標準輸入，則讀取標準輸入。 |
| remove DisplayName... | 匹配指定顯示的授權條目會(huì )從授權文件中除去。 |
| source FileName | 指定的文件作為包含 xauth 命令的腳本來(lái)執行。忽略空白行和以“#”（井字符）開(kāi)頭的行。單一破折號可用于表明標準輸入（如果尚未讀取它）。 |
| info | 無(wú)論有沒(méi)有發(fā)生任何更改，從什么位置讀取 xauth 命令，描述授權文件的信息都打印到標準輸出。 |
| exit | 如果發(fā)生任何改變，授權文件被寫(xiě)出（如果允許），并且程序退出。文件結束符作為隱式退出命令對待。 |
| quit | 程序退出，忽略任何改變。這也可以通過(guò)按中斷字符完成的。 |
| help [String] | 在標準輸出中打印以給定字符串開(kāi)頭的全部命令（或如果沒(méi)有給定字符串，則為全部命令）的描述。 |
| 在標準輸出中打印有效命令的一個(gè)簡(jiǎn)短列表。 |
add、[n]extract、[n]list、[n]merge 和 remove 命令的顯示名稱(chēng)使用同 DISPLAY 環(huán)境變量和公共 display 命令行自變量相同的格式。特定于顯示的信息（例如屏幕數）的是不必要的并且被忽略。相同機器連接（例如本地主機套接字、共享內存和網(wǎng)際協(xié)議 HostName LocalHost）引用為 HostName/unix:DisplayNumber，這樣不同機器的本地條目能存儲在一個(gè)授權文件里。
注：有不安全網(wǎng)絡(luò )的用戶(hù)應該謹慎使用加密的文件傳輸機制來(lái)在機器之間復制授權條目。類(lèi)似地，MIT-MAGIC-COOKIE-1 協(xié)議在不安全環(huán)境中不是很有用。對附加安全性感興趣的站點(diǎn)可能需要使用諸如 Kerberos 的加密授權機制。當前在協(xié)議名里不允許使用空格?？梢蕴砑右枡C制。
標志
下面的選項和 xauth 命令一起使用。它們可單獨給定（例如， -q -i）也可組合指定（例如，-qi）。
| -f AuthFile | 指定要使用的授權文件的名稱(chēng)。缺省情況下，xauth 使用 XAUTHORITY 環(huán)境變量指定的文件或用戶(hù)主目錄中的 .xauthority 文件。 |
| -v | 表明 xauth 應該詳盡地操作并打印指示不同操作（例如，有多少記錄被讀取或寫(xiě)出）結果的狀態(tài)消息。如果 xauth 從它的標準輸入讀取命令且它的標準輸出定向到終端，則這是缺省值。 |
| -q | 表明 xauth 應該安靜地運行而且不打印未經(jīng)請求的狀態(tài)消息。如果 xauth 命令在命令行上給出或如果標準輸出沒(méi)有定向到終端，則這是缺省值。 |
| -i | 表明 xauth 應該忽略任何權限文件鎖定。通常，xauth 拒絕讀或編輯任何被其它程序（通常是 xdm 或另一個(gè) xauth）鎖定的授權文件。 |
| -b | 表明 xauth 在處理之前應試圖中斷任何授權文件鎖定。這一選項僅用來(lái)清除舊的鎖定。 |
示例
xauth 命令的最常見(jiàn)運用是為當前顯示抽取目錄，把它復制到其它機器并把它合并到遠程機器上的用戶(hù)授權文件：
% xauth extract \- $DISPLAY | rsh otherhost xauth merge \-
文件
| $HOME/.Xauthority | 如果 XAUTHORITY 環(huán)境變量沒(méi)有定義，則包含缺省授權文件。 |
