NAME

BSD::Gettimeofday - Perl extension for sub-second time on Unix systems

SYNOPSIS

  use BSD::Gettimeofday;
  my ($seconds, $useconds) = gettimeofday();
  my $ok = settimeofday($seconds, $useconds);

DESCRIPTION

This module provides access to the sub-second clock get/set functions available on most unix platforms.

OVERVIEW

This module exports two function, gettimeofday and settimeofday.

gettimeofday()

Returns two values, the number of seconds since 1970, and the microsecond portion of the current system time.

settimeofday(SECONDS, USECONDS)

Sets the system clock to the supplied time. Returns undefined on error (permission denied), or 1 if successful.

SEE ALSO

perl(1), gettimeofday(2)

AUTHOR

Daniel Hagerty <hag@linnaean.org>

COPYRIGHT

Copyright (c) 2000 Daniel Hagerty. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

BUGS

No access to the gettimeofday(2) timezone structure is supplied. Most operating systems have deprecated the interface in favor of localtime.