الاسم¶

getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent - الحصول على مدخل البروتوكول

المكتبة¶

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

موجز¶

#include <netdb.h>

struct protoent *getprotoent(void);

struct protoent *getprotobyname(const char *name);
struct protoent *getprotobynumber(int proto);

void setprotoent(int stayopen);
void endprotoent(void);

الوصف¶

تقرأ الدالة getprotoent() المدخل التالي من قاعدة بيانات البروتوكولات (انظر protocols(5)) وتُعيد بنية protoent تحتوي على الحقول المفصولة من المدخل. يُفتح اتصال بقاعدة البيانات إذا لزم الأمر.

تُعيد الدالة getprotobyname() بنية protoent للمدخل من قاعدة البيانات الذي يطابق اسم البروتوكول name. يُفتح اتصال بقاعدة البيانات إذا لزم الأمر.

تُعيد الدالة getprotobynumber() بنية protoent للمدخل من قاعدة البيانات الذي يطابق رقم البروتوكول number. يُفتح اتصال بقاعدة البيانات إذا لزم الأمر.

تفتح الدالة setprotoent() اتصالاً بقاعدة البيانات، وتضبط المدخل التالي ليكون المدخل الأول. إذا كان stayopen غير صفري، فلا يُغلق الاتصال بقاعدة البيانات بين استدعاءات إحدى دوال getproto*().

تُغلق الدالة endprotoent() الاتصال بقاعدة البيانات.

تُعرف بنية protoent في <netdb.h> كالتالي:

struct protoent {


    char  *p_name;       /* الاسم الرسمي للبروتوكول */


    char **p_aliases;    /* قائمة الكنى*/


    int    p_proto;      /* رقم البروتوكول */
}

أعضاء بنية protoent هم:

p_name

الاسم الرسمي للبروتوكول.

p_aliases

قائمة منتهية بـ NULL من الأسماء البديلة للبروتوكول.

p_proto

رقم البروتوكول.

قيمة الإرجاع¶

تُعيد الدوال getprotoent() و getprotobyname() و getprotobynumber() مؤشراً إلى بنية protoent مخصصة بشكل ثابت، أو مؤشراً فارغاً إذا حدث خطأ أو تم الوصول إلى نهاية الملف.

الملفات¶

/etc/protocols

ملف قاعدة بيانات البروتوكول

السمات¶

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

في الجدول أعلاه، يشير protoent في race:protoent إلى أنه إذا استُخدمت أي من الدوال setprotoent() أو getprotoent() أو endprotoent() بالتوازي في خيوط مختلفة من برنامج، فقد تحدث سباقات بيانات.

المعايير¶

POSIX.1-2008.

التاريخ¶

POSIX.1-2001، 4.3BSD.

انظر أيضًا¶

getnetent(3)، getprotoent_r(3)، getservent(3)، protocols(5)

ترجمة¶

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

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

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