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

   1
   2 KRB5_SET_DEFAULT_REALM(3)  UNIX Programmer's Manual  KRB5_SET_DEFAULT_REALM(3)
   3
   4 N\bNA\bAM\bME\bE
   5      k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_h\bho\bos\bst\bt_\b_r\bre\bea\bal\blm\bm k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_r\bre\bea\bal\blm\bm k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_r\bre\bea\bal\blm\bms\bs
   6      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_h\bho\bos\bst\bt_\b_r\bre\bea\bal\blm\bm k\bkr\brb\bb5\b5_\b_s\bse\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_r\bre\bea\bal\blm\bm - default and host realm read
   7      and manipulation routines
   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      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  14      k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_h\bho\bos\bst\bt_\b_r\bre\bea\bal\blm\bm(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt, _\bk_\br_\bb_\b5_\b__\br_\be_\ba_\bl_\bm _\b*_\br_\be_\ba_\bl_\bm_\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_d\bde\bef\bfa\bau\bul\blt\bt_\b_r\bre\bea\bal\blm\bm(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt, _\bk_\br_\bb_\b5_\b__\br_\be_\ba_\bl_\bm _\b*_\br_\be_\ba_\bl_\bm)
  18
  19      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  20      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_r\bre\bea\bal\blm\bms\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__\br_\be_\ba_\bl_\bm _\b*_\b*_\br_\be_\ba_\bl_\bm)
  21
  22      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  23      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_h\bho\bos\bst\bt_\b_r\bre\bea\bal\blm\bm(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt, _\bc_\bo_\bn_\bs_\bt _\bc_\bh_\ba_\br _\b*_\bh_\bo_\bs_\bt,
  24              _\bk_\br_\bb_\b5_\b__\br_\be_\ba_\bl_\bm _\b*_\b*_\br_\be_\ba_\bl_\bm_\bs)
  25
  26      _\bk_\br_\bb_\b5_\b__\be_\br_\br_\bo_\br_\b__\bc_\bo_\bd_\be
  27      k\bkr\brb\bb5\b5_\b_s\bse\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_r\bre\bea\bal\blm\bm(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt, _\bc_\bo_\bn_\bs_\bt _\bc_\bh_\ba_\br _\b*_\br_\be_\ba_\bl_\bm)
  28
  29 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  30      k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_h\bho\bos\bst\bt_\b_r\bre\bea\bal\blm\bm() frees all memory allocated by _\br_\be_\ba_\bl_\bm_\bl_\bi_\bs_\bt.
  31
  32      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_r\bre\bea\bal\blm\bm() returns the first default realm for this host.
  33      The realm returned should be free with f\bfr\bre\bee\be().
  34
  35      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_r\bre\bea\bal\blm\bms\bs() returns a NULL terminated list of default
  36      realms for this context.  Realms returned by k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_r\bre\bea\bal\blm\bms\bs()
  37      should be free with k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_h\bho\bos\bst\bt_\b_r\bre\bea\bal\blm\bm().
  38
  39      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_h\bho\bos\bst\bt_\b_r\bre\bea\bal\blm\bm() returns a NULL terminated list of realms for _\bh_\bo_\bs_\bt
  40      by looking up the information in the [domain_realm] in _\bk_\br_\bb_\b5_\b._\bc_\bo_\bn_\bf or in
  41      DNS. If the mapping in [domain_realm] results in the string dns_locate,
  42      DNS is used to lookup the realm.
  43
  44      When using DNS to a resolve the domain for the host a.b.c,
  45      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_h\bho\bos\bst\bt_\b_r\bre\bea\bal\blm\bm() looks for a TXT resource record named
  46      _kerberos.a.b.c, and if not found, it strips off the first component and
  47      tries a again (_kerberos.b.c) until it reaches the root.
  48
  49      If there is no configuration or DNS information found,
  50      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_h\bho\bos\bst\bt_\b_r\bre\bea\bal\blm\bm() assumes it can use the domain part of the _\bh_\bo_\bs_\bt to
  51      form a realm.
  52
  53      k\bkr\brb\bb5\b5_\b_s\bse\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_r\bre\bea\bal\blm\bm() sets the default realm for the _\bc_\bo_\bn_\bt_\be_\bx_\bt. If NULL
  54      is used as a _\br_\be_\ba_\bl_\bm, the [libdefaults]default_realm stanza in _\bk_\br_\bb_\b5_\b._\bc_\bo_\bn_\bf is
  55      used.  If there is no such stanza in the configuration file, the
  56      k\bkr\brb\bb5\b5_\b_g\bge\bet\bt_\b_h\bho\bos\bst\bt_\b_r\bre\bea\bal\blm\bm() function is used to form a default realm.
  57
  58 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
  59      krb5.conf(5),  free(3)
  60
  61  HEIMDAL                         Mar 16, 2003                                1