getrpcent(3)

الاسم
getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent - الحصول على مدخل RPC

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

موجز
#include <netdb.h>

struct rpcent *getrpcent(void);

struct rpcent *getrpcbyname(const char *name);
struct rpcent *getrpcbynumber(int number);

void setrpcent(int stayopen);
void endrpcent(void);

الوصف
ترجع الدوال getrpcent() و getrpcbyname() و getrpcbynumber() كل منها مؤشرًا إلى كائن بالبنية التالية التي تحتوي على الحقول المفصولة لمدخل في قاعدة بيانات أرقام برامج RPC.

    struct rpcent {
        char  *r_name;     /* اسم الخادم لبرنامج RPC هذا */
        char **r_aliases;  /* قائمة الأسماء المستعارة */
        long   r_number;   /* رقم برنامج RPC */
    };

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

r_name
    اسم الخادم لبرنامج RPC هذا.

r_aliases
    قائمة منتهية بـ NULL من الأسماء البديلة لبرنامج RPC.

r_number
    رقم برنامج RPC لهذه الخدمة.

تقرأ الدالة getrpcent() المدخل التالي من قاعدة البيانات. يُفتح اتصال بقاعدة البيانات إذا لزم الأمر.

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

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

تبحث الدالتان getrpcbyname() و getrpcbynumber() بشكل تسلسلي من بداية الملف حتى يُعثر على اسم برنامج RPC مطابق أو رقم برنامج مطابق، أو حتى يتم الوصول إلى نهاية الملف.

قيمة الإرجاع
عند النجاح، ترجع getrpcent() و getrpcbyname() و getrpcbynumber() مؤشرًا إلى بنية rpcent مخصصة بشكل ثابت. يُرجع NULL عند نهاية الملف أو الخطأ.

الملفات

/etc/rpc
    قاعدة بيانات أرقام برامج RPC.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
getrpcent()، getrpcbyname()، getrpcbynumber() | سلامة الخيوط | غير آمن لتعدد الخيوط (MT-Unsafe)
setrpcent(), endrpcent() | سلامة الخيوط | المنطقة (locale) آمنة لتعدد المسالك (MT-Safe)

المعايير
BSD.

التاريخ
BSD، وسولاريس.

العلل
تُحتوى جميع المعلومات في منطقة ثابتة لذا يجب نسخها إذا أُريد حفظها.

انظر أيضًا
getrpcent_r(3)، rpc(5)، rpcinfo(8)، ypserv(8)

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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