1KRB5_DIGEST(3)           BSD Library Functions Manual           KRB5_DIGEST(3)
2

NAME

4     krb5_digest, krb5_digest_alloc, krb5_digest_free,
5     krb5_digest_set_server_cb, krb5_digest_set_type,
6     krb5_digest_set_hostname, krb5_digest_get_server_nonce,
7     krb5_digest_set_server_nonce, krb5_digest_get_opaque,
8     krb5_digest_set_opaque, krb5_digest_get_identifier,
9     krb5_digest_set_identifier, krb5_digest_init_request,
10     krb5_digest_set_client_nonce, krb5_digest_set_digest,
11     krb5_digest_set_username, krb5_digest_set_authid,
12     krb5_digest_set_authentication_user, krb5_digest_set_realm,
13     krb5_digest_set_method, krb5_digest_set_uri, krb5_digest_set_nonceCount,
14     krb5_digest_set_qop, krb5_digest_request, krb5_digest_get_responseData,
15     krb5_digest_get_rsp, krb5_digest_get_tickets,
16     krb5_digest_get_client_binding, krb5_digest_get_a1_hash — remote digest
17     (HTTP-DIGEST, SASL, CHAP) support
18

LIBRARY

20     Kerberos 5 Library (libkrb5, -lkrb5)
21

SYNOPSIS

23     #include <krb5.h>
24
25     typedef struct krb5_digest *krb5_digest;
26
27     krb5_error_code
28     krb5_digest_alloc(krb5_context context, krb5_digest *digest);
29
30     void
31     krb5_digest_free(krb5_digest digest);
32
33     krb5_error_code
34     krb5_digest_set_type(krb5_context context, krb5_digest digest,
35         const char *type);
36
37     krb5_error_code
38     krb5_digest_set_server_cb(krb5_context context, krb5_digest digest,
39         const char *type, const char *binding);
40
41     krb5_error_code
42     krb5_digest_set_hostname(krb5_context context, krb5_digest digest,
43         const char *hostname);
44
45     const char *
46     krb5_digest_get_server_nonce(krb5_context context, krb5_digest digest);
47
48     krb5_error_code
49     krb5_digest_set_server_nonce(krb5_context context, krb5_digest digest,
50         const char *nonce);
51
52     const char *
53     krb5_digest_get_opaque(krb5_context context, krb5_digest digest);
54
55     krb5_error_code
56     krb5_digest_set_opaque(krb5_context context, krb5_digest digest,
57         const char *opaque);
58
59     const char *
60     krb5_digest_get_identifier(krb5_context context, krb5_digest digest);
61
62     krb5_error_code
63     krb5_digest_set_identifier(krb5_context context, krb5_digest digest,
64         const char *id);
65
66     krb5_error_code
67     krb5_digest_init_request(krb5_context context, krb5_digest digest,
68         krb5_realm realm, krb5_ccache ccache);
69
70     krb5_error_code
71     krb5_digest_set_client_nonce(krb5_context context, krb5_digest digest,
72         const char *nonce);
73
74     krb5_error_code
75     krb5_digest_set_digest(krb5_context context, krb5_digest digest,
76         const char *dgst);
77
78     krb5_error_code
79     krb5_digest_set_username(krb5_context context, krb5_digest digest,
80         const char *username);
81
82     krb5_error_code
83     krb5_digest_set_authid(krb5_context context, krb5_digest digest,
84         const char *authid);
85
86     krb5_error_code
87     krb5_digest_set_authentication_user(krb5_context context,
88         krb5_digest digest, krb5_principal authentication_user);
89
90     krb5_error_code
91     krb5_digest_set_realm(krb5_context context, krb5_digest digest,
92         const char *realm);
93
94     krb5_error_code
95     krb5_digest_set_method(krb5_context context, krb5_digest digest,
96         const char *method);
97
98     krb5_error_code
99     krb5_digest_set_uri(krb5_context context, krb5_digest digest,
100         const char *uri);
101
102     krb5_error_code
103     krb5_digest_set_nonceCount(krb5_context context, krb5_digest digest,
104         const char *nonce_count);
105
106     krb5_error_code
107     krb5_digest_set_qop(krb5_context context, krb5_digest digest,
108         const char *qop);
109
110     krb5_error_code
111     krb5_digest_request(krb5_context context, krb5_digest digest,
112         krb5_realm realm, krb5_ccache ccache);
113
114     const char *
115     krb5_digest_get_responseData(krb5_context context, krb5_digest digest);
116
117     const char *
118     krb5_digest_get_rsp(krb5_context context, krb5_digest digest);
119
120     krb5_error_code
121     krb5_digest_get_tickets(krb5_context context, krb5_digest digest,
122         Ticket **tickets);
123
124     krb5_error_code
125     krb5_digest_get_client_binding(krb5_context context, krb5_digest digest,
126         char **type, char **binding);
127
128     krb5_error_code
129     krb5_digest_get_a1_hash(krb5_context context, krb5_digest digest,
130         krb5_data *data);
131

DESCRIPTION

133     The krb5_digest_alloc() function allocatates the digest structure.  The
134     structure should be freed with krb5_digest_free() when it is no longer
135     being used.
136
137     krb5_digest_alloc() returns 0 to indicate success.  Otherwise an kerberos
138     code is returned and the pointer that digest points to is set to NULL.
139
140     krb5_digest_free() free the structure digest.
141

SEE ALSO

143     krb5(3), kerberos(8)
144
145HEIMDAL                        February 18, 2007                       HEIMDAL