Merge from vendor branch LIBARCHIVE:
[dragonfly.git] / crypto / heimdal-0.6.3 / lib / gssapi / gssapi.cat3
1
2 GSSAPI(3)                  UNIX Programmer's Manual                  GSSAPI(3)
3
4 N\bNA\bAM\bME\bE
5      g\bgs\bss\bsa\bap\bpi\bi - Generic Security Service Application Program Interface library
6
7 L\bLI\bIB\bBR\bRA\bAR\bRY\bY
8      GSS-API Library (libgssapi, -lgssapi)
9
10 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
11      The Generic Security Service Application Program Interface (GSS-API) pro-
12      vides security services to callers in a generic fashion, supportable with
13      a range of underlying mechanisms and technologies and hence allowing
14      source-level portability of applications to different environments.
15
16 L\bLI\bIS\bST\bT O\bOF\bF F\bFU\bUN\bNC\bCT\bTI\bIO\bON\bNS\bS
17      These functions constitute the gssapi library, _\bl_\bi_\bb_\bg_\bs_\bs_\ba_\bp_\bi. Declarations
18      for these functions may be obtained from the include file _\bg_\bs_\bs_\ba_\bp_\bi_\b._\bh.
19
20
21      _\bN_\ba_\bm_\be_\b/_\bP_\ba_\bg_\be                   _\bD_\be_\bs_\bc_\br_\bi_\bp_\bt_\bi_\bo_\bn
22      gss_accept_sec_context.3
23      gss_acquire_cred.3
24      gss_add_cred.3
25      gss_add_oid_set_member.3
26      gss_canonicalize_name.3
27      gss_compare_name.3
28      gss_context_time.3
29      gss_create_empty_oid_set.3
30      gss_delete_sec_context.3
31      gss_display_name.3
32      gss_display_status.3
33      gss_duplicate_name.3
34      gss_export_name.3
35      gss_export_sec_context.3
36      gss_get_mic.3
37      gss_import_name.3
38      gss_import_sec_context.3
39      gss_indicate_mechs.3
40      gss_init_sec_context.3
41      gss_inquire_context.3
42      gss_inquire_cred.3
43      gss_inquire_cred_by_mech.3
44      gss_inquire_mechs_for_name.3
45      gss_inquire_names_for_mech.3
46      gss_krb5_copy_ccache.3
47      gss_process_context_token.3
48      gss_release_buffer.3
49      gss_release_cred.3
50      gss_release_name.3
51      gss_release_oid_set.3
52      gss_seal.3
53      gss_sign.3
54      gss_test_oid_set_member.3
55      gss_unseal.3
56      gss_unwrap.3
57      gss_verify.3
58      gss_verify_mic.3
59      gss_wrap.3
60      gss_wrap_size_limit.3
61
62 C\bCO\bOM\bMP\bPA\bAT\bTI\bIB\bBI\bIL\bLI\bIT\bTY\bY
63      The H\bHe\bei\bim\bmd\bda\bal\bl GSS-API implementation had a bug in releases before 0.6 that
64      made it fail to inter-operate when using DES3 with other GSS-API imple-
65      mentations when using g\bgs\bss\bs_\b_g\bge\bet\bt_\b_m\bmi\bic\bc() / g\bgs\bss\bs_\b_v\bve\ber\bri\bif\bfy\by_\b_m\bmi\bic\bc().  Its possible to
66      modify the behavior of the generator of the MIC with the _\bk_\br_\bb_\b5_\b._\bc_\bo_\bn_\bf con-
67      figuration file so that old clients/servers will still work.
68
69      New clients/servers will try both the old and new MIC in Heimdal 0.6.  In
70      0.7 it will check only if configured and the compatibility code will be
71      removed in 0.8.
72
73      Heimdal 0.6 still generates by default the broken GSS-API DES3 mic, this
74      will change in 0.7 to generate correct des3 mic.
75
76      To turn on compatibility with older clients and servers, change the
77      [\b[g\bgs\bss\bsa\bap\bpi\bi]\b] _\bb_\br_\bo_\bk_\be_\bn_\b__\bd_\be_\bs_\b3_\b__\bm_\bi_\bc in _\bk_\br_\bb_\b5_\b._\bc_\bo_\bn_\bf that contains a list of globbing
78      expressions that will be matched against the server name.  To turn off
79      generation of the old (incompatible) mic of the MIC use [\b[g\bgs\bss\bsa\bap\bpi\bi]\b]
80      _\bc_\bo_\br_\br_\be_\bc_\bt_\b__\bd_\be_\bs_\b3_\b__\bm_\bi_\bc.
81
82      If a match for a entry is in both [\b[g\bgs\bss\bsa\bap\bpi\bi]\b] _\bc_\bo_\br_\br_\be_\bc_\bt_\b__\bd_\be_\bs_\b3_\b__\bm_\bi_\bc and [\b[g\bgs\bss\bsa\bap\bpi\bi]\b]
83      _\bc_\bo_\br_\br_\be_\bc_\bt_\b__\bd_\be_\bs_\b3_\b__\bm_\bi_\bc, the later will override.
84
85      This config option modifies behaviour for both clients and servers.
86
87      Example:
88
89            [gssapi]
90                    broken_des3_mic = cvs/*@SU.SE
91                    broken_des3_mic = host/*@E.KTH.SE
92                    correct_des3_mic = host/*@SU.SE
93
94 B\bBU\bUG\bGS\bS
95      All of 0.5.x versions of h\bhe\bei\bim\bmd\bda\bal\bl had broken token delegations in the
96      client side, the server side was correct.
97
98 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
99      krb5(3),  krb5.conf(5),  kerberos(8)
100
101 BSD Experimental               January 23, 2003                              2