KRB5_TIMEOFDAY(3)

KRB5_TIMEOFDAY(3) | 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/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 difference 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)

September 16, 2006 | NetBSD 11.0