NAME    [Toc]    [Back]

     login, logout, logwtmp - login utility functions

SYNOPSIS    [Toc]    [Back]

     #include <utmp.h>
     #include <util.h>

     void
     login(struct utmp *ut);

     int
     logout(const char *line);

     void
     logwtmp(const char  *line,  const  char  *name,  const  char
*host);

DESCRIPTION    [Toc]    [Back]

     The  login(),  logout(),  and logwtmp() functions operate on
the database of
     current  users  in  /var/run/utmp   and   on   the   logfile
/var/log/wtmp of logins
     and logouts.

     The   login()   function   updates   the  /var/run/utmp  and
/var/log/wtmp files
     with user information contained in ut.

     The logout() function removes the entry  from  /var/run/utmp
corresponding
     to the device line.

     The  logwtmp()  function  adds  an  entry  to /var/log/wtmp.
Since login()
     will add the appropriate entry for  /var/log/wtmp  during  a
login,
     logwtmp() is usually used for logouts.

RETURN VALUES    [Toc]    [Back]

     logout()  returns non-zero if it was able to find and delete
an entry for
     line,  and  zero  if  there  is  no  entry   for   line   in
/var/run/utmp.

FILES    [Toc]    [Back]

     /dev/*
     /etc/ttys
     /var/run/utmp
     /var/log/wtmp

SEE ALSO    [Toc]    [Back]

     utmp(5)

OpenBSD      3.6                        December     14,     1995