History

Petro Karashchenko f9baa422c1 style: unify path to files in comment section Signed-off-by: Petro Karashchenko <petro.karashchenko@gmail.com>		2022-03-09 10:37:33 +08:00
..
Kconfig	style: unify path to files in comment section	2022-03-09 10:37:33 +08:00
Make.defs	netutils: fix relative path CI error	2021-06-16 09:03:06 -05:00
Makefile	netutils: fix relative path CI error	2021-06-16 09:03:06 -05:00
netcat_main.c	netutils/netcat: fixed crash on accept() invocation.	2022-02-10 12:20:27 +08:00
README.md

README.md

Network Utilities / `netcat` tool

netcat TCP/IP Swiss army knife

It was re-implemented from scratch for NuttX

DEMO

https://purl.org/rzr/weboftwins

USAGE

Usage is straightforward:

nsh> help ; netcat
Usage: netcat [-l] [destination] [port] [file]

nsh> renew eth0 ; ifconfig

eth0    Link encap:Ethernet HWaddr 52:13:FF:FF:FF:FF at UP
        inet addr:192.168.1.42 DRaddr:192.168.1.254 Mask:255.255.255.0

In the following examples, following configuration is used:

target (nuttx) is 192.168.1.42
host (linux) is 192.168.1.55

Server

As a server on NuttX and Linux's netcat as client

nsh> netcat -l

sh> cat /proc/version | netcat 192.168.1.42 31337
Linux ...

Default port is 31337 but it can changed.

nsh> renew eth0 ; ifconfig ; netcat -l
log: net: listening on :31337
Linux ...

Client

Start Server on GNU/Linux:

sh> ip addr show && netcat -l 31337

Client side on nuttx, we create

nsh> help ; renew eth0 ; ifconfig
nsh> netcat 192.168.1.55 31337 /proc/version

Using pipes

mkfifo /dev/fifo
netcat 192.168.1.55 31337 /proc/fifo
help > /dev/fifo

fxos8700cq > /dev/fifo &
fxos8700cq [7:100]
netcat 192.168.1.55 31337  /dev/fifo