.\" -*- coding: UTF-8 -*-
'\" t
.\" 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 getnetent_r 3 "28 يونيو 2025" "صفحات دليل لينكس 6.18" 
.SH الاسم
getnetent_r, getnetbyname_r, getnetbyaddr_r \- الحصول على مدخل الشبكة (قابل
لإعادة الدخول)
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <netdb.h>\fP
.P
\fBint getnetent_r(\fPsize_t size;
\fB                struct netent *restrict \fP\fIresult_buf\fP\fB,\fP
\fB                char \fP\fIbuf\fP\fB[restrict \fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB,\fP
\fB                struct netent **restrict \fP\fIresult\fP\fB,\fP
\fB                int *restrict \fP\fIh_errnop\fP\fB);\fP
\fBint getnetbyname_r(\fPsize_t size;
\fB                const char *restrict \fP\fIname\fP\fB,\fP
\fB                struct netent *restrict \fP\fIresult_buf\fP\fB,\fP
\fB                char \fP\fIbuf\fP\fB[restrict \fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB,\fP
\fB                struct netent **restrict \fP\fIresult\fP\fB,\fP
\fB                int *restrict \fP\fIh_errnop\fP\fB);\fP
\fBint getnetbyaddr_r(\fPsize_t size;
\fB                uint32_t \fP\fInet\fP\fB, int \fP\fItype\fP\fB,\fP
\fB                struct netent *restrict \fP\fIresult_buf\fP\fB,\fP
\fB                char \fP\fIbuf\fP\fB[restrict \fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB,\fP
\fB                struct netent **restrict \fP\fIresult\fP\fB,\fP
\fB                int *restrict \fP\fIh_errnop\fP\fB);\fP
.P
.fi
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBgetnetent_r\fP()، \fBgetnetbyname_r\fP()، \fBgetnetbyaddr_r\fP():
.nf
    منذ glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 وما قبله:
        _BSD_SOURCE || _SVID_SOURCE
.fi
.SH الوصف
الدوال \fBgetnetent_r\fP() و \fBgetnetbyname_r\fP() و \fBgetnetbyaddr_r\fP() هي
المكافئات القابلة لإعادة الدخول لـ \fBgetnetent\fP(3) و \fBgetnetbyname\fP(3) و
\fBgetnetbynumber\fP(3) على التوالي. تختلف في طريقة إرجاع بنية \fInetent\fP وفي
توقيع استدعاء الدالة وقيمة الإرجاع. تصف صفحة الدليل هذه الاختلافات فقط عن
الدوال غير القابلة لإعادة الدخول.
.P
بدلاً من إرجاع مؤشر إلى بنية \fInetent\fP مخصصة بشكل ثابت كنتيجة للدالة، تنسخ
هذه الدوال البنية إلى الموقع المشار إليه بواسطة \fIresult_buf\fP.
.P
.\" I can find no information on the required/recommended buffer size;
.\" the nonreentrant functions use a 1024 byte buffer -- mtk.
تُستخدم المصفوفة \fIbuf\fP لتخزين حقول السلاسل المحارف المشار إليها بواسطة بنية
\fInetent\fP المُرجعة. (تخصص الدوال غير القابلة لإعادة الدخول هذه السلاسل في
تخزين ثابت.) يُحدد حجم هذه المصفوفة في \fIsize\fP. إذا كانت \fIbuf\fP صغيرة جدًا،
يفشل الاستدعاء مع الخطأ \fBERANGE\fP، ويجب على المستدعي المحاولة مرة أخرى بمخزن
مؤقت أكبر. (يجب أن يكون مخزن مؤقت بحجم 1024 بايت كافيًا لمعظم التطبيقات.)
.P
إذا حصل استدعاء الدالة بنجاح على سجل شبكة، فسيُضبط \fI*result\fP ليشير إلى
\fIresult_buf\fP؛ وإلا، فسيُضبط \fI*result\fP إلى NULL.
.P
.\" getnetent.3 doesn't document any use of h_errno, but nevertheless
.\" the nonreentrant functions no seem to set h_errno.
يُستخدم المخزن المؤقت المشار إليه بواسطة \fIh_errnop\fP لإرجاع القيمة التي
ستُخزن في المتغير العام \fIh_errno\fP بواسطة الإصدارات غير القابلة لإعادة
الدخول من هذه الدوال.
.SH "قيمة الإرجاع"
تُعيد هذه الدوال 0 عند النجاح. وتُعيد أحد أرقام الأخطاء الموجبة المدرجة في
قسم ERRORS عند حدوث خطأ.
.P
عند حدوث خطأ، أو عدم العثور على السجل (\fBgetnetbyname_r\fP()،
\fBgetnetbyaddr_r\fP())، أو نهاية الإدخال (\fBgetnetent_r\fP())، يُضبط \fIresult\fP
إلى NULL.
.SH الأخطاء
.TP 
\fBENOENT\fP
(\fBgetnetent_r\fP()) لا توجد سجلات أخرى في قاعدة البيانات.
.TP 
\fBERANGE\fP
المخزن المؤقت \fIbuf\fP صغير جدًا. حاول مرة أخرى بمخزن أكبر (وزيادة \fIsize\fP).
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBgetnetent_r\fP()،
\fBgetnetbyname_r\fP()،
\fBgetnetbyaddr_r\fP()
T}	سلامة الخيوط	المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe)
.TE
.SH الإصدارات
توجد دوال بأسماء مماثلة في بعض الأنظمة الأخرى، وإن كان ذلك عادةً بتواقيع
استدعاء مختلفة.
.SH المعايير
GNU.
.SH "انظر أيضًا"
\fBgetnetent\fP(3)، \fBnetworks\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 .