Unix/Linux Go Back    

Linux 2.6 - man page for ftime (linux section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

FTIME(3)			    Linux Programmer's Manual				 FTIME(3)

       ftime - return date and time

       #include <sys/timeb.h>

       int ftime(struct timeb *tp);

       This  function  returns	the  current  time  as	seconds and milliseconds since the Epoch,
       1970-01-01 00:00:00 +0000 (UTC).  The time is returned in tp, which is  declared  as  fol-

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

       Here time is the number of seconds since the Epoch, and millitm is the number of millisec-
       onds since time seconds since the Epoch.  The timezone field is the  local  timezone  mea-
       sured  in minutes of time west of Greenwich (with a negative value indicating minutes east
       of Greenwich).  The dstflag field is a flag that, if nonzero, indicates that Daylight Sav-
       ing time applies locally during the appropriate part of the year.

       POSIX.1-2001  says  that  the contents of the timezone and dstflag fields are unspecified;
       avoid relying on them.

       This function always returns 0.	(POSIX.1-2001 specifies, and some systems document, a  -1
       error return.)

   Multithreading (see pthreads(7))
       The ftime() function is thread-safe.

       4.2BSD, POSIX.1-2001.  POSIX.1-2008 removes the specification of ftime().

       This function is obsolete.  Don't use it.  If the time in seconds suffices, time(2) can be
       used; gettimeofday(2) gives microseconds; clock_gettime(2) gives nanoseconds but is not as
       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.

       gettimeofday(2), time(2)

       This page is part of release 3.55 of the Linux man-pages project.  A  description  of  the
       project,     and    information	  about    reporting	bugs,	 can	be    found    at

GNU					    2013-09-26					 FTIME(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 11:57 AM.