nuttx/Documentation/applications
Swatantra Yadav a4b6b8b8bf Documentation/netutils: add comprehensive guide for ftpd
Provide a complete documentation guide for the ftpd (FTP server) network
utility in Documentation/applications/netutils/ftpd/index.rst, replacing
the previous 6-line placeholder stub.

Includes:
- Protocol architecture overview (control/data connection separation, multi-session worker pthreads, VFS mapping)
- Security considerations regarding unencrypted plaintext FTP credentials, mandatory credential hardening, home directory isolation, and encrypted password authentication
- Comprehensive supported RFC 959 / RFC 2428 / RFC 3659 FTP commands reference table
- Configuration options table and networking prerequisites (CONFIG_NETUTILS_FTPD, worker stack size, buffer sizes)
- NSH terminal usage (ftpd -4 / -6, ftpd_stop) with address-family flag requirements and configured account placeholders
- External client connection walkthroughs (FTP CLI, cURL) using configured account and anonymous workflows
- Public C API reference for types, account flags, and lifecycle functions (ftpd_open, ftpd_adduser, ftpd_session, ftpd_close)
- Complete, runnable C application example demonstrating multi-user server setup, signal-driven termination (SIGINT/SIGTERM) with atomic sig_atomic_t state, POSIX kill stop routine, and credential placeholders
- Embedded design and resource tuning guidelines (stack sizing, flash/SD card I/O buffering, and NAT passive mode)

Addresses #11081

Assisted-by: Google Gemini
Signed-off-by: Swatantra Yadav <maverickswatantra@gmail.com>
2026-10-09 12:08:21 +08:00
..
audioutils docs/applications/audioutils: Document Morsey library 2026-07-24 12:03:37 +08:00
benchmarks boards/xtensa/esp32s3: New board WaveShare ESP32-S3-Touch-LCD-1.28 (WIP). 2026-04-24 16:27:08 +08:00
boot style: Fix "the the" typo across the codebase. 2026-03-23 11:07:49 +01:00
canutils Documentation: update Lely CANopen doc 2026-07-06 11:02:46 -03:00
crypto documentation: Document MQTT-C with Mbed TLS usage. 2026-04-14 16:05:54 +08:00
examples Documentation: brand new layout for NuttX documentation. 2026-10-08 01:40:54 +08:00
fsutils Documentation: add flashtool utility 2025-12-23 08:48:26 -03:00
games Documentation: brand new layout for NuttX documentation. 2026-10-08 01:40:54 +08:00
graphics boards/xtensa/esp32s3: New board WaveShare ESP32-S3-Touch-LCD-1.28 (WIP). 2026-04-24 16:27:08 +08:00
industry docs: add SCPI application documentation 2026-06-24 23:29:57 +08:00
inertial
interpreters Documentation: Add entry for Python on ESP32-P4 2026-05-23 09:35:16 -03:00
logging boards/nucleo-c071rb: add adcscope example 2026-03-24 18:24:40 +01:00
lte
math Documentation/math: explain that KissFFT is a small FFT library 2026-09-22 00:11:08 +08:00
mlearning Documentation: brand new layout for NuttX documentation. 2026-10-08 01:40:54 +08:00
netutils Documentation/netutils: add comprehensive guide for ftpd 2026-10-09 12:08:21 +08:00
nsh docs: document chroot jail root 2026-09-20 22:27:38 +08:00
sdr
system Documentation: brand new layout for NuttX documentation. 2026-10-08 01:40:54 +08:00
testing Documentation: brand new layout for NuttX documentation. 2026-10-08 01:40:54 +08:00
tools Documentation: brand new layout for NuttX documentation. 2026-10-08 01:40:54 +08:00
wireless
index.rst Documentation/applications: add mlearning docs and rename mlearing. 2026-09-03 14:41:34 +08:00