summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristian Mauderer <christian.mauderer@embedded-brains.de>2018-03-23 07:58:18 +0100
committerChristian Mauderer <christian.mauderer@embedded-brains.de>2018-03-23 09:36:35 +0100
commit7ec935e03f13baa899ab62f5c8348eec5ca35e5c (patch)
tree8f1456d7945b75f0d514162eb904df7f71903516
parentd300a34424b2bc67dcb739ea1d91d81efeb409e5 (diff)
vprintf: Add handler that mutes all output.HEADmaster
This adds a vprintf handler that can be used to suppress all outputs of the libbsd.
-rw-r--r--libbsd.txt24
-rwxr-xr-xrtemsbsd/include/rtems/bsd/bsd.h9
-rw-r--r--rtemsbsd/rtems/rtems-kernel-vprintf.c10
3 files changed, 43 insertions, 0 deletions
diff --git a/libbsd.txt b/libbsd.txt
index f66a41bf..e7a9f784 100644
--- a/libbsd.txt
+++ b/libbsd.txt
@@ -265,6 +265,30 @@ their own implementation of the `rtems_bsd_get_allocator_domain_size()`
function (for example in the module which calls `rtems_bsd_initialize()`) if
different values are desired. The default size is 8MiB for all domains.
+=== Redirecting or Disabling the Output ===
+
+A lot of system messages are printed to the stdout by default. If you want to
+redirect them you can overwrite the default print handler. That can even be done
+before the libbsd initialization to catch all messages. An example would look
+like follows:
+
+-------------------------------------------------------------------------------
+int my_vprintf_handler(int level, const char *fmt, va_list ap) {
+ /* Do something with the messages. */
+
+ return number_of_printed_chars;
+}
+
+...
+ /* In your initialization: */
+ rtems_bsd_vprintf_handler old;
+ old = rtems_bsd_set_vprintf_handler(my_vprintf_handler);
+...
+-------------------------------------------------------------------------------
+
+As a special case, you can set the `rtems_bsd_vprintf_handler_mute(...)`
+provided by libbsd to suppress all output.
+
== Network Stack Features
http://roy.marples.name/projects/dhcpcd/index[DHCPCD(8)]:: DHCP client
diff --git a/rtemsbsd/include/rtems/bsd/bsd.h b/rtemsbsd/include/rtems/bsd/bsd.h
index 19428a51..cec14ac4 100755
--- a/rtemsbsd/include/rtems/bsd/bsd.h
+++ b/rtemsbsd/include/rtems/bsd/bsd.h
@@ -294,6 +294,15 @@ int rtems_bsd_vprintf(int level, const char *fmt, va_list ap);
*/
int rtems_bsd_setlogpriority(const char* priority);
+/**
+ * @brief Set this vprintf handler to suppress all output.
+ *
+ * @retval Allways 0.
+ *
+ * @see rtems_bsd_vprintf() for the parameters.
+ */
+int rtems_bsd_vprintf_handler_mute(int level, const char *fmt, va_list ap);
+
/** @} */
#ifdef __cplusplus
diff --git a/rtemsbsd/rtems/rtems-kernel-vprintf.c b/rtemsbsd/rtems/rtems-kernel-vprintf.c
index 7364ec6d..29dc1ff4 100644
--- a/rtemsbsd/rtems/rtems-kernel-vprintf.c
+++ b/rtemsbsd/rtems/rtems-kernel-vprintf.c
@@ -103,6 +103,16 @@ default_vprintf_handler(int level, const char *fmt, va_list ap)
static int (*vprintf_handler)(int, const char *, va_list) =
default_vprintf_handler;
+int
+rtems_bsd_vprintf_handler_mute(int level, const char *fmt, va_list ap)
+{
+ (void) level;
+ (void) fmt;
+ (void) ap;
+
+ return 0;
+}
+
rtems_bsd_vprintf_handler
rtems_bsd_set_vprintf_handler(rtems_bsd_vprintf_handler new_handler)
{