VANESSA_SOCKET_PIPE(1)

💖 VANESSA_SOCKET_PIPE 💖

okay bestie, sit down, hydrate, and let me tell you about vanessa_socket_pipe — she's a page in the General Commands Manual, section 1, and she's literally a whole vibe. 🦋

✨ NAME ✨

vanessa_socket_pipe — a Trivial TCP/IP pipe based on libvanessa_socket

✨ SYNOPSIS ✨

vanessa_socket_pipe [options]

✨ DESCRIPTION ✨

so. a TCP/IP pipe is this little user space programme that just... sits there and listens for TCP/IP connections on a port on the local host. and the moment a client connects, she turns around and makes a connection to a TCP port — possibly on a whole other host, no big deal. once both connections are up and living their truth, whatever data goes down one connection gets relayed straight to the other. boom. bi-directional pipe. it's giving glow-up. 💅

use cases? she's iconic for enabling connections to specific ports on hosts that are chillin' behind a packet filter. 🎀

and lowkey, this code is intended primarily as an example of how many of the features of libvanessa_socket work. so she's educational and serving. no cap. ✨

✨ OPTIONS ✨

• -c, --connection_limit — max number of connections to accept simultaneously. a value of zero sets no limit on the number of simultaneous connections. (default 0) 🌈
• -d, --debug — turn on verbose debuging to stderr. 👀 (yes, that's how the original spells it, we're keeping it, character for character, fr fr)
• -h, --help — display this message. bestie behavior honestly. 🫶
• -L, --listen_port — port to listen on. (mandatory) ⚠️
• -l, --listen_host — address to listen on. may be a hostname or an IP address. if not defined then listen on all local addresses. 🦋
• -n, --no_lookup — turn off lookup of hostnames and portnames. that is, hosts must be given as IP addresses and ports must be given as numbers. 😤
• -O, --outgoing_port — define a port to connect to. if not specified, -l|--listen_port will be used. 🔥
• -o, --outgoing_host — define host to connect to. may be a hostname or an IP address. (mandatory) ⚠️
• -q, --quiet — only log errors. overriden by -d|--debug. 🤫
• -t, --timeout — idle timeout in seconds. value of zero sets infinite timeout. (default 1800) ⏳

Notes: default value for binary flags is off. -L|--listen_port and -o|--outgoing_host must be defined. like, non-negotiable. 💀

✨ AUTHOR ✨

Simon Horman <horms@verge.net.au> — king behavior, we stan. 👑

and that's the whole page bestie!! she's from the General Commands Manual, section 1, dated 12th February 2001, and she still ate. periodt. 💖✨🎀