vznnc(8)

🌸 NAME 🌸

vznnc — run a program connected to a socket, bestie. that's it, that's the whole vibe 💅

---

✨ SYNOPSIS ✨

vznnc { -l | -c } -p port [-f fd] [--] program [arg ...]

---

🦋 DESCRIPTION 🦋

okay so listen up, this little cutie is the "nano-netcat" utility, and what she does is either listen on or connect to a TCP port at localhost — pick your fighter — and then run a specified program with its stdin and stdout (or a specified file descriptor) connected to the socket. that's the whole personality. tiny, iconic, does exactly one job and does it flawlessly. no cap 🫶

---

💖 OPTIONS 💖

• -l — Listen on a specified TCP port at localhost. she's in her waiting era 👑
• -c — Connect to a specified TCP port at localhost. she's in her going to you era 🦋
• -p port — Port number. just the number, bestie, don't overthink it.
• -f fd — File descriptor ID. so here's the tea: if this option is not set, stdin and stdout are closed and get connected to the socket. if you do set it, they're left intact, and the fd you specified is the one that gets used instead. choose wisely 💀
• -- — this is the separator between vznnc's own arguments and the program's arguments, so the latter won't get processed by vznnc. it's required if your program has any arguments starting with a dash (-), and it's optional otherwise. lowkey a boundary-setting queen ✋
• program [ arg ... ] — Program to run, with optional arguments. go off, king.

---

🔥 EXIT STATUS 🔥

on success she returns the program's exit status — yes, she hands you the receipts from the program itself, not her own. but if she messes up, you get one of these:

1. 1 — Invalid usage. (you did something funky with the arguments, respectfully)
2. 127 — Error executing program.
3. 220 — Network-related error. 💀

---

🌈 EXAMPLES 🌈

Example numero uno — running the receiving side of the ploop copy command on a remote server, using openssh port forwarding. the way that ssh -L carries this whole operation… obsessed ✨

PORT=2345
ssh -L localhost:$PORT:localhost:$PORT $REMOTE_SERVER \
    vznnc -l -p $PORT -- ploop copy -d $FILE -i0 -o1

Example deux — same thing, same energy, but this time with stdin and stdout left intact, using file descriptor 5 for the communication. main character fd energy 🎀

ssh -L localhost:$PORT:localhost:$PORT $REMOTE_SERVER \
    vznnc -l -p $PORT -f 5 -- ploop copy -d $FILE -i5 -o5

---

🧚 SEE ALSO 🧚

• nc(3)
• netcat(3)
• socat(2)

the whole friend group, fr fr 🫶

---

👑 LICENSE 👑

Copyright (C) 2014, Parallels, Inc. Licensed under GNU GPL v2.

---

legal girlies stay winning, that's the whole license, no drama, just GPLv2 💜

---

okay bestie that's the whole page 💖 this is vznnc(8) from the Containers manual, brought to you by OpenVZ, dated 29 May 2014 — yeah she's a 2014 baby and she still eats. periodt. 💅✨