.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993, Rickard E. Faith <faith@cs.unc.edu>
.\" Copyright 1993, Mitchum DSouza <m.dsouza@mrc-apu.cam.ac.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 gethostid 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
gethostid, sethostid \- الحصول على أو تعيين المعرف الفريد للمضيف الحالي
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <unistd.h>\fP
.P
\fBlong gethostid(void);\fP
\fBint sethostid(long \fP\fIhostid\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBgethostid\fP():
.nf
.\"        || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
.\"        || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
    منذ glibc 2.20:
        _DEFAULT_SOURCE || _XOPEN_SOURCE >= 500
    حتى و بما في ذلك glibc 2.19:
        _BSD_SOURCE || _XOPEN_SOURCE >= 500
.fi
.P
\fBsethostid\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 الوصف
\fBgethostid\fP() و \fBsethostid\fP() تحصلان أو تعينان على التوالي معرفًا فريدًا
بحجم 32 بت للجهاز الحالي. كان المقصود من المعرف ذي 32 بت أن يكون فريدًا بين
جميع أنظمة UNIX الموجودة. يشبه هذا عادةً عنوان الإنترنت للجهاز المحلي، كما
يُعاد بواسطة \fBgethostbyname\fP(3)، وبالتالي لا يحتاج عادةً إلى التعيين.
.P
استدعاء \fBsethostid\fP() مقصور على المستخدم الفائق.
.SH "قيمة الإرجاع"
\fBgethostid\fP() تُعيد المعرف ذا 32 بت للمضيف الحالي كما عُيّن بواسطة
\fBsethostid\fP().
.P
عند النجاح، \fBsethostid\fP() تُعيد 0؛ عند الخطأ، تُعاد \-1، ويُعيّن \fIerrno\fP
للإشارة إلى الخطأ.
.SH الأخطاء
يمكن أن يفشل \fBsethostid\fP() مع الأخطاء التالية:
.TP 
\fBEACCES\fP
لم يكن لدى المستدعي صلاحية الكتابة إلى الملف المستخدم لتخزين معرف المضيف.
.TP 
\fBEPERM\fP
معرف المستخدم الفعال أو معرف المجموعة الفعال لعملية الاستدعاء ليس هو نفسه
المعرف الحقيقي المقابل.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lb lb lbx
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBgethostid\fP()
T}	سلامة الخيوط	T{
.na
.nh
MT\-Safe hostid env locale
T}
T{
.na
.nh
\fBsethostid\fP()
T}	سلامة الخيوط	T{
.na
.nh
MT\-Unsafe const:hostid
T}
.TE
.SH الإصدارات
.\" libc5 used /etc/hostid; libc4 didn't have these functions
في تطبيق glibc، يُخزَّن \fIhostid\fP في الملف \fI/etc/hostid\fP. (قبل glibc 2.2،
كان الملف \fI/var/adm/hostid\fP يُستخدم.)
.P
في تطبيق glibc، إذا لم يستطع \fBgethostid\fP() فتح الملف المحتوي على معرف
المضيف، فإنه يحصل على اسم المضيف باستخدام \fBgethostname\fP(2)، ويمرر اسم
المضيف هذا إلى \fBgethostbyname_r\fP(3) للحصول على عنوان IPv4 للمضيف، ويُعيد
قيمة تم الحصول عليها بالتلاعب بالبتات في عنوان IPv4. (قد لا تكون هذه القيمة
فريدة.)
.SH المعايير
.TP 
\fBgethostid\fP()
POSIX.1\-2008.
.TP 
\fBsethostid\fP()
لا شيء.
.SH التاريخ
4.2BSD؛ أُسقط في 4.4BSD. SVr4 و POSIX.1\-2001 يتضمنان \fBgethostid\fP() ولكن ليس
\fBsethostid\fP().
.SH العلل
من المستحيل ضمان أن المُعرِّف فريد عالميًا.
.SH "انظر أيضًا"
\fBhostid\fP(1)، \fBgethostbyname\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 .