crypto/heimdal-0.6.3/lib/krb5/krb5_data.cat3

   1
   2 KRB5_DATA(3)               UNIX Programmer's Manual               KRB5_DATA(3)
   3
   4 N\bNA\bAM\bME\bE
   5      k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_z\bze\ber\bro\bo k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_f\bfr\bre\bee\be k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_d\bda\bat\bta\ba_\b_c\bco\bon\bnt\bte\ben\bnt\bts\bs
   6      k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_d\bda\bat\bta\ba k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_a\bal\bll\blo\boc\bc k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_r\bre\bea\bal\bll\blo\boc\bc k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_c\bco\bop\bpy\by
   7      k\bkr\brb\bb5\b5_\b_c\bco\bop\bpy\by_\b_d\bda\bat\bta\ba - operates on the Kerberos datatype krb5_data.
   8
   9 L\bLI\bIB\bBR\bRA\bAR\bRY\bY
  10      Kerberos 5 Library (libkrb5, -lkrb5)
  11
  12 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
  13      struct krb5_data; _\bv_\bo_\bi_\bd
  14      k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_z\bze\ber\bro\bo(_\bk_\br_\bb_\b5_\b__\bd_\ba_\bt_\ba _\b*_\bp)
  15
  16      _\bv_\bo_\bi_\bd
  17      k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_f\bfr\bre\bee\be(_\bk_\br_\bb_\b5_\b__\bd_\ba_\bt_\ba _\b*_\bp)
  18
  19      _\bv_\bo_\bi_\bd
  20      k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_d\bda\bat\bta\ba_\b_c\bco\bon\bnt\bte\ben\bnt\bts\bs(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt, _\bk_\br_\bb_\b5_\b__\bd_\ba_\bt_\ba _\b*_\bp)
  21
  22      _\bv_\bo_\bi_\bd
  23      k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_d\bda\bat\bta\ba(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt, _\bk_\br_\bb_\b5_\b__\bd_\ba_\bt_\ba _\b*_\bp)
  24
  25      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  26      k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_a\bal\bll\blo\boc\bc(_\bk_\br_\bb_\b5_\b__\bd_\ba_\bt_\ba _\b*_\bp, _\bi_\bn_\bt _\bl_\be_\bn)
  27
  28      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  29      k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_r\bre\bea\bal\bll\blo\boc\bc(_\bk_\br_\bb_\b5_\b__\bd_\ba_\bt_\ba _\b*_\bp, _\bi_\bn_\bt _\bl_\be_\bn)
  30
  31      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  32      k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_c\bco\bop\bpy\by(_\bk_\br_\bb_\b5_\b__\bd_\ba_\bt_\ba _\b*_\bp, _\bc_\bo_\bn_\bs_\bt _\bv_\bo_\bi_\bd _\b*_\bd_\ba_\bt_\ba, _\bs_\bi_\bz_\be_\b__\bt _\bl_\be_\bn)
  33
  34      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  35      k\bkr\brb\bb5\b5_\b_c\bco\bop\bpy\by_\b_d\bda\bat\bta\ba(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt, _\bc_\bo_\bn_\bs_\bt _\bk_\br_\bb_\b5_\b__\bd_\ba_\bt_\ba _\b*_\bi_\bn_\bd_\ba_\bt_\ba,
  36              _\bk_\br_\bb_\b5_\b__\bd_\ba_\bt_\ba _\b*_\b*_\bo_\bu_\bt_\bd_\ba_\bt_\ba)
  37
  38 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  39      The krb5_data structure holds a data element.  The structure contains two
  40      public accessible elements _\bl_\be_\bn_\bg_\bt_\bh (the length of data) and _\bd_\ba_\bt_\ba (the data
  41      itself).  The structure must always be initiated and freed by the func-
  42      tions documented in this manual.
  43
  44      k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_z\bze\ber\bro\bo() resets the content of _\bp.
  45
  46      k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_f\bfr\bre\bee\be() free the data in _\bp.
  47
  48      k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_d\bda\bat\bta\ba_\b_c\bco\bon\bnt\bte\ben\bnt\bts\bs() works the same way as _\bk_\br_\bb_\b5_\b__\bd_\ba_\bt_\ba_\b__\bf_\br_\be_\be. The
  49      diffrence is that krb5_free_data_contents is more portable (exists in MIT
  50      api).
  51
  52      k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_d\bda\bat\bta\ba() frees the data in _\bp and _\bp itself .
  53
  54      k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_a\bal\bll\blo\boc\bc() allocates _\bl_\be_\bn bytes in _\bp Returns 0 or an error.
  55
  56      k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_r\bre\bea\bal\bll\blo\boc\bc() reallocates the length of _\bp to the length in _\bl_\be_\bn. Re-
  57      turns 0 or an error.
  58
  59      k\bkr\brb\bb5\b5_\b_d\bda\bat\bta\ba_\b_c\bco\bop\bpy\by() copies the _\bd_\ba_\bt_\ba that have the length _\bl_\be_\bn into _\bp. _\bp is
  60      not freed so the calling function should make sure the _\bp doesn't contain
  61      anything needs to be freed.  Returns 0 or an error.
  62
  63      k\bkr\brb\bb5\b5_\b_c\bco\bop\bpy\by_\b_d\bda\bat\bta\ba() copies the krb5_data in _\bi_\bn_\bd_\ba_\bt_\ba to _\bo_\bu_\bt_\bd_\ba_\bt_\ba. _\bo_\bu_\bt_\bd_\ba_\bt_\ba is
  64      not freed so the calling function should make sure the _\bo_\bu_\bt_\bd_\ba_\bt_\ba doesn't
  65      contain anything needs to be freed.  _\bo_\bu_\bt_\bd_\ba_\bt_\ba should be freed using
  66      k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_d\bda\bat\bta\ba().  Returns 0 or an error.
  67
  68 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
  69      krb5(3),  krb5_storage(3),  kerberos(8)
  70
  71  HEIMDAL                        March 20, 2003                               2