NAME

   utc_mkbinreltime - Converts a timespec structure expressing a
                      relative time to a binary timestamp

 SYNOPSIS

   #include <dce/utc.h>

   int utc_mkbinreltime( utc_t *utc,
                         reltimespec_t *timesp,
                         timespec_t *inaccsp );

 PARAMETERS

   Input

   timesp
          A reltimespec structure that expresses a relative time.

   inaccsp
          A timespec structure that expresses inaccuracy.  If a null
          pointer is passed, or if tv_sec is set to a value of -1, the
          inaccuracy is considered to be unspecified.

   Output

   utc    Resulting relative binary timestamp.

 DESCRIPTION

   The utc_mkbinreltime() routine converts a timespec structure that
   expresses relative time to a binary timestamp.

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

 RELATED INFORMATION

   Functions: utc_binreltime
              utc_mkbintime