← Back to branch summary

~ubuntu-branches/ubuntu/raring/heimdal/raring

« back to all changes in this revision

Viewing changes to doc/doxyout/krb5/man/man3/krb5_ccache_intro.3

  • Committer: Package Import Robot
  • Author(s): Jelmer Vernooij
  • Date: 2011-10-03 23:50:05 UTC
  • mfrom: (1.1.15) (2.2.23 sid)
  • Revision ID: package-import@ubuntu.com-20111003235005-0voibbgdhyqmtp6w
Tags: 1.5.dfsg.1-3
http://bugs.debian.org/644138
Add conflicts with kcc to heimdal-clients. Closes: #644138

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/doxyout/krb5/man/man3/krb5_ccache_intro.3
 
1
.TH "krb5_ccache_intro" 3 "30 Jul 2011" "Version 1.5" "HeimdalKerberos5library" \" -*- nroff -*-
 
2
.ad l
 
3
.nh
 
4
.SH NAME
 
5
krb5_ccache_intro \- The credential cache functions 
 
6
.SH "Kerberos credential caches"
 
7
.PP
 
8
krb5_ccache structure holds a Kerberos credential cache.
 
9
.PP
 
10
Heimdal support the follow types of credential caches:
 
11
.PP
 
12
.IP "\(bu" 2
 
13
SCC Store the credential in a database
 
14
.IP "\(bu" 2
 
15
FILE Store the credential in memory
 
16
.IP "\(bu" 2
 
17
MEMORY Store the credential in memory
 
18
.IP "\(bu" 2
 
19
API A credential cache server based solution for Mac OS X
 
20
.IP "\(bu" 2
 
21
KCM A credential cache server based solution for all platforms
 
22
.PP
 
23
.SS "Example"
 
24
This is a minimalistic version of klist: 
 
25
.PP
 
26
.nf
 
27
#include <krb5.h>
 
28
 
 
29
int
 
30
main (int argc, char **argv)
 
31
{
 
32
    krb5_context context;
 
33
    krb5_cc_cursor cursor;
 
34
    krb5_error_code ret;
 
35
    krb5_ccache id;
 
36
    krb5_creds creds;
 
37
 
 
38
    if (krb5_init_context (&context) != 0)
 
39
        errx(1, 'krb5_context');
 
40
 
 
41
    ret = krb5_cc_default (context, &id);
 
42
    if (ret)
 
43
        krb5_err(context, 1, ret, 'krb5_cc_default');
 
44
 
 
45
    ret = krb5_cc_start_seq_get(context, id, &cursor);
 
46
    if (ret)
 
47
        krb5_err(context, 1, ret, 'krb5_cc_start_seq_get');
 
48
 
 
49
    while((ret = krb5_cc_next_cred(context, id, &cursor, &creds)) == 0){
 
50
        char *principal;
 
51
 
 
52
        krb5_unparse_name(context, creds.server, &principal);
 
53
        printf('principal: %s\\n', principal);
 
54
        free(principal);
 
55
        krb5_free_cred_contents (context, &creds);
 
56
    }
 
57
    ret = krb5_cc_end_seq_get(context, id, &cursor);
 
58
    if (ret)
 
59
        krb5_err(context, 1, ret, 'krb5_cc_end_seq_get');
 
60
 
 
61
    krb5_cc_close(context, id);
 
62
 
 
63
    krb5_free_context(context);
 
64
    return 0;
 
65
}
 
66
 
 
67
.fi
 
68
.PP
 
69