Add syslog.h; rename lib_rawprintf() to syslog()

git-svn-id: http://svn.code.sf.net/p/nuttx/code/trunk@5578 42af7a65-404d-4744-a932-0658087f49c3

3 files changed, 109 insertions, 28 deletions

diff --git a/nuttx/include/debug.h b/nuttx/include/debug.h
index aa5efd432..70ae2ee18 100644
--- a/nuttx/include/debug.h
+++ b/nuttx/include/debug.h
@@ -1,7 +1,7 @@
 /****************************************************************************
  * include/debug.h
  *
- *   Copyright (C) 2007-2011 Gregory Nutt. All rights reserved.
+ *   Copyright (C) 2007-2011, 2013 Gregory Nutt. All rights reserved.
  *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
@@ -43,7 +43,7 @@
 #include <nuttx/config.h>
 #include <nuttx/compiler.h>
 
-#include <stdint.h>
+#include <syslog.h>
 
 /****************************************************************************
  * Pre-processor Definitions
@@ -104,22 +104,22 @@
 
 #ifdef CONFIG_DEBUG
 # define dbg(format, arg...) \
-  lib_rawprintf(EXTRA_FMT format EXTRA_ARG, ##arg)
+  syslog(EXTRA_FMT format EXTRA_ARG, ##arg)
 
 # ifdef CONFIG_ARCH_LOWPUTC
 #  define lldbg(format, arg...) \
-   lib_lowprintf(EXTRA_FMT format EXTRA_ARG, ##arg)
+   lowsyslog(EXTRA_FMT format EXTRA_ARG, ##arg)
 # else
 #  define lldbg(x...)
 # endif
 
 # ifdef CONFIG_DEBUG_VERBOSE
 #  define vdbg(format, arg...) \
-   lib_rawprintf(EXTRA_FMT format EXTRA_ARG, ##arg)
+   syslog(EXTRA_FMT format EXTRA_ARG, ##arg)
 
 #  ifdef CONFIG_ARCH_LOWPUTC
 #    define llvdbg(format, arg...) \
-     lib_lowprintf(EXTRA_FMT format EXTRA_ARG, ##arg)
+     lowsyslog(EXTRA_FMT format EXTRA_ARG, ##arg)
 #  else
 #    define llvdbg(x...)
 #  endif
@@ -576,29 +576,16 @@ extern "C"
 {
 #endif
 
-/* These low-level debug APIs are provided by the NuttX library.  If the
- * cross-compiler's pre-processor supports a variable number of macro
- * arguments, then the macros below will map all debug statements to one
- * or the other of the following.
- */
-
-int lib_rawprintf(FAR const char *format, ...);
-
-#ifdef CONFIG_ARCH_LOWPUTC
-int lib_lowprintf(FAR const char *format, ...);
-#endif
-
 /* Dump a buffer of data */
 
 void lib_dumpbuffer(FAR const char *msg, FAR const uint8_t *buffer, unsigned int buflen);
 
-/* Enable or disable debug output */
-
-#ifdef CONFIG_DEBUG_ENABLE
-void dbg_enable(bool enable);
-#endif
-
-/* If the cross-compiler's pre-processor does not support variable length
+/* The system logging interfaces are pnormally accessed via the macros
+ * provided above.  If the cross-compiler's C pre-processor supports a
+ * variable number of macro arguments, then those macros below will map all
+ * debug statements to the logging interfaces declared in syslog.h.
+ *
+ * If the cross-compiler's pre-processor does not support variable length
  * arguments, then these additional APIs will be built.
  */
 
diff --git a/nuttx/include/nuttx/syslog.h b/nuttx/include/nuttx/syslog.h
index 3c340d23a..bb3c8f493 100644
--- a/nuttx/include/nuttx/syslog.h
+++ b/nuttx/include/nuttx/syslog.h
@@ -116,10 +116,10 @@ EXTERN int syslog_initialize(void);
  *
  * Description:
  *   This is the low-level system logging interface.  The debugging/syslogging
- *   interfaces are lib_rawprintf() and lib_lowprinf().  The difference is
- *   the lib_rawprintf() writes to fd=1 (stdout) and lib_lowprintf() uses
+ *   interfaces are syslog() and lowsyslog().  The difference is that
+ *   the syslog() internface writes to fd=1 (stdout) whereas lowsyslog() uses
  *   a lower level interface that works from interrupt handlers.  This
- *   function is a a low-level interface used to implement lib_lowprintf().
+ *   function is a a low-level interface used to implement lowsyslog().
  *
  ****************************************************************************/
 
diff --git a/nuttx/include/syslog.h b/nuttx/include/syslog.h
new file mode 100644
index 000000000..cfb2db97b
--- /dev/null
+++ b/nuttx/include/syslog.h
@@ -0,0 +1,94 @@
+/****************************************************************************
+ * include/syslog.h
+ *
+ *   Copyright (C) 2013 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ * 3. Neither the name NuttX nor the names of its contributors may be
+ *    used to endorse or promote products derived from this software
+ *    without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+ * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+ * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ ****************************************************************************/
+
+#ifndef __INCLUDE_SYSLOG_H
+#define __INCLUDE_SYSLOG_H
+
+/****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+
+#include <stdint.h>
+#include <stdarg.h>
+
+/****************************************************************************
+ * Pre-processor Definitions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Public Type Declarations
+ ****************************************************************************/
+
+/****************************************************************************
+ * Public Variables
+ ****************************************************************************/
+
+/****************************************************************************
+ * Public Function Prototypes
+ ****************************************************************************/
+
+#if defined(__cplusplus)
+extern "C"
+{
+#endif
+
+/* These low-level debug APIs are provided by the NuttX library.  These are
+ * normally accessed via the macros in debug.h.  If the cross-compiler's
+ * C pre-processor supports a variable number of macro arguments, then those
+ * macros below will map all debug statements to one or the other of the
+ * following.
+ */
+
+int syslog(FAR const char *format, ...);
+int vsyslog(const char *src, va_list ap);
+
+#ifdef CONFIG_ARCH_LOWPUTC
+int lowsyslog(FAR const char *format, ...);
+int lowvsyslog(const char *src, va_list ap);
+#endif
+
+/* Enable or disable syslog output */
+
+#ifdef CONFIG_SYSLOG_ENABLE
+void syslog_enable(bool enable);
+#endif
+
+#if defined(__cplusplus)
+}
+#endif
+
+#endif /* __INCLUDE_SYSLOG_H */