.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2003, Walter Harms <walter.harms@informatik.uni-oldenburg.de>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-1.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH setaliasent 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
setaliasent, endaliasent, getaliasent, getaliasent_r, getaliasbyname,
getaliasbyname_r \- قراءة إدخال اسم مستعار
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <aliases.h>\fP
.P
\fBvoid setaliasent(void);\fP
\fBvoid endaliasent(void);\fP
.P
\fBstruct aliasent *getaliasent(void);\fP
\fBint getaliasent_r(\fPsize_t size;
\fB                     struct aliasent *restrict \fP\fIresult\fP\fB,\fP
\fB                     char \fP\fIbuffer\fP\fB[restrict \fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB,\fP
\fB                     struct aliasent **restrict \fP\fIres\fP\fB);\fP
.P
\fBstruct aliasent *getaliasbyname(const char *\fP\fIname\fP\fB);\fP
\fBint getaliasbyname_r(\fPsize_t size;
\fB                     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\fIsize\fP\fB], size_t \fP\fIsize\fP\fB,\fP
\fB                     struct aliasent **restrict \fP\fIres\fP\fB);\fP
.fi
.SH الوصف
إحدى قواعد البيانات المتاحة مع مبدل خدمة الأسماء (NSS) هي قاعدة بيانات
الأسماء المستعارة، التي تحتوي على أسماء البريد المستعارة. (لمعرفة قواعد
البيانات المدعومة، جرب \fIgetent \-\-help\fP.) ست دوال وُفِّرت للوصول إلى قاعدة
بيانات الأسماء المستعارة.
.P
الدالة \fBgetaliasent\fP() تُرجع مؤشرًا إلى بنية تحتوي على معلومات المجموعة من
قاعدة بيانات الأسماء المستعارة. في المرة الأولى التي تُستدعى فيها تُرجع
الإدخال الأول؛ بعد ذلك، تُرجع الإدخالات المتتالية.
.P
الدالة \fBsetaliasent\fP() تُعيد مؤشر الملف إلى بداية قاعدة بيانات الأسماء
المستعارة.
.P
الدالة \fBendaliasent\fP() تُغلق قاعدة بيانات الأسماء المستعارة.
.P
\fBgetaliasent_r\fP() هي النسخة القابلة لإعادة الدخول من الدالة السابقة. البنية
المطلوبة تُخزَّن عبر الوسيط الأول ولكن المبرمج يحتاج لملء الوسائط الأخرى
أيضًا. عدم توفير مساحة كافية يُسبب فشل الدالة.
.P
الدالة \fBgetaliasbyname\fP() تأخذ وسيط الاسم وتبحث في قاعدة بيانات الأسماء
المستعارة. الإدخال يُرجع كمؤشر إلى \fIstruct aliasent\fP.
.P
\fBgetaliasbyname_r\fP() هي النسخة القابلة لإعادة الدخول من الدالة
السابقة. البنية المطلوبة تُخزَّن عبر الوسيط الثاني ولكن المبرمج يحتاج لملء
الوسائط الأخرى أيضًا. عدم توفير مساحة كافية يُسبب فشل الدالة.
.P
\fIstruct aliasent\fP مُعرَّف في \fI<aliases.h>\fP:
.P
.in +4n
.EX
struct aliasent {
    char    *alias_name;             /* اسم مستعار */
    size_t   alias_members_len;
    char   **alias_members;          /* قائمة أسماء مستعارة */
    int      alias_local;
};
.EE
.in
.SH "قيمة الإرجاع"
الدالتان \fBgetaliasent_r\fP() و \fBgetaliasbyname_r\fP() تُرجعان قيمة غير صفرية
عند الخطأ.
.SH الملفات
قاعدة بيانات الأسماء المستعارة المبدئية هي الملف \fI/etc/aliases\fP. يمكن تغيير
هذا في الملف \fI/etc/nsswitch.conf\fP.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBsetaliasent\fP(),
\fBendaliasent\fP(),
\fBgetaliasent_r\fP(),
\fBgetaliasbyname_r\fP()
T}	سلامة الخيوط	المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe)
T{
.na
.nh
\fBgetaliasent\fP(),
\fBgetaliasbyname\fP()
T}	سلامة الخيوط	غير آمن لتعدد الخيوط (MT\-Unsafe)
.TE
.SH المعايير
GNU.
.SH التاريخ
نظام NeXT لديه إجراءات مشابهة:
.P
.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 أمثلة
المثال التالي يُترجم مع \fIgcc example.c \-o example\fP.  سيفرغ جميع الأسماء في
قاعدة بيانات الأسماء المستعارة.
.P
.\" 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("Name: %s\[rs]n", al\->alias_name);
    }
    if (errno) {
        perror("reading alias");
        exit(EXIT_FAILURE);
    }
    endaliasent();
    exit(EXIT_SUCCESS);
}
.EE
.\" SRC END
.SH "انظر أيضًا"
\fBgetgrent\fP(3), \fBgetpwent\fP(3), \fBgetspent\fP(3), \fBaliases\fP(5)
.\"
.\" /etc/sendmail/aliases
.\" Yellow Pages
.\" newaliases, postalias
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .