.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2002, Ian Redfern <redferni@logica.com>
.\" 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 ether_aton 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
ether_aton, ether_ntoa, ether_ntohost, ether_hostton, ether_line,
ether_ntoa_r, ether_aton_r \- روتينات (دوال) معالجة عناوين الإيثرنت
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <netinet/ether.h>\fP
.P
\fBchar *ether_ntoa(const struct ether_addr *\fP\fIaddr\fP\fB);\fP
\fBstruct ether_addr *ether_aton(const char *\fP\fIasc\fP\fB);\fP
.P
\fBint ether_ntohost(char *\fP\fIhostname\fP\fB, const struct ether_addr *\fP\fIaddr\fP\fB);\fP
\fBint ether_hostton(const char *\fP\fIhostname\fP\fB, struct ether_addr *\fP\fIaddr\fP\fB);\fP
.P
\fBint ether_line(const char *\fP\fIline\fP\fB, struct ether_addr *\fP\fIaddr\fP\fB,\fP
\fB               char *\fP\fIhostname\fP\fB);\fP
.P
/* GNU extensions */
\fBchar *ether_ntoa_r(const struct ether_addr *\fP\fIaddr\fP\fB, char *\fP\fIbuf\fP\fB);\fP
.P
\fBstruct ether_addr *ether_aton_r(const char *\fP\fIasc\fP\fB,\fP
\fB                                struct ether_addr *\fP\fIaddr\fP\fB);\fP
.fi
.SH الوصف
تحوِّل \fBether_aton\fP() عنوان مضيف إيثرنت ذو 48 بت \fIasc\fP من الترميز المعياري
بالأرقام السداسية العشرية والنقطتين إلى بيانات ثنائية بترتيب بايتات الشبكة
وتُعيد مؤشرًا إليه في مخزن مؤقت مخصص بشكل ثابت، ستستبدله الاستدعاءات
اللاحقة. تُعيد \fBether_aton\fP() NULL إذا كان العنوان غير صالح.
.P
تحوِّل الدالة \fBether_ntoa\fP() عنوان مضيف إيثرنت \fIaddr\fP المُعطى بترتيب
بايتات الشبكة إلى سلسلة محارف بترميز الأرقام السداسية العشرية والنقطتين
المعياري، مع حذف الأصفار البادئة. تُعاد السلسلة في مخزن مؤقت مخصص بشكل ثابت،
ستستبدله الاستدعاءات اللاحقة.
.P
ترسم الدالة \fBether_ntohost\fP() عنوان إيثرنت إلى اسم المضيف المُقابل في
\fI/etc/ethers\fP وتُعيد قيمة غير صفرية إذا تعذر إيجاده.
.P
ترسم الدالة \fBether_hostton\fP() اسم مضيف إلى عنوان إيثرنت المُقابل في
\fI/etc/ethers\fP وتُعيد قيمة غير صفرية إذا تعذر إيجاده.
.P
تحلِّل الدالة \fBether_line\fP() سطرًا بصيغة \fI/etc/ethers\fP (عنوان إيثرنت يتبعه
فراغ ثم اسم مضيف؛ يُقدِّم \[aq]#\[aq] تعليقًا) وتُعيد زوج عنوان واسم مضيف،
أو قيمة غير صفرية إذا تعذر تحليله. يجب أن يكون المخزن المؤقت المُشار إليه
بواسطة \fIhostname\fP طويلًا بما يكفي \[em]على سبيل المثال، بنفس طول
\fIline\fP\[em].
.P
الدوال \fBether_ntoa_r\fP() و \fBether_aton_r\fP() هي نسخ آمنة للخيوط وقابلة
لإعادة الدخول من \fBether_ntoa\fP() و \fBether_aton\fP() على التوالي، ولا تستخدم
مخازن مؤقتة ثابتة.
.P
يُعرَّف الهيكل \fIether_addr\fP في \fI<net/ethernet.h>\fP كالتالي:
.P
.in +4n
.EX
struct ether_addr {
    uint8_t ether_addr_octet[6];
}
.EE
.in
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBether_aton\fP()،
\fBether_ntoa\fP()
T}	سلامة الخيوط	غير آمن لتعدد الخيوط (MT\-Unsafe)
T{
.na
.nh
\fBether_ntohost\fP()،
\fBether_hostton\fP()،
\fBether_line\fP()،
\fBether_ntoa_r\fP()،
\fBether_aton_r\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
لا شيء.
.SH التاريخ
4.3BSD, SunOS.
.SH العلل
.\" The fix was presumably commit c0a0f9a32c8baa6ab93d00eb42d92c02e9e146d7
.\" which was in glibc 2.3
في glibc 2.2.5 والإصدارات الأقدم، كان تنفيذ \fBether_line\fP() معطوبًا.
.SH "انظر أيضًا"
\fBethers\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 .