.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993, David Metcalfe .\" 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 getgrnam 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم getgrnam, getgrnam_r, getgrgid, getgrgid_r \- الحصول على مدخلة ملف المجموعة .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP \fB#include \fP .P \fBstruct group *getgrnam(const char *\fP\fIname\fP\fB);\fP \fBstruct group *getgrgid(gid_t \fP\fIgid\fP\fB);\fP .P \fBint getgrnam_r(\fPsize_t size; \fB const char *restrict \fP\fIname\fP\fB, struct group *restrict \fP\fIgrp\fP\fB,\fP \fB char \fP\fIbuf\fP\fB[restrict \fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB,\fP \fB struct group **restrict \fP\fIresult\fP\fB);\fP \fBint getgrgid_r(\fPsize_t size; \fB gid_t \fP\fIgid\fP\fB, struct group *restrict \fP\fIgrp\fP\fB,\fP \fB char \fP\fIbuf\fP\fB[restrict \fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB,\fP \fB struct group **restrict \fP\fIresult\fP\fB);\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBgetgrnam_r\fP(), \fBgetgrgid_r\fP(): .nf _POSIX_C_SOURCE || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .SH الوصف ترجع الدالة \fBgetgrnam\fP() مؤشرًا إلى بنية تحتوي على الحقول المفصولة للسجل في قاعدة بيانات المجموعة (مثل ملف المجموعة المحلي \fI/etc/group\fP، وNIS، وLDAP) الذي يطابق اسم المجموعة \fIname\fP. .P ترجع الدالة \fBgetgrgid\fP() مؤشرًا إلى بنية تحتوي على الحقول المفصولة للسجل في قاعدة بيانات المجموعة الذي يطابق معرف المجموعة \fIgid\fP. .P عُرف هيكل \fIgroup\fP في \fI\fP كالتالي: .P .in +4n .EX struct group { char *gr_name; /* اسم المجموعة */ char *gr_passwd; /* كلمة سر المجموعة */ gid_t gr_gid; /* معرف المجموعة */ char **gr_mem; /* مصفوفة منتهية بـ NULL من المؤشرات إلى أسماء أعضاء المجموعة */ }; .EE .in .P لمزيد من المعلومات حول حقول هذا الهيكل، راجع \fBgroup\fP(5). .P تحصل الدالتان \fBgetgrnam_r\fP() و\fBgetgrgid_r\fP() على نفس المعلومات مثل \fBgetgrnam\fP() و\fBgetgrgid\fP()، لكن تخزنان بنية \fIgroup\fP المسترجعة في المساحة المشار إليها بواسطة \fIgrp\fP. تُخزن حقول السلاسل المحارف المشار إليها بواسطة أعضاء بنية \fIgroup\fP في المخزن المؤقت \fIbuf\fP بحجم \fIsize\fP. يُخزن مؤشر إلى النتيجة (في حالة النجاح) أو NULL (في حالة عدم العثور على مدخل أو حدوث خطأ) في \fI*result\fP. .P الاستدعاء .P .in +4n .EX sysconf(_SC_GETGR_R_SIZE_MAX) .EE .in .P يرجع إما \-1، دون تغيير \fIerrno\fP، أو حجمًا مقترحًا مبدئيًا لـ \fIbuf\fP. (إذا كان هذا الحجم صغيرًا جدًا، يفشل الاستدعاء بـ \fBERANGE\fP، وفي هذه الحالة يمكن للمستدعي (caller) المحاولة مرة أخرى بذاكرة وسيطة أكبر.) .SH "قيمة الإرجاع" ترجع الدالتان \fBgetgrnam\fP() و\fBgetgrgid\fP() مؤشرًا إلى بنية \fIgroup\fP، أو NULL إذا لم يُعثر على المدخل المطابق أو حدث خطأ. إذا حدث خطأ، يُضبط \fIerrno\fP للإشارة إلى الخطأ. إذا أراد المرء التحقق من \fIerrno\fP بعد الاستدعاء، فيجب ضبطه على الصفر قبل الاستدعاء. .P قد يشير القيمة المرجعة إلى منطقة ثابتة، وقد تُستبدل باستدعاءات لاحقة لـ \fBgetgrent\fP(3) أو \fBgetgrgid\fP() أو \fBgetgrnam\fP(). (لا تمرر المؤشر المرتجع إلى \fBfree\fP(3).) .P عند النجاح، ترجع \fBgetgrnam_r\fP() و\fBgetgrgid_r\fP() صفرًا، وتضبط \fI*result\fP على \fIgrp\fP. إذا لم يُعثر على سجل مجموعة مطابق، ترجع هاتان الدالتان 0 وتخزنان NULL في \fI*result\fP. في حالة الخطأ، يُرجع رقم خطأ، ويُخزن NULL في \fI*result\fP. .SH الأخطاء .TP \fB0\fP أو \fBENOENT\fP أو \fBESRCH\fP أو \fBEBADF\fP أو \fBEPERM\fP أو ... لم يُعثر على \fIname\fP أو \fIgid\fP المعطى. .TP \fBEINTR\fP اُلتُقطت إشارة؛ انظر \fBsignal\fP(7). .TP \fBEIO\fP خطأ إدخال/إخراج. .TP \fBEMFILE\fP وُصل إلى الحد الأقصى لواصفات الملفات المفتوحة لكل عملية. .TP \fBENFILE\fP وُصل إلى الحد الأقصى لإجمالي عدد الملفات المفتوحة على مستوى النظام. .TP \fBENOMEM\fP .\" not in POSIX .\" to allocate the group structure, or to allocate buffers ذاكرة غير كافية لتخصيص بنية \fIgroup\fP. .TP \fBERANGE\fP مساحة المخزن المؤقت المقدمة غير كافية. .SH الملفات .TP \fI/etc/group\fP ملف قاعدة بيانات المجموعات المحلية .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lb lb lbx l l l. الواجهة السمة القيمة T{ .na .nh \fBgetgrnam\fP() T} سلامة الخيوط T{ .na .nh MT\-Unsafe race:grnam locale T} T{ .na .nh \fBgetgrgid\fP() T} سلامة الخيوط T{ .na .nh MT\-Unsafe race:grgid locale T} T{ .na .nh \fBgetgrnam_r\fP(), \fBgetgrgid_r\fP() T} سلامة الخيوط المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe) .TE .SH الإصدارات .\" POSIX.1-2001, POSIX.1-2008 .\" more precisely: .\" AIX 5.1 - gives ESRCH .\" OSF1 4.0g - gives EWOULDBLOCK .\" libc, glibc up to glibc 2.6, Irix 6.5 - give ENOENT .\" since glibc 2.7 - give 0 .\" FreeBSD 4.8, OpenBSD 3.2, NetBSD 1.6 - give EPERM .\" SunOS 5.8 - gives EBADF .\" Tru64 5.1b, HP-UX-11i, SunOS 5.7 - give 0 الصياغة المذكورة أعلاه تحت "القيمة المرجعة" مأخوذة من POSIX.1. لا تعتبر "عدم العثور" خطأ، وبالتالي لا تحدد القيمة التي قد يحملها \fIerrno\fP في هذه الحالة. لكن هذا يجعل التعرف على الأخطاء مستحيلًا. قد يجادل المرء بأنه وفقًا لـ POSIX، يجب ترك \fIerrno\fP دون تغيير إذا لم يُعثر على مدخل. تُظهر التجارب على أنظمة شبيهة بـ UNIX المختلفة أن العديد من القيم المختلفة تظهر في هذه الحالة: 0، ENOENT، EBADF، ESRCH، EWOULDBLOCK، EPERM، وربما أخرى. .SH المعايير POSIX.1\-2008. .SH التاريخ POSIX.1\-2001، SVr4، 4.3BSD. .SH "انظر أيضًا" \fBendgrent\fP(3), \fBfgetgrent\fP(3), \fBgetgrent\fP(3), \fBgetpwnam\fP(3), \fBsetgrent\fP(3), \fBgroup\fP(5) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .