1 /* 2 * profile.h 3 * 4 * Copyright (C) 2005 by Theodore Ts'o. 5 * 6 * %Begin-Header% 7 * This file may be redistributed under the terms of the GNU Public 8 * License. 9 * %End-Header% 10 * 11 * Copyright (C) 1985-2005 by the Massachusetts Institute of Technology. 12 * 13 * All rights reserved. 14 * 15 * Export of this software from the United States of America may require 16 * a specific license from the United States Government. It is the 17 * responsibility of any person or organization contemplating export to 18 * obtain such a license before exporting. 19 * 20 * WITHIN THAT CONSTRAINT, permission to use, copy, modify, and 21 * distribute this software and its documentation for any purpose and 22 * without fee is hereby granted, provided that the above copyright 23 * notice appear in all copies and that both that copyright notice and 24 * this permission notice appear in supporting documentation, and that 25 * the name of M.I.T. not be used in advertising or publicity pertaining 26 * to distribution of the software without specific, written prior 27 * permission. Furthermore if you modify this software you must label 28 * your software as modified software and not distribute it in such a 29 * fashion that it might be confused with the original MIT software. 30 * M.I.T. makes no representations about the suitability of this software 31 * for any purpose. It is provided "as is" without express or implied 32 * warranty. 33 * 34 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR 35 * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED 36 * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. 37 */ 38 39 #ifndef _PROFILE_H 40 #define _PROFILE_H 41 42 typedef struct _profile_t *profile_t; 43 44 typedef void (*profile_syntax_err_cb_t)(const char *file, long err, 45 int line_num); 46 47 /* 48 * Used by the profile iterator in prof_get.c 49 */ 50 #define PROFILE_ITER_LIST_SECTION 0x0001 51 #define PROFILE_ITER_SECTIONS_ONLY 0x0002 52 #define PROFILE_ITER_RELATIONS_ONLY 0x0004 53 54 #ifdef __cplusplus 55 extern "C" { 56 #endif /* __cplusplus */ 57 58 long profile_init 59 (const char * const *files, profile_t *ret_profile); 60 61 void profile_release 62 (profile_t profile); 63 64 long profile_set_default 65 (profile_t profile, const char *def_string); 66 67 long profile_get_string 68 (profile_t profile, const char *name, const char *subname, 69 const char *subsubname, const char *def_val, 70 char **ret_string); 71 long profile_get_integer 72 (profile_t profile, const char *name, const char *subname, 73 const char *subsubname, int def_val, 74 int *ret_default); 75 76 long profile_get_uint 77 (profile_t profile, const char *name, const char *subname, 78 const char *subsubname, unsigned int def_val, 79 unsigned int *ret_int); 80 81 long profile_get_double 82 (profile_t profile, const char *name, const char *subname, 83 const char *subsubname, double def_val, 84 double *ret_float); 85 86 long profile_get_boolean 87 (profile_t profile, const char *name, const char *subname, 88 const char *subsubname, int def_val, 89 int *ret_default); 90 91 long profile_iterator_create 92 (profile_t profile, const char *const *names, 93 int flags, void **ret_iter); 94 95 void profile_iterator_free 96 (void **iter_p); 97 98 long profile_iterator 99 (void **iter_p, char **ret_name, char **ret_value); 100 101 profile_syntax_err_cb_t profile_set_syntax_err_cb(profile_syntax_err_cb_t hook); 102 103 #ifdef __cplusplus 104 } 105 #endif /* __cplusplus */ 106 107 #endif /* _KRB5_H */ 108