1/*
2 * Copyright (c) 1997 - 2010 Kungliga Tekniska H��gskolan
3 * (Royal Institute of Technology, Stockholm, Sweden).
4 * All rights reserved.
5 *
6 * Portions Copyright (c) 2009 Apple Inc. All rights reserved.
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
10 * are met:
11 *
12 * 1. Redistributions of source code must retain the above copyright
13 *    notice, this list of conditions and the following disclaimer.
14 *
15 * 2. Redistributions in binary form must reproduce the above copyright
16 *    notice, this list of conditions and the following disclaimer in the
17 *    documentation and/or other materials provided with the distribution.
18 *
19 * 3. Neither the name of the Institute nor the names of its contributors
20 *    may be used to endorse or promote products derived from this software
21 *    without specific prior written permission.
22 *
23 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26 * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 * SUCH DAMAGE.
34 */
35
36#include "krb5_locl.h"
37#include <assert.h>
38#include <com_err.h>
39
40#define INIT_FIELD(C, T, E, D, F)					\
41    (C)->E = krb5_config_get_ ## T ## _default ((C), NULL, (D), 	\
42						"libdefaults", F, NULL)
43
44#define INIT_FLAG(C, O, V, D, F)					\
45    do {								\
46	if (krb5_config_get_bool_default((C), NULL, (D),"libdefaults", F, NULL)) { \
47	    (C)->O |= V;						\
48        }								\
49    } while(0)
50
51/*
52 * Set the list of etypes `ret_etypes' from the configuration variable
53 * `name'
54 */
55
56static krb5_error_code
57set_etypes (krb5_context context,
58	    const char *name,
59	    krb5_enctype **ret_enctypes)
60{
61    char **etypes_str;
62    krb5_enctype *etypes = NULL;
63
64    etypes_str = krb5_config_get_strings(context, NULL, "libdefaults",
65					 name, NULL);
66    if(etypes_str){
67	int i, j, k;
68	for(i = 0; etypes_str[i]; i++);
69	etypes = malloc((i+1) * sizeof(*etypes));
70	if (etypes == NULL) {
71	    krb5_config_free_strings (etypes_str);
72	    krb5_set_error_message (context, ENOMEM, N_("malloc: out of memory", ""));
73	    return ENOMEM;
74	}
75	for(j = 0, k = 0; j < i; j++) {
76	    krb5_enctype e;
77	    if(krb5_string_to_enctype(context, etypes_str[j], &e) != 0)
78		continue;
79	    if (krb5_enctype_valid(context, e) != 0)
80		continue;
81	    etypes[k++] = e;
82	}
83	etypes[k] = ETYPE_NULL;
84	krb5_config_free_strings(etypes_str);
85    }
86    *ret_enctypes = etypes;
87    return 0;
88}
89
90/*
91 * read variables from the configuration file and set in `context'
92 */
93
94static krb5_error_code
95init_context_from_config_file(krb5_context context)
96{
97    krb5_error_code ret;
98    const char * tmp;
99    char **s;
100    krb5_enctype *tmptypes;
101
102    INIT_FIELD(context, time, max_skew, 5 * 60, "clockskew");
103    INIT_FIELD(context, time, kdc_timeout, 3, "kdc_timeout");
104    INIT_FIELD(context, int, max_retries, 3, "max_retries");
105
106    INIT_FIELD(context, string, http_proxy, NULL, "http_proxy");
107
108    ret = krb5_config_get_bool_default(context, NULL, FALSE,
109				       "libdefaults",
110				       "allow_weak_crypto", NULL);
111    if (ret) {
112	krb5_enctype_enable(context, ETYPE_DES_CBC_CRC);
113	krb5_enctype_enable(context, ETYPE_DES_CBC_MD4);
114	krb5_enctype_enable(context, ETYPE_DES_CBC_MD5);
115	krb5_enctype_enable(context, ETYPE_DES_CBC_NONE);
116	krb5_enctype_enable(context, ETYPE_DES_CFB64_NONE);
117	krb5_enctype_enable(context, ETYPE_DES_PCBC_NONE);
118    }
119
120    ret = set_etypes (context, "default_etypes", &tmptypes);
121    if(ret)
122	return ret;
123    free(context->etypes);
124    context->etypes = tmptypes;
125
126    ret = set_etypes (context, "default_etypes_des", &tmptypes);
127    if(ret)
128	return ret;
129    free(context->etypes_des);
130    context->etypes_des = tmptypes;
131
132    ret = set_etypes (context, "default_as_etypes", &tmptypes);
133    if(ret)
134	return ret;
135    free(context->as_etypes);
136    context->as_etypes = tmptypes;
137
138    ret = set_etypes (context, "default_tgs_etypes", &tmptypes);
139    if(ret)
140	return ret;
141    free(context->tgs_etypes);
142    context->tgs_etypes = tmptypes;
143
144    ret = set_etypes (context, "permitted_enctypes", &tmptypes);
145    if(ret)
146	return ret;
147    free(context->permitted_enctypes);
148    context->permitted_enctypes = tmptypes;
149
150    /* default keytab name */
151    tmp = NULL;
152    if(!issuid())
153	tmp = getenv("KRB5_KTNAME");
154    if(tmp != NULL)
155	context->default_keytab = tmp;
156    else
157	INIT_FIELD(context, string, default_keytab,
158		   KEYTAB_DEFAULT, "default_keytab_name");
159
160    INIT_FIELD(context, string, default_keytab_modify,
161	       NULL, "default_keytab_modify_name");
162
163    INIT_FIELD(context, string, time_fmt,
164	       "%Y-%m-%dT%H:%M:%S", "time_format");
165
166    INIT_FIELD(context, string, date_fmt,
167	       "%Y-%m-%d", "date_format");
168
169    INIT_FIELD(context, bool, log_utc,
170	       FALSE, "log_utc");
171
172
173
174    /* init dns-proxy slime */
175    tmp = krb5_config_get_string(context, NULL, "libdefaults",
176				 "dns_proxy", NULL);
177    if(tmp)
178	roken_gethostby_setup(context->http_proxy, tmp);
179    krb5_free_host_realm (context, context->default_realms);
180    context->default_realms = NULL;
181
182    {
183	krb5_addresses addresses;
184	char **adr, **a;
185
186	krb5_set_extra_addresses(context, NULL);
187	adr = krb5_config_get_strings(context, NULL,
188				      "libdefaults",
189				      "extra_addresses",
190				      NULL);
191	memset(&addresses, 0, sizeof(addresses));
192	for(a = adr; a && *a; a++) {
193	    ret = krb5_parse_address(context, *a, &addresses);
194	    if (ret == 0) {
195		krb5_add_extra_addresses(context, &addresses);
196		krb5_free_addresses(context, &addresses);
197	    }
198	}
199	krb5_config_free_strings(adr);
200
201	krb5_set_ignore_addresses(context, NULL);
202	adr = krb5_config_get_strings(context, NULL,
203				      "libdefaults",
204				      "ignore_addresses",
205				      NULL);
206	memset(&addresses, 0, sizeof(addresses));
207	for(a = adr; a && *a; a++) {
208	    ret = krb5_parse_address(context, *a, &addresses);
209	    if (ret == 0) {
210		krb5_add_ignore_addresses(context, &addresses);
211		krb5_free_addresses(context, &addresses);
212	    }
213	}
214	krb5_config_free_strings(adr);
215    }
216
217    INIT_FIELD(context, bool, scan_interfaces, TRUE, "scan_interfaces");
218    INIT_FIELD(context, int, fcache_vno, 0, "fcache_version");
219    /* prefer dns_lookup_kdc over srv_lookup. */
220    INIT_FIELD(context, bool, srv_lookup, TRUE, "srv_lookup");
221    INIT_FIELD(context, bool, srv_lookup, context->srv_lookup, "dns_lookup_kdc");
222    INIT_FIELD(context, int, large_msg_size, 1400, "large_message_size");
223    INIT_FLAG(context, flags, KRB5_CTX_F_DNS_CANONICALIZE_HOSTNAME, TRUE, "dns_canonicalize_hostname");
224    INIT_FLAG(context, flags, KRB5_CTX_F_CHECK_PAC, TRUE, "check_pac");
225    context->default_cc_name = NULL;
226    context->default_cc_name_set = 0;
227
228    s = krb5_config_get_strings(context, NULL, "logging", "krb5", NULL);
229    if(s) {
230	char **p;
231	krb5_initlog(context, "libkrb5", &context->debug_dest);
232	for(p = s; *p; p++)
233	    krb5_addlog_dest(context, context->debug_dest, *p);
234	krb5_config_free_strings(s);
235    }
236
237    tmp = krb5_config_get_string(context, NULL, "libdefaults",
238				 "check-rd-req-server", NULL);
239    if (tmp == NULL && !issuid())
240	tmp = getenv("KRB5_CHECK_RD_REQ_SERVER");
241    if(tmp) {
242	if (strcasecmp(tmp, "ignore") == 0)
243	    context->flags |= KRB5_CTX_F_RD_REQ_IGNORE;
244    }
245
246    return 0;
247}
248
249static krb5_error_code
250cc_ops_register(krb5_context context)
251{
252    context->cc_ops = NULL;
253    context->num_cc_ops = 0;
254
255#ifndef KCM_IS_API_CACHE
256    krb5_cc_register(context, &krb5_acc_ops, TRUE);
257#endif
258    krb5_cc_register(context, &krb5_fcc_ops, TRUE);
259    krb5_cc_register(context, &krb5_mcc_ops, TRUE);
260#ifdef HAVE_SCC
261    krb5_cc_register(context, &krb5_scc_ops, TRUE);
262#endif
263#ifdef HAVE_KCM
264#ifdef KCM_IS_API_CACHE
265    krb5_cc_register(context, &krb5_akcm_ops, TRUE);
266#endif
267    krb5_cc_register(context, &krb5_kcm_ops, TRUE);
268#endif
269    _krb5_load_ccache_plugins(context);
270    return 0;
271}
272
273static krb5_error_code
274cc_ops_copy(krb5_context context, const krb5_context src_context)
275{
276    const krb5_cc_ops **cc_ops;
277
278    context->cc_ops = NULL;
279    context->num_cc_ops = 0;
280
281    if (src_context->num_cc_ops == 0)
282	return 0;
283
284    cc_ops = malloc(sizeof(cc_ops[0]) * src_context->num_cc_ops);
285    if (cc_ops == NULL) {
286	krb5_set_error_message(context, KRB5_CC_NOMEM,
287			       N_("malloc: out of memory", ""));
288	return KRB5_CC_NOMEM;
289    }
290
291    memcpy(rk_UNCONST(cc_ops), src_context->cc_ops,
292	   sizeof(cc_ops[0]) * src_context->num_cc_ops);
293    context->cc_ops = cc_ops;
294    context->num_cc_ops = src_context->num_cc_ops;
295
296    return 0;
297}
298
299static krb5_error_code
300kt_ops_register(krb5_context context)
301{
302    context->num_kt_types = 0;
303    context->kt_types     = NULL;
304
305    krb5_kt_register (context, &krb5_fkt_ops);
306    krb5_kt_register (context, &krb5_wrfkt_ops);
307    krb5_kt_register (context, &krb5_javakt_ops);
308    krb5_kt_register (context, &krb5_mkt_ops);
309#ifndef HEIMDAL_SMALLER
310    krb5_kt_register (context, &krb5_akf_ops);
311#endif
312    krb5_kt_register (context, &krb5_any_ops);
313    return 0;
314}
315
316static krb5_error_code
317kt_ops_copy(krb5_context context, const krb5_context src_context)
318{
319    context->num_kt_types = 0;
320    context->kt_types     = NULL;
321
322    if (src_context->num_kt_types == 0)
323	return 0;
324
325    context->kt_types = malloc(sizeof(context->kt_types[0]) * src_context->num_kt_types);
326    if (context->kt_types == NULL) {
327	krb5_set_error_message(context, ENOMEM,
328			       N_("malloc: out of memory", ""));
329	return ENOMEM;
330    }
331
332    context->num_kt_types = src_context->num_kt_types;
333    memcpy(context->kt_types, src_context->kt_types,
334	   sizeof(context->kt_types[0]) * src_context->num_kt_types);
335
336    return 0;
337}
338
339static const char *sysplugin_dirs[] =  {
340    LIBDIR "/plugin/krb5",
341#ifdef __APPLE__
342    "/Library/KerberosPlugins/KerberosFrameworkPlugins",
343    "/System/Library/KerberosPlugins/KerberosFrameworkPlugins",
344#endif
345    NULL
346};
347
348static void
349init_context_once(void *ctx)
350{
351    krb5_context context = ctx;
352
353    _krb5_load_plugins(context, "krb5", sysplugin_dirs);
354
355    bindtextdomain(HEIMDAL_TEXTDOMAIN, HEIMDAL_LOCALEDIR);
356}
357
358
359/**
360 * Initializes the context structure and reads the configuration file
361 * /etc/krb5.conf. The structure should be freed by calling
362 * krb5_free_context() when it is no longer being used.
363 *
364 * @param context pointer to returned context
365 *
366 * @return Returns 0 to indicate success.  Otherwise an errno code is
367 * returned.  Failure means either that something bad happened during
368 * initialization (typically ENOMEM) or that Kerberos should not be
369 * used ENXIO.
370 *
371 * @ingroup krb5
372 */
373
374KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
375krb5_init_context(krb5_context *context)
376{
377    static heim_base_once_t init_context = HEIM_BASE_ONCE_INIT;
378    krb5_context p;
379    krb5_error_code ret;
380    char **files;
381
382    *context = NULL;
383
384    p = calloc(1, sizeof(*p));
385    if(!p)
386	return ENOMEM;
387
388    p->mutex = malloc(sizeof(HEIMDAL_MUTEX));
389    if (p->mutex == NULL) {
390	free(p);
391	return ENOMEM;
392    }
393    HEIMDAL_MUTEX_init(p->mutex);
394
395    p->flags |= KRB5_CTX_F_HOMEDIR_ACCESS;
396
397    ret = krb5_get_default_config_files(&files);
398    if(ret)
399	goto out;
400    ret = krb5_set_config_files(p, files);
401    krb5_free_config_files(files);
402    if(ret)
403	goto out;
404
405    /* init error tables */
406    krb5_init_ets(p);
407    cc_ops_register(p);
408    kt_ops_register(p);
409
410#ifdef PKINIT
411    ret = hx509_context_init(&p->hx509ctx);
412    if (ret)
413	goto out;
414#endif
415    if (rk_SOCK_INIT())
416	p->flags |= KRB5_CTX_F_SOCKETS_INITIALIZED;
417
418out:
419    if(ret) {
420	krb5_free_context(p);
421	p = NULL;
422    } else {
423	heim_base_once_f(&init_context, p, init_context_once);
424    }
425    *context = p;
426    return ret;
427}
428
429#ifndef HEIMDAL_SMALLER
430
431KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
432krb5_get_permitted_enctypes(krb5_context context,
433			    krb5_enctype **etypes)
434{
435    return krb5_get_default_in_tkt_etypes(context, KRB5_PDU_NONE, etypes);
436}
437
438/*
439 *
440 */
441
442static krb5_error_code
443copy_etypes (krb5_context context,
444	     krb5_enctype *enctypes,
445	     krb5_enctype **ret_enctypes)
446{
447    unsigned int i;
448
449    for (i = 0; enctypes[i]; i++)
450	;
451    i++;
452
453    *ret_enctypes = malloc(sizeof(ret_enctypes[0]) * i);
454    if (*ret_enctypes == NULL) {
455	krb5_set_error_message(context, ENOMEM,
456			       N_("malloc: out of memory", ""));
457	return ENOMEM;
458    }
459    memcpy(*ret_enctypes, enctypes, sizeof(ret_enctypes[0]) * i);
460    return 0;
461}
462
463/**
464 * Make a copy for the Kerberos 5 context, the new krb5_context shoud
465 * be freed with krb5_free_context().
466 *
467 * @param context the Kerberos context to copy
468 * @param out the copy of the Kerberos, set to NULL error.
469 *
470 * @return Returns 0 to indicate success.  Otherwise an kerberos et
471 * error code is returned, see krb5_get_error_message().
472 *
473 * @ingroup krb5
474 */
475
476KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
477krb5_copy_context(krb5_context context, krb5_context *out)
478{
479    krb5_error_code ret;
480    krb5_context p;
481
482    *out = NULL;
483
484    p = calloc(1, sizeof(*p));
485    if (p == NULL) {
486	krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
487	return ENOMEM;
488    }
489
490    p->mutex = malloc(sizeof(HEIMDAL_MUTEX));
491    if (p->mutex == NULL) {
492	krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
493	free(p);
494	return ENOMEM;
495    }
496    HEIMDAL_MUTEX_init(p->mutex);
497
498
499    if (context->default_cc_name)
500	p->default_cc_name = strdup(context->default_cc_name);
501    if (context->default_cc_name_env)
502	p->default_cc_name_env = strdup(context->default_cc_name_env);
503
504    if (context->etypes) {
505	ret = copy_etypes(context, context->etypes, &p->etypes);
506	if (ret)
507	    goto out;
508    }
509    if (context->etypes_des) {
510	ret = copy_etypes(context, context->etypes_des, &p->etypes_des);
511	if (ret)
512	    goto out;
513    }
514
515    if (context->default_realms) {
516	ret = krb5_copy_host_realm(context,
517				   context->default_realms, &p->default_realms);
518	if (ret)
519	    goto out;
520    }
521
522    ret = _krb5_config_copy(context, context->cf, &p->cf);
523    if (ret)
524	goto out;
525
526    /* XXX should copy */
527    krb5_init_ets(p);
528
529    cc_ops_copy(p, context);
530    kt_ops_copy(p, context);
531
532#if 0 /* XXX */
533    if(context->warn_dest != NULL)
534	;
535    if(context->debug_dest != NULL)
536	;
537#endif
538
539    ret = krb5_set_extra_addresses(p, context->extra_addresses);
540    if (ret)
541	goto out;
542    ret = krb5_set_extra_addresses(p, context->ignore_addresses);
543    if (ret)
544	goto out;
545
546    ret = _krb5_copy_send_to_kdc_func(p, context);
547    if (ret)
548	goto out;
549
550    *out = p;
551
552    return 0;
553
554 out:
555    krb5_free_context(p);
556    return ret;
557}
558
559#endif
560
561/**
562 * Frees the krb5_context allocated by krb5_init_context().
563 *
564 * @param context context to be freed.
565 *
566 * @ingroup krb5
567 */
568
569KRB5_LIB_FUNCTION void KRB5_LIB_CALL
570krb5_free_context(krb5_context context)
571{
572    if (context->default_cc_name)
573	free(context->default_cc_name);
574    if (context->default_cc_name_env)
575	free(context->default_cc_name_env);
576    free(context->etypes);
577    free(context->etypes_des);
578    krb5_free_host_realm (context, context->default_realms);
579    krb5_config_file_free (context, context->cf);
580    free_error_table (context->et_list);
581    free(rk_UNCONST(context->cc_ops));
582    free(context->kt_types);
583    krb5_clear_error_message(context);
584    if(context->warn_dest != NULL)
585	krb5_closelog(context, context->warn_dest);
586    if(context->debug_dest != NULL)
587	krb5_closelog(context, context->debug_dest);
588    krb5_set_extra_addresses(context, NULL);
589    krb5_set_ignore_addresses(context, NULL);
590    krb5_set_send_to_kdc_func(context, NULL, NULL);
591
592#ifdef PKINIT
593    if (context->hx509ctx)
594	hx509_context_free(&context->hx509ctx);
595#endif
596
597    HEIMDAL_MUTEX_destroy(context->mutex);
598    free(context->mutex);
599    if (context->flags & KRB5_CTX_F_SOCKETS_INITIALIZED) {
600 	rk_SOCK_EXIT();
601    }
602
603    memset(context, 0, sizeof(*context));
604    free(context);
605}
606
607/**
608 * Reinit the context from a new set of filenames.
609 *
610 * @param context context to add configuration too.
611 * @param filenames array of filenames, end of list is indicated with a NULL filename.
612 *
613 * @return Returns 0 to indicate success.  Otherwise an kerberos et
614 * error code is returned, see krb5_get_error_message().
615 *
616 * @ingroup krb5
617 */
618
619KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
620krb5_set_config_files(krb5_context context, char **filenames)
621{
622    krb5_error_code ret;
623    krb5_config_binding *tmp = NULL;
624    while(filenames != NULL && *filenames != NULL && **filenames != '\0') {
625	ret = krb5_config_parse_file_multi(context, *filenames, &tmp);
626	if(ret != 0 && ret != ENOENT && ret != EACCES && ret != EPERM) {
627	    krb5_config_file_free(context, tmp);
628	    return ret;
629	}
630	filenames++;
631    }
632#if 0
633    /* with this enabled and if there are no config files, Kerberos is
634       considererd disabled */
635    if(tmp == NULL)
636	return ENXIO;
637#endif
638
639#ifdef _WIN32
640    _krb5_load_config_from_registry(context, &tmp);
641#endif
642
643    krb5_config_file_free(context, context->cf);
644    context->cf = tmp;
645    ret = init_context_from_config_file(context);
646    return ret;
647}
648
649static krb5_error_code
650add_file(char ***pfilenames, int *len, char *file)
651{
652    char **pp = *pfilenames;
653    int i;
654
655    for(i = 0; i < *len; i++) {
656	if(strcmp(pp[i], file) == 0) {
657	    free(file);
658	    return 0;
659	}
660    }
661
662    pp = realloc(*pfilenames, (*len + 2) * sizeof(*pp));
663    if (pp == NULL) {
664	free(file);
665	return ENOMEM;
666    }
667
668    pp[*len] = file;
669    pp[*len + 1] = NULL;
670    *pfilenames = pp;
671    *len += 1;
672    return 0;
673}
674
675/*
676 *  `pq' isn't free, it's up the the caller
677 */
678
679KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
680krb5_prepend_config_files(const char *filelist, char **pq, char ***ret_pp)
681{
682    krb5_error_code ret;
683    const char *p, *q;
684    char **pp;
685    int len;
686    char *fn;
687
688    pp = NULL;
689
690    len = 0;
691    p = filelist;
692    while(1) {
693	ssize_t l;
694	q = p;
695	l = strsep_copy(&q, PATH_SEP, NULL, 0);
696	if(l == -1)
697	    break;
698	fn = malloc(l + 1);
699	if(fn == NULL) {
700	    krb5_free_config_files(pp);
701	    return ENOMEM;
702	}
703	(void)strsep_copy(&p, PATH_SEP, fn, l + 1);
704	ret = add_file(&pp, &len, fn);
705	if (ret) {
706	    krb5_free_config_files(pp);
707	    return ret;
708	}
709    }
710
711    if (pq != NULL) {
712	int i;
713
714	for (i = 0; pq[i] != NULL; i++) {
715	    fn = strdup(pq[i]);
716	    if (fn == NULL) {
717		krb5_free_config_files(pp);
718		return ENOMEM;
719	    }
720	    ret = add_file(&pp, &len, fn);
721	    if (ret) {
722		krb5_free_config_files(pp);
723		return ret;
724	    }
725	}
726    }
727
728    *ret_pp = pp;
729    return 0;
730}
731
732/**
733 * Prepend the filename to the global configuration list.
734 *
735 * @param filelist a filename to add to the default list of filename
736 * @param pfilenames return array of filenames, should be freed with krb5_free_config_files().
737 *
738 * @return Returns 0 to indicate success.  Otherwise an kerberos et
739 * error code is returned, see krb5_get_error_message().
740 *
741 * @ingroup krb5
742 */
743
744KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
745krb5_prepend_config_files_default(const char *filelist, char ***pfilenames)
746{
747    krb5_error_code ret;
748    char **defpp, **pp = NULL;
749
750    ret = krb5_get_default_config_files(&defpp);
751    if (ret)
752	return ret;
753
754    ret = krb5_prepend_config_files(filelist, defpp, &pp);
755    krb5_free_config_files(defpp);
756    if (ret) {
757	return ret;
758    }
759    *pfilenames = pp;
760    return 0;
761}
762
763#ifdef _WIN32
764
765/**
766 * Checks the registry for configuration file location
767 *
768 * Kerberos for Windows and other legacy Kerberos applications expect
769 * to find the configuration file location in the
770 * SOFTWARE\MIT\Kerberos registry key under the value "config".
771 */
772char *
773_krb5_get_default_config_config_files_from_registry()
774{
775    static const char * KeyName = "Software\\MIT\\Kerberos";
776    char *config_file = NULL;
777    LONG rcode;
778    HKEY key;
779
780    rcode = RegOpenKeyEx(HKEY_CURRENT_USER, KeyName, 0, KEY_READ, &key);
781    if (rcode == ERROR_SUCCESS) {
782        config_file = _krb5_parse_reg_value_as_multi_string(NULL, key, "config",
783                                                            REG_NONE, 0, PATH_SEP);
784        RegCloseKey(key);
785    }
786
787    if (config_file)
788        return config_file;
789
790    rcode = RegOpenKeyEx(HKEY_LOCAL_MACHINE, KeyName, 0, KEY_READ, &key);
791    if (rcode == ERROR_SUCCESS) {
792        config_file = _krb5_parse_reg_value_as_multi_string(NULL, key, "config",
793                                                            REG_NONE, 0, PATH_SEP);
794        RegCloseKey(key);
795    }
796
797    return config_file;
798}
799
800#endif
801
802/**
803 * Get the global configuration list.
804 *
805 * @param pfilenames return array of filenames, should be freed with krb5_free_config_files().
806 *
807 * @return Returns 0 to indicate success.  Otherwise an kerberos et
808 * error code is returned, see krb5_get_error_message().
809 *
810 * @ingroup krb5
811 */
812
813KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
814krb5_get_default_config_files(char ***pfilenames)
815{
816    const char *files = NULL;
817
818    if (pfilenames == NULL)
819        return EINVAL;
820    if(!issuid())
821	files = getenv("KRB5_CONFIG");
822
823#ifdef _WIN32
824    if (files == NULL) {
825        char * reg_files;
826        reg_files = _krb5_get_default_config_config_files_from_registry();
827        if (reg_files != NULL) {
828            krb5_error_code code;
829
830            code = krb5_prepend_config_files(reg_files, NULL, pfilenames);
831            free(reg_files);
832
833            return code;
834        }
835    }
836#endif
837
838    if (files == NULL)
839	files = krb5_config_file;
840
841    return krb5_prepend_config_files(files, NULL, pfilenames);
842}
843
844/**
845 * Free a list of configuration files.
846 *
847 * @param filenames list, terminated with a NULL pointer, to be
848 * freed. NULL is an valid argument.
849 *
850 * @return Returns 0 to indicate success. Otherwise an kerberos et
851 * error code is returned, see krb5_get_error_message().
852 *
853 * @ingroup krb5
854 */
855
856KRB5_LIB_FUNCTION void KRB5_LIB_CALL
857krb5_free_config_files(char **filenames)
858{
859    char **p;
860    for(p = filenames; p && *p != NULL; p++)
861	free(*p);
862    free(filenames);
863}
864
865/**
866 * Returns the list of Kerberos encryption types sorted in order of
867 * most preferred to least preferred encryption type.  Note that some
868 * encryption types might be disabled, so you need to check with
869 * krb5_enctype_valid() before using the encryption type.
870 *
871 * @return list of enctypes, terminated with ETYPE_NULL. Its a static
872 * array completed into the Kerberos library so the content doesn't
873 * need to be freed.
874 *
875 * @ingroup krb5
876 */
877
878KRB5_LIB_FUNCTION const krb5_enctype * KRB5_LIB_CALL
879krb5_kerberos_enctypes(krb5_context context)
880{
881    static const krb5_enctype p[] = {
882	ETYPE_AES256_CTS_HMAC_SHA1_96,
883	ETYPE_AES128_CTS_HMAC_SHA1_96,
884	ETYPE_DES3_CBC_SHA1,
885	ETYPE_DES3_CBC_MD5,
886	ETYPE_ARCFOUR_HMAC_MD5,
887	ETYPE_DES_CBC_MD5,
888	ETYPE_DES_CBC_MD4,
889	ETYPE_DES_CBC_CRC,
890	ETYPE_NULL
891    };
892    return p;
893}
894
895/*
896 *
897 */
898
899static krb5_error_code
900copy_enctypes(krb5_context context,
901	      const krb5_enctype *in,
902	      krb5_enctype **out)
903{
904    krb5_enctype *p = NULL;
905    size_t m, n;
906
907    for (n = 0; in[n]; n++)
908	;
909    n++;
910    ALLOC(p, n);
911    if(p == NULL)
912	return krb5_enomem(context);
913    for (n = 0, m = 0; in[n]; n++) {
914	if (krb5_enctype_valid(context, in[n]) != 0)
915	    continue;
916	p[m++] = in[n];
917    }
918    p[m] = KRB5_ENCTYPE_NULL;
919    if (m == 0) {
920	free(p);
921	krb5_set_error_message (context, KRB5_PROG_ETYPE_NOSUPP,
922				N_("no valid enctype set", ""));
923	return KRB5_PROG_ETYPE_NOSUPP;
924    }
925    *out = p;
926    return 0;
927}
928
929
930/*
931 * set `etype' to a malloced list of the default enctypes
932 */
933
934static krb5_error_code
935default_etypes(krb5_context context, krb5_enctype **etype)
936{
937    const krb5_enctype *p = krb5_kerberos_enctypes(context);
938    return copy_enctypes(context, p, etype);
939}
940
941/**
942 * Set the default encryption types that will be use in communcation
943 * with the KDC, clients and servers.
944 *
945 * @param context Kerberos 5 context.
946 * @param etypes Encryption types, array terminated with ETYPE_NULL (0).
947 *
948 * @return Returns 0 to indicate success. Otherwise an kerberos et
949 * error code is returned, see krb5_get_error_message().
950 *
951 * @ingroup krb5
952 */
953
954KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
955krb5_set_default_in_tkt_etypes(krb5_context context,
956			       const krb5_enctype *etypes)
957{
958    krb5_error_code ret;
959    krb5_enctype *p = NULL;
960
961    if(etypes) {
962	ret = copy_enctypes(context, etypes, &p);
963	if (ret)
964	    return ret;
965    }
966    if(context->etypes)
967	free(context->etypes);
968    context->etypes = p;
969    return 0;
970}
971
972/**
973 * Get the default encryption types that will be use in communcation
974 * with the KDC, clients and servers.
975 *
976 * @param context Kerberos 5 context.
977 * @param etypes Encryption types, array terminated with
978 * ETYPE_NULL(0), caller should free array with krb5_xfree():
979 *
980 * @return Returns 0 to indicate success. Otherwise an kerberos et
981 * error code is returned, see krb5_get_error_message().
982 *
983 * @ingroup krb5
984 */
985
986KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
987krb5_get_default_in_tkt_etypes(krb5_context context,
988			       krb5_pdu pdu_type,
989			       krb5_enctype **etypes)
990{
991    krb5_enctype *enctypes = NULL;
992    krb5_error_code ret;
993    krb5_enctype *p;
994
995    heim_assert(pdu_type == KRB5_PDU_AS_REQUEST ||
996		pdu_type == KRB5_PDU_TGS_REQUEST ||
997		pdu_type == KRB5_PDU_NONE, "pdu contant not as expected");
998
999    if (pdu_type == KRB5_PDU_AS_REQUEST && context->as_etypes != NULL)
1000	enctypes = context->as_etypes;
1001    else if (pdu_type == KRB5_PDU_TGS_REQUEST && context->tgs_etypes != NULL)
1002	enctypes = context->tgs_etypes;
1003    else if (context->etypes != NULL)
1004	enctypes = context->etypes;
1005
1006    if (enctypes != NULL) {
1007	ret = copy_enctypes(context, enctypes, &p);
1008	if (ret)
1009	    return ret;
1010    } else {
1011	ret = default_etypes(context, &p);
1012	if (ret)
1013	    return ret;
1014    }
1015    *etypes = p;
1016    return 0;
1017}
1018
1019/**
1020 * Init the built-in ets in the Kerberos library.
1021 *
1022 * @param context kerberos context to add the ets too
1023 *
1024 * @ingroup krb5
1025 */
1026
1027KRB5_LIB_FUNCTION void KRB5_LIB_CALL
1028krb5_init_ets(krb5_context context)
1029{
1030    if(context->et_list == NULL){
1031	krb5_add_et_list(context, initialize_krb5_error_table_r);
1032	krb5_add_et_list(context, initialize_asn1_error_table_r);
1033	krb5_add_et_list(context, initialize_heim_error_table_r);
1034
1035	krb5_add_et_list(context, initialize_k524_error_table_r);
1036
1037#ifdef COM_ERR_BINDDOMAIN_krb5
1038	bindtextdomain(COM_ERR_BINDDOMAIN_krb5, HEIMDAL_LOCALEDIR);
1039	bindtextdomain(COM_ERR_BINDDOMAIN_asn1, HEIMDAL_LOCALEDIR);
1040	bindtextdomain(COM_ERR_BINDDOMAIN_heim, HEIMDAL_LOCALEDIR);
1041	bindtextdomain(COM_ERR_BINDDOMAIN_k524, HEIMDAL_LOCALEDIR);
1042#endif
1043
1044#ifdef PKINIT
1045	krb5_add_et_list(context, initialize_hx_error_table_r);
1046#ifdef COM_ERR_BINDDOMAIN_hx
1047	bindtextdomain(COM_ERR_BINDDOMAIN_hx, HEIMDAL_LOCALEDIR);
1048#endif
1049#endif
1050    }
1051}
1052
1053/**
1054 * Make the kerberos library default to the admin KDC.
1055 *
1056 * @param context Kerberos 5 context.
1057 * @param flag boolean flag to select if the use the admin KDC or not.
1058 *
1059 * @ingroup krb5
1060 */
1061
1062KRB5_LIB_FUNCTION void KRB5_LIB_CALL
1063krb5_set_use_admin_kdc (krb5_context context, krb5_boolean flag)
1064{
1065    context->use_admin_kdc = flag;
1066}
1067
1068/**
1069 * Make the kerberos library default to the admin KDC.
1070 *
1071 * @param context Kerberos 5 context.
1072 *
1073 * @return boolean flag to telling the context will use admin KDC as the default KDC.
1074 *
1075 * @ingroup krb5
1076 */
1077
1078KRB5_LIB_FUNCTION krb5_boolean KRB5_LIB_CALL
1079krb5_get_use_admin_kdc (krb5_context context)
1080{
1081    return context->use_admin_kdc;
1082}
1083
1084/**
1085 * Add extra address to the address list that the library will add to
1086 * the client's address list when communicating with the KDC.
1087 *
1088 * @param context Kerberos 5 context.
1089 * @param addresses addreses to add
1090 *
1091 * @return Returns 0 to indicate success. Otherwise an kerberos et
1092 * error code is returned, see krb5_get_error_message().
1093 *
1094 * @ingroup krb5
1095 */
1096
1097KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1098krb5_add_extra_addresses(krb5_context context, krb5_addresses *addresses)
1099{
1100
1101    if(context->extra_addresses)
1102	return krb5_append_addresses(context,
1103				     context->extra_addresses, addresses);
1104    else
1105	return krb5_set_extra_addresses(context, addresses);
1106}
1107
1108/**
1109 * Set extra address to the address list that the library will add to
1110 * the client's address list when communicating with the KDC.
1111 *
1112 * @param context Kerberos 5 context.
1113 * @param addresses addreses to set
1114 *
1115 * @return Returns 0 to indicate success. Otherwise an kerberos et
1116 * error code is returned, see krb5_get_error_message().
1117 *
1118 * @ingroup krb5
1119 */
1120
1121KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1122krb5_set_extra_addresses(krb5_context context, const krb5_addresses *addresses)
1123{
1124    if(context->extra_addresses)
1125	krb5_free_addresses(context, context->extra_addresses);
1126
1127    if(addresses == NULL) {
1128	if(context->extra_addresses != NULL) {
1129	    free(context->extra_addresses);
1130	    context->extra_addresses = NULL;
1131	}
1132	return 0;
1133    }
1134    if(context->extra_addresses == NULL) {
1135	context->extra_addresses = malloc(sizeof(*context->extra_addresses));
1136	if(context->extra_addresses == NULL) {
1137	    krb5_set_error_message (context, ENOMEM, N_("malloc: out of memory", ""));
1138	    return ENOMEM;
1139	}
1140    }
1141    return krb5_copy_addresses(context, addresses, context->extra_addresses);
1142}
1143
1144/**
1145 * Get extra address to the address list that the library will add to
1146 * the client's address list when communicating with the KDC.
1147 *
1148 * @param context Kerberos 5 context.
1149 * @param addresses addreses to set
1150 *
1151 * @return Returns 0 to indicate success. Otherwise an kerberos et
1152 * error code is returned, see krb5_get_error_message().
1153 *
1154 * @ingroup krb5
1155 */
1156
1157KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1158krb5_get_extra_addresses(krb5_context context, krb5_addresses *addresses)
1159{
1160    if(context->extra_addresses == NULL) {
1161	memset(addresses, 0, sizeof(*addresses));
1162	return 0;
1163    }
1164    return krb5_copy_addresses(context,context->extra_addresses, addresses);
1165}
1166
1167/**
1168 * Add extra addresses to ignore when fetching addresses from the
1169 * underlaying operating system.
1170 *
1171 * @param context Kerberos 5 context.
1172 * @param addresses addreses to ignore
1173 *
1174 * @return Returns 0 to indicate success. Otherwise an kerberos et
1175 * error code is returned, see krb5_get_error_message().
1176 *
1177 * @ingroup krb5
1178 */
1179
1180KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1181krb5_add_ignore_addresses(krb5_context context, krb5_addresses *addresses)
1182{
1183
1184    if(context->ignore_addresses)
1185	return krb5_append_addresses(context,
1186				     context->ignore_addresses, addresses);
1187    else
1188	return krb5_set_ignore_addresses(context, addresses);
1189}
1190
1191/**
1192 * Set extra addresses to ignore when fetching addresses from the
1193 * underlaying operating system.
1194 *
1195 * @param context Kerberos 5 context.
1196 * @param addresses addreses to ignore
1197 *
1198 * @return Returns 0 to indicate success. Otherwise an kerberos et
1199 * error code is returned, see krb5_get_error_message().
1200 *
1201 * @ingroup krb5
1202 */
1203
1204KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1205krb5_set_ignore_addresses(krb5_context context, const krb5_addresses *addresses)
1206{
1207    if(context->ignore_addresses)
1208	krb5_free_addresses(context, context->ignore_addresses);
1209    if(addresses == NULL) {
1210	if(context->ignore_addresses != NULL) {
1211	    free(context->ignore_addresses);
1212	    context->ignore_addresses = NULL;
1213	}
1214	return 0;
1215    }
1216    if(context->ignore_addresses == NULL) {
1217	context->ignore_addresses = malloc(sizeof(*context->ignore_addresses));
1218	if(context->ignore_addresses == NULL) {
1219	    krb5_set_error_message (context, ENOMEM, N_("malloc: out of memory", ""));
1220	    return ENOMEM;
1221	}
1222    }
1223    return krb5_copy_addresses(context, addresses, context->ignore_addresses);
1224}
1225
1226/**
1227 * Get extra addresses to ignore when fetching addresses from the
1228 * underlaying operating system.
1229 *
1230 * @param context Kerberos 5 context.
1231 * @param addresses list addreses ignored
1232 *
1233 * @return Returns 0 to indicate success. Otherwise an kerberos et
1234 * error code is returned, see krb5_get_error_message().
1235 *
1236 * @ingroup krb5
1237 */
1238
1239KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1240krb5_get_ignore_addresses(krb5_context context, krb5_addresses *addresses)
1241{
1242    if(context->ignore_addresses == NULL) {
1243	memset(addresses, 0, sizeof(*addresses));
1244	return 0;
1245    }
1246    return krb5_copy_addresses(context, context->ignore_addresses, addresses);
1247}
1248
1249/**
1250 * Set version of fcache that the library should use.
1251 *
1252 * @param context Kerberos 5 context.
1253 * @param version version number.
1254 *
1255 * @return Returns 0 to indicate success. Otherwise an kerberos et
1256 * error code is returned, see krb5_get_error_message().
1257 *
1258 * @ingroup krb5
1259 */
1260
1261KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1262krb5_set_fcache_version(krb5_context context, int version)
1263{
1264    context->fcache_vno = version;
1265    return 0;
1266}
1267
1268/**
1269 * Get version of fcache that the library should use.
1270 *
1271 * @param context Kerberos 5 context.
1272 * @param version version number.
1273 *
1274 * @return Returns 0 to indicate success. Otherwise an kerberos et
1275 * error code is returned, see krb5_get_error_message().
1276 *
1277 * @ingroup krb5
1278 */
1279
1280KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1281krb5_get_fcache_version(krb5_context context, int *version)
1282{
1283    *version = context->fcache_vno;
1284    return 0;
1285}
1286
1287/**
1288 * Runtime check if the Kerberos library was complied with thread support.
1289 *
1290 * @return TRUE if the library was compiled with thread support, FALSE if not.
1291 *
1292 * @ingroup krb5
1293 */
1294
1295
1296KRB5_LIB_FUNCTION krb5_boolean KRB5_LIB_CALL
1297krb5_is_thread_safe(void)
1298{
1299#ifdef ENABLE_PTHREAD_SUPPORT
1300    return TRUE;
1301#else
1302    return FALSE;
1303#endif
1304}
1305
1306/**
1307 * Set if the library should use DNS to canonicalize hostnames.
1308 *
1309 * @param context Kerberos 5 context.
1310 * @param flag if its dns canonicalizion is used or not.
1311 *
1312 * @ingroup krb5
1313 */
1314
1315KRB5_LIB_FUNCTION void KRB5_LIB_CALL
1316krb5_set_dns_canonicalize_hostname (krb5_context context, krb5_boolean flag)
1317{
1318    if (flag)
1319	context->flags |= KRB5_CTX_F_DNS_CANONICALIZE_HOSTNAME;
1320    else
1321	context->flags &= ~KRB5_CTX_F_DNS_CANONICALIZE_HOSTNAME;
1322}
1323
1324/**
1325 * Get if the library uses DNS to canonicalize hostnames.
1326 *
1327 * @param context Kerberos 5 context.
1328 *
1329 * @return return non zero if the library uses DNS to canonicalize hostnames.
1330 *
1331 * @ingroup krb5
1332 */
1333
1334KRB5_LIB_FUNCTION krb5_boolean KRB5_LIB_CALL
1335krb5_get_dns_canonicalize_hostname (krb5_context context)
1336{
1337    return (context->flags & KRB5_CTX_F_DNS_CANONICALIZE_HOSTNAME) ? 1 : 0;
1338}
1339
1340/**
1341 * Get current offset in time to the KDC.
1342 *
1343 * @param context Kerberos 5 context.
1344 * @param sec seconds part of offset.
1345 * @param usec micro seconds part of offset.
1346 *
1347 * @return returns zero
1348 *
1349 * @ingroup krb5
1350 */
1351
1352KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1353krb5_get_kdc_sec_offset (krb5_context context, int32_t *sec, int32_t *usec)
1354{
1355    if (sec)
1356	*sec = context->kdc_sec_offset;
1357    if (usec)
1358	*usec = context->kdc_usec_offset;
1359    return 0;
1360}
1361
1362/**
1363 * Set current offset in time to the KDC.
1364 *
1365 * @param context Kerberos 5 context.
1366 * @param sec seconds part of offset.
1367 * @param usec micro seconds part of offset.
1368 *
1369 * @return returns zero
1370 *
1371 * @ingroup krb5
1372 */
1373
1374KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1375krb5_set_kdc_sec_offset (krb5_context context, int32_t sec, int32_t usec)
1376{
1377    context->kdc_sec_offset = sec;
1378    if (usec >= 0)
1379	context->kdc_usec_offset = usec;
1380    return 0;
1381}
1382
1383/**
1384 * Get max time skew allowed.
1385 *
1386 * @param context Kerberos 5 context.
1387 *
1388 * @return timeskew in seconds.
1389 *
1390 * @ingroup krb5
1391 */
1392
1393KRB5_LIB_FUNCTION time_t KRB5_LIB_CALL
1394krb5_get_max_time_skew (krb5_context context)
1395{
1396    return context->max_skew;
1397}
1398
1399/**
1400 * Set max time skew allowed.
1401 *
1402 * @param context Kerberos 5 context.
1403 * @param t timeskew in seconds.
1404 *
1405 * @ingroup krb5
1406 */
1407
1408KRB5_LIB_FUNCTION void KRB5_LIB_CALL
1409krb5_set_max_time_skew (krb5_context context, time_t t)
1410{
1411    context->max_skew = t;
1412}
1413
1414/*
1415 * Init encryption types in len, val with etypes.
1416 *
1417 * @param context Kerberos 5 context.
1418 * @param pdu_type type of pdu
1419 * @param len output length of val.
1420 * @param val output array of enctypes.
1421 * @param etypes etypes to set val and len to, if NULL, use default enctypes.
1422
1423 * @return Returns 0 to indicate success. Otherwise an kerberos et
1424 * error code is returned, see krb5_get_error_message().
1425 *
1426 * @ingroup krb5
1427 */
1428
1429KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1430_krb5_init_etype(krb5_context context,
1431		 krb5_pdu pdu_type,
1432		 unsigned *len,
1433		 krb5_enctype **val,
1434		 const krb5_enctype *etypes)
1435{
1436    krb5_error_code ret;
1437
1438    if (etypes == NULL)
1439	ret = krb5_get_default_in_tkt_etypes(context, pdu_type, val);
1440    else
1441	ret = copy_enctypes(context, etypes, val);
1442    if (ret)
1443	return ret;
1444
1445    if (len) {
1446	*len = 0;
1447	while ((*val)[*len] != KRB5_ENCTYPE_NULL)
1448	    (*len)++;
1449    }
1450    return 0;
1451}
1452
1453/*
1454 * Allow homedir accces
1455 */
1456
1457static HEIMDAL_MUTEX homedir_mutex = HEIMDAL_MUTEX_INITIALIZER;
1458static krb5_boolean allow_homedir = TRUE;
1459
1460krb5_boolean
1461_krb5_homedir_access(krb5_context context)
1462{
1463    krb5_boolean allow;
1464
1465#ifdef HAVE_GETEUID
1466    /* is never allowed for root */
1467    if (geteuid() == 0)
1468	return FALSE;
1469#endif
1470
1471    if (context && (context->flags & KRB5_CTX_F_HOMEDIR_ACCESS) == 0)
1472	return FALSE;
1473
1474    HEIMDAL_MUTEX_lock(&homedir_mutex);
1475    allow = allow_homedir;
1476    HEIMDAL_MUTEX_unlock(&homedir_mutex);
1477    return allow;
1478}
1479
1480/**
1481 * Enable and disable home directory access on either the global state
1482 * or the krb5_context state. By calling krb5_set_home_dir_access()
1483 * with context set to NULL, the global state is configured otherwise
1484 * the state for the krb5_context is modified.
1485 *
1486 * For home directory access to be allowed, both the global state and
1487 * the krb5_context state have to be allowed.
1488 *
1489 * Administrator (root user), never uses the home directory.
1490 *
1491 * @param context a Kerberos 5 context or NULL
1492 * @param allow allow if TRUE home directory
1493 * @return the old value
1494 *
1495 * @ingroup krb5
1496 */
1497
1498KRB5_LIB_FUNCTION krb5_boolean KRB5_LIB_CALL
1499krb5_set_home_dir_access(krb5_context context, krb5_boolean allow)
1500{
1501    krb5_boolean old;
1502    if (context) {
1503	old = (context->flags & KRB5_CTX_F_HOMEDIR_ACCESS) ? TRUE : FALSE;
1504	if (allow)
1505	    context->flags |= KRB5_CTX_F_HOMEDIR_ACCESS;
1506	else
1507	    context->flags &= ~KRB5_CTX_F_HOMEDIR_ACCESS;
1508    } else {
1509	HEIMDAL_MUTEX_lock(&homedir_mutex);
1510	old = allow_homedir;
1511	allow_homedir = allow;
1512	HEIMDAL_MUTEX_unlock(&homedir_mutex);
1513    }
1514
1515    return old;
1516}
1517