KRB5_DATA(3)               UNIX Programmer's Manual               KRB5_DATA(3)

NNAAMMEE
     kkrrbb55__ddaattaa kkrrbb55__ddaattaa__zzeerroo kkrrbb55__ddaattaa__ffrreeee kkrrbb55__ffrreeee__ddaattaa__ccoonntteennttss
     kkrrbb55__ffrreeee__ddaattaa kkrrbb55__ddaattaa__aalllloocc kkrrbb55__ddaattaa__rreeaalllloocc kkrrbb55__ddaattaa__ccooppyy
     kkrrbb55__ccooppyy__ddaattaa - operates on the Kerberos datatype krb5_data.

LLIIBBRRAARRYY
     Kerberos 5 Library (libkrb5, -lkrb5)

SSYYNNOOPPSSIISS
     struct krb5_data; _v_o_i_d
     kkrrbb55__ddaattaa__zzeerroo(_k_r_b_5___d_a_t_a _*_p)

     _v_o_i_d
     kkrrbb55__ddaattaa__ffrreeee(_k_r_b_5___d_a_t_a _*_p)

     _v_o_i_d
     kkrrbb55__ffrreeee__ddaattaa__ccoonntteennttss(_k_r_b_5___c_o_n_t_e_x_t _c_o_n_t_e_x_t, _k_r_b_5___d_a_t_a _*_p)

     _v_o_i_d
     kkrrbb55__ffrreeee__ddaattaa(_k_r_b_5___c_o_n_t_e_x_t _c_o_n_t_e_x_t, _k_r_b_5___d_a_t_a _*_p)

     _k_r_b_5___e_r_r_o_r___c_o_d_e
     kkrrbb55__ddaattaa__aalllloocc(_k_r_b_5___d_a_t_a _*_p, _i_n_t _l_e_n)

     _k_r_b_5___e_r_r_o_r___c_o_d_e
     kkrrbb55__ddaattaa__rreeaalllloocc(_k_r_b_5___d_a_t_a _*_p, _i_n_t _l_e_n)

     _k_r_b_5___e_r_r_o_r___c_o_d_e
     kkrrbb55__ddaattaa__ccooppyy(_k_r_b_5___d_a_t_a _*_p, _c_o_n_s_t _v_o_i_d _*_d_a_t_a, _s_i_z_e___t _l_e_n)

     _k_r_b_5___e_r_r_o_r___c_o_d_e
     kkrrbb55__ccooppyy__ddaattaa(_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 _*_i_n_d_a_t_a,
             _k_r_b_5___d_a_t_a _*_*_o_u_t_d_a_t_a)

DDEESSCCRRIIPPTTIIOONN
     The krb5_data structure holds a data element.  The structure contains two
     public accessible elements _l_e_n_g_t_h (the length of data) and _d_a_t_a (the data
     itself).  The structure must always be initiated and freed by the func-
     tions documented in this manual.

     kkrrbb55__ddaattaa__zzeerroo() resets the content of _p.

     kkrrbb55__ddaattaa__ffrreeee() free the data in _p.

     kkrrbb55__ffrreeee__ddaattaa__ccoonntteennttss() works the same way as _k_r_b_5___d_a_t_a___f_r_e_e. The
     diffrence is that krb5_free_data_contents is more portable (exists in MIT
     api).

     kkrrbb55__ffrreeee__ddaattaa() frees the data in _p and _p itself .

     kkrrbb55__ddaattaa__aalllloocc() allocates _l_e_n bytes in _p Returns 0 or an error.

     kkrrbb55__ddaattaa__rreeaalllloocc() reallocates the length of _p to the length in _l_e_n. Re-
     turns 0 or an error.

     kkrrbb55__ddaattaa__ccooppyy() copies the _d_a_t_a that have the length _l_e_n into _p. _p is
     not freed so the calling function should make sure the _p doesn't contain
     anything needs to be freed.  Returns 0 or an error.

     kkrrbb55__ccooppyy__ddaattaa() copies the krb5_data in _i_n_d_a_t_a to _o_u_t_d_a_t_a. _o_u_t_d_a_t_a is
     not freed so the calling function should make sure the _o_u_t_d_a_t_a doesn't
     contain anything needs to be freed.  _o_u_t_d_a_t_a should be freed using
     kkrrbb55__ffrreeee__ddaattaa().  Returns 0 or an error.

SSEEEE AALLSSOO
     krb5(3),  krb5_storage(3),  kerberos(8)

 HEIMDAL                        March 20, 2003                               2