X-Git-Url: http://git.silcnet.org/gitweb/?a=blobdiff_plain;f=lib%2Fsilcutil%2Fsilcutil.h;h=57c5b1db9434d3013ab603097fa1dfbafd241995;hb=413da0f8686910f5e627393157566ae729ca99c4;hp=28598bf2d3d65896b6a471932964b0cdf9db7f86;hpb=6a164e529cda00a6ebb5b34dd108aa8e67108442;p=silc.git diff --git a/lib/silcutil/silcutil.h b/lib/silcutil/silcutil.h index 28598bf2..57c5b1db 100644 --- a/lib/silcutil/silcutil.h +++ b/lib/silcutil/silcutil.h @@ -393,7 +393,8 @@ char *silc_client_chumode_char(SilcUInt32 mode); * * DESCRIPTION * - * Creates fingerprint from data, usually used with SHA1 digests. + * Return a textual representation of the fingerprint in *data, the + * caller must free the returned string. * ***/ char *silc_fingerprint(const unsigned char *data, SilcUInt32 data_len); @@ -471,13 +472,28 @@ char *silc_get_input(const char *prompt, bool echo_off); * * DESCRIPTION * - * Return current time to struct timeval. - * - * This function is system dependant. + * Return current time to struct timeval. This function is system + * dependant. Returns 0 on success and -1 on error. * ***/ int silc_gettimeofday(struct timeval *p); +/****f* silcutil/SilcUtilAPI/silc_compare_timeval + * + * SYNOPSIS + * + * bool silc_compare_timeval(struct timeval *smaller, + * struct timeval *bigger) + * + * DESCRIPTION + * + * Compare two timeval structures and return TRUE if the first + * time value is smaller than the second time value. + * + ***/ +bool silc_compare_timeval(struct timeval *smaller, + struct timeval *bigger); + /****f* silcutil/SilcUtilAPI/silc_string_regexify * * SYNOPSIS @@ -535,7 +551,8 @@ int silc_string_match(const char *string1, const char *string2); * DESCRIPTION * * Returns the username of the user. If the global variable LOGNAME - * does not exists we will get the name from the passwd file. + * does not exists we will get the name from the passwd file. The + * caller must free the returned name. * * This function is system dependant. * @@ -550,7 +567,8 @@ char *silc_get_username(); * * DESCRIPTION * - * Returns the real name of ther user from the passwd file. + * Returns the real name of ther user from the passwd file. The + * caller must free the returned name. * * This function is system dependant. *