Provided by: manpages-pl-dev_4.13-4_all 
NAZWA
clearenv - czyszczenie środowiska
SKŁADNIA
#include <stdlib.h> int clearenv(void); Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)): clearenv(): /* Glibc od 2.19: */ _DEFAULT_SOURCE || /* Glibc w wersji <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
OPIS
Funkcja clearenv() czyści środowisko z wszystkich par nazwa-wartość i nadaje zewnętrznej zmiennej environ
wartość NULL. Po tym wywołaniu nowe zmienne można dodać do środowiska za pomocą putenv(3) i setenv(3).
WARTOŚĆ ZWRACANA
Funkcja clearenv() zwraca zero przy pomyślnym zakończeniu, a wartość niezerową w przypadku błędu.
WERSJE
Dostępne od glibc 2.0.
ATRYBUTY
Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7). ┌───────────┬────────────────────────┬─────────────────────┐ │Interfejs │ Atrybut │ Wartość │ ├───────────┼────────────────────────┼─────────────────────┤ │clearenv() │ Bezpieczeństwo wątkowe │ MT-Unsafe const:env │ └───────────┴────────────────────────┴─────────────────────┘
ZGODNE Z
Różne warianty Uniksa (DG/UX, HP-UX, QNX, ...). POSIX.9 (bindings for FORTRAN77). POSIX.1-1996 nie
akceptował clearenv() ani putenv(3), ale zmienił zdanie i ujął te funkcje w wykazie w jednym z
późniejszych wydań standardu (patrz §B.4.6.1). Jednakże, POSIX.1-2001 dodaje jedynie putenv(3) i odrzuca
clearenv().
UWAGI
Na systemach na których clearenv() jest niedostępne, przypisanie
environ = NULL;
prawdopodobnie zrobi to samo.
Funkcja clearenv() 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ą exec(3). Aplikacje mogą to
uczynić zaczynając od wyczyszczenia środowiska, a następnie dodawania wybranych zmiennych środowiskowych.
Proszę zauważyć, że głównych efektem działania clearenv() jest dostosowanie wartości wskaźnika
environ(7); funkcja ta nie usuwa zawartości buforów zawierających definicje środowiska.
Na stronach podręcznika dla DG/UX i Tru64 jest napisane: Jeśli environ zostało zmodyfikowane przez
cokolwiek innego niż funkcje putenv(3), getenv(3) lub clearenv(), to clearenv() zwróci błąd,
pozostawiając niezmienione środowisko procesu.
ZOBACZ TAKŻE
getenv(3), putenv(3), setenv(3), unsetenv(3), environ(7)
O STRONIE
Angielska wersja tej strony pochodzi z wydania 5.10 projektu Linux man-pages. Opis projektu, informacje
dotyczące zgłaszania błędów oraz najnowszą wersję oryginału można znaleźć pod adresem
https://www.kernel.org/doc/man-pages/.
T◈UMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Andrzej Krzysztofowicz
<ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać
zapoznając się z GNU General Public License w wersji 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ lub
nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej ⟨manpages-pl-
list@lists.sourceforge.net⟩.