'\" t
.\"     Title: ll2_read_entry
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: دليل المبرمج
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "LL2_READ_ENTRY" "3" "2026-05-18" "util\-linux 2.42.1" "دليل المبرمج"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "الاسم"
ll2_read_entry \- يقرأ مدخلة واحدة من قاعدة البيانات ويُرجعها.
.SH "موجز"
.sp
\fB#include <lastlog2.h>\fP
.sp
\fBint ll2_read_entry (struct ll2_context *\fIcontext\fP, const char *\fIمستخدم\fP,
int64_t *\fIll_time\fP, char \fB\fItty\fP, char \fP\fIrhost\fP,
char \fB\fIpam_service\fP, char \fP\fIerror\fP);\fP
.SH "الوصف"
.sp
يقرأ المدخلة الأولى من قاعدة البيانات، المحددة في \fIcontext\fP، للمستخدم \fIمستخدم\fP. إذا كان \fIcontext\fP هو NULL، فستُتخذ قاعدة البيانات المبدئية المحددة في \fILL2_DEFAULT_DATABASE\fP.
.sp
.if n .RS 4
.nf
.fam C
char\&    *error = NULL;
const\&   char *user = "root";
int64_t res_time;
char\&    *res_tty = NULL;
char\&    *res_rhost = NULL;
char\&    *res_service = NULL;

int ret = ll2_read_entry (NULL, user, &res_time, &res_tty, &res_rhost, &res_service, &error);
.fam
.fi
.if n .RE
.SH "قيمة الإرجاع"
.sp
يُرجع 0 عند النجاح، و ‎\-ENOMEM أو ‎\-1 عند أي فشل آخر. يحتوي \fIerror\fP على سلسلة نصية للخطأ إذا كانت القيمة المرجعة هي ‎\-1. لا يُضمن احتواء \fIerror\fP على سلسلة نصية للخطأ، فقد يكون NULL أيضًا. يجب تحرير \fIerror\fP بواسطة \fIالمستدعِي\fP. إذا كانت قاعدة بيانات lastlog2 غير موجودة على الإطلاق، فتُضبط قيمة errno ENOENT ويمكن التحقق منها.
.sp
تُرجع القيم المُقيمة بواسطة \fIll_time\fP و \fItty\fP و \fIrhost\fP و \fIpam_service\fP.
.SH "المؤلفين"
.sp
.MTO "kukuk\(atsuse.de" "Thorsten Kukuk" ""
.SH "انظر أيضاً"
.sp
\fBlastlog2\fP(3)، \fBll2_new_context\fP(3)، \fBll2_unref_context\fP(3)، \fBll2_read_all\fP(3)، \fBll2_write_entry\fP(3)، \fBll2_update_login_time\fP(3)، \fBll2_remove_entry\fP(3)، \fBll2_rename_user\fP(3)، \fBll2_import_lastlog\fP(3)
.SH "التبليغ عن الأخطاء"
.sp
لتقارير العِلل، استخدم \c
.URL "https://github.com/util\-linux/util\-linux/issues" "مُتتبع المشكلات" "."
.SH "التوفر"
.sp
المكتبة \fBliblastlog2\fP جزء من حزمة util\-linux منذ الإصدار 2.40. يمكن تنزيلها من \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "أرشيف نواة لينكس" "."