nets.c

nets.c - Network Sender

nets.c is a small C library and CLI for sending standard input to one TCP or UDP address.

CLI

Send bytes from standard input to a network address.

Examples

Send to a TCP endpoint:

echo 'hola' | nets 127.0.0.1:8080

Send to port 80 by default:

echo 'hola' | nets 127.0.0.1

Send a UDP datagram:

echo 'hola' | nets 127.0.0.1:8080 --udp

Parameters

Parameter	Description
`<addr>[:port]`	Destination host or IP address. Port defaults to `80`.
`--tcp`	Use TCP. This is the default.
`--udp`	Use UDP.
`-h`, `--help`	Show help and usage.
`-v`, `--version`	Show version.

Public API

#include "nets.h"

const char msg[] = "hello\n";
kc_nets_send("127.0.0.1", 8080, KC_NETS_TCP, msg, sizeof(msg) - 1);

Lifecycle

kc_nets_send() opens a socket, sends the provided bytes, and closes the socket before returning.
TCP sends all bytes over one connection.
UDP sends the provided bytes as one datagram.
The caller owns the input buffer before and after the call.

Build

Compiled artifacts are generated under bin/{arch}/{platform}/ for the host architecture running the build.

make clean && make

Multiarch Builds

The project is prepared to build artifacts for multiple architectures under bin/{arch}/{platform}/. A plain make builds only the current host architecture, while the targets below build the full matrix or a specific target.

make all
make x86_64/linux
make x86_64/windows
make i686/linux
make i686/windows
make aarch64/linux
make aarch64/android
make armv7/linux
make armv7/android
make armv7hf/linux
make riscv64/linux
make powerpc64le/linux
make mips/linux
make mipsel/linux
make mips64el/linux
make s390x/linux
make loongarch64/linux

License

This project is distributed under the GNU General Public License version 3 (GPLv3).

Repo

GitHub: kaisarcode/nets.c