Return to gettimeofday.2 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man2

Annotation of 43BSDTahoe/man/man2/gettimeofday.2, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)gettimeofday.2      6.8 (Berkeley) 4/11/87
                      6: .\"
                      7: .TH GETTIMEOFDAY 2 "April 11, 1987"
                      8: .UC 4
                      9: .SH NAME
                     10: gettimeofday, settimeofday \- get/set date and time
                     11: .SH SYNOPSIS
                     12: .nf
                     13: .ft B
                     14: #include <sys/time.h>
                     15: .PP
                     16: .ft B
                     17: gettimeofday(tp, tzp)
                     18: struct timeval *tp;
                     19: struct timezone *tzp;
                     20: .PP
                     21: .ft B
                     22: settimeofday(tp, tzp)
                     23: struct timeval *tp;
                     24: struct timezone *tzp;
                     25: .fi
                     26: .SH DESCRIPTION
                     27: The system's notion of the current Greenwich time and the current time
                     28: zone is obtained with the \fIgettimeofday\fP call, and set with the
                     29: \fIsettimeofday\fP call.  The time is expressed in seconds and microseconds
                     30: since midnight (0 hour), January 1, 1970.  The resolution of the system
                     31: clock is hardware dependent, and the time may be updated continuously or
                     32: in ``ticks.''  If \fItp\fP or \fItzp\fP is NULL, the associated time
                     33: information will not be returned or set.
                     34: .PP
                     35: The structures pointed to by
                     36: .I tp
                     37: and
                     38: .I tzp
                     39: are defined in 
                     40: .I <sys/time.h>
                     41: as:
                     42: .PP
                     43: .nf
                     44: .RS
                     45: .DT
                     46: struct timeval {
                     47:        long    tv_sec;         /* seconds since Jan. 1, 1970 */
                     48:        long    tv_usec;                /* and microseconds */
                     49: };
                     50: .sp 1
                     51: struct timezone {
                     52:        int     tz_minuteswest; /* of Greenwich */
                     53:        int     tz_dsttime;     /* type of dst correction to apply */
                     54: };
                     55: .RE
                     56: .fi
                     57: .PP
                     58: The 
                     59: .I timezone
                     60: structure indicates the local time zone
                     61: (measured in minutes of time westward from Greenwich),
                     62: and a flag that, if nonzero, indicates that
                     63: Daylight Saving time applies locally during
                     64: the appropriate part of the year.
                     65: .PP
                     66: Only the super-user may set the time of day or time zone.
                     67: .SH RETURN
                     68: A 0 return value indicates that the call succeeded.
                     69: A \-1 return value indicates an error occurred, and in this
                     70: case an error code is stored into the global variable \fIerrno\fP.
                     71: .SH "ERRORS
                     72: The following error codes may be set in \fIerrno\fP:
                     73: .TP 15
                     74: [EFAULT]
                     75: An argument address referenced invalid memory.
                     76: .TP 15
                     77: [EPERM]
                     78: A user other than the super-user attempted to set the time.
                     79: .SH "SEE ALSO"
                     80: date(1), adjtime(2), ctime(3), timed(8)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.