NAME

   utc_gmtime - Converts a binary timestamp to a tm structure that
                expresses GMT or the equivalent UTC

 SYNOPSIS

   #include <dce/utc.h>

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

 PARAMETERS

   Input

   utc
       Binary timestamp to be converted to tm structure components.
       Use NULL if you want this routine to use the current time for
       this parameter.

   Output

   timetm
       Time component of the binary timestamp.

   tns
       Nanoseconds since the Time component of the binary timestamp.

   inacctm
       Seconds of the inaccuracy component of the 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 binary timestamp.
       If the inaccuracy is unspecified, ins returns a value of -1.

 DESCRIPTION

   The utc_gmtime() routine converts a binary timestamp to a tm structure
   that expresses GMT (or the equivalent UTC). 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_cmpintervaltime reference page.

 RELATED INFORMATION

   Functions: utc_anytime
              utc_gmtzone
              utc_localtime
              utc_mkgmtime