.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993, David Metcalfe <david@prism.demon.co.uk>
.\" 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 getprotoent 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent \-
الحصول على مدخل البروتوكول
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <netdb.h>\fP
.P
\fBstruct protoent *getprotoent(void);\fP
.P
\fBstruct protoent *getprotobyname(const char *\fP\fIname\fP\fB);\fP
\fBstruct protoent *getprotobynumber(int \fP\fIproto\fP\fB);\fP
.P
\fBvoid setprotoent(int \fP\fIstayopen\fP\fB);\fP
\fBvoid endprotoent(void);\fP
.fi
.SH الوصف
تقرأ الدالة \fBgetprotoent\fP() المدخل التالي من قاعدة بيانات البروتوكولات
(انظر \fBprotocols\fP(5)) وتُعيد بنية \fIprotoent\fP تحتوي على الحقول المفصولة من
المدخل. يُفتح اتصال بقاعدة البيانات إذا لزم الأمر.
.P
تُعيد الدالة \fBgetprotobyname\fP() بنية \fIprotoent\fP للمدخل من قاعدة البيانات
الذي يطابق اسم البروتوكول \fIname\fP. يُفتح اتصال بقاعدة البيانات إذا لزم
الأمر.
.P
تُعيد الدالة \fBgetprotobynumber\fP() بنية \fIprotoent\fP للمدخل من قاعدة البيانات
الذي يطابق رقم البروتوكول \fInumber\fP. يُفتح اتصال بقاعدة البيانات إذا لزم
الأمر.
.P
تفتح الدالة \fBsetprotoent\fP() اتصالاً بقاعدة البيانات، وتضبط المدخل التالي
ليكون المدخل الأول. إذا كان \fIstayopen\fP غير صفري، فلا يُغلق الاتصال بقاعدة
البيانات بين استدعاءات إحدى دوال \fBgetproto*\fP().
.P
تُغلق الدالة \fBendprotoent\fP() الاتصال بقاعدة البيانات.
.P
تُعرف بنية \fIprotoent\fP في \fI<netdb.h>\fP كالتالي:
.P
.in +4n
.EX
struct protoent {
    char  *p_name;       /* الاسم الرسمي للبروتوكول */
    char **p_aliases;    /* قائمة الكنى*/
    int    p_proto;      /* رقم البروتوكول */
}
.EE
.in
.P
أعضاء بنية \fIprotoent\fP هم:
.TP 
\fIp_name\fP
الاسم الرسمي للبروتوكول.
.TP 
\fIp_aliases\fP
قائمة منتهية بـ NULL من الأسماء البديلة للبروتوكول.
.TP 
\fIp_proto\fP
رقم البروتوكول.
.SH "قيمة الإرجاع"
تُعيد الدوال \fBgetprotoent\fP() و \fBgetprotobyname\fP() و \fBgetprotobynumber\fP()
مؤشراً إلى بنية \fIprotoent\fP مخصصة بشكل ثابت، أو مؤشراً فارغاً إذا حدث خطأ أو
تم الوصول إلى نهاية الملف.
.SH الملفات
.PD 0
.TP 
\fI/etc/protocols\fP
ملف قاعدة بيانات البروتوكول
.PD
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lb lb lbx
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBgetprotoent\fP()
T}	سلامة الخيوط	T{
.na
.nh
MT\-Unsafe race:protoent
race:protoentbuf locale
T}
T{
.na
.nh
\fBgetprotobyname\fP()
T}	سلامة الخيوط	T{
.na
.nh
MT\-Unsafe race:protobyname
locale
T}
T{
.na
.nh
\fBgetprotobynumber\fP()
T}	سلامة الخيوط	T{
.na
.nh
MT\-Unsafe race:protobynumber
locale
T}
T{
.na
.nh
\fBsetprotoent\fP(),
\fBendprotoent\fP()
T}	سلامة الخيوط	T{
.na
.nh
MT\-Unsafe race:protoent
locale
T}
.TE
.P
في الجدول أعلاه، يشير \fIprotoent\fP في \fIrace:protoent\fP إلى أنه إذا استُخدمت
أي من الدوال \fBsetprotoent\fP() أو \fBgetprotoent\fP() أو \fBendprotoent\fP()
بالتوازي في خيوط مختلفة من برنامج، فقد تحدث سباقات بيانات.
.SH المعايير
POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001، 4.3BSD.
.SH "انظر أيضًا"
\fBgetnetent\fP(3)، \fBgetprotoent_r\fP(3)، \fBgetservent\fP(3)، \fBprotocols\fP(5)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .