.\" 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