explain_ftime_or_die(3) Library Functions Manual explain_ftime_or_die(3)NAME
explain_ftime_or_die - return date and time and report errors
SYNOPSIS
#include <libexplain/ftime.h>
void explain_ftime_or_die(struct timeb *tp);
int explain_ftime_on_error(struct timeb *tp);
DESCRIPTION
The explain_ftime_or_die function is used to call the ftime(3) system call. On failure an explanation will be printed to stderr, obtained
from the explain_ftime(3) function, and then the process terminates by calling exit(EXIT_FAILURE).
The explain_ftime_on_error function is used to call the ftime(3) system call. On failure an explanation will be printed to stderr, obtained
from the explain_ftime(3) function, but still returns to the caller.
tp The tp, exactly as to be passed to the ftime(3) system call.
RETURN VALUE
The explain_ftime_or_die function only returns on success, see ftime(3) for more information. On failure, prints an explanation and exits,
it does not return.
The explain_ftime_on_error function always returns the value return by the wrapped ftime(3) system call.
EXAMPLE
The explain_ftime_or_die function is intended to be used in a fashion similar to the following example:
explain_ftime_or_die(tp);
SEE ALSO ftime(3)
return date and time
explain_ftime(3)
explain ftime(3) errors
exit(2) terminate the calling process
COPYRIGHT
libexplain version 0.52
Copyright (C) 2009 Peter Miller
explain_ftime_or_die(3)
Check Out this Related Man Page
FTIME(P) POSIX Programmer's Manual FTIME(P)
NAME
ftime - get date and time (LEGACY)
SYNOPSIS
#include <sys/timeb.h>
int ftime(struct timeb *tp);
DESCRIPTION
The ftime() function shall set the time and millitm members of the timeb structure pointed to by tp to contain the seconds and milliseconds
portions, respectively, of the current time in seconds since the Epoch. The contents of the timezone and dstflag members of tp after a call
to ftime() are unspecified.
The system clock need not have millisecond granularity. Depending on any granularity (particularly a granularity of one) renders code non-
portable.
RETURN VALUE
Upon successful completion, the ftime() function shall return 0; otherwise, -1 shall be returned.
ERRORS
No errors are defined.
The following sections are informative.
EXAMPLES
Getting the Current Time and Date
The following example shows how to get the current system time values using the ftime() function. The timeb structure pointed to by tp is
filled with the current system time values for time and millitm.
#include <sys/timeb.h>
struct timeb tp;
int status;
...
status = ftime(&tp);
APPLICATION USAGE
For applications portability, the time() function should be used to determine the current time instead of ftime(). Realtime applications
should use clock_gettime() to determine the current time instead of ftime().
RATIONALE
None.
FUTURE DIRECTIONS
This function may be withdrawn in a future version.
SEE ALSO
clock_getres() , ctime() , gettimeofday() , time() , the Base Definitions volume of IEEE Std 1003.1-2001, <sys/timeb.h>
COPYRIGHT
Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1, 2003 Edition, Standard for Information Technol-
ogy -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between this version and the original IEEE
and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained
online at http://www.opengroup.org/unix/online.html .
IEEE /The Open Group 2003 FTIME(P)