88 lines
No EOL
2.3 KiB
Groff
88 lines
No EOL
2.3 KiB
Groff
'\" t
|
|
.\" Title: ll2_write_entry
|
|
.\" Author: [see the "AUTHOR(S)" section]
|
|
.\" Generator: Asciidoctor 2.0.20
|
|
.\" Date: 2025-02-26
|
|
.\" Manual: Programmer's Manual
|
|
.\" Source: util-linux 2.41
|
|
.\" Language: English
|
|
.\"
|
|
.TH "LL2_WRITE_ENTRY" "3" "2025-02-26" "util\-linux 2.41" "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_write_entry \- Writes a new entry into the database.
|
|
.SH "SYNOPSIS"
|
|
.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 "DESCRIPTION"
|
|
.sp
|
|
Writes a new entry into database, which is defined in \fIcontext\fP.
|
|
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
|
|
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 is the service or instance name which has generated the entry (optional).
|
|
.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
|
|
Thorsten Kukuk (\c
|
|
.MTO "kukuk\(atsuse.de" "" ")"
|
|
.SH "SEE ALSO"
|
|
.sp
|
|
\fBlastlog2\fP(3),
|
|
\fBll2_new_context(3),
|
|
*ll2_unref_context(3),
|
|
*ll2_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 "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" "." |