PUTENV(3)

ИМЯ
putenv - изменяет или добавляет переменную окружения

ОБЗОР
#include <stdlib.h>

int putenv(char *string);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

putenv(): _XOPEN_SOURCE
    || /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
    || /* версии glibc <= 2.19: */ _SVID_SOURCE

ОПИСАНИЕ
Функция putenv() добавляет или изменяет значение переменных окружения. Аргумент string должен быть представлен в форме name=value. Если переменной с именем name нет в окружении, то string добавляется к окружению. Если переменная name уже существует, то значение name в окружении изменяется на value. Строка, на которую указывает string, становится частью окружения, так что её изменение приведёт к изменению окружения.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Функция putenv() возвращает ноль при успешном выполнении и не ноль в противном случае. При ошибке errno отражает причину ошибки.

ОШИБКИ

ENOMEM
    Недостаточно памяти под новое окружение.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
putenv() | Безвредность в нитях | MT-Unsafe const:env

СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.

ЗАМЕЧАНИЯ
От функции putenv() не требуется быть реентерабельной, и она такова в glibc 2.0, но в glibc 2.1 она реентерабельна.

Начиная с версии 2.1.2 glibc соответствует SUSv2: используется указатель string, передаваемый putenv(). В частности, эта строка становится частью окружения; последующее её изменение приводит к изменению окружения. Таким образом, ошибочным будет вызывать putenv() с автоматической переменной в качестве аргумента, так как после возврата из вызвавшей функции строка string является частью окружения. Однако, версии glibc 2.0 по 2.1.1 работают по-другому: используется копия строки. С одной стороны, это вызывает утечку памяти, с другой стороны, это не соответствует SUSv2.

В версии 4.4BSD как и в glibc 2.0 используется копия.

В SUSv2 удалено const из прототипа и это сделано в glibc 2.1.3.

Реализация библиотеки GNU C предоставляет нестандартное расширение. Если string не включает знака равно:

    putenv("NAME");

то именованная переменная удаляется из окружения вызывающего.

СМОТРИТЕ ТАКЖЕ
clearenv(3), getenv(3), setenv(3), unsetenv(3), environ(7)