'\" t
.\"     Title: ll2_update_login_time
.\"    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_UPDATE_LOGIN_TIME" "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_update_login_time \- يكتب مدخلة *جديدة* مع وقت ولوج محدث.
.SH "موجز"
.sp
\fB#include <lastlog2.h>\fP
.sp
\fBint ll2_update_login_time (struct ll2_context *\fIcontext\fP,
const char *\fIuser\fP, int64_t \fIll_time\fP,
char **\fIerror\fP);\fP
.SH "الوصف"
.sp
يكتب مدخلة \fBجديدة\fP في قاعدة البيانات، المحددة في \fIcontext\fP، للمستخدم \fIمستخدم\fP. يُحدد الوقت بواسطة \fIll_time\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 login_time = time(0); // الحصول على وقت النظام;

int ret = ll2_update_login_time (NULL, user, login_time, &error);
.fam
.fi
.if n .RE
.SH "قيمة الإرجاع"
.sp
يعيد 0 عند النجاح، و \-ENOMEM أو \-1 عند الفشل الآخر. يحتوي \fIerror\fP على سلسلة خطأ إذا كانت القيمة المعادة هي \-1. لا يُضمن احتواء \fIerror\fP على سلسلة خطأ، فقد يكون NULL أيضاً. يجب تحرير \fIerror\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_read_entry\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/" "أرشيف نواة لينكس" "."