الاسم

ll2_read_entry - يقرأ مدخلة واحدة من قاعدة البيانات ويُرجعها.

موجز

#include <lastlog2.h>

int ll2_read_entry (struct ll2_context *context, const char *مستخدم, int64_t *ll_time, char tty, char rhost, char pam_service, char error);

الوصف

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

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

قيمة الإرجاع

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

تُرجع القيم المُقيمة بواسطة ll_time و tty و rhost و pam_service.

المؤلفين

Thorsten Kukuk <kukuk@suse.de>

انظر أيضاً

lastlog2(3)، ll2_new_context(3)، ll2_unref_context(3)، ll2_read_all(3)، ll2_write_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/.