.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993, David Metcalfe .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getservent 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم getservent, getservbyname, getservbyport, setservent, endservent \- الحصول على مدخل الخدمة .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBstruct servent *getservent(void);\fP .P \fBstruct servent *getservbyname(const char *\fP\fIname\fP\fB, const char *\fP\fIproto\fP\fB);\fP \fBstruct servent *getservbyport(int \fP\fIport\fP\fB, const char *\fP\fIproto\fP\fB);\fP .P \fBvoid setservent(int \fP\fIstayopen\fP\fB);\fP \fBvoid endservent(void);\fP .fi .SH الوصف تقرأ الدالة \fBgetservent\fP() المدخل التالي من قاعدة بيانات الخدمات (انظر \fBservices\fP(5)) وتُعيد بنية \fIservent\fP تحتوي على الحقول المفصولة من المدخل. يُفتح اتصال بقاعدة البيانات إذا لزم الأمر. .P تُعيد الدالة \fBgetservbyname\fP() بنية \fIservent\fP للمدخل من قاعدة البيانات الذي يطابق اسم الخدمة \fIname\fP باستخدام البروتوكول \fIproto\fP. إذا كان \fIproto\fP NULL، يُطابق أي بروتوكول. يُفتح اتصال بقاعدة البيانات إذا لزم الأمر. .P تُعيد الدالة \fBgetservbyport\fP() بنية \fIservent\fP للمدخل من قاعدة البيانات الذي يطابق المنفذ \fIport\fP (المُعطى بترتيب بايتات الشبكة) باستخدام البروتوكول \fIproto\fP. إذا كان \fIproto\fP NULL، يُطابق أي بروتوكول. يُفتح اتصال بقاعدة البيانات إذا لزم الأمر. .P تفتح الدالة \fBsetservent\fP() اتصالاً بقاعدة البيانات، وتضبط المدخل التالي على أنه المدخل الأول. إذا كان \fIstayopen\fP غير صفري، فلن يُغلق الاتصال بقاعدة البيانات بين استدعاءات إحدى دوال \fBgetserv*\fP(). .P تُغلق الدالة \fBendservent\fP() الاتصال بقاعدة البيانات. .P تُعرف بنية \fIservent\fP في \fI\fP كما يلي: .P .in +4n .EX struct servent { char *s_name; /* اسم الخدمة الرسمي */ char **s_aliases; /* قائمة الكنى */ int s_port; /* رقم المنفذ */ char *s_proto; /* البروتوكول الذي سيستخدم */ } .EE .in .P أعضاء بنية \fIservent\fP هم: .TP \fIs_name\fP الاسم الرسمي للخدمة. .TP \fIs_aliases\fP قائمة منتهية بـ NULL من الأسماء البديلة للخدمة. .TP \fIs_port\fP رقم المنفذ للخدمة المُعطى بترتيب بايتات الشبكة. .TP \fIs_proto\fP اسم البروتوكول المستخدم مع هذه الخدمة. .SH "قيمة الإرجاع" الدوال \fBgetservent\fP() و \fBgetservbyname\fP() و \fBgetservbyport\fP() تُرجع مؤشرًا إلى بنية \fIservent\fP مخصصة بشكل ثابت، أو NULL إذا حدث خطأ أو تم الوصول إلى نهاية الملف. .SH الملفات .TP \fI/etc/services\fP ملف قاعدة بيانات الخدمات .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lb lb lbx l l l. الواجهة السمة القيمة T{ .na .nh \fBgetservent\fP() T} سلامة الخيوط T{ .na .nh MT\-Unsafe race:servent race:serventbuf locale T} T{ .na .nh \fBgetservbyname\fP() T} سلامة الخيوط T{ .na .nh MT\-Unsafe race:servbyname locale T} T{ .na .nh \fBgetservbyport\fP() T} سلامة الخيوط T{ .na .nh MT\-Unsafe race:servbyport locale T} T{ .na .nh \fBsetservent\fP(), \fBendservent\fP() T} سلامة الخيوط T{ .na .nh MT\-Unsafe race:servent locale T} .TE .P في الجدول أعلاه، يشير \fIservent\fP في \fIrace:servent\fP إلى أنه إذا استُخدمت أي من الدوال \fBsetservent\fP() أو \fBgetservent\fP() أو \fBendservent\fP() بالتوازي في خيوط مختلفة من برنامج، فقد تحدث سباقات بيانات. .SH المعايير POSIX.1\-2008. .SH التاريخ POSIX.1\-2001، 4.3BSD. .SH "انظر أيضًا" \fBgetnetent\fP(3) و \fBgetprotoent\fP(3) و \fBgetservent_r\fP(3) و \fBservices\fP(5) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .