.\" -*- coding: UTF-8 -*-
.\" Copyright 1993, Rickard E. Faith <faith@cs.unc.edu>
.\" 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 getdomainname 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
getdomainname, setdomainname \- الحصول/تعيين اسم نطاق NIS
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <unistd.h>\fP
.P
\fBint getdomainname(\fPsize_t size;
\fB                  char \fP\fIname\fP\fB[\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB);\fP
\fBint setdomainname(\fPsize_t size;
\fB                  const char \fP\fIname\fP\fB[\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBgetdomainname\fP(), \fBsetdomainname\fP():
.nf
.\"		commit 266865c0e7b79d4196e2cc393693463f03c90bd8
    منذ glibc 2.21:
        _DEFAULT_SOURCE
    في glibc 2.19 و 2.20:
        _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
    حتى glibc 2.19 وما قبله:
        _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
.fi
.SH الوصف
تُستخدم هذه الدوال للوصول إلى اسم نطاق NIS للنظام المضيف أو تغييره.  بشكل
أدق، تعمل على اسم نطاق NIS المرتبط بمساحة أسماء UTS الخاصة بالعملية
المستدعية.
.P
تضبط \fBsetdomainname\fP() اسم النطاق على القيمة المعطاة في المصفوفة المحرفية
\fIname\fP.  تحدد الوسيطة \fIsize\fP عدد البايتات في \fIname\fP.  (وبالتالي، لا تتطلب
\fIname\fP بايت فارغ في النهاية.)
.P
ترجع \fBgetdomainname\fP() اسم النطاق المنتهي بفارغ في المصفوفة المحرفية
\fIname\fP، التي حجمها \fIsize\fP بايت.  إذا كان اسم النطاق المنتهي بفارغ يتطلب
أكثر من \fIlen\fP بايت، ترجع \fBgetdomainname\fP() أول \fIlen\fP بايت (glibc) أو تعطي
خطأ (libc).
.SH "قيمة الإرجاع"
عند النجاح، يُعاد الصفر. وعند حدوث خطأ، يُعاد الرقم \-1، ويُضبط \fIerrno\fP
للإشارة إلى الخطأ.
.SH الأخطاء
قد تفشل \fBsetdomainname\fP() مع الأخطاء التالية:
.TP 
\fBEFAULT\fP
أشار \fIname\fP إلى خارج مساحة عنوان المستخدم.
.TP 
\fBEINVAL\fP
كانت \fIsize\fP سالبة أو كبيرة جدًا.
.TP 
\fBEPERM\fP
لم يمتلك المستدعي القدرة \fBCAP_SYS_ADMIN\fP في مساحة اسم المستخدم المرتبطة
بمساحة أسماء UTS الخاصة به (انظر \fBnamespaces\fP(7)).
.P
قد تفشل \fBgetdomainname\fP() مع الأخطاء التالية:
.TP 
\fBEINVAL\fP
بالنسبة لـ \fBgetdomainname\fP() تحت libc: \fIname\fP هو NULL أو \fIname\fP يساوي أو
أطول من \fIsize\fP بايت.
.SH الإصدارات
في معظم بنى لينكس (بما في ذلك x86)، لا يوجد استدعاء نظام \fBgetdomainname\fP()؛
بدلاً من ذلك، تنفذ glibc \fBgetdomainname\fP() كدالة مكتبة ترجع نسخة من حقل
\fIdomainname\fP الذي يُرجع من استدعاء \fBuname\fP(2).
.SH المعايير
.\" But they appear on most systems...
لا شيء.
.SH التاريخ
منذ لينكس 1.0، الحد الأقصى لحجم اسم النطاق، بما في ذلك البايت الفارغ في
النهاية، هو 64 بايت.  في النوى الأقدم، كان 8 بايت.
.SH "انظر أيضًا"
\fBgethostname\fP(2), \fBsethostname\fP(2), \fBuname\fP(2), \fButs_namespaces\fP(7)
.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 .