nuttx/sched/mqueue
Marco Casaroli ac7b5f5218 sched: Run a module's SIGEV_THREAD notification with its data base.
A SIGEV_THREAD notification -- from mq_notify() or timer_create() -- runs its
callback on a shared signal-notification work queue, not in the registering
task.  That worker carries no FDPIC data base, so a module's callback reaches
it with the wrong base and cannot touch its own globals.  This is unlike every
other callback entry point, where the callback runs in a task that inherited
the module's data space and resolving the code address is enough.

The base is knowable exactly once, at registration, when the call is still in
the module's own context: capture it there with fdpic_base() into the
persisted work structure (mq's ntwork, the timer's pt_work).  At send or
expiry the descriptor is resolved to its code address -- a plain memory read
that needs no base -- and stored in work->func.  The worker, seeing a non-zero
base, installs it in the FDPIC register around the call and restores it after;
a zero base, which is every non-module callback, takes the direct path
unchanged.

fdpic_base() exposes the test fdpic_callback() already makes internally --
whether the caller is a module -- for a site that has to decide before it
stores a pointer somewhere the register will no longer be correct.

fdpic_invoke() is the install-call-restore, in the same ARM-thumb inline asm
as the rest of fdpic.h.  It saves the register on the stack and keeps the push
8-byte aligned, and pins the argument in r0, so it asks the allocator for only
two free registers -- enough on builds that also reserve a frame pointer.  It
is safe against preemption: the FDPIC register is REG_PIC in the saved
context, preserved across a context switch, and base firmware reserves it so
no interrupt handler disturbs it.  A context switch or interrupt while the
callback runs therefore keeps the module's base.

Verified with CONFIG_SIG_EVTHREAD on two ARM cores: an RP2350 (Cortex-M33,
armv8-m) on hardware and mps2-an500 (Cortex-M7, armv7e-m) under QEMU.  On each
a module's mq_notify and timer_create SIGEV_THREAD callbacks run on the worker
and write a distinctive value into a module global, proving the base was
installed.  Removing just the register install makes the same callback
HardFault the board, confirming it is load-bearing.

Assisted-by: Claude Code:claude-opus-5
Signed-off-by: Marco Casaroli <marco.casaroli@gmail.com>
2026-08-01 12:23:27 +02:00
..
CMakeLists.txt sched/mqueue/CMakeLists.txt: fix compilation for CONFIG_DISABLE_MQUEUE_SYSV=n 2025-01-17 23:14:39 +08:00
Make.defs mqueue: refactor of mqueue 2024-09-29 18:18:01 +08:00
mq_getattr.c fs/file: unify prefix about file_xxx api, like file_open, file_ioctl 2025-06-12 18:12:42 +08:00
mq_initialize.c sched: unify Private Types banners 2025-05-28 10:17:15 +08:00
mq_msgfree.c sched: remove all spin_lock_irqsave(NULL) 2025-01-06 23:11:44 +08:00
mq_msgqalloc.c sched: migrate to SPDX identifier 2024-09-12 01:10:14 +08:00
mq_msgqfree.c include/debug.h: Move to include/nuttx/debug.h 2026-04-07 07:50:06 -03:00
mq_notify.c sched: Run a module's SIGEV_THREAD notification with its data base. 2026-08-01 12:23:27 +02:00
mq_rcvinternal.c !sys/types.h: change time_t and clock_t to int64_t to align with other OSes 2026-05-19 16:21:28 +08:00
mq_receive.c !include/fcntl.h: align open flags with Linux values 2026-06-30 13:43:44 +08:00
mq_recover.c sched: migrate to SPDX identifier 2024-09-12 01:10:14 +08:00
mq_send.c !include/fcntl.h: align open flags with Linux values 2026-06-30 13:43:44 +08:00
mq_setattr.c fs/file: unify prefix about file_xxx api, like file_open, file_ioctl 2025-06-12 18:12:42 +08:00
mq_sndinternal.c !sys/types.h: change time_t and clock_t to int64_t to align with other OSes 2026-05-19 16:21:28 +08:00
mq_waitirq.c sched: After nxsched_add_readytorun, change first parameter to up_switch_context to this_task() 2025-08-20 10:16:43 +08:00
mqueue.h !sys/types.h: change time_t and clock_t to int64_t to align with other OSes 2026-05-19 16:21:28 +08:00
msg.h sched: migrate to SPDX identifier 2024-09-12 01:10:14 +08:00
msgctl.c sched: migrate to SPDX identifier 2024-09-12 01:10:14 +08:00
msgget.c sched: migrate to SPDX identifier 2024-09-12 01:10:14 +08:00
msginternal.c sched: migrate to SPDX identifier 2024-09-12 01:10:14 +08:00
msgrcv.c sched: After nxsched_add_readytorun, change first parameter to up_switch_context to this_task() 2025-08-20 10:16:43 +08:00
msgsnd.c sched: After nxsched_add_readytorun, change first parameter to up_switch_context to this_task() 2025-08-20 10:16:43 +08:00