.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2012, YOSHIFUJI Hideaki/吉藤英明 <hideaki.yoshifuji@miraclelinux.com>
.\" Copyright 2012, Michael Kerrisk <mtk.manpages@gmail.com>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH if_nameindex 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
if_nameindex, if_freenameindex \- الحصول على أسماء وفهارس واجهات الشبكة
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <net/if.h>\fP
.P
\fBstruct if_nameindex *if_nameindex(\fP\fIvoid\fP\fB);\fP
\fBvoid if_freenameindex(struct if_nameindex *\fP\fIptr\fP\fB);\fP
.fi
.SH الوصف
ترجع الدالة \fBif_nameindex\fP() مصفوفة من تراكيب \fIif_nameindex\fP، يحتوي كل
منها على معلومات عن إحدى واجهات الشبكة في النظام المحلي. يحتوي التركيب
\fIif_nameindex\fP على الأقل على المدخلات التالية:
.P
.in +4n
.EX
unsigned int if_index;  /* Index of interface (1, 2, ...) */
char        *if_name;   /* Null\-terminated name ("eth0", etc.) */
.EE
.in
.P
يحتوي الحقل \fIif_index\fP على فهرس الواجهة. يشير الحقل \fIif_name\fP إلى اسم
الواجهة المنتهي بصفر. يُشار إلى نهاية المصفوفة بمدخل فيه \fIif_index\fP مضبوط
على صفر و \fIif_name\fP مضبوط على NULL.
.P
يُخصص تركيب البيانات الذي ترجعه \fBif_nameindex\fP() ديناميكيًا ويجب تحريره
باستخدام \fBif_freenameindex\fP() عند عدم الحاجة إليه.
.SH "قيمة الإرجاع"
عند النجاح، ترجع \fBif_nameindex\fP() مؤشرًا إلى المصفوفة؛ عند الخطأ، يُرجع
NULL، ويُضبط \fIerrno\fP للإشارة إلى الخطأ.
.SH الأخطاء
قد تفشل \fBif_nameindex\fP() وتضبط \fIerrno\fP إذا:
.TP 
\fBENOBUFS\fP
موارد غير كافية متاحة.
.P
قد تفشل \fBif_nameindex\fP() أيضًا لأي من الأخطاء المحددة لـ \fBsocket\fP(2)،
\fBbind\fP(2)، \fBioctl\fP(2)، \fBgetsockname\fP(2)، \fBrecvmsg\fP(2)، \fBsendto\fP(2)، أو
\fBmalloc\fP(3).
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBif_nameindex\fP(),
\fBif_freenameindex\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
POSIX.1\-2008, RFC\ 3493.
.SH التاريخ
glibc 2.1.  POSIX.1\-2001.  BSDi.
.P
قبل glibc 2.3.4، دعم التنفيذ فقط الواجهات بعناوين IPv4. دعم الواجهات التي لا
تحتوي على عناوين IPv4 متاح فقط على الأنوية التي تدعم netlink.
.SH أمثلة
يُظهر البرنامج أدناه استخدام الدوال الموصوفة في هذه الصفحة. مثال على
المخرجات التي قد ينتجها هذا البرنامج هو التالي:
.P
.in +4n
.EX
$\fB ./a.out\fP;
1: lo
2: wlan0
3: em1
.EE
.in
.SS "مصدر البرنامج"
.\" SRC BEGIN (if_nameindex.c)
.EX
#include <net/if.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
\&
int
main(void)
{
    struct if_nameindex *if_ni, *i;
\&
    if_ni = if_nameindex();
    if (if_ni == NULL) {
        perror("if_nameindex");
        exit(EXIT_FAILURE);
    }
\&
    for (i = if_ni; !(i\->if_index == 0 && i\->if_name == NULL); i++)
        printf("%u: %s\[rs]n", i\->if_index, i\->if_name);
\&
    if_freenameindex(if_ni);
\&
    exit(EXIT_SUCCESS);
}
.EE
.\" SRC END
.SH "انظر أيضًا"
\fBgetsockopt\fP(2), \fBsetsockopt\fP(2), \fBgetifaddrs\fP(3), \fBif_indextoname\fP(3),
\fBif_nametoindex\fP(3), \fBifconfig\fP(8)
.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 .