NAME

   utc_reltime - Converts a relative binary timestamp to a tm structure

 SYNOPSIS

   #include <dce/utc.h>

   int utc_reltime( struct tm *timetm,
                    long *tns,
                    struct tm *inacctm,
                    long *ins,
                    utc_t *utc );

 PARAMETERS

   Input

   utc    Relative binary timestamp.

   Output

   timetm
          Relative time component of the relative binary timestamp.
          The field tm_mday returns a value of -1 and the fields
          tm_year and tm_mon return values of 0 (zero). The field
          tm_yday contains the number of days of relative time.

   tns    Nanoseconds since the Time component of the relative binary
          timestamp.

   inacctm
          Seconds of the inaccuracy component of the relative binary
          timestamp.  If the inaccuracy is finite, then tm_mday returns
          a value of -1 and tm_mon and tm_year return values of 0
          (zero). The field tm_yday contains the inaccuracy in days.
          If the inaccuracy is unspecified, all tm structure fields
          return values of -1.

   ins    Nanoseconds of the inaccuracy component of the relative binary
          timestamp.

 DESCRIPTION

   The utc_reltime() routine converts a relative binary timestamp to
   a tm structure. Additional returns include nanoseconds since Time
   and nanoseconds of inaccuracy.

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

 RELATED INFORMATION

   Functions: utc_mkreltime