NAME

   utc_mkgmtime -  Converts a tm structure that expresses GMT or UTC
                   to a binary timestamp

 SYNOPSIS

   #include <dce/utc.h>

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

 PARAMETERS

   Input

   timetm
          A tm structure that expresses GMT. On input, tm_wday and
          tm_yday are ignored; the value of tm_isdt should be -1.

   tns    Nanoseconds since the Time component.

   inacctm
          A tm structure that expresses days, hours, minutes, and seconds
          of inaccuracy.  If a null pointer is passed, or if tm_yday is
          negative, the inaccuracy is considered to be unspecified.  On
          input, tm_mday, tm_mon, tm_wday, and tm_isdst are ignored.

   ins    Nanoseconds of the inaccuracy component.

   Output

   utc    Resulting binary timestamp.

 DESCRIPTION

   The utc_mkgmtime() routine converts a tm structure that expresses GMT
   or UTC to a binary timestamp. Additional inputs include nanoseconds
   since the last second of 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_gmtime