unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Page:
Section:
Apropos / Subsearch:
optional field

UPDWTMP(3)                 Linux Programmer's Manual                UPDWTMP(3)



NAME
       updwtmp, logwtmp - append an entry to the wtmp file

SYNOPSIS
       #include <&lt;utmp.h>&gt;

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

DESCRIPTION
       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 utmp file.

FILES
       /var/log/wtmp
              database of past user logins

CONFORMING TO
       Not  in  POSIX.1-2001.   Present  on Solaris, NetBSD, and perhaps other
       systems.

AVAILABILITY
       Both functions are available under glibc2, but not under  libc5.   How-
       ever,  logwtmp()  used  to  occur  in  the old libbsd.  These days, the
       logwtmp() function is included in libutil.  (Hence you'll need  to  add
       -lutil to your compiler command line to get it.)

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

       #include <&lt;utmpx.h>&gt;

       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.

SEE ALSO
       getutxent(3), wtmp(5)

COLOPHON
       This  page  is  part of release 3.05 of the Linux man-pages project.  A
       description of the project, and information about reporting  bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.



GNU                               2008-07-02                        UPDWTMP(3)