Name

utc_bintime - 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

utcBinary timestamp.  Use NULL if you want this routine to use the current time for this parameter. 

Output

timespTime component of the binary timestamp, in the form of seconds and nanoseconds since the base time. 

inaccspInaccuracy component of the binary timestamp, in the form of seconds and nanoseconds. 

tdfTDF 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

 0Indicates that the routine executed successfully. 

-1Indicates an invalid time argument or invalid results. 

Examples

See the sample program in the utc_anytime(3dts) reference page. 

Related Information

Functions: utc_binreltime(3dts), utc_mkbintime(3dts).