NAME

   utc_pointtime - Converts a binary timestamp to three binary
                   timestamps that represent the earliest, most
                   likely, and latest time

 SYNOPSIS

   #include <dce/utc.h>

   int utc_pointtime( utc_t *utclp,
                      utc_t *utcmp,
                      utc_t *utchp,
                      utc_t *utc );

 PARAMETERS

   Input

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

   Output

   utclp
       Lowest (earliest) possible absolute time or shortest possible
       relative time that the input timestamp can represent.

   utcmp
       Midpoint of the input timestamp.

   utchp
       Highest (latest) possible absolute time or longest possible
       relative time that the input timestamp can represent.

 DESCRIPTION

   The utc_pointtime() routine converts a binary timestamp to three
   binary timestamps that represent the earliest, latest, and most
   likely (midpoint) times.  If the input is a relative binary time,
   the outputs represent relative binary times.

 NOTES

   All outputs have zero inaccuracy.  An error is returned if the input
   binary timestamp has an unspecified inaccuracy.

 RETURN VALUES

    0    Indicates that the routine executed successfully.

   -1    Indicates an invalid time argument.

 EXAMPLES

   See the sample program in the utc_addtime reference page.

 RELATED INFORMATION

   Functions: utc_boundtime
              utc_spantime