.\" -*- 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 maja 2024 r." "Linux man\-pages 6.9.1" .SH NAZWA clearenv \- czyści środowisko .SH BIBLIOTEKA Standardowa biblioteka C (\fIlibc\fP, \fI\-lc\fP) .SH SKŁADNIA .nf \fB#include \fP .P \fBint clearenv(void);\fP .fi .P .RS -4 Wymagane ustawienia makr biblioteki glibc (patrz \fBfeature_test_macros\fP(7)): .RE .P \fBclearenv\fP(): .nf /* glibc >= 2.19: */ _DEFAULT_SOURCE || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .fi .SH OPIS Funkcja \fBclearenv\fP() czyści środowisko z wszystkich par nazwa\-wartość i nadaje zewnętrznej zmiennej \fIenviron\fP wartość NULL. Po tym wywołaniu nowe zmienne można dodać do środowiska za pomocą \fBputenv\fP(3) i \fBsetenv\fP(3). .SH "WARTOŚĆ ZWRACANA" .\" 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". Funkcja \fBclearenv\fP() zwraca zero przy pomyślnym zakończeniu, a wartość niezerową w przypadku błędu. .SH ATRYBUTY Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interfejs Atrybut Wartość T{ .na .nh \fBclearenv\fP() T} Bezpieczeństwo wątkowe MT\-niebezpieczne const:env .TE .SH STANDARDY .TP \fBputenv\fP() POSIX.1\-2008. .TP \fBclearenv\fP() Brak. .SH HISTORIA .TP \fBputenv\fP() glibc 2.0. POSIX.1\-2001. .TP \fBclearenv\fP() glibc 2.0. .P Różne warianty Uniksa (DG/UX, HP\-UX, QNX, ...). POSIX.9 (przypięcia dla języka FORTRAN77). POSIX.1\-1996 nie akceptował \fBclearenv\fP() ani \fBputenv\fP(3), ale zmienił zdanie i ujął te funkcje w wykazie w jednym z późniejszych wydań standardu (patrz \[sc]B.4.6.1). Jednakże, POSIX.1\-2001 dodaje jedynie \fBputenv\fP(3) i odrzuca \fBclearenv\fP(). .SH UWAGI Na systemach na których \fBclearenv\fP() jest niedostępne, przypisanie .P .in +4n .EX environ = NULL; .EE .in .P prawdopodobnie zrobi to samo. .P Funkcja \fBclearenv\fP() może być przydatna w aplikacjach dbających o bezpieczeństwo, które chcą dokładnie kontrolować środowisko przekazywane do programów wykonywanych za pomocą \fBexec\fP(3). Aplikacje mogą to uczynić zaczynając od wyczyszczenia środowiska, a następnie dodawania wybranych zmiennych środowiskowych. .P Proszę zauważyć, że głównym efektem działania \fBclearenv\fP() jest dostosowanie wartości wskaźnika \fBenviron\fP(7); funkcja ta nie usuwa zawartości buforów zawierających definicje środowiska. .P .\" .P .\" HP-UX has a ENOMEM error return. Na stronach podręcznika dla DG/UX i Tru64 jest napisane: Jeśli \fIenviron\fP zostało zmodyfikowane przez cokolwiek innego niż funkcje \fBputenv\fP(3), \fBgetenv\fP(3) lub \fBclearenv\fP(), to \fBclearenv\fP() zwróci błąd, pozostawiając niezmienione środowisko procesu. .SH "ZOBACZ TAKŻE" \fBgetenv\fP(3), \fBputenv\fP(3), \fBsetenv\fP(3), \fBunsetenv\fP(3), \fBenviron\fP(7) .PP .SH TŁUMACZENIE Tłumaczenie niniejszej strony podręcznika: Andrzej Krzysztofowicz , Robert Luberda i Michał Kułach . .PP Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License w wersji 3 .UE lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI. .PP Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej .MT manpages-pl-list@lists.sourceforge.net .ME .