الاسم

ll2_read_all - يقرأ جميع المدخلات من قاعدة البيانات ويستدعي دالة النداء المعاد (callback) لكل مدخل.

موجز

#include <lastlog2.h> int ll2_read_all (struct ll2_context *context, int (*callback)(const char *user, int64_t ll_time, const char *tty, const char *rhost, const char *pam_service, const char *cb_error), char **error);

الوصف

يقرأ جميع المدخلات من قاعدة البيانات، المحددة في context، ويستدعي دالة النداء المعاد callback لكل مدخل. إذا كان context هو NULL، تُؤخذ قاعدة البيانات المبدئية المحددة في LL2_DEFAULT_DATABASE.

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);

قيمة الإرجاع

يُرجع 0 عند النجاح، و ‎-ENOMEM أو ‎-1 عند أي فشل آخر. يحتوي error على سلسلة نصية للخطأ إذا كانت القيمة المرجعة هي ‎-1. لا يُضمن احتواء error على سلسلة نصية للخطأ، فقد يكون NULL أيضًا. يجب تحرير error بواسطة المستدعِي. إذا كانت قاعدة بيانات lastlog2 غير موجودة على الإطلاق، فتُضبط قيمة errno ENOENT ويمكن التحقق منها.

المؤلفين

Thorsten Kukuk <kukuk@suse.de>

انظر أيضاً

lastlog2(3)، ll2_new_context(3)، ll2_unref_context(3)، ll2_write_entry(3)، ll2_read_entry(3)، ll2_update_login_time(3)، ll2_remove_entry(3)، ll2_rename_user(3)، ll2_import_lastlog(3)

التبليغ عن الأخطاء

لتقارير العِلل، استخدم مُتتبع المشكلات https://github.com/util-linux/util-linux/issues.

التوفر

المكتبة liblastlog2 جزء من حزمة util-linux منذ الإصدار 2.40. يمكن تنزيلها من أرشيف نواة لينكس https://www.kernel.org/pub/linux/utils/util-linux/.

2026-05-18

util-linux 2.42.1