From 5e76477456ce8bc4a1eeaccb5c5e1d3d99ab1300 Mon Sep 17 00:00:00 2001 From: ajs Date: Fri, 3 Dec 2004 19:03:33 +0000 Subject: 2004-12-03 Andrew J. Schorr * HACKING: Indicate that header files should be consulted for documentation, particularly logging levels in lib/log.h. * log.h: Document appropriate use of syslog logging priorities inside quagga. --- ChangeLog | 5 +++++ HACKING | 11 ++++++++++- lib/ChangeLog | 5 +++++ lib/log.h | 16 ++++++++++++++++ 4 files changed, 36 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index 8754e7d2..69b08756 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2004-12-03 Andrew J. Schorr + + * HACKING: Indicate that header files should be consulted for + documentation, particularly logging levels in lib/log.h. + 2004-11-24 Paul Jakma * TODO: Add source routing, zebra filtering and lib/ documenting. diff --git a/HACKING b/HACKING index fa5ac1ac..1335b082 100644 --- a/HACKING +++ b/HACKING @@ -1,5 +1,5 @@ -*- mode: text; -*- -$Id: HACKING,v 1.12 2004/11/15 19:23:47 gdt Exp $ +$Id: HACKING,v 1.13 2004/12/03 19:03:33 ajs Exp $ GUIDELINES FOR HACKING ON QUAGGA @@ -36,6 +36,15 @@ the top, commented out appropriately for the file type. Just add Id:, replacing with $. See line 2 of HACKING for an example; on checkout :$ is expanded to include the value. +Please document fully the proper use of a new function in the header file +in which it is declared. And please consult existing headers for +documentation on how to use existing functions. In particular, please consult +these header files: + + lib/log.h logging levels and usage guidance + [more to be added] + + CHANGELOG Add a ChangeLog entry whenever changing code, except for minor fixes diff --git a/lib/ChangeLog b/lib/ChangeLog index d334b04e..79062cae 100644 --- a/lib/ChangeLog +++ b/lib/ChangeLog @@ -1,3 +1,8 @@ +2004-12-03 Andrew J. Schorr + + * log.h: Document appropriate use of syslog logging priorities + inside quagga. + 2004-12-03 Andrew J. Schorr * command.h: Remove fields log_stdout and log_syslog from struct host, diff --git a/lib/log.h b/lib/log.h index e596cdd0..26ff902b 100644 --- a/lib/log.h +++ b/lib/log.h @@ -24,6 +24,22 @@ #include +/* Here is some guidance on logging levels to use: + * + * LOG_DEBUG - For all messages that are enabled by optional debugging + * features, typically preceded by "if (IS...DEBUG...)" + * LOG_INFO - Information that may be of interest, but everything seems + * to be working properly. + * LOG_NOTICE - Only for message pertaining to daemon startup or shutdown. + * LOG_WARNING - Warning conditions: unexpected events, but the daemon believes + * it can continue to operate correctly. + * LOG_ERR - Error situations indicating malfunctions. Probably require + * attention. + * + * Note: LOG_CRIT, LOG_ALERT, and LOG_EMERG are currently not used anywhere, + * please use LOG_ERR instead. + */ + #define ZLOG_NOLOG 0x00 #define ZLOG_FILE 0x01 #define ZLOG_SYSLOG 0x02 -- cgit v1.2.1