Sys::Lastlog 1.5

Sys::Lastlog is a Perl module to provide a moderately Object Oreiented Interface to lastlog files on some Unix-like systems.

SYNOPSIS

use Sys::Lastlog;

my $ll = Sys::Lastlog->new();

while(my $llent = $ll->getllent() )
{
print $llent->ll_line(),"n";
}

The lastlog file provided on most Unix-like systems stores information about when each user on the system last logged in. The file is sequential and indexed on the UID (that is to say a user with UID 500 will have the 500th record in the file). Most systems do not provide a C API to access this file and programs such as lastlog will provide their own methods of doing this.

This module provides an Object Oriented Perl API to access this file in order that programs like lastlog can written in Perl (for example the plastlog program in this distribution) or that programs can determine a users last login for their own purposes.

The module provides three methods for accessing lastlog sequentially, by UID or by login name. Each method returns an object of type Sys::Lastlog::Entry that itself provides methods for accessing the information for each record.