.\" -*- 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 getpwent 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم getpwent, setpwent, endpwent \- الحصول على مدخل ملف كلمة السر .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP \fB#include \fP .P \fBstruct passwd *getpwent(void);\fP \fBvoid setpwent(void);\fP \fBvoid endpwent(void);\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBgetpwent\fP()، \fBsetpwent\fP()، \fBendpwent\fP(): .nf .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED _XOPEN_SOURCE >= 500 || /* glibc >= 2.19: */ _DEFAULT_SOURCE || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .SH الوصف الدالة \fBgetpwent\fP() تُرجع مؤشرًا إلى بنية تحتوي على الحقول المفصولة لسجل من قاعدة بيانات كلمة السر (مثل ملف كلمة السر المحلي \fI/etc/passwd\fP، NIS، وLDAP). في المرة الأولى التي تُستدعى فيها \fBgetpwent\fP()، تُرجع المدخل الأول؛ وبعد ذلك، تُرجع المدخلات المتعاقبة. .P الدالة \fBsetpwent\fP() تُعيد التوجيه إلى بداية قاعدة بيانات كلمة السر. .P الدالة \fBendpwent\fP() تُستخدم لإغلاق قاعدة بيانات كلمة السر بعد إجراء كل المعالجة. .P عُرف هيكل \fIpasswd\fP في \fI\fP كالتالي: .P .in +4n .EX struct passwd { char *pw_name; /* اسم المستخدم */ char *pw_passwd; /* كلمة سر المستخدم */ uid_t pw_uid; /* معرف المستخدم */ gid_t pw_gid; /* معرف المجموعة */ char *pw_gecos; /* معلومات المستخدم */ char *pw_dir; /* دليل المنزل */ char *pw_shell; /* برنامج الصدفة */ }; .EE .in .P لمزيد من المعلومات حول حقول هذا الهيكل، راجع \fBpasswd\fP(5). .SH "قيمة الإرجاع" الدالة \fBgetpwent\fP() تُرجع مؤشرًا إلى بنية \fIpasswd\fP، أو NULL إذا لم يكن هناك المزيد من المدخلات أو حدث خطأ. إذا حدث خطأ، يُضبط \fIerrno\fP للإشارة إلى الخطأ. إذا أراد المرء التحقق من \fIerrno\fP بعد الاستدعاء، يجب ضبطه على الصفر قبل الاستدعاء. .P قد تشير القيمة المُرجعة إلى منطقة ثابتة، وقد تُستبدل باستدعاءات لاحقة لـ \fBgetpwent\fP()، \fBgetpwnam\fP(3)، أو \fBgetpwuid\fP(3). (لا تُمرر المؤشر المُعاد إلى \fBfree\fP(3).) .SH الأخطاء .TP \fBEINTR\fP اُلتُقطت إشارة؛ انظر \fBsignal\fP(7). .TP \fBEIO\fP خطأ إدخال/إخراج. .TP \fBEMFILE\fP وُصل إلى الحد الأقصى لواصفات الملفات المفتوحة لكل عملية. .TP \fBENFILE\fP وُصل إلى الحد الأقصى لإجمالي عدد الملفات المفتوحة على مستوى النظام. .TP \fBENOMEM\fP .\" not in POSIX .\" to allocate the passwd structure, or to allocate buffers ذاكرة غير كافية لتخصيص بنية \fIpasswd\fP. .TP \fBERANGE\fP مساحة المخزن المؤقت المقدمة غير كافية. .SH الملفات .TP \fI/etc/passwd\fP ملف قاعدة بيانات كلمات السر المحلية .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lb lb lbx l l l. الواجهة السمة القيمة T{ .na .nh \fBgetpwent\fP() T} سلامة الخيوط T{ .na .nh MT\-Unsafe race:pwent race:pwentbuf locale T} T{ .na .nh \fBsetpwent\fP()، \fBendpwent\fP() T} سلامة الخيوط T{ .na .nh غير آمن للمسارات المتعددة (MT\-Unsafe) سباق:pwent locale T} .TE .P في الجدول أعلاه، \fIpwent\fP في \fIrace:pwent\fP يُشير إلى أنه إذا استُخدمت أي من الدوال \fBsetpwent\fP()، \fBgetpwent\fP()، أو \fBendpwent\fP() بالتوازي في خيوط مختلفة من برنامج، فقد تحدث سباقات بيانات. .SH الإصدارات لم يُحدد حقل \fIpw_gecos\fP في POSIX، ولكنه موجود في معظم التنفيذات. .SH المعايير POSIX.1\-2008. .SH التاريخ POSIX.1\-2001، SVr4، 4.3BSD. .SH "انظر أيضًا" \fBfgetpwent\fP(3)، \fBgetpw\fP(3)، \fBgetpwent_r\fP(3)، \fBgetpwnam\fP(3)، \fBgetpwuid\fP(3)، \fBputpwent\fP(3)، \fBpasswd\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 .