getprotoent(3)

الاسم
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).
الواجهة | السمة | القيمة
getprotoent() | سلامة الخيوط | MT-Unsafe race:protoent race:protoentbuf locale
getprotobyname() | سلامة الخيوط | MT-Unsafe race:protobyname locale
getprotobynumber() | سلامة الخيوط | MT-Unsafe race:protobynumber locale
setprotoent(), endprotoent() | سلامة الخيوط | MT-Unsafe race:protoent locale

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

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