1 /* $Id: log.h,v 1.1 2003/06/04 00:25:38 marka Exp $ */ 2 /* 3 * Copyright (c) 2000 Japan Network Information Center. All rights reserved. 4 * 5 * By using this file, you agree to the terms and conditions set forth bellow. 6 * 7 * LICENSE TERMS AND CONDITIONS 8 * 9 * The following License Terms and Conditions apply, unless a different 10 * license is obtained from Japan Network Information Center ("JPNIC"), 11 * a Japanese association, Kokusai-Kougyou-Kanda Bldg 6F, 2-3-4 Uchi-Kanda, 12 * Chiyoda-ku, Tokyo 101-0047, Japan. 13 * 14 * 1. Use, Modification and Redistribution (including distribution of any 15 * modified or derived work) in source and/or binary forms is permitted 16 * under this License Terms and Conditions. 17 * 18 * 2. Redistribution of source code must retain the copyright notices as they 19 * appear in each source code file, this License Terms and Conditions. 20 * 21 * 3. Redistribution in binary form must reproduce the Copyright Notice, 22 * this License Terms and Conditions, in the documentation and/or other 23 * materials provided with the distribution. For the purposes of binary 24 * distribution the "Copyright Notice" refers to the following language: 25 * "Copyright (c) 2000-2002 Japan Network Information Center. All rights reserved." 26 * 27 * 4. The name of JPNIC may not be used to endorse or promote products 28 * derived from this Software without specific prior written approval of 29 * JPNIC. 30 * 31 * 5. Disclaimer/Limitation of Liability: THIS SOFTWARE IS PROVIDED BY JPNIC 32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 34 * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JPNIC BE LIABLE 35 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 36 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 37 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR 38 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 39 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 40 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 41 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 42 */ 43 44 #ifndef IDN_LOG_H 45 #define IDN_LOG_H 1 46 47 #ifdef __cplusplus 48 extern "C" { 49 #endif 50 51 /* 52 * libidnkit logging facility. 53 */ 54 55 #include <idn/export.h> 56 57 /* 58 * Log level definition. 59 */ 60 enum { 61 idn_log_level_fatal = 0, 62 idn_log_level_error = 1, 63 idn_log_level_warning = 2, 64 idn_log_level_info = 3, 65 idn_log_level_trace = 4, 66 idn_log_level_dump = 5 67 }; 68 69 /* 70 * Log handler type. 71 */ 72 typedef void (*idn_log_proc_t)(int level, const char *msg); 73 74 /* 75 * Log routines. 76 */ 77 IDN_EXPORT void idn_log_fatal(const char *fmt, ...); 78 IDN_EXPORT void idn_log_error(const char *fmt, ...); 79 IDN_EXPORT void idn_log_warning(const char *fmt, ...); 80 IDN_EXPORT void idn_log_info(const char *fmt, ...); 81 IDN_EXPORT void idn_log_trace(const char *fmt, ...); 82 IDN_EXPORT void idn_log_dump(const char *fmt, ...); 83 84 /* 85 * Set/get log level. 86 * 87 * If log level has not been explicitly defined by 'idn_log_setlevel', 88 * the default level is determined by the value of enrironment 89 * variable 'IDN_LOG_LEVEL'. 90 */ 91 IDN_EXPORT void idn_log_setlevel(int level); 92 IDN_EXPORT int idn_log_getlevel(void); 93 94 /* 95 * Set log handler. 96 * 97 * If no log handler is set, log goes to stderr by default. 98 * You can reset the handler to the default one by specifying 99 * NULL. 100 */ 101 IDN_EXPORT void idn_log_setproc(idn_log_proc_t proc); 102 103 #ifdef __cplusplus 104 } 105 #endif 106 107 #endif /* IDN_LOG_H */ 108