docs/afb-daemon-debugging.md

   1 # Debugging binder and bindings
   2
   3 When compiled with the symbol AGL_DEVEL defined, the ***binder***
   4 understands the 2 configuration variables:
   5
   6  - AFB_DEBUG_BREAK: to emit interrupts
   7  - AFB_DEBUG_WAIT: to wait interrupts
   8
   9 To use these variables, assign it the list of break or wait points
  10 to reach.
  11
  12 Example:
  13
  14 ```bash
  15 $ AFB_DEBUG_BREAK=main-entry AFB_DEBUG_WAIT=start-load,start-exec afb-daemon ....
  16 ```
  17
  18 This tells to ***afb-daemon*** to break at the point **main-entry** and to
  19 wait at the points **start-load** and **start-exec**.
  20
  21 The items of the list can be separated using comma, space, tab or new-line.
  22
  23 The break/wait points are, in the order of their occurrence:
  24
  25 - main-entry: before decode arguments
  26 - main-args: before daemon setup
  27 - main-start: before starting jobs
  28 - start-entry: before initialisation of sessions and hooks
  29 - start-load: before load and pre-init of bindings
  30 - start-start: before init of bindings
  31 - start-http: before start of http server
  32 - start-call: before execution of requests of the command line (option --call)
  33 - start-exec: before execution of child preocees
  34
  35 Note also that a call to 'personality' is inserted just after
  36 the point start-start.