ИМЯ

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");

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

ИМЯ