utc_bintime(3dts)
Converts a binary timestamp to a timespec structure
Synopsis
#include <dce/utc.h>
int utc_bintime(
timespec_t *timesp,
timespec_t *inaccsp,
long *tdf,
utc_t *utc);
Parameters
Input
utc
Binary timestamp. Use NULL if you want this routine to use the current time for this parameter.
Output
timesp
Time component of the binary timestamp, in the form of seconds and nanoseconds since the base time.
inaccsp
Inaccuracy component of the binary timestamp, in the form of seconds and nanoseconds.
tdf
TDF component of the binary timestamp in the form of signed number of seconds east of GMT.
Description
The utc_bintime( ) routine converts a binary timestamp to a timespec structure. The TDF information contained in the timestamp is returned.
Return Values
~0 Indicates that the routine executed successfully.
1 Indicates an invalid time argument or invalid results.
Examples
See the sample program in the utc_anytime(3dts) reference page.
Related Information
Functions: