1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
KRB5_RD_ERROR(3) BSD Library Functions Manual KRB5_RD_ERROR(3)
NNAAMMEE
kkrrbb55__rrdd__eerrrroorr, kkrrbb55__ffrreeee__eerrrroorr, kkrrbb55__ffrreeee__eerrrroorr__ccoonntteennttss,
kkrrbb55__eerrrroorr__ffrroomm__rrdd__eerrrroorr -- parse, free and read error from KRB-ERROR
message
LLIIBBRRAARRYY
Kerberos 5 Library (libkrb5, -lkrb5)
SSYYNNOOPPSSIISS
##iinncclluuddee <<kkrrbb55..hh>>
_k_r_b_5___e_r_r_o_r___c_o_d_e
kkrrbb55__rrdd__eerrrroorr(_k_r_b_5___c_o_n_t_e_x_t _c_o_n_t_e_x_t, _c_o_n_s_t _k_r_b_5___d_a_t_a _*_m_s_g,
_K_R_B___E_R_R_O_R _*_r_e_s_u_l_t);
_v_o_i_d
kkrrbb55__ffrreeee__eerrrroorr(_k_r_b_5___c_o_n_t_e_x_t _c_o_n_t_e_x_t, _k_r_b_5___e_r_r_o_r _*_e_r_r_o_r);
_v_o_i_d
kkrrbb55__ffrreeee__eerrrroorr__ccoonntteennttss(_k_r_b_5___c_o_n_t_e_x_t _c_o_n_t_e_x_t, _k_r_b_5___e_r_r_o_r _*_e_r_r_o_r);
_k_r_b_5___e_r_r_o_r___c_o_d_e
kkrrbb55__eerrrroorr__ffrroomm__rrdd__eerrrroorr(_k_r_b_5___c_o_n_t_e_x_t _c_o_n_t_e_x_t, _c_o_n_s_t _k_r_b_5___e_r_r_o_r _*_e_r_r_o_r,
_c_o_n_s_t _k_r_b_5___c_r_e_d_s _*_c_r_e_d_s);
DDEESSCCRRIIPPTTIIOONN
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.
kkrrbb55__rrdd__eerrrroorr() parses and returns the kerboeros error message, the
structure should be freed with kkrrbb55__ffrreeee__eerrrroorr__ccoonntteennttss() when the caller
is done with the structure.
kkrrbb55__ffrreeee__eerrrroorr() frees the content and the memory region holding the
structure iself.
kkrrbb55__ffrreeee__eerrrroorr__ccoonntteennttss() free the content of the KRB-ERROR message.
kkrrbb55__eerrrroorr__ffrroomm__rrdd__eerrrroorr() 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 kkrrbb55__ggeett__eerrrroorr__ssttrriinngg(_3) (don't forget to free the returned string
with kkrrbb55__ffrreeee__eerrrroorr__ssttrriinngg()).
SSEEEE AALLSSOO
krb5(3), krb5_set_error_string(3), krb5_get_error_string(3), krb5.conf(5)
HEIMDAL July 26, 2004 HEIMDAL
|
