ftime(2) — SYSTEM CALLS

NAME

ftime − get time and date

SYNOPSIS

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

#include <sys/times.h>
#include <sys/timeb.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.

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.

— Application Compatibility Package

Museum