man3p/gettimeofday.3p

   1 .\" Copyright (c) 2001-2003 The Open Group, All Rights Reserved
   2 .TH "GETTIMEOFDAY" P 2003 "IEEE/The Open Group" "POSIX Programmer's Manual"
   3 .\" gettimeofday
   4 .SH NAME
   5 gettimeofday \- get the date and time
   6 .SH SYNOPSIS
   7 .LP
   8 \fB#include <sys/time.h>
   9 .br
  10 .sp
  11 int gettimeofday(struct timeval *restrict\fP \fItp\fP\fB, void *restrict\fP
  12 \fItzp\fP\fB); \fP
  13 \fB
  14 .br
  15 \fP
  16 .SH DESCRIPTION
  17 .LP
  18 The \fIgettimeofday\fP() function shall obtain the current time, expressed
  19 as seconds and microseconds since the Epoch, and
  20 store it in the \fBtimeval\fP structure pointed to by \fItp\fP. The
  21 resolution of the system clock is unspecified.
  22 .LP
  23 If \fItzp\fP is not a null pointer, the behavior is unspecified.
  24 .SH RETURN VALUE
  25 .LP
  26 The \fIgettimeofday\fP() function shall return 0 and no value shall
  27 be reserved to indicate an error.
  28 .SH ERRORS
  29 .LP
  30 No errors are defined.
  31 .LP
  32 \fIThe following sections are informative.\fP
  33 .SH EXAMPLES
  34 .LP
  35 None.
  36 .SH APPLICATION USAGE
  37 .LP
  38 None.
  39 .SH RATIONALE
  40 .LP
  41 None.
  42 .SH FUTURE DIRECTIONS
  43 .LP
  44 None.
  45 .SH SEE ALSO
  46 .LP
  47 \fIctime\fP() , \fIftime\fP() , the Base Definitions volume of
  48 IEEE\ Std\ 1003.1-2001, \fI<sys/time.h>\fP
  49 .SH COPYRIGHT
  50 Portions of this text are reprinted and reproduced in electronic form
  51 from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
  52 -- Portable Operating System Interface (POSIX), The Open Group Base
  53 Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
  54 Electrical and Electronics Engineers, Inc and The Open Group. In the
  55 event of any discrepancy between this version and the original IEEE and
  56 The Open Group Standard, the original IEEE and The Open Group Standard
  57 is the referee document. The original Standard can be obtained online at
  58 http://www.opengroup.org/unix/online.html .