ftime (3)

NAME

       ftime - return date and time

SYNOPSIS

       #include <sys/timeb.h>

       int ftime(struct timeb *tp);

DESCRIPTION

       Return current date and time in tp, which is declared as follows:

                 struct timeb {
                      time_t   time;
                      unsigned short millitm;
                      short    timezone;
                      short    dstflag;
                 };

       Here time is the number of seconds since the epoch, millitm is the num-
       ber of milliseconds since time seconds since the epoch, timezone is the
       local time zone measured in minutes of time west of Greenwich, and dst-
       flag is a flag that, if nonzero, indicates that  Daylight  Saving  time
       applies locally during the appropriate part of the year.

       These  days  the  contents of the timezone and dstflag fields are unde-
       fined.

RETURN VALUE

       This function always returns 0.

BUGS

       This function is obsolete. Don't use it. If the time  in  seconds  suf-
       fices,   time(2)  can  be  used;  gettimeofday(2)  gives  microseconds;
       clock_gettime(3) gives nanoseconds but is not yet widely available.

       Under libc4 and libc5 the  millitm  field  is  meaningful.   But  early
       glibc2 is buggy and returns 0 there; glibc 2.1.1 is correct again.

HISTORY

       The ftime() function appeared in 4.2BSD.

CONFORMING TO

       BSD 4.2, POSIX 1003.1-2001.

SEE ALSO

       gettimeofday(2), time(2)

Linux                             2001-12-14                          ftime(3)