---
name: "getlastlogx"
section: "3"
platform: "macos"
package: "Libc"
version: "1752.120.2"
release: "macOS 26.5"
platforms: ["macos"]
url: "https://new.carta.tech/getlastlogx"
---

# getlastlogx(3)

user accounting database functions

## NAME

**getlastlogx**, **getlastlogxbyname**, **getutmp**, **getutmpx**, **utmpxname** – user accounting database functions

## SYNOPSIS

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

*struct* *lastlogx* *\**\

**getlastlogx**(*uid\_t uid*, *struct lastlogx \*ll*);

*struct* *lastlogx* *\**\

**getlastlogxbyname**(*const char \*name*, *struct lastlogx \*ll*);

*void*\

**getutmp**(*const struct utmpx \*ux*, *struct utmp \*u*);

*void*\

**getutmpx**(*const struct utmp \*u*, *struct utmpx \*ux*);

*int*\

**utmpxname**(*const char \*fname*);

## DESCRIPTION

The **getlastlogx**() function looks up the entry for the user with user id *uid* and returns it in *ll*. If the provided *ll* is NULL, the necessary space will be allocated by **getlastlogx**() and should be **free**(*Ns*, *d*) by the caller. The **getlastlogxbyname**() function is similar to **getlastlogx**(), except the user name is passed.

**getutmp**() function fills out the entries in the struct utmp *u* with the data provided in the struct utmpx *ux*. **getutmpx**() does the opposite, filling out the entries in the struct utmpx *ux* with the data provided in the struct utmp *u*, and initializing all the unknown fields to 0. The sole exception is the *ut\_type* field, which will be initialized to USER\_PROCESS.

A *struct* *lastlogx* is defined like this:

```
struct lastlogx {
        struct timeval ll_tv;           /* time entry was created */
        char ll_line[_UTX_LINESIZE];    /* tty name */
        char ll_host[_UTX_HOSTSIZE];    /* host name */
};
```

The **utmpxname**() function sets the default [utmpx(5)](/utmpx/5.md) database file name to *fname*.

## RETURN VALUES

**getlastlogx**() and **getlastlogxbyname**() return the found entry on success, or NULL if it could not open the database, could not find an entry matching *uid* or *name*, or could not allocate the necessary space (in case *ll* was NULL).

**utmpxname**() returns 1 on success, or 0 if the supplied file name was too long or did not end with ‘x’.

## SEE ALSO

[endutxent(3)](/endutxent/3.md), [utmpx(5)](/utmpx/5.md)

## HISTORY

The functions **getutmp**(), **getutmpx**(), and **utmpxname**() first appeared in Solaris. **getlastlogx** first appeared in NetBSD 2.0.