---
name: "ll2_read_entry"
section: "3"
platform: "linux"
package: "util-linux-libs"
version: "2.42.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/ll2_read_entry"
---

# ll2\_read\_entry(3)

Reads one entry from database and returns that.

## NAME

ll2\_read\_entry - Reads one entry from database and returns that.

## SYNOPSIS

**#include \<lastlog2.h\>**

**int ll2\_read\_entry (struct ll2\_context \****context***, const char \****user***,** **int64\_t \****ll\_time***, char** *tty***, char** *rhost,* *char pam\_service***, char** *error);*

## DESCRIPTION

*Reads the first entry from database, defined in context, for user user.* *If context is NULL, the default database, defined in LL2\_DEFAULT\_DATABASE,* *will be taken.*

```
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);
```

## RETURN VALUE

*Returns 0 on success, -ENOMEM or -1 on other failure.* *error contains an error string if the return value is -1.* *error is not guaranteed to contain an error string, could also be NULL.* *error should be freed by the caller.* *If lastlog2 database does not exist at all, the errno ENOENT is set* *and can be checked.*

*The evaluated values are returned by ll\_time, tty, rhost and pam\_service.*

## AUTHORS

*Thorsten Kukuk \<kukuk@suse.de\>*

## SEE ALSO

**lastlog2***(3),* **ll2\_new\_context***(3),* **ll2\_unref\_context***(3),* **ll2\_read\_all***(3),* **ll2\_write\_entry***(3),* **ll2\_update\_login\_time***(3),* **ll2\_remove\_entry***(3),* **ll2\_rename\_user***(3),* **ll2\_import\_lastlog***(3)*

## REPORTING BUGS

*For bug reports, use the* *issue tracker \<https://github.com/util-linux/util-linux/issues\>.*

## AVAILABILITY

*The* **liblastlog2** *library is part of the util-linux package since version 2.40. It can be downloaded from* *Linux Kernel Archive \<https://www.kernel.org/pub/linux/utils/util-linux/\>.*