This is an automated email from the ASF dual-hosted git repository. xiaoxiang781216 pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit 33053669ac016e5210a20a5a3b8ae190c02e2b35 Author: Matteo Golin <[email protected]> AuthorDate: Sat Sep 19 14:32:36 2026 -0400 docs/pthread: Document pthread_sigqueue Documents the new implementation of pthread_sigqueue. Signed-off-by: Matteo Golin <[email protected]> --- Documentation/reference/user/08_pthread.rst | 24 ++++++++++++++++++++++++ Documentation/standards/posix.rst | 2 ++ 2 files changed, 26 insertions(+) diff --git a/Documentation/reference/user/08_pthread.rst b/Documentation/reference/user/08_pthread.rst index 109279d1869..ae985d83a80 100644 --- a/Documentation/reference/user/08_pthread.rst +++ b/Documentation/reference/user/08_pthread.rst @@ -108,6 +108,7 @@ The main task thread does not have thread-specific data. - :c:func:`pthread_kill` - :c:func:`pthread_sigmask` + - :c:func:`pthread_sigqueue` No support for the following pthread interfaces is provided by NuttX: @@ -1716,3 +1717,26 @@ No support for the following pthread interfaces is provided by NuttX: **POSIX Compatibility:** Comparable to the POSIX interface of the same name. + +.. c:function:: int pthread_sigqueue(pthread_t thread, int sig, const union sigval value); + + This function queues a signal and data to a thread. It operates similarly to + ``sigqueue()``. + + **Input Parameters:** + + - ``thread``. The ID of a thread in the same process as the caller. + - ``sig``. The signal to be sent + - ``value``. Data to accompany the signal (see ``sigqueue``) + + **Returned Value:** + + - ``EAGAIN``. The limit of signals which may be queued has been reached. + - ``EINVAL``. ``sig`` was invalid. + - ``ENOSYS``. ``pthread_sigqueue()`` is not supported on this system. + - ``ESRCH``. ``thread`` is not valid. + + **Assumptions/Limitations:** + + **POSIX Compatibility:** Comparable to the POSIX interface of the same + name. diff --git a/Documentation/standards/posix.rst b/Documentation/standards/posix.rst index e435248d746..72189f197f1 100644 --- a/Documentation/standards/posix.rst +++ b/Documentation/standards/posix.rst @@ -744,6 +744,8 @@ Base Threads: +-----------------------------------------+---------+ | :c:func:`pthread_sigmask` | Yes | +-----------------------------------------+---------+ +| :c:func:`pthread_sigqueue` | Yes | ++-----------------------------------------+---------+ | :c:func:`pthread_testcancel` | Yes | +-----------------------------------------+---------+ | :c:func:`sched_yield` | Yes |
