Aksal/nuttx
3
1
Fork 1
mirror of https://github.com/apache/nuttx.git synced 2026-08-01 20:28:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Documentation/applications: document Dropbear scp file transfers

Browse source 
Document how to transfer files with scp on the Dropbear server port,
which requires the legacy protocol (scp -O) since the port has no SFTP
server. Recent OpenSSH clients default to SFTP and fail otherwise.

Signed-off-by: Felipe Moura <moura.fmo@gmail.com>
This commit is contained in:
Felipe Moura 2026-07-05 13:31:26 -03:00 • committed by Alan C. Assis
parent e0b4eb7c9c
commit 4a927bc7e0
1 changed files with 36 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

36
Documentation/applications/netutils/dropbear/index.rst
View file

@ -77,6 +77,35 @@ Then open an SSH session from a host on the same network::
<username>@<ip_address>'s password:
nsh>
File transfer with scp
----------------------
When ``CONFIG_NETUTILS_DROPBEAR_SCP`` is enabled (default ``y``, requires
``CONFIG_PIPES=y``), Dropbear's ``scp`` program is built as a builtin
application and the server accepts SSH ``exec`` requests, allowing files to
be copied to and from the board with a standard ``scp`` client.
The port implements only the legacy scp protocol. OpenSSH 9.0 and later
default to the SFTP protocol, which is not supported by this port, so a
plain ``scp`` invocation from a recent Linux distribution fails. Pass the
``-O`` flag to force the legacy scp protocol.
Copy a file from the host to the board::
$ scp -O <file> <username>@<ip_address>:/data/<file>
Copy a file from the board back to the host::
$ scp -O <username>@<ip_address>:/data/<file> .
When Dropbear listens on a non-default port, add ``-P <port>``::
$ scp -O -P 2222 <file> <username>@<ip_address>:/data/<file>
Transfers must always be initiated from the host. Running ``scp`` on the
target to push or pull files from another machine is not supported, since
the port does not include an SSH client.
Notes
-----
@ -120,6 +149,13 @@ Remove the stale entry with::
Then reconnect normally. The client will prompt to accept the new host key.
**scp fails with "subsystem request failed" or "Connection closed"**
Recent OpenSSH clients use the SFTP protocol by default, which this port
does not support. Retry forcing the legacy scp protocol::
$ scp -O <file> <username>@<ip_address>:/data/<file>
**Connection refused**
Check that the board has obtained an IP address and that the Dropbear task is