diff options
| author | Alexandra Ellwood <lxs@mit.edu> | 2008-08-22 15:34:46 +0000 |
|---|---|---|
| committer | Alexandra Ellwood <lxs@mit.edu> | 2008-08-22 15:34:46 +0000 |
| commit | 57af1ae768f955d6de06ab910b9ba49aaa0277d0 (patch) | |
| tree | 1f9266abf1fb4adc882805882dab716d49693f14 /src | |
| parent | 8b675ecdf45217a779ef2f7809583a545cef5582 (diff) | |
| download | krb5-57af1ae768f955d6de06ab910b9ba49aaa0277d0.tar.gz krb5-57af1ae768f955d6de06ab910b9ba49aaa0277d0.tar.xz krb5-57af1ae768f955d6de06ab910b9ba49aaa0277d0.zip | |
Updated documentation to be more specific about TLS impact
git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@20683 dc483132-0cff-0310-8789-dd5450dbe970
Diffstat (limited to 'src')
| -rw-r--r-- | src/include/kim/kim_error.h | 13 |
1 files changed, 8 insertions, 5 deletions
diff --git a/src/include/kim/kim_error.h b/src/include/kim/kim_error.h index de2453422..07c6d172f 100644 --- a/src/include/kim/kim_error.h +++ b/src/include/kim/kim_error.h @@ -77,12 +77,15 @@ extern "C" { /*! * \param out_string On success, a human-readable UTF-8 string describing the * error representedby \a in_error. Must be freed with - * kim_string_free() - * \param in_error an error code. + * kim_string_free(). + * \param in_error an error code. Used to verify that the correct error + * string will be returned (see note below). * \return On success, KIM_NO_ERROR. - * \note This API returns thread local storage. It should be called - * immediately after a KIM API returns an error so that the correct string - * is returned. + * \note This API is implemented using thread local storage. It should be + * called immediately after a KIM API returns an error code so that the correct + * string is returned. The returned copy may then be held by the caller until + * needed. If \a in_error does not match the last saved error KIM may return + * a less descriptive string. * \brief Get a text description of an error suitable for display to the user. */ kim_error kim_string_get_last_error_message (kim_string *out_string, |