clearenv(3)                Library Functions Manual                clearenv(3)

NAZWA
       clearenv - czyszczenie srodowiska

BIBLIOTEKA
       Standardowa biblioteka C (libc, -lc)

SKLADNIA
       #include <stdlib.h>

       int clearenv(void);

   Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

       clearenv():
           /* glibc >= 2.19: */ _DEFAULT_SOURCE
               || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE

OPIS
       Funkcja clearenv() czysci srodowisko z wszystkich par nazwa-wartosc i
       nadaje zewnetrznej zmiennej environ wartosc NULL. Po tym wywolaniu nowe
       zmienne mozna dodac do srodowiska za pomoca putenv(3) i setenv(3).

WARTOSC ZWRACANA
       Funkcja clearenv() zwraca zero przy pomyslnym zakonczeniu, a wartosc
       niezerowa w przypadku bledu.

ATRYBUTY
       Informacje o pojeciach uzywanych w tym rozdziale mozna znalezc w
       podreczniku attributes(7).

       +--------------+--------------------------+----------------------------+
       |Interfejs     | Atrybut                  | Wartosc                    |
       +--------------+--------------------------+----------------------------+
       |clearenv()    | Bezpieczenstwo watkowe   | MT-niebezpieczne const:env |
       +--------------+--------------------------+----------------------------+
STANDARDY
       putenv()
              POSIX.1-2008.

       clearenv()
              None.

HISTORIA
       putenv()
              glibc 2.0.  POSIX.1-2001.

       clearenv()
              glibc 2.0.

       Rozne warianty Uniksa (DG/UX, HP-UX, QNX, ...). POSIX.9 (bindings for
       FORTRAN77). POSIX.1-1996 nie akceptowal clearenv() ani putenv(3), ale
       zmienil zdanie i ujal te funkcje w wykazie w jednym z pozniejszych
       wydan standardu (patrz <section>B.4.6.1). Jednakze, POSIX.1-2001 dodaje
       jedynie putenv(3) i odrzuca clearenv().

UWAGI
       Na systemach na ktorych clearenv() jest niedostepne, przypisanie

           environ = NULL;

       prawdopodobnie zrobi to samo.

       Funkcja clearenv() moze byc przydatna w aplikacjach dbajacych o
       bezpieczenstwo, ktore chca dokladnie kontrolowac srodowisko
       przekazywane do programow wykonywanych za pomoca exec(3). Aplikacje
       moga to uczynic zaczynajac od wyczyszczenia srodowiska, a nastepnie
       dodawania wybranych zmiennych srodowiskowych.

       Prosze zauwazyc, ze glownych efektem dzialania clearenv() jest
       dostosowanie wartosci wskaznika environ(7); funkcja ta nie usuwa
       zawartosci buforow zawierajacych definicje srodowiska.

       Na stronach podrecznika dla DG/UX i Tru64 jest napisane: Jesli environ
       zostalo zmodyfikowane przez cokolwiek innego niz funkcje putenv(3),
       getenv(3) lub clearenv(), to clearenv() zwroci blad, pozostawiajac
       niezmienione srodowisko procesu.

ZOBACZ TAKZE
       getenv(3), putenv(3), setenv(3), unsetenv(3), environ(7)

TLUMACZENIE
       Autorami polskiego tlumaczenia niniejszej strony podrecznika sa:
       Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>, Robert Luberda
       <robert@debian.org> i Michal Kulach <michal.kulach@gmail.com>

       Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o
       warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public
       License w wersji 3 <https://www.gnu.org/licenses/gpl-3.0.html> lub
       nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI.

       Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy
       dyskusyjnej <manpages-pl-list@lists.sourceforge.net>.

Linux man-pages 6.06       31 pazdziernika 2023 r.                 clearenv(3)