roarmonhttp(1)

📦 version 1.0~beta12, in ubuntu jammy

💖 roarmonhttp — the manual page, bestie edition 💖

okay so you found roarmonhttp(1) in the System User's Manual and you're like "what is this little creature" — don't worry, I got you. grab a strawberry 🍓 and let's go.

✨ NAME ✨

roarmonhttp — CGI and inetd based streaming server emulation for RoarAudio 🦋

like, it cosplays as a streaming server. for RoarAudio. that's the whole vibe.

✨ SYNOPSIS ✨

roarmonhttp [--inetd]

that's it. that's the whole invocation. one optional flag and she's ready 💅

✨ DESCRIPTION ✨

okay so here's the tea ☕ — this program emulates a streaming server using RoarAudio. that's the entire personality.

she can be run either:

  • from a webserver as CGI, or
  • via inetd in inetd mode.

and the modes are NOT equal, bestie, so listen up:

In CGI mode it is limited to client (listener) HTTP connections. that's it. that's the ceiling. 😭
In inetd mode it can handle source clients and gopher, too. main character energy fr fr 👑

and here's the cute part — there is no need for a specal port for gopher. (yes, the original says "specal". we keep it. character for character. iconic typo, no notes 💀) The protocol is detected per client at runtime. so she just knows. iykyk ✨

✨ OPTIONS ✨

  • --inetd — Enables inetd mode. 🎀
  • --server SERVER — Set Server to connect to. This may be usfull in inetd mode. (again — original spelling, we preserve the artifacts, it's a museum 🏛️)
  • --rate, --bits, --channels, --codec — Sets the default rate, bits, channels or codec. Those option taking a argument for the given option. Codec names may be used. 🎵
  • --rel-id SID — Set the stream ID for the stream this stream is relative to. (stream-ception, we love her 🌈)
  • --help — Show a brief help. 🫶

✨ EXAMPLES ✨

Here is an example of a roarmonhttp listening on port 8000 using inetd:

8000 stream tcp nowait roard /usr/bin/roarmonhttp roarmonhttp --inetd

look at her go. port 8000, tcp, nowait, user roard, full path, and --inetd at the end like a little bow 🎀 ate and left no crumbs.

✨ SEE ALSO ✨

go read them. for me. 🥺

✨ HISTORY ✨

For history information see RoarAudio(7). 📜

sign-off time 🌸

this whole thing came from RoarAudio, dated January 2010, and it's roarmonhttp(1) all the way through. vintage but still serving looks 💜 no cap.

k bye, go stream something 🦋✨

📦 where this page comes from