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

   1
   2 KRB5_CONTEXT(3)            UNIX Programmer's Manual            KRB5_CONTEXT(3)
   3
   4 N\bNA\bAM\bME\bE
   5      k\bkr\brb\bb5\b5_\b_i\bin\bni\bit\bt_\b_c\bco\bon\bnt\bte\bex\bxt\bt, k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_c\bco\bon\bnt\bte\bex\bxt\bt - create and delete krb5_context
   6      structures
   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_i\bin\bni\bit\bt_\b_c\bco\bon\bnt\bte\bex\bxt\bt(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\b*_\bc_\bo_\bn_\bt_\be_\bx_\bt)
  14
  15      _\bv_\bo_\bi_\bd
  16      k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_c\bco\bon\bnt\bte\bex\bxt\bt(_\bk_\br_\bb_\b5_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt _\bc_\bo_\bn_\bt_\be_\bx_\bt)
  17
  18 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  19      The k\bkr\brb\bb5\b5_\b_i\bin\bni\bit\bt_\b_c\bco\bon\bnt\bte\bex\bxt\bt() function initializes the _\bc_\bo_\bn_\bt_\be_\bx_\bt structure and
  20      reads the configuration file _\b/_\be_\bt_\bc_\b/_\bk_\br_\bb_\b5_\b._\bc_\bo_\bn_\bf.
  21
  22      The structure should be freed by calling k\bkr\brb\bb5\b5_\b_f\bfr\bre\bee\be_\b_c\bco\bon\bnt\bte\bex\bxt\bt() when it is
  23      no longer being used.
  24
  25 R\bRE\bET\bTU\bUR\bRN\bN V\bVA\bAL\bLU\bUE\bES\bS
  26      k\bkr\brb\bb5\b5_\b_i\bin\bni\bit\bt_\b_c\bco\bon\bnt\bte\bex\bxt\bt() returns 0 to indicate success.  Otherwise an errno
  27      code is returned.  Failure means either that something bad happened dur-
  28      ing initialization (typically [ENOMEM]) or that Kerberos should not be
  29      used [ENXIO].
  30
  31 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
  32      errno(2),  krb5_context(3),  kerberos(8)
  33
  34  HEIMDAL                       January 21, 2001                              1