ftime(2)       UNIX System V(Application Compatibility Package)        ftime(2)


NAME
      ftime - get 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 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
      cc(1), 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.














10/89                                                                    Page 1