'\" t
.\"     Title: ll2_read_entry
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-09-22
.\"    Manual: Programmierhandbuch
.\"    Source: util-linux 2.41.2
.\"  Language: English
.\"
.TH "LL2_READ_ENTRY" "3" "2025-09-22" "util\-linux 2.41.2" "Programmierhandbuch"
.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 "BEZEICHNUNG"
ll2_read_entry \- liest einen Eintrag aus einer Datenbank und liefert ihn zurück.
.SH "ÜBERSICHT"
.sp
\fB#include <lastlog2.h>\fP
.sp
\fBint ll2_read_entry (struct ll2_context *\fIKontext\fP, const char *\fIBenutzer\fP,
int64_t *\fIll\-Zeit\fP, char \fB\fITTY\fP, char \fP\fIferner\-Rechner\fP,
char \fB\fIPAM\-Dienst\fP, char \fP\fIFehler\fP);\fP
.SH "BESCHREIBUNG"
.sp
Liest den ersten Eintrag aus der in \fIKontext\fP definierten Datenbank für den angegebenen \fIBenutzer\fP. Wenn \fIKontext\fP NULL ist, wird die in \fILL2_DEFAULT_DATABASE\fP definierte Standarddatenbank verwendet.
.sp
.if n .RS 4
.nf
.fam C
char\&    *error = NULL;
const\&   char *user = "root";
int64_t res_time;
char\&    *res_tty = NULL;
char\&    *res_rhost = NULL;
char\&    *res_service = NULL;

int ret = ll2_read_entry (NULL, user, &res_time, &res_tty, &res_rhost, &res_service, &error);
.fam
.fi
.if n .RE
.SH "RÜCKGABEWERT"
.sp
Gibt bei Erfolg 0, bei anderen Fehlern \-ENOMEM oder \-1 zurück. \fIFehler\fP enthält eine Fehlerzeichenkette, wenn der Rückgabewert \-1 ist. \fIerror\fP enthält nicht garantiert eine Fehlerzeichenkette, könnte auch NULL sein. \fIFehler\fP sollte vom Aufrufer freigegeben werden. Falls die Datenbank lastlog2 nicht existiert, wird der Fehler ENOENT gesetzt und kann überprüft werden.
.sp
Die errechneten Werte werden von \fIll_time\fP, \fItty\fP, \fIrhost\fP und \fIpam_service\fP zurückgegeben.
.SH "AUTOREN"
.sp
.MTO "kukuk\(atsuse.de" "Thorsten Kukuk" ""
.SH "SIEHE AUCH"
.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_update_login_time\fP(3), \fBll2_remove_entry\fP(3), \fBll2_rename_user\fP(3), \fBll2_import_lastlog\fP(3)
.SH "FEHLER MELDEN"
.sp
Nutzen Sie zum Melden von Fehlern das \c
.URL "https://github.com/util\-linux/util\-linux/issues" "Fehlererfassungssystem" "."
.SH "VERFÜGBARKEIT"
.sp
Die Bibliothek \fBliblastlog2\fP ist seit Version 2.40 Teil des Pakets util\-linux, welches aus dem \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux\-Kernel\-Archiv" ""
heruntergeladen werden kann.