putenv(3)                  Library Functions Manual                  putenv(3)

NUME
       putenv - modifica sau adauga o variabila de mediu

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <stdlib.h>

       int putenv(char *string);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       putenv():
           _XOPEN_SOURCE
               || /* glibc >= 2.19: */ _DEFAULT_SOURCE
               || /* glibc <= 2.19: */ _SVID_SOURCE

DESCRIERE
       Func<?>ia putenv() adauga sau modifica valoarea variabilelor de mediu.
       Argumentul string este de forma nume=valoare.  Daca nume nu exista deja
       in mediu, atunci string se adauga in mediu.  Daca nume exista, atunci
       valoarea lui nume din mediu este schimbata in valoare.  <?>irul indicat
       de string devine parte a mediului, astfel incat modificarea <?>irului
       modifica mediul.

VALOAREA RETURNATA
       Func<?>ia putenv() returneaza zero in caz de succes.  In caz de e<?>ec,
       aceasta returneaza o valoare diferita de zero, iar errno este
       configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       ENOMEM Spa<?>iu insuficient pentru a aloca un nou mediu.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +--------------------------+---------------------+---------------------+
       |Interfa<?>a               | Atribut             | Valoare             |
       +--------------------------+---------------------+---------------------+
       |putenv()                  | Siguran<?>a firelor | MT-Unsafe const:env |
       +--------------------------+---------------------+---------------------+
STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001, SVr2, 4.3BSD-Reno.

       Nu este necesar ca func<?>ia putenv() sa fie reentranta, iar cea din
       glibc 2.0 nu este, dar cea din versiunea glibc 2.1 este.

       Incepand cu glibc 2.1.2, implementarea glibc este conforma cu SUSv2: se
       utilizeaza indicatorul string dat in putenv().  In special, acest <?>ir
       devine parte a mediului; modificarea ulterioara a acestuia va modifica
       mediul; (astfel, este o eroare sa se apeleze putenv() cu o variabila
       automata ca argument, apoi sa se revina din func<?>ia de apelare in
       timp ce string face inca parte din mediu).  Cu toate acestea, de la
       glibc 2.0 la glibc 2.1.1, aceasta difera: se utilizeaza o copie a
       <?>irului de caractere.  Pe de o parte, acest lucru cauzeaza o pierdere
       de memorie, iar pe de alta parte incalca SUSv2.

       Versiunea 4.3BSD-Reno, ca <?>i glibc 2.0, utilizeaza o copie; acest
       lucru este corectat in toate BSD-urile moderne.

       SUSv2 elimina const din prototip, la fel <?>i glibc 2.1.3.

       Implementarea bibliotecii GNU C ofera o extensie nestandardizata.  Daca
       string nu include un semn egal:

           putenv("NUME");

       atunci variabila numita este eliminata din mediul apelantului.

CONSULTA<?>I <?>I
       clearenv(3), getenv(3), setenv(3), unsetenv(3), environ(7)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.06 31 octombrie 2023                     putenv(3)