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

   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 reference page.

 RELATED INFORMATION

   Functions: utc_binreltime
              utc_mkbintime