1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
'\" t
.\" Title: ll2_update_login_time
.\" Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\" Date: 2025-12-15
.\" Manual: Programmer's Manual
.\" Source: util-linux 2.41.3
.\" Language: English
.\"
.TH "LL2_UPDATE_LOGIN_TIME" "3" "2025-12-15" "util\-linux 2.41.3" "Programmer\*(Aqs Manual"
.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 "NAME"
ll2_update_login_time \- Writes a *new* entry with updated login time.
.SH "SYNOPSIS"
.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 "DESCRIPTION"
.sp
Writes a \fBnew\fP entry to database, defined in \fIcontext\fP, for user \fIuser\fP.
Time is set by \fIll_time\fP whereas the other values are taken from
an already existing entry.
If \fIcontext\fP is NULL, the default database, defined in \fILL2_DEFAULT_DATABASE\fP,
will be taken.
.sp
.if n .RS 4
.nf
.fam C
char *error = NULL;
const char *user = "root";
int64_t login_time = time(0); // Get the system time;
int ret = ll2_update_login_time (NULL, user, login_time, &error);
.fam
.fi
.if n .RE
.SH "RETURN VALUE"
.sp
Returns 0 on success, \-ENOMEM or \-1 on other failure.
\fIerror\fP contains an error string if the return value is \-1.
\fIerror\fP is not guaranteed to contain an error string, could also be NULL.
\fIerror\fP should be freed by the caller.
.SH "AUTHORS"
.sp
.MTO "kukuk\(atsuse.de" "Thorsten Kukuk" ""
.SH "SEE ALSO"
.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 "REPORTING BUGS"
.sp
For bug reports, use the \c
.URL "https://github.com/util\-linux/util\-linux/issues" "issue tracker" "."
.SH "AVAILABILITY"
.sp
The \fBliblastlog2\fP library is part of the util\-linux package since version 2.40. It can be downloaded from \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."
|
