ftime(2)                  SYSTEM CALLS                   ftime(2)



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.














            Last change: XENIX Compatibility Package            1