'\" t
.\"     Title: ll2_read_all
.\"    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_ALL" "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_all \- يقرأ جميع المدخلات من قاعدة البيانات ويستدعي دالة النداء المعاد (callback) لكل مدخل.
.SH "موجز"
.sp
\fB#include <lastlog2.h>\fP
\fBint ll2_read_all (struct ll2_context *\fIcontext\fP,
int (*\fIcallback\fP)(const char *\fIuser\fP, int64_t \fIll_time\fP,
const char *\fItty\fP, const char *\fIrhost\fP,
const char *\fIpam_service\fP, const char *\fIcb_error\fP),
char **\fIerror\fP);\fP
.SH "الوصف"
.sp
يقرأ جميع المدخلات من قاعدة البيانات، المحددة في \fIcontext\fP، ويستدعي دالة النداء المعاد \fIcallback\fP لكل مدخل. إذا كان \fIcontext\fP هو NULL، تُؤخذ قاعدة البيانات المبدئية المحددة في \fILL2_DEFAULT_DATABASE\fP.
.sp
.if n .RS 4
.nf
.fam C
char\&  *error = NULL;
const char *user = "root";

static int
callback (const char *res_user, int64_t ll_time, const char *res_tty,
          const char *res_rhost, const char *res_service, const char *cb_error)
{
   /* يُرجع != 0 إذا لم تعد هناك حاجة لمعالجة أي مدخلات إضافية بواسطة المستدعَى */
   return 0;
}

int ret = ll2_read_all (NULL, callback, &error);
.fam
.fi
.if n .RE
.SH "قيمة الإرجاع"
.sp
يُرجع 0 عند النجاح، و ‎\-ENOMEM أو ‎\-1 عند أي فشل آخر. يحتوي \fIerror\fP على سلسلة نصية للخطأ إذا كانت القيمة المرجعة هي ‎\-1. لا يُضمن احتواء \fIerror\fP على سلسلة نصية للخطأ، فقد يكون NULL أيضًا. يجب تحرير \fIerror\fP بواسطة \fIالمستدعِي\fP. إذا كانت قاعدة بيانات lastlog2 غير موجودة على الإطلاق، فتُضبط قيمة errno ENOENT ويمكن التحقق منها.
.SH "المؤلفين"
.sp
.MTO "kukuk\(atsuse.de" "Thorsten Kukuk" ""
.SH "انظر أيضاً"
.sp
\fBlastlog2\fP(3)، \fBll2_new_context\fP(3)، \fBll2_unref_context\fP(3)، \fBll2_write_entry\fP(3)، \fBll2_read_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/" "أرشيف نواة لينكس" "."