.\" Copyright (c) 1993 Michael Haardt (michael@moria.de), .\" Fri Apr 2 11:32:09 MET DST 1993 .\" and Andries Brouwer (aeb@cwi.nl), Fri Feb 14 21:47:50 1997. .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sun Jul 25 10:45:30 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Sun Jul 21 21:25:26 1996 by Andries Brouwer (aeb@cwi.nl) .\" Modified Mon Oct 21 17:47:19 1996 by Eric S. Raymond (esr@thyrsus.com) .\" Modified Wed Aug 27 20:28:58 1997 by Nicolás Lichtmaier (nick@debian.org) .\" Modified Mon Sep 21 00:00:26 1998 by Andries Brouwer (aeb@cwi.nl) .\" Modified Wed Jan 24 06:37:24 2001 by Eric S. Raymond (esr@thyrsus.com) .\" Modified Thu Dec 13 23:53:27 2001 by Martin Schulze .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH environ 7 2024\-06\-15 "Linux 手冊頁 6.9.1" .SH 名稱 environ \- 使用者環境 .SH 概述 .nf \fBextern char **\fP\fIenviron\fP\fB;\fP .fi .SH 描述 變數 \fIenviron\fP 指向一個儲存指標的陣列，這些指標指向被稱為“環境（environment）”的字串。陣列中最後一個指標的值為 NULL。該字串陣列在新程式啟動時被 \fBexecve\fP(2) 呼叫提供給程序。當子程序被 \fBfork\fP(2) 建立時，它繼承其父程序環境的一份\fI副本\fP。 .P 習慣上約定在 \fIenviron\fP 中的字串有類似“\fI名稱\fP\fB=\fP\fI值\fP”的形式。其中的名稱是大小寫敏感的，且不能包含字元“\fB=\fP”。其中的值可以為任何字串可以表示的文字。名稱和值不能包含內嵌的空位元組字元（\[aq]\[rs]0\[aq]），以此避免其被誤認為字串終止位置。 .P 環境變數可由 \fBsh\fP(1) 中的 \fIexport\fP 命令在 shell 的環境中被設定，或者在使用 \fBcsh\fP(1) 時使用 \fIsetenv\fP 命令。 .P 對 shell 來說，其初始的環境相關變數可經由多種方式被填充，如在使用了 \fBpam\fP(8) 的系統上，\fBpam_env\fP(8) 會對所有使用者在登入時啟用 \fI/etc/environment\fP 中的定義。除此之外，許多 shell 初始化指令碼，如系統層級的 \fI/etc/profile\fP 指令碼和各個使用者的初始化指令碼，可能包含一些會向 shell 的環境中新增變數的命令；請參考您使用的 shell 的手冊頁瞭解詳細資訊。 .P Bourne 風格的 shell 支援下面的語法 .P .in +4n .EX 名稱=值 命令 .EE .in .P 它可被用來僅在執行 \fI命令\fP 時建立對應的環境變數定義。在 \fI命令\fP 之前，可以存在多個變數定義，其間使用空格進行分隔。 .P 引數還可以在呼叫 \fBexec\fP(3)時被放置於環境之中。C 程式可以使用諸如 \fBgetenv\fP(3), \fBputenv\fP(3), \fBsetenv\fP(3) 和 \fBunsetenv\fP(3) 的函式操縱其環境。 .P 本文的下述部分列出了系統上常見的環境變數。這個列表並不完整，且僅包含普通使用者在日常使用中常見的變數。特定程式或軟體庫函式所使用的環境變數通常會在其對應的手冊頁中的“環境”一節中進行描述。 .TP \fBUSER\fP 已登入使用者的名稱（被某些 BSD 衍生的程式所使用）。其在登入時被設定，請見下文的備註一節。 .TP \fBLOGNAME\fP 已登入使用者的名稱（被某些 System\-V 衍生的程式所使用）。其在登入時被設定，請見下文的備註一節。 .TP \fBHOME\fP 使用者登入時的目錄。其在登入時被設定，請見下文的備註一節。 .TP \fBLANG\fP 用於語言和區域設定類別的名稱，它在未被 \fBLC_ALL\fP 或更具體的環境變數，如 \fBLC_COLLATE\fP, \fBLC_CTYPE\fP, \fBLC_MESSAGES\fP, \fBLC_MONETARY\fP, \fBLC_NUMERIC\fP 和 \fBLC_TIME\fP 所覆蓋時生效（請參見 \fBlocale\fP(7) 以瞭解 \fBLC_*\fP 環境變數的具體細節）。 .TP \fBPATH\fP 它是一系列目錄字首，可被 \fBsh\fP(1) 和許多其他程式所使用以搜尋由簡單的檔名（即不含有斜線的路徑名）所指定的可執行檔案。各個字首之間被冒號（\fB:\fP）所分隔。整個字首列表會被從前到後進行搜尋，程式會檢查給定路徑名在附加字首、斜線和檔名之後的路徑是否存在，直到找到一個符合條件的可執行檔案為止。 .IP 還存在一個遺留的特性：如果字首長度為零（即由兩個相鄰的冒號組成，或者有起始或終止位置的冒號存在），該字首會被解釋為指定當前工作目錄。然而，當前已不推薦使用該特性，且 POSIX 認為一個符合標準的應用程式應當使用顯式的路徑名（如 \fI.\fP）來指定當前工作目錄。 .IP 類似 \fBPATH\fP，還存在 \fBCDPATH\fP 會被某些 shell 用來尋找更改目錄指令的目標目錄，以及被 \fBman\fP(1) 所使用尋找手冊頁的 \fBMANPATH\fP，等等。 .TP \fBPWD\fP 當前工作目錄的絕對路徑。它的組成部分必須被規範化（即不可出現 \fI.\&\fP 或 \fI..\&\fP 的路徑部分）。 .TP \fBSHELL\fP 使用者登入 shell 的絕對路徑名。其在登入時被設定，請見下文的備註一節。 .TP \fBTERM\fP 輸出應當相容的終端型別。 .TP \fBPAGER\fP 使用者偏好的顯示文字檔案的實用工具。可被設定為任何 \fIsh\ \-c\fP 命令可接受的命令字串運算子。如果 \fBPAGER\fP 的值為空或未被設定，則啟動分頁器的應用程式會預設選擇一個程式，如 \fBless\fP(1) 或 \fBmore\fP(1)。 .TP \fBEDITOR\fP/\fBVISUAL\fP .\" .TP .\" .B BROWSER .\" The user's preferred utility to browse URLs. Sequence of colon-separated .\" browser commands. See http://www.catb.org/\[ti]esr/BROWSER/ . 使用者偏好使用的編輯文字檔案的工具。可被設定為任何 \fIsh\ \-c\fP 命令可接受的命令字串運算子。 .P 請注意，許多程式和軟體庫例程的行為都會受到特定環境變數存在與否及其取值的影響。下面給出一些例子： .IP \[bu] 3 \fBLANG\fP, \fBLANGUAGE\fP, \fBNLSPATH\fP, \fBLOCPATH\fP, \fBLC_ALL\fP, \fBLC_MESSAGES\fP 等等變數會影響語言和區域設定的處理；請參見 \fBcatopen\fP(3), \fBgettext\fP(3) 和 \fBlocale\fP(7)。 .IP \[bu] \fBTMPDIR\fP 影響由 \fBtempnam\fP(3) 和其他例程建立的路徑名稱的字首，以及由 \fBsort\fP(1) 和其他程式所使用的臨時目錄名。 .IP \[bu] \fBLD_LIBRARY_PATH\fP, \fBLD_PRELOAD\fP 和其他 \fBLD_*\fP 變數會影響動態載入器/連結器的行為。請參見 \fBld.so\fP(8)。 .IP \[bu] \fBPOSIXLY_CORRECT\fP 使得特定的程式和軟體庫例程遵循 POSIX 所指定的行為。 .IP \[bu] \fBmalloc\fP(3) 的行為受到 \fBMALLOC_*\fP 變數的影響。 .IP \[bu] \fBHOSTALIASES\fP 變數給出包含 \fBgethostbyname\fP(3) 將要使用的主機別名的檔案的名稱。 .IP \[bu] \fBTZ\fP 和 \fBTZDIR\fP 給出 \fBtzset\fP(3) 所使用的時區資訊，並涉及諸如 \fBctime\fP(3), \fBlocaltime\fP(3), \fBmktime\fP(3), \fBstrftime\fP(3) 等函式。另請參見 \fBtzselect\fP(8)。 .IP \[bu] \fBTERMCAP\fP 提供如何處理給定終端的相關資訊（或者給出包含這些資訊的檔案的檔名） .IP \[bu] \fBCOLUMNS\fP 和 \fBLINES\fP 會告知應用程式視窗大小資訊，它可能會覆蓋實際大小的配置。 .IP \[bu] \fBPRINTER\fP 或 \fBLPDEST\fP 可能指定要使用的印表機。請見 \fBlpr\fP(1)。 .SH 備註 歷史上以及標準上，\fIenviron\fP 必須被使用者程式所宣告。然而，一個現存的不標準的方便程式設計師工作的方法是將 \fIenviron\fP 宣告在 \fI\fP 標頭檔案中，前提是 \fB_GNU_SOURCE\fP 功能測試宏已被定義（參見 \fBfeature_test_macros\fP(7)）。 .P \fBprctl\fP(2) 中的 \fBPR_SET_MM_ENV_START\fP 和 \fBPR_SET_MM_ENV_END\fP 操作可被用來控制程序環境的位置。 .P \fBHOME\fP, \fBLOGNAME\fP, \fBSHELL\fP 和 \fBUSER\fP 變數會在使用者經由會話管理介面被變更時被設定。者通常是經由類似 \fBlogin\fP(1) 的程式以及使用者資料庫（例如 \fBpasswd\fP(5)）所完成的。（使用 \fBsu\fP(1) 切換到 root 使用者可能導致混合的環境變數，其中 \fBLOGNAME\fP 和 \fBUSER\fP 被保留為舊有使用者的值；參見 \fBsu\fP(1) 手冊頁。） .SH 缺陷 很顯然，這個機制有安全風險。許多系統命令可被使用者指定的不同尋常的 \fBIFS\fP 或 \fBLD_LIBRARY_PATH\fP 的值所欺騙。 .P 還存在名稱空間汙染的風險。如 \fImake\fP 和 \fIautoconf\fP 等程式允許環境中具有和實用工具相同命名（但全大寫）的變數覆蓋預設所使用的工具路徑。因此，使用者可以使用 \fBCC\fP 來選擇想要使用的 C 編譯器（類似地，還有 \fBMAKE\fP, \fBAR\fP, \fBAS\fP, \fBFC\fP, \fBLD\fP, \fBLEX\fP, \fBRM\fP, \fBYACC\fP 等等）。然而，在某些傳統的使用場景中這些環境變數還會被賦值為程式選項而非路徑名，例如 \fBMORE\fP 和 \fBLESS\fP。這些用法被認為是錯誤的，應當在新程式中避免。 .SH 參見 \fBbash\fP(1), \fBcsh\fP(1), \fBenv\fP(1), \fBlogin\fP(1), \fBprintenv\fP(1), \fBsh\fP(1), \fBsu\fP(1), \fBtcsh\fP(1), \fBexecve\fP(2), \fBclearenv\fP(3), \fBexec\fP(3), \fBgetenv\fP(3), \fBputenv\fP(3), \fBsetenv\fP(3), \fBunsetenv\fP(3), \fBlocale\fP(7), \fBld.so\fP(8), \fBpam_env\fP(8) .SH "跋" .br 本頁面中文版由中文 man 手冊頁計劃提供。 .br 中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR