updwtmp(3) — Linux manual page

updwtmp(3)              Library Functions Manual              updwtmp(3)

NAME         top

       updwtmp, logwtmp - append an entry to the wtmp file

LIBRARY         top

       System utilities library (libutil, -lutil)

SYNOPSIS         top

       #include <utmp.h>

       void updwtmp(const char *wtmp_file, const struct utmp *ut);
       void logwtmp(const char *line, const char *name, const char *host);

DESCRIPTION         top

       updwtmp() appends the utmp structure ut to the wtmp file.

       logwtmp() constructs a utmp structure using line, name, host,
       current time, and current process ID.  Then it calls updwtmp() to
       append the structure to the wtmp file.

FILES         top

       /var/log/wtmp
              database of past user logins

ATTRIBUTES         top

       For an explanation of the terms used in this section, see
       attributes(7).
       ┌────────────────────┬───────────────┬──────────────────────────┐
       │ Interface          │ Attribute     │ Value                    │
       ├────────────────────┼───────────────┼──────────────────────────┤
       │ updwtmp(),         │ Thread safety │ MT-Unsafe sig:ALRM timer │
       │ logwtmp()          │               │                          │
       └────────────────────┴───────────────┴──────────────────────────┘

VERSIONS         top

       For consistency with the other "utmpx" functions (see
       getutxent(3)), glibc provides (since glibc 2.1):

           #define _GNU_SOURCE          /* See feature_test_macros(7) */
           #include <utmpx.h>
           void updwtmpx (const char *wtmpx_file, const struct utmpx *utx);

       This function performs the same task as updwtmp(), but differs in
       that it takes a utmpx structure as its last argument.

STANDARDS         top

       None.

HISTORY         top

       Solaris, NetBSD.

SEE ALSO         top

       getutxent(3), wtmp(5)

COLOPHON         top

       This page is part of the man-pages (Linux kernel and C library
       user-space interface documentation) project.  Information about
       the project can be found at 
       ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report
       for this manual page, see
       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.
       This page was obtained from the tarball man-pages-6.9.1.tar.gz
       fetched from
       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on
       2024-06-26.  If you discover any rendering problems in this HTML
       version of the page, or you believe there is a better or more up-
       to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not
       part of the original manual page), send a mail to
       [email protected]

Linux man-pages 6.9.1          2024-05-02                     updwtmp(3)

Pages that refer to this page: utmp(5)

HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.