'\" t
.\"     Title: ll2_rename_user
.\"    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_RENAME_USER" "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_rename_user \- يغير اسم مدخلة مستخدم.
.SH "موجز"
.sp
\fB#include <lastlog2.h>\fP
.sp
\fBint ll2_rename_user (struct ll2_context *\fIcontext\fP, const char *\fIuser\fP,
const char *\fInewname\fP, char **\fIerror\fP);\fP
.SH "الوصف"
.sp
يغير اسم المستخدم من \fIمستخدم\fP إلى \fInewname\fP لمدخلة واحدة في قاعدة البيانات المحددة بواسطة \fIcontext\fP. ستُحذف جميع المدخلات الأخرى للمستخدم \fIمستخدم\fP. إذا كان \fIcontext\fP هو NULL، فستُتخذ قاعدة البيانات المبدئية المحددة في \fILL2_DEFAULT_DATABASE\fP.
.sp
.if n .RS 4
.nf
.fam C
char\&    *error = NULL;
const\&   char *user = "root";
const\&   char *new_user = "notroot";

int ret = ll2_rename_user (NULL, user, new_user, &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_update_login_time\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/" "أرشيف نواة لينكس" "."