mpsl: Add multithread lock acquire prerequisite to unint header

ppryga-nordic · nordicjm · commit ac1e1f14de6d · 2025-03-12T11:00:40.000Z
The mpsl_lib_uninit() may not be called without the multithreading
lock acquired: MULTITHREADING_LOCK_ACQUIRE(). That could lead to
a race condition between uninit call and mpsl_low_prio_work_handler().

It is a user responsibility to call MULTITHREADING_LOCK_ACQUIRE()
before the mpsl_lib_uninit().
For example please see hci_driver_close().

Signed-off-by: Piotr Pryga &lt;piotr.pryga@nordicsemi.no&gt;
diff --git a/include/mpsl/mpsl_lib.h b/include/mpsl/mpsl_lib.h
@@ -50,6 +50,8 @@ int32_t mpsl_lib_init(void);
  * user to override any interrupt handlers used by MPSL.
  *
  * @pre This method requires CONFIG_MPSL_DYNAMIC_INTERRUPTS to be enabled.
+ * @pre The function requires the multithreading lock (@see MULTITHREADING_LOCK_ACQUIRE())
+ *      to be acquired before.
  *
  * @note
  * After successful execution of this method, user-supplied interrupt

Original file line number	Diff line number	Diff line change
`@@ -50,6 +50,8 @@ int32_t mpsl_lib_init(void);`
`50`	`50`	`* user to override any interrupt handlers used by MPSL.`
`51`	`51`	`*`
`52`	`52`	`* @pre This method requires CONFIG_MPSL_DYNAMIC_INTERRUPTS to be enabled.`
	`53`	`+ * @pre The function requires the multithreading lock (@see MULTITHREADING_LOCK_ACQUIRE())`
	`54`	`+ * to be acquired before.`
`53`	`55`	`*`
`54`	`56`	`* @note`
`55`	`57`	`* After successful execution of this method, user-supplied interrupt`