krb5_rd_error(3)

krb5_rd_error3

Parse, free and read error from krb-error message

Usage

#include <krb5.h>

krb5_error_code

krb5_rd_error(krb5_context context, const krb5_data *msg, KRB_ERROR *result);

void

krb5_free_error(krb5_context context, krb5_error *error);

void

krb5_free_error_contents(krb5_context context, krb5_error *error);

krb5_error_code

krb5_error_from_rd_error(krb5_context context, const krb5_error *error, const krb5_creds *creds);

Library

Kerberos 5 Library (libkrb5, -lkrb5)

Overview

Usually applications never needs to parse and understand Kerberos error messages since higher level functions will parse and push up the error in the krb5_context. These functions are described for completeness.

krb5_rd_error() parses and returns the kerboeros error message, the structure should be freed with krb5_free_error_contents() when the caller is done with the structure.

krb5_free_error() frees the content and the memory region holding the structure iself.

krb5_free_error_contents() free the content of the KRB-ERROR message.

krb5_error_from_rd_error() will parse the error message and set the error buffer in krb5_context to the error string passed back or the matching error code in the KRB-ERROR message. Caller should pick up the message with krb5_get_error_string(3) (don't forget to free the returned string with krb5_free_error_string()).

Releases

10 releases since Debian 4.0 (Etch); the text changed 2 times.

  1. 4.0
  2. 5.0
  3. 6.0–13

From heimdal-dev 7.8.git20221117.28daf24+dfsg-9+deb13u1 in Debian 13 (Trixie). Parsed by carta from the page's mdoc source.