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 للإشارة إلى الخطأ.

الأخطاء

ENOMEM
    ذاكرة غير كافية لتخصيص بنية 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 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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