Skip to content

extend the multi-thread safety section in Hook's Developer's Guide

The Hook's Developer's Guide has a short text about multi-thread safety around the multi_threading_compatible C function and the MultiThreadingCriticalSection.

This ticket proposes to extend this by:

  • explain the difference between the Kea thread safety and the generic thread safety
  • explain how to make the hook code Kea thread safe
  • insist about the fact that MultiThreadingCriticalSection must not be used when can be entered from a packet processing callout point
  • give the (short) list of Kea APIs which are generic thread safe
  • insist about the fact that by outside this short list all Kea APIs are not generic thread safe nor in general the C++ programming language
  • use the last comment to introduce the fact that hooks are not required to be written in C++
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information