INOUT(1)

🎀 INOUT(1) — User Commands, but make it a group chat 🎀

okay bestie, this is the inout manual page — the INOUT(1) one, from the User Commands section. she’s here to swap file handles and run your command, and she ate. 💅

🌸 NAME 🌸

inout — replace stdin, stdout, stderr and then run a command. 💖

✨ SYNOPSIS ✨

inout    newin newout        command [arg...]

inouterr newin newout newerr command [arg...]

💖 DESCRIPTION 💖

okay so the command inout(1) — which may alternatively be installed as arpa2inout or a2inout — replaces its stdin and stdout file handles with the ones described by newin and newout respectively, and then uses exec(3) to run command arg.... slay. 🫶

the name may actually be aliased to hold a mixture of the substrings in, out, and err to replace the respective standard file handle with a newxxx handle. replacement will always be in this order, and it is advised to retain that order in the filename, by way of suggestion. iykyk. 🦋

🦋 NEW HANDLES 🦋

the redirection notations that may be used for newin, newout, and newerr vary on the basis of their first character, bestie:

• - — the file handle is left unchanged. literally untouched. ✨
• /path/to/file — the file is opened readonly in newin or otherwise writeonly. in the latter case, any prior content will be overwritten. 💀
• (empty) — the empty string produces no input to newin and quietly drops anything sent to it from newout or newerr; it works like /dev/null. 🙈
• :port — the port number is opened as a TCP socket on the ::1 host. the socket is a client in newin and a server in the others, so an output stream will be blocked until it is being read. this means that some degree of concurrency may be required — plan accordingly. 🔥

👑 AUTHOR 👑

Written by Rick van Rein of OpenFortress.nl, for the ARPA2.net project. 💜

🐛 REPORTING BUGS 🐛

for any discussion, including about bugs, please use the https://gitlab.com/arpa2/arpa2common/ project page for ARPA2 Common. we use its issue tracker to track bugs and feature requests. 🫶

💜 COPYRIGHT 💜

Copyright © 2024 Rick van Rein, ARPA2.net. 🎀

ARPA2 is funded from InternetWide.org, which in turn receives funding from various sources. Part of this work was funded through a grant of SIDNfonds, a public interest fund geared towards a better Internet for all, and paid by administration fees for .nl domain names. Other parts were funded by NLnet, a public interest fund geared towwards open source excellence, and by the NGI Pointer fund of the European Union.

🌈 SEE ALSO 🌈

ARPA2 Common is documented on http://common.arpa2.net/ and its code is on https://gitlab.com/arpa2/arpa2common/ — go peek, bestie. 🦋

---

that’s the whole page, bestie! 💅 source/version and date tea: ARPA2.net, September 2024, page INOUT(1). mwah 🫶✨