.\" -*- 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 getgrent 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم getgrent, setgrent, endgrent \- الحصول على مدخل ملف المجموعة .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP \fB#include \fP .P \fBstruct group *getgrent(void);\fP .P \fBvoid setgrent(void);\fP \fBvoid endgrent(void);\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBsetgrent\fP(): .nf .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED _XOPEN_SOURCE >= 500 || /* glibc >= 2.19: */ _DEFAULT_SOURCE || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .P \fBgetgrent\fP(), \fBendgrent\fP(): .nf .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED منذ glibc 2.22: _XOPEN_SOURCE >= 500 || _DEFAULT_SOURCE glibc 2.21 وما قبلها _XOPEN_SOURCE >= 500 || /* Since glibc 2.12: */ _POSIX_C_SOURCE >= 200809L || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .SH الوصف ترجع الدالة \fBgetgrent\fP() مؤشرًا إلى بنية تحتوي على الحقول المفصولة لسجل في قاعدة بيانات المجموعة (مثل ملف المجموعة المحلي \fI/etc/group\fP وNIS وLDAP). عند استدعاء \fBgetgrent\fP() لأول مرة، ترجع أول مدخل؛ وبعد ذلك، ترجع المدخلات المتعاقبة. .P تعيد الدالة \fBsetgrent\fP() التوجيه إلى بداية قاعدة بيانات المجموعة، للسماح بالمسح المتكرر. .P تُستخدم الدالة \fBendgrent\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). .SH "قيمة الإرجاع" ترجع الدالة \fBgetgrent\fP() مؤشرًا إلى بنية \fIgroup\fP، أو NULL إذا لم يكن هناك المزيد من المدخلات أو حدث خطأ. .P عند حدوث خطأ، قد يُضبط \fIerrno\fP. إذا أراد المرء التحقق من \fIerrno\fP بعد الاستدعاء، فيجب ضبطه على الصفر قبل الاستدعاء. .P قد يشير القيمة المرجعة إلى منطقة ثابتة، وقد تُستبدل باستدعاءات لاحقة لـ \fBgetgrent\fP() أو \fBgetgrgid\fP(3) أو \fBgetgrnam\fP(3). (لا تمرر المؤشر المرتجع إلى \fBfree\fP(3).) .SH الأخطاء .TP \fBEAGAIN\fP الخدمة غير متاحة مؤقتًا؛ حاول مرة أخرى لاحقًا. بالنسبة لواجهات NSS الخلفية في glibc، يشير هذا إلى خطأ مؤقت في التواصل مع الواجهة الخلفية. قد يصحح الخطأ نفسه؛ يُقترح إعادة المحاولة لاحقًا. .TP \fBEINTR\fP اُلتُقطت إشارة؛ انظر \fBsignal\fP(7). .TP \fBEIO\fP خطأ إدخال/إخراج. .TP \fBEMFILE\fP وُصل إلى الحد الأقصى لواصفات الملفات المفتوحة لكل عملية. .TP \fBENFILE\fP وُصل إلى الحد الأقصى لإجمالي عدد الملفات المفتوحة على مستوى النظام. .TP .\" not in POSIX \fBENOENT\fP لا يمكن العثور على ملف إدخال ضروري. بالنسبة لواجهات NSS الخلفية في glibc، يشير هذا إلى أن الواجهة الخلفية لم تُضبط بشكل صحيح. .TP \fBENOMEM\fP .\" not in POSIX ذاكرة غير كافية لتخصيص بنية \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 \fBgetgrent\fP() T} سلامة الخيوط T{ .na .nh MT\-Unsafe race:grent race:grentbuf locale T} T{ .na .nh \fBsetgrent\fP(), \fBendgrent\fP() T} سلامة الخيوط T{ .na .nh غير آمن للمسارات المتعددة (MT\-Unsafe) سباق:grent locale T} .TE .P في الجدول أعلاه، يشير \fIgrent\fP في \fIrace:grent\fP إلى أنه إذا استُخدمت أي من الدوال \fBsetgrent\fP() أو \fBgetgrent\fP() أو \fBendgrent\fP() بالتوازي في خيوط مختلفة من برنامج، فقد تحدث سباقات بيانات. .SH المعايير POSIX.1\-2008. .SH التاريخ POSIX.1\-2001، SVr4، 4.3BSD. .SH "انظر أيضًا" \fBfgetgrent\fP(3), \fBgetgrent_r\fP(3), \fBgetgrgid\fP(3), \fBgetgrnam\fP(3), \fBgetgrouplist\fP(3), \fBputgrent\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 .