The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

Name

SPVM::Sys::Time - Time System Call

Usage

  use Sys::Time;

Description

Sys::Process provides the methods to call the system call for the time manipulation.

Class Methods

gettimeofday

  static method gettimeofday : int ($tv : Sys::Time::Timeval, $tz : Sys::Time::Timezone);

The functions gettimeofday() can get the time as well as a timezone. The tv argument is a struct timeval (as specified in <sys/time.h>):

See gettimeofday(2) - Linux man page in Linux.

clock

  static method clock : long ()

The value returned is the CPU time used so far as a clock_t; to get the number of seconds used, divide by CLOCKS_PER_SEC.

See clock(3) - Linux man page in Linux.

clock_gettime

  static method clock_gettime : int ($clk_id : int, $tp : Sys::Time::Timespec);

The functions clock_gettime() retrieves the time of the specified clock clk_id.

See clock_gettime(3) - Linux man page in Linux.

The $tp is a Sys::Time::Timespec object.

clock_getres

  static method clock_getres : int ($clk_id : int, $res : Sys::Time::Timespec);

The functions clock_getres() retrieves the time of the specified clock clk_id.

See clock_getres(3) - Linux man page in Linux.

The $res is a Sys::Time::Timespec object.

setitimer

  static method setitimer : int ($which : int, $new_value : Sys::Time::Itimerval, $old_value : Sys::Time::Itimerval)

The function setitimer() sets the specified timer to the value in new_value. If old_value is non-NULL, the old value of the timer is stored there.

See setitimer(2) - Linux man page in Linux.

The $new_value is a Sys::Time::Itimerval object.

The $old_value is a Sys::Time::Itimerval object.

getitimer

  static method getitimer : int ($which : int, $curr_value : Sys::Time::Itimerval);

The function getitimer() fills the structure pointed to by curr_value with the current setting for the timer specified by which (one of ITIMER_REAL, ITIMER_VIRTUAL, or ITIMER_PROF).

See getitimer(2) - Linux man page in Linux.

The $curr_value is a Sys::Time::Itimerval object.

times

  static method times : long ($buffer : Sys::Time::Tms);

times() stores the current process times in the struct tms that buf points to. The struct tms is as defined in <sys/times.h>:

See the detail of the times function in the case of Linux.

clock_nanosleep

  static method clock_nanosleep : int ($clockid : int, $flags : int, $request : Sys::Time::Timespec, $remain : Sys::Time::Timespec);

Like nanosleep(2), clock_nanosleep() allows the calling thread to sleep for an interval specified with nanosecond precision. It differs in allowing the caller to select the clock against which the sleep interval is to be measured, and in allowing the sleep interval to be specified as either an absolute or a relative value.

See the detail of the clock_nanosleep(2) - Linux man page function in the case of Linux.

The $request is a Sys::Time::Timespec object.

The $remain is a Sys::Time::Timespec object.

nanosleep

  static method nanosleep : int ($rqtp : Sys::Time::Timespec, $rmtp : Sys::Time::Timespec);

The nanosleep() function shall cause the current thread to be suspended from execution until either the time interval specified by the rqtp argument has elapsed or a signal is delivered to the calling thread, and its action is to invoke a signal-catching function or to terminate the process.

See the detail of the nanosleep function in the case of Linux.

The rqtp is a Sys::Time::Timespec object.

The rmtp is a Sys::Time::Timespec object.