getenv

Section: C Library Functions (3)
Updated: 2026-02-08
Index JM Home Page roff page

名前

getenv, secure_getenv - 環境変数を得る

ライブラリ

標準 C ライブラリ (libc,~-lc)

書式

#include <stdlib.h>

char *getenv(const char *name);
char *secure_getenv(const char *name);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

secure_getenv():

    _GNU_SOURCE

説明

関数 getenv() は、環境リストから名前が name の環境変数を検索し、対応する value 文字列へのポインターを返す。

The secure_getenv() function is just like getenv() except that it returns NULL in cases where "secure execution" is required. Secure execution is required if one of the following conditions was true when the program run by the calling process was loaded:

•: プロセスの実効ユーザー ID がプロセスの実ユーザー ID と一致しない場合、またはプロセスの実効グループ ID がプロセスの実グループ ID と一致しない場合 (通常、この状況になるのは、 set-user-ID プログラムか set-group-ID プログラムを実行した場合である)。
•: 実行ファイルで実効ケーパビリティビットがセットされている場合。
•: プロセスの許可ケーパビリティセットが空でない場合。

Linux セキュリティモジュールにより要求された場合にも "secure execution" は必要となる場合がある。

secure_getenv() 関数は、 set-user-ID プログラムや set-group-ID プログラムが実行環境を偶然信用してしまった場合に起こり得る脆弱性を、汎用ライブラリで回避するために使うことを意図して作られた。

返り値

関数 getenv() は、環境における値 value へのポインターを返す。 name にマッチする環境変数が存在しないときには NULL を返す。

属性

この節で使用されている用語の説明については、 attributes(7) を参照。

インターフェース	属性	値
getenv(), secure_getenv()	Thread safety	MT-Safe env

標準規格

getenv(): C11, POSIX.1-2008.
secure_getenv(): POSIX.1-2024.

歴史

getenv(): POSIX.1-2001, C89, C99, SVr4, 4.3BSD.
secure_getenv(): POSIX.1-2024, glibc 2.17.

注意

環境リストの文字列は name=value という形式をしている。

通常の実装では、 getenv() は環境リスト内の文字列へのポインターを返す。呼び出し元はこの文字列を変更しないように注意しなければならない。この文字列を変更すると、そのプロセスの環境を変化させることになるからである。

getenv() の実装はリエントラント (再入可能) であることを要求されていない。 getenv() の返り値により参照される文字列は静的に割り当てられてもよく、文字列の内容は後続の getenv(), putenv(3), setenv(3), unsetenv(3) の呼び出しにより変更されることがある。

secure_getenv() の "secure execution" モードは、カーネルからユーザー空間に渡される補助ベクトル (auxiliary vector) の AT_SECURE フラグにより制御される。

This document was created by man2html, using the manual pages.

getenv

名前

ライブラリ

書式

説明

返り値

属性

標準規格

歴史

注意

関連項目

Index