From 62d58f229f7b499ce02ed644c3d628281bbd7d99 Mon Sep 17 00:00:00 2001 From: Sebastian Huber Date: Tue, 24 Mar 2020 07:47:18 +0100 Subject: c-user: Document new event record config options Update #3904. --- c-user/config/event-record.rst | 65 +++++++++++++++++++++++++++++++++++++++++- 1 file changed, 64 insertions(+), 1 deletion(-) (limited to 'c-user') diff --git a/c-user/config/event-record.rst b/c-user/config/event-record.rst index 8ca9534..edd8722 100644 --- a/c-user/config/event-record.rst +++ b/c-user/config/event-record.rst @@ -1,6 +1,6 @@ .. SPDX-License-Identifier: CC-BY-SA-4.0 -.. Copyright (C) 2019 embedded brains GmbH (http://www.embedded-brains.de) +.. Copyright (C) 2019, 2020 embedded brains GmbH (http://www.embedded-brains.de) Event Recording Configuration ============================= @@ -37,6 +37,69 @@ NOTES: The record extensions capture thread create, start, restart, delete, switch, begin, exitted and terminate events. +.. index:: CONFIGURE_RECORD_FATAL_DUMP_BASE64 + +.. _CONFIGURE_RECORD_FATAL_DUMP_BASE64: + +CONFIGURE_RECORD_FATAL_DUMP_BASE64 +---------------------------------- + +CONSTANT: + ``CONFIGURE_RECORD_FATAL_DUMP_BASE64`` + +OPTION TYPE: + This configuration option is a boolean feature define. + +DEFAULT CONFIGURATION: + If this configuration option is undefined, then the described feature is not + enabled. + +DESCRIPTION: + In case + + * this configuration option is defined + + * and :ref:`CONFIGURE_RECORD_PER_PROCESSOR_ITEMS` is properly defined, + + * and :ref:`CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB` is undefined, + + then the event records are dumped in Base64 encoding in a fatal error + extension (see :ref:`Terminate`). + +NOTES: + This extension can be used to produce crash dumps. + +.. index:: CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB + +.. _CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB: + +CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB +--------------------------------------- + +CONSTANT: + ``CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB`` + +OPTION TYPE: + This configuration option is a boolean feature define. + +DEFAULT CONFIGURATION: + If this configuration option is undefined, then the described feature is not + enabled. + +DESCRIPTION: + In case + + * this configuration option is defined + + * and :ref:`CONFIGURE_RECORD_PER_PROCESSOR_ITEMS` is properly defined, + + then the event records are compressed by zlib and dumped in Base64 encoding + in a fatal error extension (see :ref:`Terminate`). + +NOTES: + The zlib compression needs about 512KiB of RAM. This extension can be used + to produce crash dumps. + .. index:: CONFIGURE_RECORD_PER_PROCESSOR_ITEMS .. _CONFIGURE_RECORD_PER_PROCESSOR_ITEMS: -- cgit v1.2.3