roar_stream_exec(3)

📦 version 1.0~beta12, in ubuntu jammy

💅 roar_stream_exec — a lil' guide from your fav Unix bestie

okay so bestie, we're in the RoarAudio section of the System Manager's Manual, and today's main character is roar_stream_exec(3). it's giving "make this stream the boss of everything" and honestly? iconic. let's get into it 🎀

✨ NAME ✨

roar_stream_exec — set a stream as the master stream of a client 👑

✨ SYNOPSIS ✨

#include <roaraudio.h>

int roar_stream_exec(struct roar_connection * con, struct roar_stream *
s);

like yes, that's the whole vibe. one function, two args, zero drama 🌸

✨ DESCRIPTION ✨

okay so here's the tea ☕ — this sets a stream to be the master stream of a client.

and what IS a master stream, you ask? it's a stream that gets sent via the client's control channel. lowkey important.

here's the part that's highkey serious though: if a master stream is closed, the client and all its streams are closed. not just one, not just some — all of them. the whole squad goes down together fr fr 💀

and it gets even more permanent than that:

Setting a master stream can not be undone. periodt. and no control commands can be sent anymore either. like, ever. it's over bestie 🫶

so yeah, once you do this, you're committed. no take-backs, no "wait actually—", nothing.

this is used mainly for opening a connection for just playback, when you don't need to change things later. exactly like how roar_simple_play(3) does it. so if that's your plan, you're in the right place ✨

✨ PARAMETERS ✨

  • con — the connection to the server. your lil' phone line to the RoarAudio server 📞
  • s — the stream that's about to be crowned master stream 👑

✨ RETURN VALUE ✨

  • on success, these calls return 0 — slay ✨
  • on error, -1 is returned — not slay 😭

✨ EXAMPLES ✨

FIXME

ngl bestie, the examples are literally just the word FIXME. that's it. that's the whole example section. the docs said "we'll do it later" and then simply never did 🙈 keeping it real.

✨ SEE ALSO ✨

go read those too, they're part of the family 🦋

and that's a wrap, bestie 💖 this lil' page came from the fine folks behind RoarAudio, dated May 2011, and it lives at roar_stream_exec(3). go forth and master-stream responsibly, mwah 💅✨

📦 where this page comes from