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 إذا:

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

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

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

قد تفشل 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 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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