Scroll to navigation

fgetpwent(3) Library Functions Manual fgetpwent(3)

الاسم

fgetpwent - الحصول على مدخل ملف كلمة السر

المكتبة

مكتبة سي المعيارية (libc، -lc)

موجز

#include <stdio.h>
#include <sys/types.h>
#include <pwd.h>
struct passwd *fgetpwent(FILE *stream);

متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

fgetpwent():


منذ glibc 2.19:
_DEFAULT_SOURCE
في glibc 2.19 وما قبله:
_SVID_SOURCE

الوصف

ترجع الدالة fgetpwent() مؤشرًا إلى بنية تحتوي على الحقول المفصولة لسطر في الملف stream. عند استدعائها أول مرة، ترجع أول مدخل؛ وبعد ذلك، ترجع المداخل المتتالية. يجب أن يكون للملف المشار إليه بواسطة stream نفس تنسيق /etc/passwd (انظر passwd(5)).

عُرف هيكل passwd في <pwd.h> كالتالي:


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; /* برنامج الصدفة */ };

قيمة الإرجاع

ترجع الدالة fgetpwent() مؤشرًا إلى بنية passwd، أو NULL إذا لم يكن هناك المزيد من المداخل أو حدث خطأ. في حالة حدوث خطأ، يُضبط errno للإشارة إلى الخطأ.

الأخطاء

ذاكرة غير كافية لتخصيص بنية passwd.

الملفات

/etc/passwd
ملف قاعدة بيانات كلمات السر

السمات

للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).

الواجهة السمة القيمة
fgetpwent() سلامة الخيوط MT-Unsafe race:fgetpwent

المعايير

لا يوجد.

التاريخ

SVr4.

انظر أيضًا

endpwent(3), fgetpwent_r(3), fopen(3), getpw(3), getpwent(3), getpwnam(3), getpwuid(3), putpwent(3), setpwent(3), passwd(5)

ترجمة

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.

8 فبراير 2026 صفحات دليل لينكس (لم تصدر بعد)