.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" and Copyright (C) 2004, 2007 Michael Kerrisk .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" References consulted: .\" Linux libc source code .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:20:58 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Fri Feb 14 21:47:50 1997 by Andries Brouwer (aeb@cwi.nl) .\" Modified 9 Jun 2004, Michael Kerrisk .\" Changed unsetenv() prototype; added EINVAL error .\" Noted nonstandard behavior of setenv() if name contains '=' .\" 2005-08-12, mtk, glibc 2.3.4 fixed the "name contains '='" bug .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH setenv 3 "20 iulie 2023" "Pagini de manual de Linux 6.05.01" .SH NUME setenv \- modifică sau adaugă o variabilă de mediu .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH REZUMAT .nf \fB#include \fP .PP \fBint setenv(const char *\fP\fIname\fP\fB, const char *\fP\fIvalue\fP\fB, int \fP\fIoverwrite\fP\fB);\fP \fBint unsetenv(const char *\fP\fIname\fP\fB);\fP .fi .PP .RS -4 Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați \fBfeature_test_macros\fP(7)): .RE .PP \fBsetenv\fP(), \fBunsetenv\fP(): .nf _POSIX_C_SOURCE >= 200112L || /* glibc <= 2.19: */ _BSD_SOURCE .fi .SH DESCRIERE Funcția \fBsetenv\fP() adaugă variabila \fIname\fP în mediu cu valoarea \fIvalue\fP, în cazul în care \fIname\fP nu există deja. Dacă \fIname\fP există în mediu, atunci valoarea sa este schimbată cu \fIvalue\fP dacă \fIoverwrite\fP este diferită de zero; dacă \fIoverwrite\fP este zero, atunci valoarea lui \fIname\fP nu este schimbată (iar \fBsetenv\fP() returnează o stare de succes). Această funcție face copii ale șirurilor de caractere indicate de \fIname\fP și \fIvalue\fP (spre deosebire de \fBputenv\fP(3)). .PP Funcția \fBunsetenv\fP() șterge variabila \fIname\fP din mediu. Dacă \fIname\fP nu există în mediu, atunci funcția reușește, iar mediul rămâne neschimbat. .SH "VALOAREA RETURNATĂ" Funcțiile \fBsetenv\fP() și \fBunsetenv\fP() returnează zero în caz de succes sau \-1 în caz de eroare, cu \fIerrno\fP configurată pentru a indica eroarea. .SH ERORI\-IEȘIRE .TP \fBEINVAL\fP \fIname\fP este NULL, indică un șir de lungime 0 sau conține un caracter \[aq]=\[aq]. .TP \fBENOMEM\fP Memorie insuficientă pentru a adăuga o nouă variabilă în mediu. .SH ATRIBUTE Pentru o explicație a termenilor folosiți în această secțiune, a se vedea \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interfață Atribut Valoare T{ .na .nh \fBsetenv\fP(), \fBunsetenv\fP() T} Siguranța firelor MT\-Unsafe const:env .TE .sp 1 .SH STANDARDE POSIX.1\-2008. .SH ISTORIC POSIX.1\-2001, 4.3BSD. .PP Înainte de glibc 2.2.2.2, \fBunsetenv\fP() a fost prototipat ca returnând \fIvoid\fP; versiunile mai recente ale glibc urmează prototipul conform POSIX.1 prezentat în REZUMAT. .SH LIMITĂRI POSIX.1 nu impune ca \fBsetenv\fP() sau \fBunsetenv\fP() să fie reentrantă. .SH ERORI POSIX.1 specifică faptul că, dacă \fIname\fP conține un caracter \[aq]=\[aq], atunci \fBsetenv\fP() trebuie să eșueze cu eroarea \fBEINVAL\fP; cu toate acestea, versiunile de glibc anterioare glibc 2.3.4 permiteau un semn \[aq]=\[aq] în \fIname\fP. .SH "CONSULTAȚI ȘI" \fBclearenv\fP(3), \fBgetenv\fP(3), \fBputenv\fP(3), \fBenviron\fP(7) .PP .SH TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .PP Această traducere este documentație gratuită; citiți .UR https://www.gnu.org/licenses/gpl-3.0.html Licența publică generală GNU Versiunea 3 .UE sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE. .PP Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la .MT translation-team-ro@lists.sourceforge.net .ME .