.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2003 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
.\"
.\" SPDX-License-Identifier: GPL-1.0-or-later
.\"
.\" Polished a bit, added a little, aeb
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH setaliasent 3 "20 iulie 2023" "Pagini de manual de Linux 6.05.01" 
.SH NUME
setaliasent, endaliasent, getaliasent, getaliasent_r, getaliasbyname,
getaliasbyname_r \- citesc o intrare alias
.SH BIBLIOTECA
Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP)
.SH REZUMAT
.nf
\fB#include <aliases.h>\fP
.PP
\fBvoid setaliasent(void);\fP
\fBvoid endaliasent(void);\fP
.PP
\fBstruct aliasent *getaliasent(void);\fP
\fBint getaliasent_r(struct aliasent *restrict \fP\fIresult\fP\fB,\fP
\fB                     char \fP\fIbuffer\fP\fB[restrict .\fP\fIbuflen\fP\fB], size_t \fP\fIbuflen\fP\fB,\fP
\fB                     struct aliasent **restrict \fP\fIres\fP\fB);\fP
.PP
\fBstruct aliasent *getaliasbyname(const char *\fP\fIname\fP\fB);\fP
\fBint getaliasbyname_r(const char *restrict \fP\fIname\fP\fB,\fP
\fB                     struct aliasent *restrict \fP\fIresult\fP\fB,\fP
\fB                     char \fP\fIbuffer\fP\fB[restrict .\fP\fIbuflen\fP\fB], size_t \fP\fIbuflen\fP\fB,\fP
\fB                     struct aliasent **restrict \fP\fIres\fP\fB);\fP
.fi
.SH DESCRIERE
Una dintre bazele de date disponibile cu Name Service Switch (NSS) este baza
de date de alias, care conține nume de alias de poștă electronică; (pentru a
afla ce baze de date sunt acceptate, încercați \fIgetent \-\-help\fP). Pentru a
accesa baza de date de alias sunt furnizate șase funcții.
.PP
Funcția \fBgetaliasent\fP() returnează un indicator către o structură care
conține informațiile de grup din baza de date de alias Prima dată când este
apelată, returnează prima intrare; ulterior, returnează intrări succesive.
.PP
Funcția \fBsetaliasent\fP() derulează indicatorul de fișier la începutul bazei
de date de alias.
.PP
Funcția \fBendaliasent\fP() închide baza de date de alias.
.PP
\fBgetaliasent_r\fP() este versiunea reentrantă a funcției
anterioare. Structura solicitată este stocată prin intermediul primului
argument, dar programatorul trebuie să completeze și celelalte
argumente. Dacă nu se oferă suficient spațiu, funcția eșuează.
.PP
Funcția \fBgetaliasbyname\fP() primește argumentul nume și caută în baza de
date cu pseudonime. Intrarea este returnată sub forma unui indicator către o
structură \fIstruc aliasent\fP.
.PP
\fBgetaliasbyname_r\fP() este versiunea reentrantă a funcției
anterioare. Structura solicitată este stocată prin intermediul primului
argument, dar programatorul trebuie să completeze și celelalte
argumente. Dacă nu se oferă suficient spațiu, funcția eșuează.
.PP
\fIstruct aliasent\fP este definită în \fI<aliases.h>\fP:
.PP
.in +4n
.EX
struct aliasent {
    char    *alias_name;             /* nume alias */
    size_t   alias_members_len;
    char   **alias_members;          /* listă nume alias */
    int      alias_local;
};
.EE
.in
.SH "VALOAREA RETURNATĂ"
Funcțiile \fBgetaliasent_r\fP() și \fBgetaliasbyname_r\fP() returnează o valoare
diferită de zero în caz de eroare.
.SH FIȘIERE
Baza de date alias implicită este fișierul \fI/etc/aliases\fP. Acesta poate fi
modificat în fișierul \fI/etc/nsswitch.conf\fP.
.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
\fBsetaliasent\fP(),
\fBendaliasent\fP(),
\fBgetaliasent_r\fP(),
\fBgetaliasbyname_r\fP()
T}	Siguranța firelor	MT\-Safe locale
T{
.na
.nh
\fBgetaliasent\fP(),
\fBgetaliasbyname\fP()
T}	Siguranța firelor	MT\-Unsafe
.TE
.sp 1
.SH STANDARDE
GNU.
.SH ISTORIC
Sistemul NeXT are rutine similare:
.PP
.in +4n
.EX
#include <aliasdb.h>
\&
void alias_setent(void);
void alias_endent(void);
alias_ent *alias_getent(void);
alias_ent *alias_getbyname(char *name);
.EE
.in
.SH EXEMPLE
Următorul exemplu compilează cu \fIgcc example.c \-o example\fP. Acesta va afișa
toate numele din baza de date de alias.
.PP
.\" SRC BEGIN (setaliasent.c)
.EX
#include <aliases.h>
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
\&
int
main(void)
{
    struct aliasent *al;
\&
    setaliasent();
    for (;;) {
        al = getaliasent();
        if (al == NULL)
            break;
        printf("Nume: %s\en", al\->alias_name);
    }
    if (errno) {
        perror("citind alias");
        exit(EXIT_FAILURE);
    }
    endaliasent();
    exit(EXIT_SUCCESS);
}
.EE
.\" SRC END
.SH "CONSULTAȚI ȘI"
\fBgetgrent\fP(3), \fBgetpwent\fP(3), \fBgetspent\fP(3), \fBaliases\fP(5)
.\"
.\" /etc/sendmail/aliases
.\" Yellow Pages
.\" newaliases, postalias
.PP
.SH TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de
Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>
.
.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 .