diff options
| -rw-r--r-- | docs/SUMMARY.md | 1 | ||||
| -rw-r--r-- | docs/afb-daemon-debugging.md | 36 |
2 files changed, 37 insertions, 0 deletions
diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index 9fed80c7..44b06f8d 100644 --- a/docs/SUMMARY.md +++ b/docs/SUMMARY.md @@ -11,3 +11,4 @@ * [Annexes](annexes.md) * [Installing the binder on a desktop](afb-desktop-package.md) * [Options of afb-daemon](afb-daemon-options.md) + * [Debugging afb-daemon](afb-daemon-debugging.md) diff --git a/docs/afb-daemon-debugging.md b/docs/afb-daemon-debugging.md new file mode 100644 index 00000000..dd5fd64b --- /dev/null +++ b/docs/afb-daemon-debugging.md @@ -0,0 +1,36 @@ +# Debugging afb-daemon and its bindings + +When compiled with the symbol AGL_DEVEL defined, the ***binder*** +understand the 2 configuration variables: + + - AFB_DEBUG_BREAK: to emit interrupts + - AFB_DEBUG_WAIT: to wait interrupts + +To use these variables, assign it the list of break or wait points +to reach. + +Example: + +```bash +$ AFB_DEBUG_BREAK=main-entry AFB_DEBUG_WAIT=start-load,start-exec afb-daemon .... +``` + +This tells to ***afb-daemon*** to break at the point **main-entry** and to +wait at the points **start-load** and **start-exec**. + +The items of the list can be separated using comma, space, tab or new-line. + +The break/wait points are, in the order of their occurence: + +- main-entry: before decode arguments +- main-args: before daemon setup +- main-start: before starting jobs +- start-entry: before initialisation of sessions and hooks +- start-load: before load and pre-init of bindings +- start-start: before init of bindings +- start-http: before start of http server +- start-call: before execution of requests of the command line (option --call) +- start-exec: before execution of child preocees + +Note also that a call to 'personality' is inserted just after +the point start-start. |