.\" -*- 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 getpw 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم getpw \- إعادة بناء مدخل سطر كلمة السر .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#define _GNU_SOURCE\fP /* انظر feature_test_macros(7) */ \fB#include \fP \fB#include \fP .P \fB[[مهمل]] int getpw(uid_t \fP\fIuid\fP\fB, char *\fP\fIbuf\fP\fB);\fP .fi .SH الوصف تعيد الدالة \fBgetpw\fP() بناء مدخل سطر كلمة السر لمعرف المستخدم \fIuid\fP المعطى في المخزن المؤقت \fIbuf\fP. يحتوي المخزن المؤقت المُعاد على سطر بالتنسيق .P .in +4n .EX \fBname:passwd:uid:gid:gecos:dir:shell\fP .EE .in .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 "قيمة الإرجاع" تُرجع الدالة \fBgetpw\fP() 0 عند النجاح؛ عند الخطأ، تُرجع \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .P إذا لم يُعثر على \fIuid\fP في قاعدة بيانات كلمة السر، تُرجع \fBgetpw\fP() \-1، وتضبط \fIerrno\fP إلى 0، وتترك \fIbuf\fP دون تغيير. .SH الأخطاء .TP \fB0\fP أو \fBENOENT\fP لا يوجد مستخدم مطابق لـ \fIuid\fP. .TP \fBEINVAL\fP \fIbuf\fP هو NULL. .TP \fBENOMEM\fP ذاكرة غير كافية لتخصيص بنية \fIpasswd\fP. .SH الملفات .TP \fI/etc/passwd\fP ملف قاعدة بيانات كلمات السر .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBgetpw\fP() T} سلامة الخيوط المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe) .TE .SH المعايير لا شيء. .SH التاريخ SVr2. .SH العلل الدالة \fBgetpw\fP() خطيرة لأنها قد تُفيض المخزن المؤقت \fIbuf\fP المُقدم. أُهملت بواسطة \fBgetpwuid\fP(3). .SH "انظر أيضًا" \fBendpwent\fP(3), \fBfgetpwent\fP(3), \fBgetpwent\fP(3), \fBgetpwnam\fP(3), \fBgetpwuid\fP(3), \fBputpwent\fP(3), \fBsetpwent\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 .