diff options
author | José Bollo <jose.bollo@iot.bzh> | 2017-07-05 13:39:27 +0200 |
---|---|---|
committer | José Bollo <jose.bollo@iot.bzh> | 2017-07-05 15:41:24 +0200 |
commit | 846e952260278225b79de4062fff1f8f2145a544 (patch) | |
tree | 78634333f934aba955808199b382d33c665f9fa8 /src/afb-debug.h | |
parent | 71762eeb3fc6e89ee17be512d295d305b2664142 (diff) |
afb-debug: add features for debugging
When compiled with -DAGL_DEVEL or -DAFB_INSERT_DEBUG_FEATURES
afb-daemon interprets the environment variables
AFB_DEBUG_BREAK and AFB_DEBUG_WAIT.
The environment variable AFB_DEBUG_BREAK make afb-daemon emit
a break (SIGINT) that should be treated by the debugger.
The environment variable AFB_DEBUG_WAIT make afb-daemon wait
for a break (SIGINT) to continue. This can be used to attach
a debugger.
The content of the variables AFB_DEBUG_BREAK and AFB_DEBUG_WAIT
is a list of key names of the point where the action should
occur. The list is separated by spaces or commas ','.
Example:
AFB_DEBUG_WAIT=main-entry,start-load
The defined points are: main-entry, main-args, main-start,
start-entry, start-load, start-start, start-http, start-call,
start-exec.
Here some of their characteristic:
- main-entry: at the beginning befaore any other instruction
- main-args: after parsing arguments
- main-start: after daemonisation before starting
- start-entry: at start entry
- start-load: before loading bindings after initialisation of afb-daemon
- start-start: after loading bindings befaore starting it
- start-call: after init before starting HTTP server
- start-http: after http server, before calling startup calls
- start-exec: before running the --exec command
Change-Id: Id405e749c590fb95f32e30a7d37c30b6412cf0a5
Signed-off-by: José Bollo <jose.bollo@iot.bzh>
Diffstat (limited to 'src/afb-debug.h')
-rw-r--r-- | src/afb-debug.h | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/src/afb-debug.h b/src/afb-debug.h new file mode 100644 index 00000000..4723cd06 --- /dev/null +++ b/src/afb-debug.h @@ -0,0 +1,29 @@ +/* + Copyright 2017 IoT.bzh + + author: José Bollo <jose.bollo@iot.bzh> + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +*/ + +#pragma once + +#if defined(AGL_DEVEL) && !defined(AFB_INSERT_DEBUG_FEATURES) +# define AFB_INSERT_DEBUG_FEATURES +#endif + +#if defined(AFB_INSERT_DEBUG_FEATURES) +extern void afb_debug(const char *key); +#else +#define afb_debug(x) ((void)0) +#endif |