time man page on PC-BSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
PC-BSD logo
[printable version]

TIME(3)			 BSD Library Functions Manual		       TIME(3)

NAME
     time — get time of day

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <time.h>

     time_t
     time(time_t *tloc);

DESCRIPTION
     The time() function returns the value of time in seconds since 0 hours, 0
     minutes, 0 seconds, January 1, 1970, Coordinated Universal Time.  If an
     error occurs, time() returns the value (time_t)-1.

     The return value is also stored in *tloc, provided that tloc is non-null.

ERRORS
     The time() function may fail for any of the reasons described in
     gettimeofday(2).

SEE ALSO
     clock_gettime(2), gettimeofday(2), ctime(3)

STANDARDS
     The time function conforms to IEEE Std 1003.1-2001 (“POSIX.1”).

HISTORY
     A time() function appeared in Version 6 AT&T UNIX.

BUGS
     Neither ISO/IEC 9899:1999 (“ISO C99”) nor IEEE Std 1003.1-2001
     (“POSIX.1”) requires time() to set errno on failure; thus, it is impossi‐
     ble for an application to distinguish the valid time value -1 (represent‐
     ing the last UTC second of 1969) from the error return value.

     Systems conforming to earlier versions of the C and POSIX standards
     (including older versions of FreeBSD) did not set *tloc in the error
     case.

BSD				 July 18, 2003				   BSD
[top]

List of man pages available for PC-BSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net