NAME
	  time -  Gets time

     LIBRARY
	  Standard C Library (libc.a)

     SYNOPSIS
	  #include <time.h>
	  time_t time(
	       time_t *tloc) ;


     PARAMETERS
	  tloc	    Points to the location where the return value is
		    stored. When this parameter	is a null pointer, no
		    value is stored.


     DESCRIPTION
	  The time() function returns the time in seconds since	the
	  epoch. The epoch is referenced to 00:00:00 UTC (Coordinated
	  Universal Time) 1 Jan	1970.

     NOTES
	  AES Support Level:
			 Full use


     RETURN VALUES
	  Upon successful completion, the time() function returns the
	  value	of time	in seconds since the epoch.  Otherwise,	the
	  value	((time_t) -  1)	is returned.

     RELATED INFORMATION
	  Functions: clock(3), gettimeofday(2),	stime(3)