muroar_connect(3)

📦 version 0.1.13, in ubuntu jammy

💖 muroar_connect(3) 💖

okay bestie, welcome to the muRoar Programmer's Manual — this is the page for muroar_connect(3) and it's literally the front door to the RoarAudio sound daemon. let's get into it 🫶

✨ NAME ✨

muroar_connect — Opens a connection to a RoarAudio sound daemon

🌸 SYNOPSIS 🌸

#include <muroar.h>

muroar_t muroar_connect(const char * server, const char * name);

🦋 DESCRIPTION 🦋

so basically this function opens up a connection to a sound server that speaks the RoarAudio protocol. that's it, that's the whole vibe — you call it, you get a connection. iconic. 👑

🎀 PARAMETERS 🎀

  • server — the address of the server you wanna connect to. you can set it to NULL and it'll just connect to the default server instead. lazy girlie behavior, but valid. 💅
  • name — the name of your application. this one should be a string the user will actually recognize, okay? like, think "OpenOffice Impress" and not "soffice.bin" (that's the process name, bestie, nobody knows what that is 😭). you can set this to NULL to get some generic default string, but honestly? strongly recommended that you pass something useful here. don't be shy, name your app. ✨

💜 RETURN VALUE 💜

on success, this call hands you back a file handle to an open connection. slay. 🎉

on error? you get MUROAR_HANDLE_INVALID back instead. not slay. 💀

🙈 BUGS 🙈

ngl, this function does not currently support DECnet — UNIX Sockets and IPv4 are the ones that work. periodt.

⭐ HISTORY ⭐

this function first appeared in muRoar version 0.1beta0. a legend from the very start, fr fr. 👑

🌈 SEE ALSO 🌈

muRoar 🎀 April 2012 💖 that's the whole page bestie, go forth and connect — ily, bye!! 🦋✨

📦 where this page comes from