Scroll to navigation

if_nametoindex(3) Library Functions Manual if_nametoindex(3)

الاسم

if_nametoindex, if_indextoname - تعيينات بين أسماء واجهات الشبكة وفهارسها

المكتبة

مكتبة سي المعيارية (libc، -lc)

موجز

#include <net/if.h>
unsigned int if_nametoindex(const char *ifname);
char *if_indextoname(unsigned int ifindex, char *ifname);

الوصف

تُرجع الدالة if_nametoindex() فهرس واجهة الشبكة المطابق للاسم ifname.

تُرجع الدالة if_indextoname() اسم واجهة الشبكة المطابق لفهرس الواجهة ifindex. يُوضع الاسم في المخزن المؤقت المشار إليه بـ ifname. يجب أن يسمح المخزن المؤقت بتخزين IF_NAMESIZE بايت على الأقل.

قيمة الإرجاع

عند النجاح، تُرجع if_nametoindex() رقم فهرس واجهة الشبكة؛ عند الخطأ، يُرجع 0 ويُضبط errno للإشارة إلى الخطأ.

عند النجاح، تُرجع if_indextoname() ifname؛ عند الخطأ، يُرجع NULL ويُضبط errno للإشارة إلى الخطأ.

الأخطاء

قد تفشل if_nametoindex() وتُضبط errno إذا:

لم يُعثر على واجهة بالاسم المُعطى.

قد تفشل if_indextoname() وتُضبط errno إذا:

لم يُعثر على واجهة للفهرس.

قد تفشل if_nametoindex() و if_indextoname() أيضًا لأي من الأخطاء المُحددة لـ socket(2) أو ioctl(2).

السمات

للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).

الواجهة السمة القيمة
if_nametoindex()، if_indextoname() سلامة الخيوط MT-Safe

المعايير

POSIX.1-2008, RFC 3493.

التاريخ

POSIX.1-2001. BSDi.

انظر أيضًا

getifaddrs(3)، if_nameindex(3)، ifconfig(8)

ترجمة

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.

8 فبراير 2026 صفحات دليل لينكس (لم تصدر بعد)