NAME    [Toc]    [Back]

     logwtmp -- append a new record to the wtmp file

LIBRARY    [Toc]    [Back]

     System Utilities Library (libutil, -lutil)

SYNOPSIS    [Toc]    [Back]

     #include <sys/types.h>
     #include <libutil.h>

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

DESCRIPTION    [Toc]    [Back]

     The function logwtmp() tries to append a new record to the wtmp(5) file,
     using the provided arguments line, name, and host, and the current time.

     If the length of the hostname string host is longer than what would fit
     into the hostname field of the wtmp(5) file, it will first be attempted
     to convert it into a numerical IP address using gethostbyname(3).	Failing
 this, the hostname will be recorded as "invalid hostname".

     The calling process must have permission to write to the wtmp(5) file.

RETURN VALUES    [Toc]    [Back]

     None.

SEE ALSO    [Toc]    [Back]

     gethostbyname(3), login(3), wtmp(5)


FreeBSD 5.2.1		       December 29, 1996		 FreeBSD 5.2.1