.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References: RFC 2553
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH inet_ntop 3 "28 يونيو 2025" "صفحات دليل لينكس 6.18" 
.SH الاسم
inet_ntop \- تحويل عناوين IPv4 و IPv6 من الصيغة الثنائية إلى الصيغة النصية
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <arpa/inet.h>\fP
.P
\fBconst char *inet_ntop(\fPsocklen_t size;
\fB                      int \fP\fIaf\fP\fB, const void *restrict \fP\fIsrc\fP\fB,\fP
\fB                      char \fP\fIdst\fP\fB[restrict \fP\fIsize\fP\fB], socklen_t \fP\fIsize\fP\fB);\fP
.fi
.SH الوصف
تحوّل هذه الدالة بنية عنوان الشبكة \fIsrc\fP في عائلة العناوين \fIaf\fP إلى سلسلة
محارف. تُنسخ السلسلة الناتجة إلى المخزن المؤقت المشار إليه بـ \fIdst\fP، والذي
يجب أن يكون مؤشرًا غير فارغ. يُحدد المستدعي عدد البايتات المتاحة في هذا
المخزن في المعامل \fIsize\fP.
.P
تمدّد \fBinet_ntop\fP() الدالة \fBinet_ntoa\fP(3) لدعم عائلات عناوين متعددة،
وتُعتبر \fBinet_ntoa\fP(3) الآن مهملة لصالح \fBinet_ntop\fP(). عائلات العناوين
التالية مدعومة حاليًا:
.TP 
\fBAF_INET\fP
يشير \fIsrc\fP إلى \fIstruct in_addr\fP (بترتيب بايتات الشبكة) والذي يُحوّل إلى
عنوان شبكة IPv4 في الصيغة العشرية المنقوطة،
\[dq]\fIddd.ddd.ddd.ddd\fP\[dq]. يجب أن يكون المخزن \fIdst\fP بطول
\fBINET_ADDRSTRLEN\fP بايت على الأقل.
.TP 
\fBAF_INET6\fP
يشير \fIsrc\fP إلى \fIstruct in6_addr\fP (بترتيب بايتات الشبكة) والذي يُحوّل إلى
تمثيل لهذا العنوان في أنسب صيغة عنوان شبكة IPv6 لهذا العنوان. يجب أن يكون
المخزن \fIdst\fP بطول \fBINET6_ADDRSTRLEN\fP بايت على الأقل.
.SH "قيمة الإرجاع"
عند النجاح، تُعيد \fBinet_ntop\fP() مؤشرًا غير فارغ إلى \fIdst\fP. يُعاد NULL إذا
حدث خطأ، مع تعيين \fIerrno\fP للإشارة إلى الخطأ.
.SH الأخطاء
.TP 
\fBEAFNOSUPPORT\fP
لم تكن \fIaf\fP عائلة عناوين صالحة.
.TP 
\fBENOSPC\fP
ستتجاوز سلسلة العنوان المحوّلة الحجم المُعطى بواسطة \fIsize\fP.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBinet_ntop\fP()
T}	سلامة الخيوط	المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe)
.TE
.SH المعايير
POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001.
.P
.\" 2.1.3: size_t, 2.1.91: socklen_t
لاحظ أن RFC\ 2553 يُعرّف نموذجًا أوليًا حيث المعامل الأخير \fIsize\fP من النوع
\fIsize_t\fP. تتبع العديد من الأنظمة RFC\ 2553. glibc 2.0 و 2.1 تحتوي على
\fIsize_t\fP، لكن 2.2 وما بعده تحتوي على \fIsocklen_t\fP.
.SH العلل
يحوّل \fBAF_INET6\fP عناوين IPv6 المُعيّنة لـ IPv4 إلى صيغة IPv6.
.SH أمثلة
انظر \fBinet_pton\fP(3).
.SH "انظر أيضًا"
\fBgetnameinfo\fP(3), \fBinet\fP(3), \fBinet_pton\fP(3)
.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 .