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
The following commit(s) were added to refs/heads/master by this push:
new 21e9d0cafa0 Documentation/rexecd: document command-line options
including -t
21e9d0cafa0 is described below
commit 21e9d0cafa09b93943807ebb90a71b16ab04fab5
Author: wangjianyu3 <[email protected]>
AuthorDate: Tue Jun 30 10:24:28 2026 +0800
Documentation/rexecd: document command-line options including -t
Fill in the previously empty rexecd page with a description of the
daemon, its listening port/RPMsg name, usage, and all command-line
options (-4/-6/-r/-t), including the new -t threadless option that
serves each connection inline without a per-connection worker thread.
Signed-off-by: wangjianyu3 <[email protected]>
---
.../applications/netutils/rexecd/index.rst | 39 ++++++++++++++++++++++
1 file changed, 39 insertions(+)
diff --git a/Documentation/applications/netutils/rexecd/index.rst
b/Documentation/applications/netutils/rexecd/index.rst
index de6fb0e7f66..7f1246cda68 100644
--- a/Documentation/applications/netutils/rexecd/index.rst
+++ b/Documentation/applications/netutils/rexecd/index.rst
@@ -1,3 +1,42 @@
==================================
``rexecd`` Remote Execution Server
==================================
+
+``rexecd`` is the daemon that serves remote execution requests from the
+``rexec`` client. For the IP families it listens on the rexec port
+(``REXECD_PORT``, 512); for ``AF_RPMSG`` it listens on a corresponding
+RPMsg socket name. It authenticates the request and runs the requested
+command, piping its output back to the client.
+
+By default ``rexecd`` spawns a detached worker thread per accepted
+connection so that multiple sessions can run concurrently.
+
+Usage
+=====
+
+.. code-block:: none
+
+ rexecd [-4|-6|-r] [-t]
+
+Options
+=======
+
+``-4``
+ Specify the address family as ``AF_INET`` (IPv4). This is the default.
+
+``-6``
+ Specify the address family as ``AF_INET6`` (IPv6).
+
+``-r``
+ Specify the address family as ``AF_RPMSG``. This serves the daemon over
+ an RPMsg link instead of TCP/IP, allowing a remote processor in an AMP
+ system to execute commands. See
:doc:`/components/drivers/special/rpmsg/concepts`
+ for details on RPMsg.
+
+``-t``
+ Serve each connection inline in the main task instead of spawning a
+ per-connection worker thread. This avoids allocating the worker stack
+ (``CONFIG_NETUTILS_REXECD_STACKSIZE``) from the heap, which helps on
+ low-memory targets. With this option connections are served strictly
+ one at a time: a long-running or interactive command blocks the accept
+ loop until it finishes.
