17c478bd9Sstevel@tonic-gate /* 2*9525b14bSRao Shoaib * Copyright (c) 2004 by Internet Systems Consortium, Inc. ("ISC") 37c478bd9Sstevel@tonic-gate * Copyright (c) 1996-1999 by Internet Software Consortium. 47c478bd9Sstevel@tonic-gate * 57c478bd9Sstevel@tonic-gate * Permission to use, copy, modify, and distribute this software for any 67c478bd9Sstevel@tonic-gate * purpose with or without fee is hereby granted, provided that the above 77c478bd9Sstevel@tonic-gate * copyright notice and this permission notice appear in all copies. 87c478bd9Sstevel@tonic-gate * 9*9525b14bSRao Shoaib * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES 10*9525b14bSRao Shoaib * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11*9525b14bSRao Shoaib * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR 12*9525b14bSRao Shoaib * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13*9525b14bSRao Shoaib * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14*9525b14bSRao Shoaib * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT 15*9525b14bSRao Shoaib * OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 167c478bd9Sstevel@tonic-gate */ 177c478bd9Sstevel@tonic-gate 187c478bd9Sstevel@tonic-gate #ifndef LOGGING_H 197c478bd9Sstevel@tonic-gate #define LOGGING_H 207c478bd9Sstevel@tonic-gate 217c478bd9Sstevel@tonic-gate #include <sys/types.h> 227c478bd9Sstevel@tonic-gate #include <stdio.h> 237c478bd9Sstevel@tonic-gate #include <stdarg.h> 247c478bd9Sstevel@tonic-gate #include <unistd.h> 257c478bd9Sstevel@tonic-gate 267c478bd9Sstevel@tonic-gate #define log_critical (-5) 277c478bd9Sstevel@tonic-gate #define log_error (-4) 287c478bd9Sstevel@tonic-gate #define log_warning (-3) 297c478bd9Sstevel@tonic-gate #define log_notice (-2) 307c478bd9Sstevel@tonic-gate #define log_info (-1) 317c478bd9Sstevel@tonic-gate #define log_debug(level) (level) 327c478bd9Sstevel@tonic-gate 337c478bd9Sstevel@tonic-gate typedef enum { log_syslog, log_file, log_null } log_channel_type; 347c478bd9Sstevel@tonic-gate 357c478bd9Sstevel@tonic-gate #define LOG_MAX_VERSIONS 99 367c478bd9Sstevel@tonic-gate 377c478bd9Sstevel@tonic-gate #define LOG_CLOSE_STREAM 0x0001 387c478bd9Sstevel@tonic-gate #define LOG_TIMESTAMP 0x0002 397c478bd9Sstevel@tonic-gate #define LOG_TRUNCATE 0x0004 407c478bd9Sstevel@tonic-gate #define LOG_USE_CONTEXT_LEVEL 0x0008 417c478bd9Sstevel@tonic-gate #define LOG_PRINT_LEVEL 0x0010 427c478bd9Sstevel@tonic-gate #define LOG_REQUIRE_DEBUG 0x0020 437c478bd9Sstevel@tonic-gate #define LOG_CHANNEL_BROKEN 0x0040 447c478bd9Sstevel@tonic-gate #define LOG_PRINT_CATEGORY 0x0080 457c478bd9Sstevel@tonic-gate #define LOG_CHANNEL_OFF 0x0100 467c478bd9Sstevel@tonic-gate 477c478bd9Sstevel@tonic-gate typedef struct log_context *log_context; 487c478bd9Sstevel@tonic-gate typedef struct log_channel *log_channel; 497c478bd9Sstevel@tonic-gate 507c478bd9Sstevel@tonic-gate #define LOG_OPTION_DEBUG 0x01 517c478bd9Sstevel@tonic-gate #define LOG_OPTION_LEVEL 0x02 527c478bd9Sstevel@tonic-gate 537c478bd9Sstevel@tonic-gate #define log_open_stream __log_open_stream 547c478bd9Sstevel@tonic-gate #define log_close_stream __log_close_stream 557c478bd9Sstevel@tonic-gate #define log_get_stream __log_get_stream 567c478bd9Sstevel@tonic-gate #define log_get_filename __log_get_filename 577c478bd9Sstevel@tonic-gate #define log_check_channel __log_check_channel 587c478bd9Sstevel@tonic-gate #define log_check __log_check 597c478bd9Sstevel@tonic-gate #define log_vwrite __log_vwrite 607c478bd9Sstevel@tonic-gate #define log_write __log_write 617c478bd9Sstevel@tonic-gate #define log_new_context __log_new_context 627c478bd9Sstevel@tonic-gate #define log_free_context __log_free_context 637c478bd9Sstevel@tonic-gate #define log_add_channel __log_add_channel 647c478bd9Sstevel@tonic-gate #define log_remove_channel __log_remove_channel 657c478bd9Sstevel@tonic-gate #define log_option __log_option 667c478bd9Sstevel@tonic-gate #define log_category_is_active __log_category_is_active 677c478bd9Sstevel@tonic-gate #define log_new_syslog_channel __log_new_syslog_channel 687c478bd9Sstevel@tonic-gate #define log_new_file_channel __log_new_file_channel 697c478bd9Sstevel@tonic-gate #define log_set_file_owner __log_set_file_owner 707c478bd9Sstevel@tonic-gate #define log_new_null_channel __log_new_null_channel 717c478bd9Sstevel@tonic-gate #define log_inc_references __log_inc_references 727c478bd9Sstevel@tonic-gate #define log_dec_references __log_dec_references 737c478bd9Sstevel@tonic-gate #define log_get_channel_type __log_get_channel_type 747c478bd9Sstevel@tonic-gate #define log_free_channel __log_free_channel 757c478bd9Sstevel@tonic-gate #define log_close_debug_channels __log_close_debug_channels 767c478bd9Sstevel@tonic-gate 777c478bd9Sstevel@tonic-gate FILE * log_open_stream(log_channel); 787c478bd9Sstevel@tonic-gate int log_close_stream(log_channel); 797c478bd9Sstevel@tonic-gate FILE * log_get_stream(log_channel); 807c478bd9Sstevel@tonic-gate char * log_get_filename(log_channel); 817c478bd9Sstevel@tonic-gate int log_check_channel(log_context, int, log_channel); 827c478bd9Sstevel@tonic-gate int log_check(log_context, int, int); 837c478bd9Sstevel@tonic-gate #ifdef __GNUC__ 847c478bd9Sstevel@tonic-gate void log_vwrite(log_context, int, int, const char *, 857c478bd9Sstevel@tonic-gate va_list args) 867c478bd9Sstevel@tonic-gate __attribute__((__format__(__printf__, 4, 0))); 877c478bd9Sstevel@tonic-gate void log_write(log_context, int, int, const char *, ...) 887c478bd9Sstevel@tonic-gate __attribute__((__format__(__printf__, 4, 5))); 897c478bd9Sstevel@tonic-gate #else 907c478bd9Sstevel@tonic-gate void log_vwrite(log_context, int, int, const char *, 917c478bd9Sstevel@tonic-gate va_list args); 927c478bd9Sstevel@tonic-gate void log_write(log_context, int, int, const char *, ...); 937c478bd9Sstevel@tonic-gate #endif 947c478bd9Sstevel@tonic-gate int log_new_context(int, char **, log_context *); 957c478bd9Sstevel@tonic-gate void log_free_context(log_context); 967c478bd9Sstevel@tonic-gate int log_add_channel(log_context, int, log_channel); 977c478bd9Sstevel@tonic-gate int log_remove_channel(log_context, int, log_channel); 987c478bd9Sstevel@tonic-gate int log_option(log_context, int, int); 997c478bd9Sstevel@tonic-gate int log_category_is_active(log_context, int); 1007c478bd9Sstevel@tonic-gate log_channel log_new_syslog_channel(unsigned int, int, int); 1017c478bd9Sstevel@tonic-gate log_channel log_new_file_channel(unsigned int, int, const char *, 1027c478bd9Sstevel@tonic-gate FILE *, unsigned int, 1037c478bd9Sstevel@tonic-gate unsigned long); 1047c478bd9Sstevel@tonic-gate int log_set_file_owner(log_channel, uid_t, gid_t); 1057c478bd9Sstevel@tonic-gate log_channel log_new_null_channel(void); 1067c478bd9Sstevel@tonic-gate int log_inc_references(log_channel); 1077c478bd9Sstevel@tonic-gate int log_dec_references(log_channel); 1087c478bd9Sstevel@tonic-gate log_channel_type log_get_channel_type(log_channel); 1097c478bd9Sstevel@tonic-gate int log_free_channel(log_channel); 1107c478bd9Sstevel@tonic-gate void log_close_debug_channels(log_context); 1117c478bd9Sstevel@tonic-gate 1127c478bd9Sstevel@tonic-gate #endif /* !LOGGING_H */ 113*9525b14bSRao Shoaib /*! \file */ 114