KRB5_TIMEOFDAY(3)        BSD Library Functions Manual        KRB5_TIMEOFDAY(3)

NAME
     krb5_timeofday, krb5_set_real_time, krb5_us_timeofday, krb5_format_time,
     krb5_string_to_deltat -- Kerberos 5 time handling functions

LIBRARY
     Kerberos 5 Library (libkrb5, -lkrb5)

SYNOPSIS
     #include <krb5.h>

     krb5_timestamp;

     krb5_deltat;

     krb5_error_code
     krb5_set_real_time(krb5_context context, krb5_timestamp sec,
         int32_t usec);

     krb5_error_code
     krb5_timeofday(krb5_context context, krb5_timestamp *timeret);

     krb5_error_code
     krb5_us_timeofday(krb5_context context, krb5_timestamp *sec,
         int32_t *usec);

     krb5_error_code
     krb5_format_time(krb5_context context, time_t t, char *s, size_t len,
         krb5_boolean include_time);

     krb5_error_code
     krb5_string_to_deltat(const char *string, krb5_deltat *deltat);

DESCRIPTION
     krb5_set_real_time sets the absolute time that the caller knows the KDC
     has.  With this the Kerberos library can calculate the relative differ-
     ence between the KDC time and the local system time and store it in the
     context.  With this information the Kerberos library can adjust all time
     stamps in Kerberos packages.

     krb5_timeofday() returns the current time, but adjusted with the time
     difference between the local host and the KDC.  krb5_us_timeofday() also
     returns microseconds.

     krb5_format_time formats the time t into the string s of length len.  If
     include_time is set, the time is set include_time.

     krb5_string_to_deltat parses delta time string into deltat.

SEE ALSO
     gettimeofday(2), krb5(3)

HEIMDAL                        Sepember 16, 2006                       HEIMDAL
