|
|
1.1 root 1: .\" Copyright (c) 1989 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)time.3 5.2 (Berkeley) 6/23/90
19: .\"
20: .TH TIME 3 "June 23, 1990"
21: .UC 4
22: .SH NAME
23: time \- get time of day
24: .SH SYNOPSIS
25: .nf
26: .B #include <sys/types.h>
27:
28: .B time_t time(tloc)
29: .B time_t *tloc;
30: .fi
31: .SH DESCRIPTION
32: .PP
33: .I Time
34: returns the value of time in seconds since 0 hours, 0 minutes,
35: 0 seconds, January 1, 1970, Coordinated Universal Time.
36: .PP
37: The argument
38: .I tloc
39: points to an area where the return value is also stored.
40: If
41: .I tloc
42: is a NULL pointer, no value is stored.
43: .PP
44: Upon successful completion,
45: .IR time ()
46: returns the value of time.
47: Otherwise a value of ((\fItime_t\fR) -1)
48: is returned and
49: .I errno
50: is set to indicate the error.
51: .SH "ERRORS
52: The following error codes may be set in
53: .IR errno :
54: .TP 15
55: [EFAULT]
56: An argument address referenced invalid memory.
57: .SH "SEE ALSO"
58: gettimeofday(2), ctime(3)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.