.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 2001 John Levon .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Additions, aeb, 2001-10-17. .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH clearenv 3 "5 февраля 2023 г." "Linux man\-pages 6.03" .SH ИМЯ clearenv \- очищает окружение .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .PP \fBint clearenv(void);\fP .fi .PP .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .PP \fBclearenv\fP(): .nf /* glibc >= 2.19: */ _DEFAULT_SOURCE || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .fi .SH ОПИСАНИЕ Функция \fBclearenv\fP() очищает окружение от всех пар имя\-значение и устанавливает значение внешней переменной \fIenviron\fP равным NULL. После этого вызова новые переменные можно добавлять в окружение с помощью \fBputenv\fP(3) и \fBsetenv\fP(3). .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" .\" Most versions of UNIX return -1 on error, or do not even have errors. .\" glibc info and the Watcom C library document "a nonzero value". Функция \fBclearenv\fP() возвращает ноль при успешном выполнении и ненулевое значение при ошибках. .SH ВЕРСИИ Доступна в glibc с версии 2.0. .SH АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .ad l .nh .TS allbox; lbx lb lb l l l. Интерфейс Атрибут Значение T{ \fBclearenv\fP() T} Безвредность в нитях MT\-Unsafe const:env .TE .hy .ad .sp 1 .SH СТАНДАРТЫ Есть в различных версиях UNIX (DG/UX, HP\-UX, QNX, …) В POSIX.9 (привязки для FORTRAN77). В POSIX.1\-1996 функции \fBclearenv\fP() и \fBputenv\fP() не приняты, но указано, что они войдут в следующие версии стандарта (смотрите \[sc]B.4.6.1). Однако, в POSIX.1\-2001 добавлена только \fBputenv\fP(), а \fBclearenv\fP() — отклонена. .SH ЗАМЕЧАНИЯ В системах, где \fBclearenv\fP() отсутствует, присваивайте .PP .in +4n .EX environ = NULL; .EE .in .PP самостоятельно. .PP Функция \fBclearenv\fP() может пригодиться в приложениях, которые для безопасности полностью контролирую окружение, передаваемое программам, запускающимся посредством \fBexec\fP(3). Для этого приложение сначала очищает окружение, а затем добавляет выборочные переменные окружения. .PP Заметим, что главным свойством \fBclearenv\fP() является присвоение значения указателю \fBenviron\fP(7); эта функция не стирает содержимое буферов, содержащих само окружение. .PP .\" .LP .\" HP-UX has a ENOMEM error return. В справочных страницах DG/UX и Tru64 написано: если \fIenviron\fP изменялась не с помощью функций \fBputenv\fP(3), \fBgetenv\fP(3) или \fBclearenv\fP(), то \fBclearenv\fP() возвратит ошибку и окружение процесса не будет изменено. .SH "СМ. ТАКЖЕ" \fBgetenv\fP(3), \fBputenv\fP(3), \fBsetenv\fP(3), \fBunsetenv\fP(3), \fBenviron\fP(7) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Azamat Hackimov , Dmitriy S. Seregin , Dmitry Bolkhovskikh , Katrin Kutepova , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .