NAME

ftime - gets time and date

SYNOPSIS

cc [flag ...] file ... -lx [library ...]
#include <sys/times.h>

ftime(struct timeb *tp);

DESCRIPTION

ftime returns the time in a structure (see DIAGNOSTICS below). ftime will fail if tp points to an illegal address [EFAULT].

DIAGNOSTICS

The ftime entry fills in a structure pointed to by its argu-
ment, as defined by <sys/timeb.h>:
     /* Structure returned by ftime system call */

     struct timeb {
          long time;
          unsigned short millitm;
          short  timezone;
          short  dstflag;
     };
Note that the timezone value is a  system  default  timezone
and  not  the  value  of  the  TZ environment variable.  The
structure contains the time since the 00:00:00 GMT,  January
1,  1970  up  to 1000 milliseconds of more-precise interval,
the local time zone (measured in minutes  of  time  westward
from Greenwich), and a flag that, if nonzero, indicates that
Daylight Saving time applies locally during the  appropriate
part of the year.

SEE ALSO

stime(2), ctime(3C),

NOTES

Since ftime does not return the correct timezone value, its use is not recommended. See ctime(3C) for accurate use of the TZ variable.