ftime(2)               (XENIX Compatibility Package)               ftime(2)


   NAME
         ftime - gets time and date

   SYNOPSIS
         cc [flag ...] file ... -lx [library ...]

   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 argument, 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.

















   7/91                                                                 Page 1