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

   1
   2 KRB5_GET_KRBHST(3)         UNIX Programmer's Manual         KRB5_GET_KRBHST(3)
   3
   4 N\bNA\bAM\bME\bE
   5      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_k\bkr\brb\bbh\bhs\bst\bt k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_k\bkr\brb\bb_\b_a\bad\bdm\bmi\bin\bn_\b_h\bhs\bst\bt k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_k\bkr\brb\bb_\b_c\bch\bha\ban\bng\bge\bep\bpw\bw_\b_h\bhs\bst\bt
   6      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_k\bkr\brb\bb5\b52\b24\b4h\bhs\bst\bt k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_k\bkr\brb\bbh\bhs\bst\bt - lookup Kerberos KDC hosts
   7
   8 L\bLI\bIB\bBR\bRA\bAR\bRY\bY
   9      Kerberos 5 Library (libkrb5, -lkrb5)
  10
  11 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
  12      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  13      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_k\bkr\brb\bbh\bhs\bst\bt(_\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__\br_\be_\ba_\bl_\bm _\b*_\br_\be_\ba_\bl_\bm,
  14              _\bc_\bh_\ba_\br _\b*_\b*_\b*_\bh_\bo_\bs_\bt_\bl_\bi_\bs_\bt)
  15
  16      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  17      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_k\bkr\brb\bb_\b_a\bad\bdm\bmi\bin\bn_\b_h\bhs\bst\bt(_\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__\br_\be_\ba_\bl_\bm _\b*_\br_\be_\ba_\bl_\bm,
  18              _\bc_\bh_\ba_\br _\b*_\b*_\b*_\bh_\bo_\bs_\bt_\bl_\bi_\bs_\bt)
  19
  20      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  21      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_k\bkr\brb\bb_\b_c\bch\bha\ban\bng\bge\bep\bpw\bw_\b_h\bhs\bst\bt(_\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__\br_\be_\ba_\bl_\bm _\b*_\br_\be_\ba_\bl_\bm,
  22              _\bc_\bh_\ba_\br _\b*_\b*_\b*_\bh_\bo_\bs_\bt_\bl_\bi_\bs_\bt)
  23
  24      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  25      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_k\bkr\brb\bb5\b52\b24\b4h\bhs\bst\bt(_\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__\br_\be_\ba_\bl_\bm _\b*_\br_\be_\ba_\bl_\bm,
  26              _\bc_\bh_\ba_\br _\b*_\b*_\b*_\bh_\bo_\bs_\bt_\bl_\bi_\bs_\bt)
  27
  28      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  29      k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_k\bkr\brb\bbh\bhs\bst\bt(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt, _\bc_\bh_\ba_\br _\b*_\b*_\bh_\bo_\bs_\bt_\bl_\bi_\bs_\bt)
  30
  31 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  32      These functions implement the old API to get a list of Kerberos hosts,
  33      and are thus similar to the k\bkr\brb\bb5\b5_\b_k\bkr\brb\bbh\bhs\bst\bt_\b_i\bin\bni\bit\bt() functions. However, since
  34      these functions returns _\ba_\bl_\bl hosts in one go, they potentially have to do
  35      more lookups than necessary. These functions remain for compatibility
  36      reasons.
  37
  38      After a call to one of these functions, _\bh_\bo_\bs_\bt_\bl_\bi_\bs_\bt is a NULL terminated
  39      list of strings, pointing to the requested Kerberos hosts. These should
  40      be freed with k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_k\bkr\brb\bbh\bhs\bst\bt() when done with.
  41
  42 E\bEX\bXA\bAM\bMP\bPL\bLE\bE
  43      The following code will print the KDCs of the realm ``MY.REALM''.
  44
  45            char **hosts, **p;
  46            krb5_get_krbhst(context, "MY.REALM", &hosts);
  47            for(p = hosts; *p; p++)
  48                printf("%s\n", *p);
  49            krb5_free_krbhst(context, hosts);
  50
  51 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
  52      krb5_krbhst_init(3)
  53
  54  HEIMDAL                         June 17, 2001                               1