Man page - environ(7)
Packages contas this manual
- pts(4)
- initrd(4)
- bootparam(7)
- proc_driver(5)
- udp(7)
- proc_pid_numa_maps(5)
- standards(7)
- epoll(7)
- proc(5)
- proc_net(5)
- urandom(4)
- proc_pid_fdinfo(5)
- mailaddr(7)
- iso-8859-5(7)
- iso_8859-6(7)
- iconv(1)
- full(4)
- user-keyring(7)
- intro(5)
- ftm(7)
- shm_overview(7)
- feature_test_macros(7)
- proc_crypto(5)
- tzfile(5)
- aio(7)
- boot(7)
- proc_profile(5)
- proc_cgroups(5)
- cpuset(7)
- proc_pid_coredump_filter(5)
- proc_pid_cwd(5)
- proc_uptime(5)
- st(4)
- precedence(7)
- ddp(7)
- proc_zoneinfo(5)
- iso_8859_3(7)
- proc_pid_root(5)
- latin4(7)
- proc_tid_children(5)
- proc_pid_oom_adj(5)
- proc_mounts(5)
- iso_8859-14(7)
- ld-linux(8)
- capabilities(7)
- ptmx(4)
- mouse(4)
- sysfs(5)
- rtld-audit(7)
- proc_partitions(5)
- iso_8859_6(7)
- queue(7)
- proc_pid_pagemap(5)
- proc_pid_stack(5)
- proc_pid_mem(5)
- uri(7)
- ttytype(5)
- namespaces(7)
- proc_sys_user(5)
- latin5(7)
- procfs(5)
- charmap(5)
- proc_sys_kernel(5)
- getent(1)
- ip(7)
- iso_8859-5(7)
- queue(3)
- proc_sys_vm(5)
- random(7)
- iso-8859-10(7)
- process-keyring(7)
- protocols(5)
- system_data_types(7)
- operator(7)
- proc_pid_timerslack_ns(5)
- wtmp(5)
- iso_8859_15(7)
- cp1252(7)
- iso_8859_11(7)
- pkeys(7)
- kmem(4)
- proc_pid_clear_refs(5)
- proc_meminfo(5)
- latin8(7)
- zdump(8)
- fuse(4)
- utf-8(7)
- proc_kpagecount(5)
- futex(7)
- complex(7)
- iso_8859-13(7)
- proc_kcore(5)
- iso_8859-8(7)
- iso_8859_14(7)
- iconvconfig(8)
- network_namespaces(7)
- thread-keyring(7)
- locale(5)
- proc_pid_oom_score_adj(5)
- proc_pid_statm(5)
- signal-safety(7)
- units(7)
- re_format(7)
- proc_pid_comm(5)
- latin1(7)
- glibc(7)
- environ(7)
- iso_8859-9(7)
- tty(4)
- proc_pid_projid_map(5)
- urn(7)
- iso_8859_8(7)
- proc_loadavg(5)
- ipc_namespaces(7)
- proc_pid_syscall(5)
- proc_pid_cgroup(5)
- proc_pid_mountstats(5)
- proc_kpageflags(5)
- utmpx(5)
- termio(7)
- iso-8859-13(7)
- suffixes(7)
- iso_8859-16(7)
- intro(1)
- hostname(7)
- proc_pid_status(5)
- proc_pid_fd(5)
- proc_malloc(5)
- proc_sys_debug(5)
- proc_pid_mounts(5)
- console_codes(4)
- iso_8859_2(7)
- iso-8859-16(7)
- proc_thread-self(5)
- socket(7)
- sock_diag(7)
- null(4)
- raw(7)
- memusagestat(1)
- proc_pid_mountinfo(5)
- proc_sys_sunrpc(5)
- iso-8859-1(7)
- motd(5)
- iso_8859-7(7)
- utmp(5)
- proc_pid_auxv(5)
- latin2(7)
- intro(2)
- proc_modules(5)
- user_namespaces(7)
- iso-8859-2(7)
- proc_version(5)
- ldd(1)
- iso_8859-3(7)
- proc_diskstats(5)
- session-keyring(7)
- ascii(7)
- hosts.equiv(5)
- group(5)
- intro(4)
- proc_cmdline(5)
- resolver(5)
- time(7)
- packet(7)
- proc_kpagecgroup(5)
- hosts(5)
- proc_pid_maps(5)
- proc_tty(5)
- inotify(7)
- msr(4)
- tzselect(8)
- proc_locks(5)
- hpsa(4)
- mount_namespaces(7)
- cgroups(7)
- fanotify(7)
- latin7(7)
- intro(6)
- proc_slabinfo(5)
- proc_timer_list(5)
- proc_kallsyms(5)
- mq_overview(7)
- proc_buddyinfo(5)
- iso_8859-15(7)
- proc_pid_wchan(5)
- iso-8859-8(7)
- proc_stat(5)
- attributes(7)
- proc_bus(5)
- sln(8)
- iso_8859_4(7)
- cgroup_namespaces(7)
- symlink(7)
- fifo(7)
- proc_keys(5)
- locale(1)
- proc_devices(5)
- inode(7)
- iso_8859_13(7)
- nptl(7)
- svipc(7)
- proc_sys_proc(5)
- xattr(7)
- proc_key-users(5)
- iso_8859_10(7)
- erofs(5)
- sd(4)
- proc_ide(5)
- proc_dma(5)
- proc_pid_environ(5)
- utf8(7)
- proc_pid_seccomp(5)
- tcp(7)
- localedef(1)
- path_resolution(7)
- proc_kmsg(5)
- regex(7)
- unix(7)
- netdevice(7)
- host.conf(5)
- nss(5)
- proc_pid_io(5)
- issue(5)
- iso_8859-10(7)
- pipe(7)
- nologin(5)
- vcs(4)
- proc_mtrr(5)
- networks(5)
- resolv.conf(5)
- pldd(1)
- koi8-r(7)
- arp(7)
- ld.so(8)
- wavelan(4)
- proc_pid_uid_map(5)
- zero(4)
- iso-8859-7(7)
- memusage(1)
- iso-8859-6(7)
- latin6(7)
- user-session-keyring(7)
- armscii-8(7)
- shells(5)
- cp1251(7)
- rtnetlink(7)
- koi8-u(7)
- address_families(7)
- cpuid(4)
- core(5)
- pty(7)
- tis-620(7)
- iso_8859-1(7)
- math_error(7)
- iso_8859-4(7)
- proc_pid_autogroup(5)
- man(7)
- cciss(4)
- icmp(7)
- sprof(1)
- glob(7)
- iso-8859-9(7)
- proc_sys_dev(5)
- url(7)
- zic(8)
- sched(7)
- services(5)
- proc_pid(5)
- securetty(5)
- acct(5)
- loop(4)
- vcsa(4)
- iso_8859-2(7)
- proc_vmstat(5)
- pthreads(7)
- proc_timer_stats(5)
- uts_namespaces(7)
- elf(5)
- libc(7)
- proc_sysrq-trigger(5)
- credentials(7)
- proc_sys_net(5)
- numa(7)
- bpf-helpers(7)
- netlink(7)
- proc_pid_personality(5)
- iso_8859-11(7)
- mem(4)
- proc_apm(5)
- proc_pid_task(5)
- proc_cpuinfo(5)
- iso_8859_7(7)
- random(4)
- proc_sys_fs(5)
- proc_pid_ns(5)
- proc_filesystems(5)
- slabinfo(5)
- proc_sys_abi(5)
- latin9(7)
- proc_pid_stat(5)
- proc_execdomains(5)
- proc_swaps(5)
- keyrings(7)
- proc_ioports(5)
- iso_8859_1(7)
- hd(4)
- proc_self(5)
- landlock(7)
- proc_interrupts(5)
- port(4)
- proc_pid_cpuset(5)
- vdso(7)
- iso_8859_5(7)
- intro(7)
- mtrace(1)
- latin3(7)
- proc_sys(5)
- repertoiremap(5)
- lirc(4)
- filesystems(5)
- proc_ksyms(5)
- unicode(7)
- iso_8859_9(7)
- man-pages(7)
- pid_namespaces(7)
- proc_pid_attr(5)
- proc_sysvipc(5)
- intro(3)
- spufs(7)
- proc_config.gz(5)
- sem_overview(7)
- ldconfig(8)
- loop-control(4)
- iso-8859-4(7)
- proc_pid_timers(5)
- smartpqi(4)
- posixoptions(7)
- nsswitch.conf(5)
- proc_pid_map_files(5)
- time_namespaces(7)
- string_copying(7)
- iso-8859-11(7)
- proc_pid_gid_map(5)
- latin10(7)
- proc_pid_setgroups(5)
- ld-linux.so(8)
- ram(4)
- iso-8859-3(7)
- intro(8)
- proc_fb(5)
- vsock(7)
- termcap(5)
- fs(5)
- proc_iomem(5)
- iso-8859-15(7)
- signal(7)
- persistent-keyring(7)
- rtc(4)
- dsp56k(4)
- proc_pid_net(5)
- rpc(5)
- lp(4)
- veth(4)
- hier(7)
- kernel_lockdown(7)
- iso-8859-14(7)
- dir_colors(5)
- proc_scsi(5)
- proc_pid_cmdline(5)
- proc_fs(5)
- x25(7)
- proc_tid(5)
- proc_pid_smaps(5)
- proc_pid_limits(5)
- proc_pid_oom_score(5)
- locale(7)
- proc_pci(5)
- charsets(7)
- iso_8859_16(7)
- ipv6(7)
- tmpfs(5)
- proc_pid_exe(5)
- sysvipc(7)
- udplite(7)
- gai.conf(5)
apt-get install manpages
Available languages:
en fr it pl ja ro zh_TW zh_CN deManual
| environ(7) | Miscellaneous Information Manual | environ(7) |
名称
environ - 用户环境
概述
extern char **environ;
描述
变量 environ 指向一个存储指针的数组,这些指针指向被称为“环境(environment)”的字符串。数组中最后一个指针的值为 NULL。该字符串数组在新程序启动时被 execve(2) 调用提供给进程。当子进程被 fork(2) 创建时,它继承其父进程环境的一份副本。
习惯上约定在 environ 中的字符串有类似“名称=值”的形式。其中的名称是大小写敏感的,且不能包含字符“=”。其中的值可以为任何字符串可以表示的文本。名称和值不能包含内嵌的空字节字符('\0'),以此避免其被误认为字符串终止位置。
环境变量可由 sh(1) 中的 export 命令在 shell 的环境中被设定,或者在使用 csh(1) 时使用 setenv 命令。
对 shell 来说,其初始的环境相关变量可经由多种方式被填充,如在使用了 pam(8) 的系统上,pam_env(8) 会对所有用户在登录时启用 /etc/environment 中的定义。除此之外,许多 shell 初始化脚本,如系统层级的 /etc/profile 脚本和各个用户的初始化脚本,可能包含一些会向 shell 的环境中添加变量的命令;请参考您使用的 shell 的手册页了解详细信息。
Bourne 风格的 shell 支持下面的语法
名称=值 命令
它可被用来仅在执行 命令 时创建对应的环境变量定义。在 命令 之前,可以存在多个变量定义,其间使用空格进行分隔。
参数还可以在调用 exec(3)时被放置于环境之中。C 程序可以使用诸如 getenv(3), putenv(3), setenv(3) 和 unsetenv(3) 的函数操纵其环境。
本文的下述部分列出了系统上常见的环境变量。这个列表并不完整,且仅包含普通用户在日常使用中常见的变量。特定程序或软件库函数所使用的环境变量通常会在其对应的手册页中的“环境”一节中进行描述。
- USER
- 已登录用户的名称(被某些 BSD 衍生的程序所使用)。其在登录时被设置,请见下文的备注一节。
- LOGNAME
- 已登录用户的名称(被某些 System-V 衍生的程序所使用)。其在登录时被设置,请见下文的备注一节。
- HOME
- 用户登录时的目录。其在登录时被设置,请见下文的备注一节。
- LANG
- 用于语言和区域设置类别的名称,它在未被 LC_ALL 或更具体的环境变量,如 LC_COLLATE, LC_CTYPE, LC_MESSAGES, LC_MONETARY, LC_NUMERIC 和 LC_TIME 所覆盖时生效(请参见 locale(7) 以了解 LC_* 环境变量的具体细节)。
- PATH
- 它是一系列目录前缀,可被 sh(1) 和许多其他程序所使用以搜索由简单的文件名(即不含有斜线的路径名)所指定的可执行文件。各个前缀之间被冒号(:)所分隔。整个前缀列表会被从前到后进行搜索,程序会检查给定路径名在附加前缀、斜线和文件名之后的路径是否存在,直到找到一个符合条件的可执行文件为止。
- 还存在一个遗留的特性:如果前缀长度为零(即由两个相邻的冒号组成,或者有起始或终止位置的冒号存在),该前缀会被解释为指定当前工作目录。然而,当前已不推荐使用该特性,且 POSIX 认为一个符合标准的应用程序应当使用显式的路径名(如 .)来指定当前工作目录。
- 类似 PATH,还存在 CDPATH 会被某些 shell 用来寻找更改目录指令的目标目录,以及被 man(1) 所使用寻找手册页的 MANPATH,等等。
- PWD
- 当前工作目录的绝对路径。它的组成部分必须被规范化(即不可出现 . 或 .. 的路径部分)。
- SHELL
- 用户登录 shell 的绝对路径名。其在登录时被设置,请见下文的备注一节。
- TERM
- 输出应当兼容的终端类型。
- PAGER
- 用户偏好的显示文本文件的实用工具。可被设置为任何 sh -c 命令可接受的命令字符串操作符。如果 PAGER 的值为空或未被设置,则启动分页器的应用程序会默认选择一个程序,如 less(1) 或 more(1)。
- EDITOR/VISUAL
- 用户偏好使用的编辑文本文件的工具。可被设置为任何 sh -c 命令可接受的命令字符串操作符。
请注意,许多程序和软件库例程的行为都会受到特定环境变量存在与否及其取值的影响。下面给出一些例子:
- •
- LANG, LANGUAGE, NLSPATH, LOCPATH, LC_ALL, LC_MESSAGES 等等变量会影响语言和区域设置的处理;请参见 catopen(3), gettext(3) 和 locale(7)。
- •
- TMPDIR 影响由 tempnam(3) 和其他例程创建的路径名称的前缀,以及由 sort(1) 和其他程序所使用的临时目录名。
- •
- LD_LIBRARY_PATH, LD_PRELOAD 和其他 LD_* 变量会影响动态加载器/链接器的行为。请参见 ld.so(8)。
- •
- POSIXLY_CORRECT 使得特定的程序和软件库例程遵循 POSIX 所指定的行为。
- •
- malloc(3) 的行为受到 MALLOC_* 变量的影响。
- •
- HOSTALIASES 变量给出包含 gethostbyname(3) 将要使用的主机别名的文件的名称。
- •
- TZ 和 TZDIR 给出 tzset(3) 所使用的时区信息,并涉及诸如 ctime(3), localtime(3), mktime(3), strftime(3) 等函数。另请参见 tzselect(8)。
- •
- TERMCAP 提供如何处理给定终端的相关信息(或者给出包含这些信息的文件的文件名)
- •
- COLUMNS 和 LINES 会告知应用程序窗口大小信息,它可能会覆盖实际大小的配置。
- •
- PRINTER 或 LPDEST 可能指定要使用的打印机。请见 lpr(1)。
备注
历史上以及标准上,environ 必须被用户程序所声明。然而,一个现存的不标准的方便程序员工作的方法是将 environ 声明在 <unistd.h> 头文件中,前提是 _GNU_SOURCE 功能测试宏已被定义(参见 feature_test_macros(7))。
prctl(2) 中的 PR_SET_MM_ENV_START 和 PR_SET_MM_ENV_END 操作可被用来控制进程环境的位置。
HOME, LOGNAME, SHELL 和 USER 变量会在用户经由会话管理界面被变更时被设置。者通常是经由类似 login(1) 的程序以及用户数据库(例如 passwd(5))所完成的。(使用 su(1) 切换到 root 用户可能导致混合的环境变量,其中 LOGNAME 和 USER 被保留为旧有用户的值;参见 su(1) 手册页。)
缺陷
很显然,这个机制有安全风险。许多系统命令可被用户指定的不同寻常的 IFS 或 LD_LIBRARY_PATH 的值所欺骗。
还存在命名空间污染的风险。如 make 和 autoconf 等程序允许环境中具有和实用工具相同命名(但全大写)的变量覆盖默认所使用的工具路径。因此,用户可以使用 CC 来选择想要使用的 C 编译器(类似地,还有 MAKE, AR, AS, FC, LD, LEX, RM, YACC 等等)。然而,在某些传统的使用场景中这些环境变量还会被赋值为程序选项而非路径名,例如 MORE 和 LESS。这些用法被认为是错误的,应当在新程序中避免。
参见
bash(1), csh(1), env(1), login(1), printenv(1), sh(1), su(1), tcsh(1), execve(2), clearenv(3), exec(3), getenv(3), putenv(3), setenv(3), unsetenv(3), locale(7), ld.so(8), pam_env(8)
跋
本页面中文版由中文
man 手册页计划提供。
中文 man
手册页计划:https://github.com/man-pages-zh/manpages-zh
| 2024-06-15 | Linux 手册页 6.9.1 |