From 00a1623a59b1540c28781e8ccd8341c8114dbc75 Mon Sep 17 00:00:00 2001
From: David Lawrence <source@isc.org>
Date: Mon, 11 Oct 1999 13:16:42 +0000
Subject: [PATCH] isc_log_vwrite is now a public function

---
 lib/isc/include/isc/log.h | 39 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/lib/isc/include/isc/log.h b/lib/isc/include/isc/log.h
index ce9283a3f6..623a2a754b 100644
--- a/lib/isc/include/isc/log.h
+++ b/lib/isc/include/isc/log.h
@@ -15,7 +15,7 @@
  * SOFTWARE.
  */
 
-/* $Id: log.h,v 1.1 1999/09/23 17:43:50 tale Exp $ */
+/* $Id: log.h,v 1.2 1999/10/11 13:16:42 tale Exp $ */
 
 #ifndef ISC_LOG_H
 #define ISC_LOG_H 1
@@ -420,6 +420,43 @@ isc_log_write(isc_log_t *lctx, isc_logcategory_t *category,
  *	meaningful error.
  */
 
+void
+isc_log_vwrite(isc_log_t *lctx, isc_logcategory_t *category,
+	       isc_logmodule_t *module, int level, const char *format,
+	       va_list args);
+/*
+ * Write a message to the log channels.
+ *
+ * Notes:
+ *	lctx can be NULL; this is allowed so that programs which use
+ *	libraries that use the ISC logging system are not required to
+ *	also use it.
+ *
+ *	The format argument is a printf(3) string, with additional arguments
+ *	as necessary.
+ *
+ * Requires:
+ *	lctx is a valid logging context.
+ *
+ *	The category and module arguments must have ids that are in the
+ *	range of known ids, as estabished by isc_log_registercategories()
+ *	and isc_log_registermodules().
+ *
+ *	level != ISC_LOG_DYNAMiC.  ISC_LOG_DYNAMIC is used only to define
+ *	channels, and explicit debugging level must be identified for
+ *	isc_log_write() via ISC_LOG_DEBUG(level).
+ *
+ *	format != NULL.
+ *
+ * Ensures:
+ *	The log message is written to every channel associated with the
+ *	indicated category/module pair.
+ *
+ * Returns:
+ *	Nothing.  Failure to log a message is not construed as a
+ *	meaningful error.
+ */
+
 void
 isc_log_setdebuglevel(isc_log_t *lctx, unsigned int level);
 /*