'\" t
.\"     Title: ll2_write_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_WRITE_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_write_entry \- يكتب مدخلًا جديدًا في قاعدة البيانات.
.SH "موجز"
.sp
\fB#include <lastlog2.h>\fP
.sp
\fBint ll2_write_entry (struct ll2_context *\fIcontext\fP, const char *\fIuser\fP,
int64_t \fIll_time\fP, const char *\fItty\fP,
const char *\fIrhost\fP, const char *\fIpam_service\fP,
char **\fIerror\fP);\fP
.SH "الوصف"
.sp
يكتب مدخلًا جديدًا في قاعدة البيانات المعرفة في \fIcontext\fP. إذا كان \fIcontext\fP هو NULL، تُستخدم قاعدة البيانات المبدئية المعرفة في \fILL2_DEFAULT_DATABASE\fP.
.sp
.if n .RS 4
.nf
.fam C
time_t login_time = time(0); // Get the system time
char\&   *error = NULL;
const\&  char *user = "root";

int ret = ll2_write_entry (NULL, user, login_time, "pts/0",
                            "192.168.122.1", NULL, &error);
.fam
.fi
.if n .RE
.sp
\fIpam_service\fP هو اسم الخدمة أو النسخة التي ولّدت المدخل (اختياري).
.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_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/" "أرشيف نواة لينكس" "."