Converts a binary timestamp to a timespec structure.

    Format

      #include <utc.h>

      int utc_bintime(*timesp, *inaccsp, *tdf, *utc)

         timespec_t *timesp;
         timespec_t *inaccsp;
         long *tdf;
         const utc_t *utc;

1 - Parameters

    Input

 utc

    Binary timestamp.

    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 or west of GMT.

2 - Description

    The Binary Time routine converts a binary timestamp to a timespec
    structure. The TDF information contained in the timestamp is
    returned.

3 - Returns

     0   Indicates that the routine executed successfully.
    -1   Indicates an invalid time argument or invalid results.

4 - Example

    See the sample program for the utc_anytime routine.

5 - Related Functions

    utc_binreltime, utc_mkbintime