.\" -*- 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 "2 мая 2024 г." "Справочные страницы Linux 6.9.1" .SH НАИМЕНОВАНИЕ clearenv \- очищает окружение .SH БИБЛИОТЕКА Стандартная библиотека языка C (\fIlibc\fP, \fI\-lc\fP) .SH ОБЗОР .nf \fB#include \fP .P \fBint clearenv(void);\fP .fi .P .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .P \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 АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Интерфейс Атрибут Значение T{ .na .nh \fBclearenv\fP() T} Безвредность в нитях MT\-Unsafe const:env .TE .SH СТАНДАРТЫ .TP \fBputenv\fP() POSIX.1\-2008. .TP \fBclearenv\fP() Отсутствуют. .SH ИСТОРИЯ .TP \fBputenv\fP() glibc 2.0. POSIX.1\-2001. .TP \fBclearenv\fP() glibc 2.0. .P Есть в различных версиях 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() отсутствует, присваивайте .P .in +4n .EX environ = NULL; .EE .in .P самостоятельно. .P Функция \fBclearenv\fP() может пригодиться в приложениях, которые для безопасности полностью контролирую окружение, передаваемое программам, запускающимся посредством \fBexec\fP(3). Для этого приложение сначала очищает окружение, а затем добавляет выборочные переменные окружения. .P Заметим, что главным свойством \fBclearenv\fP() является присвоение значения указателю \fBenviron\fP(7); эта функция не стирает содержимое буферов, содержащих само окружение. .P .\" .P .\" 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 , Иван Павлов и Kirill Rekhov . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT списка рассылки русских переводчиков .ME .