xnu-2782.40.9.tar.gz

[apple/xnu.git] / bsd / man / man2 / gettimeofday.2

diff --git a/bsd/man/man2/gettimeofday.2 b/bsd/man/man2/gettimeofday.2
index 67f2760c63ce804defdc9f7190994d4880e3b86a..a9b3005554ff8cb9769e78aa35bff5e4f44ba25d 100644 (file)
--- a/bsd/man/man2/gettimeofday.2
+++ b/bsd/man/man2/gettimeofday.2
@@ -33,7 +33,7 @@
 .\"
 .\"     @(#)gettimeofday.2     8.2 (Berkeley) 5/26/95
 .\"
 .\"
 .\"     @(#)gettimeofday.2     8.2 (Berkeley) 5/26/95
 .\"

-.Dd May 26, 1995
+.Dd August 5, 2008

 .Dt GETTIMEOFDAY 2
 .Os BSD 4
 .Sh NAME
 .Dt GETTIMEOFDAY 2
 .Os BSD 4
 .Sh NAME


@@ -53,10 +53,6 @@
 .Fa "const struct timezone *tzp"
 .Fc
 .Sh DESCRIPTION
 .Fa "const struct timezone *tzp"
 .Fc
 .Sh DESCRIPTION

-.Bf -symbolic
-Note: timezone is no longer used; this information is kept outside
-the kernel.
-.Ef

 .Pp
 The system's notion of the current Greenwich time and the current time
 zone is obtained with the
 .Pp
 The system's notion of the current Greenwich time and the current time
 zone is obtained with the


@@ -68,10 +64,24 @@ since midnight (0 hour), January 1, 1970.  The resolution of the system
 clock is hardware dependent, and the time may be updated continuously or
 in ``ticks.''  If
 .Fa tp
 clock is hardware dependent, and the time may be updated continuously or
 in ``ticks.''  If
 .Fa tp

-or
+is NULL
+and

 .Fa tzp
 .Fa tzp

-is NULL, the associated time
-information will not be returned or set.
+is non-NULL,
+.Fn gettimeofday
+will populate the timezone struct in 
+.Fa tzp .
+If 
+.Fa tp
+is non-NULL and
+.Fa tzp 
+is NULL, then only the timeval struct in
+.Fa tp
+is populated. If both
+.Fa tp
+and
+.Fa tzp
+are NULL, nothing is returned.

 .Pp
 The structures pointed to by
 .Fa tp
 .Pp
 The structures pointed to by
 .Fa tp


@@ -82,6 +92,7 @@ are defined in
 as:
 .Pp
 .Bd -literal
 as:
 .Pp
 .Bd -literal

+

 struct timeval {
        time_t       tv_sec;   /* seconds since Jan. 1, 1970 */
        suseconds_t  tv_usec;  /* and microseconds */
 struct timeval {
        time_t       tv_sec;   /* seconds since Jan. 1, 1970 */
        suseconds_t  tv_usec;  /* and microseconds */


@@ -91,6 +102,7 @@ struct timezone {
        int     tz_minuteswest; /* of Greenwich */
        int     tz_dsttime;     /* type of dst correction to apply */
 };
        int     tz_minuteswest; /* of Greenwich */
        int     tz_dsttime;     /* type of dst correction to apply */
 };

+

 .Ed
 .Pp
 The 
 .Ed
 .Pp
 The