Returns the current system time and inaccuracy as a binary
    timestamp.

    Format

      #include <utc.h>

      int utc_gettime(*utc)

         utc_t *utc;

1  –  Parameters

    Input

    None.

    Output

 utc

    System time as a binary timestamp.

2  –  Description

    The Get Time routine returns the current system time and
    inaccuracy in a binary timestamp. The routine takes the TDF
    from the operating system's kernel; the TDF is specified in a
    system-dependent manner.

3  –  Returns

     0   Indicates that the routine executed successfully.
    -1   Generic error that indicates the time service cannot be
         accessed.

4  –  Example

    See the sample program for the utc_binreltime routine.