NAME

   utc_subtime - Computes the difference between two binary timestamps

 SYNOPSIS

   #include <dce/utc.h>

   int utc_subtime( utc_t *result,
                    utc_t *utc1,
                    utc_t *utc2 );

 PARAMETERS

   Input

   utc1
       Binary timestamp or relative binary timestamp. Use NULL if you
       want this routine to use the current time for this parameter.

   utc2
       Binary timestamp or relative binary timestamp. Use NULL if you
       want this routine to use the current time for this parameter.

   Output

   result
       Resulting binary timestamp or relative binary timestamp,
       depending upon the operation performed:

         + absolute time-absolute time=relative time

         + relative time-relative time=relative time

         + absolute time-relative time=absolute time

         + relative time-absolute time is undefined.  (See the note
           later in this reference page.)

 DESCRIPTION

   The utc_subtime() routine subtracts one binary timestamp from
   another.  The two binary timestamps express either an absolute
   time and a relative time, two relative times, or two absolute
   times.  The resulting timestamp is utc1 minus utc2. The inaccuracies
   of the two input timestamps are combined and included in the output
   timestamp.  The TDF in the first timestamp is copied to the output.

 NOTES

   Although no error is returned, the combination relative time-
   absolute time should not be used.

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

 RELATED INFORMATION

   Functions: utc_addtime