Re: [PATCH v3 4/4] Test: Added self-testing and documentation

[Randy Dunlap]

Hi--

On 8/16/26 8:34 AM, mathura kumar wrote:
> Add test coverage to verify system call behavior under
> different-different cases.
> 
> Update index documentation to include two new doc.
> 	1) mq_recvmmsg.rst
> 	2) mq_sendmmsg.rst
> 
> The tests validate:
> 	1) Offset boundries.
> 	2) Partial success behaviors.
> 	3) Timeout behavior.
> 
> Documentation changes include:
> 	1) Updated implementation details.
> 	2) Error handlings mechanism.
> 	3) Tests details.
> 
> Signed-off-by: mathura kumar <mathura.kumar.tech@xxxxxxxxx>
> ---
>  Documentation/userspace-api/index.rst       |   2 +
>  Documentation/userspace-api/mq_recvmmsg.rst | 205 ++++++++++
>  Documentation/userspace-api/mq_sendmmsg.rst | 168 +++++++++
>  tools/testing/selftests/ipc/Makefile        |   2 +-
>  tools/testing/selftests/ipc/mq_recvmmsg.c   | 392 ++++++++++++++++++++
>  tools/testing/selftests/ipc/mq_sendmmsg.c   | 360 ++++++++++++++++++
>  6 files changed, 1128 insertions(+), 1 deletion(-)
>  create mode 100644 Documentation/userspace-api/mq_recvmmsg.rst
>  create mode 100644 Documentation/userspace-api/mq_sendmmsg.rst
>  create mode 100644 tools/testing/selftests/ipc/mq_recvmmsg.c
>  create mode 100644 tools/testing/selftests/ipc/mq_sendmmsg.c

Documentation build warnings (from 'make htmldocs'):

Documentation/userspace-api/mq_recvmmsg.rst:96: WARNING: Bullet list ends without a blank line; unexpected unindent. [docutils]
/work/lnx/repo/linux-next/Documentation/userspace-api/mq_recvmmsg.rst:179: WARNING: Title underline too short.

3.4 start_idx argument
~~~~~~~~~~~~~~~~~~~ [docutils]
Documentation/userspace-api/mq_sendmmsg.rst:77: WARNING: Bullet list ends without a blank line; unexpected unindent. [docutils]
/work/lnx/repo/linux-next/Documentation/userspace-api/mq_sendmmsg.rst:146: WARNING: Title underline too short.

3.3 start_idx argument
~~~~~~~~~~~~~~~~~~~ [docutils]


-- 
~Randy