.\" -*- 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 "20 lipca 2023 r." "Linux man\-pages 6.05.01" .SH NAZWA clearenv \- czyszczenie środowiska .SH BIBLIOTEKA Standardowa biblioteka C (\fIlibc\fP, \fI\-lc\fP) .SH SKŁADNIA .nf \fB#include \fP .PP \fBint clearenv(void);\fP .fi .PP .RS -4 Wymagane ustawienia makr biblioteki glibc (patrz \fBfeature_test_macros\fP(7)): .RE .PP \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 .sp 1 .SH STANDARDY .TP \fBputenv\fP() POSIX.1\-2008. .TP \fBclearenv\fP() None. .SH HISTORIA .TP \fBputenv\fP() glibc 2.0. POSIX.1\-2001. .TP \fBclearenv\fP() glibc 2.0. .PP Różne warianty Uniksa (DG/UX, HP\-UX, QNX, ...). POSIX.9 (bindings for 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 .PP .in +4n .EX environ = NULL; .EE .in .PP prawdopodobnie zrobi to samo. .PP 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. .PP Proszę zauważyć, że głównych 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. .PP .\" .LP .\" 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 Autorami polskiego tłumaczenia niniejszej strony podręcznika są: 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 .