НАИМЕНОВАНИЕ

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

БИБЛИОТЕКА

       Стандартная библиотека языка C (libc, -lc)

ОБЗОР

       #include <stdlib.h>

       int setenv(const char *name, const char *value, int overwrite);
       int unsetenv(const char *name);

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

       setenv(), unsetenv():
           _POSIX_C_SOURCE >= 200112L
               || /* glibc <= 2.19: */ _BSD_SOURCE

ОПИСАНИЕ

       Функция  setenv()  добавляет переменную name в окружение со значением value, если name ещё не существует.
       Если name в окружении существует, то её значение изменяется на  value,  если  overwrite  имеет  ненулевое
       значение;  если overwrite равно нулю, то значение name не изменяется (и setenv() завершается без ошибки).
       Эта функция делает копию строк, указанных в name и value (в отличии от putenv(3)).

       Функция unsetenv() удаляет переменную name из окружения. Если name в окружении не существует, то  функция
       завершается без ошибки и окружение не изменяется.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       setenv()   and  unsetenv()   functions return zero on success, or -1 on error, with errno set to indicate
       the error.

ОШИБКИ

       EINVAL name is NULL, points to a string of length 0, or contains an '=' character.

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

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).
       ┌──────────────────────────────────────────────────────────┬──────────────────────┬─────────────────────┐
       │ Интерфейс                                                │ Атрибут              │ Значение            │
       ├──────────────────────────────────────────────────────────┼──────────────────────┼─────────────────────┤
       │ setenv(), unsetenv()                                     │ Безвредность в нитях │ MT-Unsafe const:env │
       └──────────────────────────────────────────────────────────┴──────────────────────┴─────────────────────┘

СТАНДАРТЫ

       POSIX.1-2008.

ИСТОРИЯ

       POSIX.1-2001, 4.3BSD.

       До glibc 2.2.2, unsetenv() объявлялась как возвращающая void; более новые версии glibc следуют объявлению
       из POSIX.1, показанному в ОБЗОРЕ.

CAVEATS

       В POSIX.1 не требуется, чтобы setenv() или unsetenv() были реентерабельными.

ОШИБКИ

       POSIX.1 specifies that if name contains an '=' character, then  setenv()   should  fail  with  the  error
       EINVAL; however, versions of glibc before glibc 2.3.4 allowed an '=' sign in name.

СМОТРИТЕ ТАКЖЕ

       clearenv(3), getenv(3), putenv(3), environ(7)

ПЕРЕВОД

       Русский  перевод  этой  страницы  руководства разработал(и) Alexander Golubev <fatzer2@gmail.com>, Azamat
       Hackimov  <azamat.hackimov@gmail.com>,  Hotellook,   Nikita   <zxcvbnm3230@mail.ru>,   Spiros   Georgaras
       <sng@hellug.gr>,  Vladislav  <ivladislavefimov@gmail.com>,  Yuri Kozlov <yuray@komyakino.ru>, Иван Павлов
       <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

       Этот перевод является свободной программной документацией; он распространяется на условиях  общедоступной
       лицензии  GNU  (GNU  General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите  об  этом
       разработчику(ам)   по   его(их)  адресу(ам)  электронной  почты  или  по  адресу  списка рассылки русских
       переводчиков.

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                                        setenv(3)