Provided by: manpages-ro-dev_4.23.1-1_all 
NUME
getgrent, setgrent, endgrent - obține intrarea din fișierul de grup
BIBLIOTECA
Biblioteca C standard (libc, -lc)
SINOPSIS
#include <sys/types.h>
#include <grp.h>
struct group *getgrent(void);
void setgrent(void);
void endgrent(void);
Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați feature_test_macros(7)):
setgrent():
_XOPEN_SOURCE >= 500
|| /* glibc >= 2.19: */ _DEFAULT_SOURCE
|| /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
getgrent(), endgrent():
Începând cu glibc 2.22:
_XOPEN_SOURCE >= 500 || _DEFAULT_SOURCE
glibc 2.21 și versiunile anterioare
_XOPEN_SOURCE >= 500
|| /* Începând cu glibc 2.12: */ _POSIX_C_SOURCE >= 200809L
|| /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
DESCRIERE
Funcția getgrent() returnează un indicator către o structură care conține câmpurile defalcate ale unei
înregistrări din baza de date de grupuri (de exemplu, fișierul de grup local /etc/group, NIS și LDAP).
Prima dată când este apelată getgrent(), aceasta returnează prima intrare; ulterior, returnează intrări
succesive.
Funcția setgrent() revine la începutul bazei de date a grupului, pentru a permite scanări repetate.
Funcția endgrent() este utilizată pentru a închide baza de date a grupului după ce a fost efectuată toată
prelucrarea.
Structura group este definită în <grp.h> după cum urmează:
struct group {
char *gr_name; /* numele grupului */
char *gr_passwd; /* parola grupului */
gid_t gr_gid; /* identificatorul grupului */
char **gr_mem; /* vector de indicatori cu terminație NULL
la numele membrilor grupului */
};
Pentru mai multe informații despre câmpurile acestei structuri, a se vedea group(5).
VALOAREA RETURNATĂ
Funcția getgrent() returnează un indicator la o structură group sau NULL dacă nu mai există intrări sau
dacă apare o eroare.
În caz de eroare, se poate configura errno. Dacă se dorește verificarea lui errno după apel, aceasta
trebuie să fie fixată la zero înainte de apel.
Valoarea de returnare poate indica o zonă statică și poate fi suprascrisă de apelurile ulterioare la
getgrent(), getgrgid(3) sau getgrnam(3); (nu pasează indicatorul returnat către free(3).)
ERORI-IEȘIRE
EAGAIN Serviciul a fost temporar indisponibil; încercați din nou mai târziu. Pentru serviciile NSS din
glibc, acest lucru indică o eroare temporară de comunicare cu aceste servicii. Eroarea se poate
corecta de la sine; se sugerează să încercați din nou mai târziu.
EINTR A fost captat un semnal; a se vedea signal(7).
EIO Eroare de In/Ieș.
EMFILE Limita per proces a numărului de descriptori de fișiere deschise a fost atinsă.
ENFILE Limita la nivel de sistem a numărului total de fișiere deschise a fost atinsă.
ENOENT Nu poate fi găsit un fișier de intrare necesar. În cazul serviciilor NSS din glibc, acest lucru
indică faptul că aceste servicii nu sunt configurate corect.
ENOMEM Memorie insuficientă pentru alocarea structurii group.
ERANGE Spațiul de memorie tampon furnizat este insuficient.
FIȘIERE
/etc/group fișier de bază de date a grupurilor locale
ATRIBUTE
Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7). ┌───────────────────────┬───────────────────┬────────────────────────────────────────────────────────────┐ │Interfață │ Atribut │ Valoare │ ├───────────────────────┼───────────────────┼────────────────────────────────────────────────────────────┤ │getgrent() │ Siguranța firelor │ MT-Unsafe race:grent race:grentbuf locale │ ├───────────────────────┼───────────────────┼────────────────────────────────────────────────────────────┤ │setgrent(), endgrent() │ Siguranța firelor │ MT-Unsafe race:grent locale │ └───────────────────────┴───────────────────┴────────────────────────────────────────────────────────────┘ În tabelul de mai sus, grent din race:grent semnifică faptul că, dacă oricare dintre funcțiile setgrent(), getgrent() sau endgrent() sunt utilizate în paralel în diferite fire de execuție ale unui program, pot apărea accesări concurente la date („data races”).
STANDARDE
POSIX.1-2008.
ISTORIC
POSIX.1-2001, SVr4, 4.3BSD.
CONSULTAȚI ȘI
fgetgrent(3), getgrent_r(3), getgrgid(3), getgrnam(3), getgrouplist(3), putgrent(3), group(5)
TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu
<remusgabriel.chelu@disroot.org>
Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ sau o versiune ulterioară cu privire la condiții privind
drepturile de autor. NU se asumă NICIO RESPONSABILITATE.
Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la ⟨translation-team-
ro@lists.sourceforge.net⟩.