On Apache
Under GNU General Public License
2024-12-12 17:01 @18.191.200.42 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
Sys::Utmp::Utent(3pm) User Contributed Perl Documentation Sys::Utmp::Utent(3pm)
NAME
Sys::Utmp::Utent - represent a single utmp entry
SYNOPSIS
use Sys::Utmp;
my $utmp = Sys::Utmp->new();
while ( my $utent = $utmp->getutent() )
{
if ( $utent->user_process )
{
print $utent->ut_user,"\n";
}
}
$utmp->endutent;
DESCRIPTION
As described in the Sys::Utmp documentation the getutent method returns an object of the
type Sys::Utmp::Utent which provides methods for accessing the fields in the utmp record.
There are also methods for determining the type of the record.
The access methods relate to the common names for the members of the C struct utent -
those provided are the superset from the Gnu implementation and may not be available on
all systems: where they are not they will return the empty string.
ut_user
Returns the use this record was created for if this is a record for a user process.
Some systems may return other information depending on the record type. If no user
was set this will be the empty string. If tainting is switched on with the '-T'
switch to perl then this will be 'tainted' as it is possible that the user name came
from an untrusted source.
ut_id
The identifier for this record - it might be the inittab tag or some other system
dependent value.
ut_line
For user process records this will be the name of the terminalor line that the user is
connected on.
ut_pid
The process ID of the process that created this record.
ut_type
The type of the record this will have a value corresponding to one of the constants
(not all of these may be available on all systems and there may well be others which
should be described in the getutent manpage or in /usr/include/utmp.h ) :
ACCOUNTING - record was created for system accounting purposes.
BOOT_TIME - the record was created at boot time.
DEAD_PROCESS - The process that created this record has terminated.
EMPTY - record probably contains no other useful information.
INIT_PROCESS - this is a record for process created by init.
LOGIN_PROCESS - this record was created for a login process (e.g. getty).
NEW_TIME - record created when the system time has been set.
OLD_TIME - record recording the old tme when the system time has been set.
RUN_LVL - records the time at which the current run level was started.
USER_PROCESS - record created for a user process (e.g. a login )
for convenience Sys::Utmp::Utent provides methods which are lower case versions of the
constant names which return true if the record is of that type.
ut_host
On systems which support this the method will return the hostname of the host for
which the process that created the record was started - for example for a telnet
login. If taint checking has been turned on (with the -T switch to perl ) then this
value will be tainted as it is possible that a remote user will be in control of the
DNS for the machine they have logged in from. ( see perlsec for more on tainting )
ut_time
The time in epoch seconds wt which the record was created.
BUGS
Probably. This module has been tested on Linux, Solaris, FreeBSD ,SCO Openserver and SCO
UnixWare and found to work on those platforms. If you have difficulty building the module
or it doesnt behave as expected then please contact the author including if appropriate
your /usr/include/utmp.h
AUTHOR
Jonathan Stowe, <jns AT gellyfish.uk>
LICENCE
This Software is Copyright Jonathan Stowe 2001-2013
This Software is published as-is with no warranty express or implied.
This is free software and can be distributed under the same terms as Perl itself.
SEE ALSO
perl. Sys::Utmp
perl v5.34.0 2022-02-06 Sys::Utmp::Utent(3pm)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-12-12 17:01 @18.191.200.42 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)