AuOpenServer(3)

✨ AuOpenServer ✨

okay bestie so this one's from the audiolib manual (section 3, library functions, we love a classic) and it's literally the "hey let's go meet the audio server" function 💖 connecting, bestie, it's giving first-day-of-school energy.

🌸 NAME 🌸

AuOpenServer — connect to audio server 🎧✨

🦋 SYNOPSIS 🦋

#include <audio/audiolib.h>

AuServer *AuOpenServer(servername, num_authproto, authproto,
num_authdata, authdata, ret_status)
    char *servername;
    int num_authproto;
    char *authproto;
    int num_authdata;
    char *authdata;
    char **return_status; /* RETURN */

🎀 ARGUMENTS 🎀

• servername — the audio server name, periodt. This is the thing that decides which server you're hitting up and which communications domain gets used. lowkey the main character of these args 💅
• num_authproto — the length of the connection authorization protocol name. just the number, bestie, not the name itself 🔢
• authproto — the actual name of the connection authorization protocol.
• num_authdata — the length of the connection authorization data.
• authdata — the connection authorization data itself.
• return_status — if this is non-NULL and the connection gets refused, it hands you back an error message. it's marked /* RETURN */ in the synopsis, so it's a little output channel, not an input 🌈

💜 DESCRIPTION 💜

So AuOpenServer creates a connection to the audio server you specified, and returns a pointer to an AuServer structure — OR NULL 😭 — and if it returns NULL and return_status is non-NULL, then return_status points at an error message telling you why it wasn't successful. rude but helpful, honestly.

Now the servername lore, because this part is lowkey iconic:

• If servername is NULL, or it's a pointer to NUL — a pointer to a NUL, not a NUL pointer, bestie, they are NOT the same thing 🙈 — then AuOpenServer pulls the value from the environment.
• servername has the format hostname:port or hostname::port. yes the colons matter. the colon count is the whole plot twist ✨
• If a double colon (::) separates the hostname and port number, AuOpenServer connects using DECnet streams. double colon, double commitment 🫶
• If a single colon (:) separates them, and the hostname is a host machine name, then AuOpenServer connects using TCP streams. classic, reliable, we stan.
• If a single colon (:) separates them, and the hostname is "unix", then AuOpenServer connects using UNIX domain sockets (or Streams). local girlie behavior, love that for you 🍓
• If the hostname is not specified at all, AuOpenServer uses whatever it believes is the fastest transport. it just picks. it has opinions. trust it 💅

ngl bestie the transport decision is genuinely doing a lot of vibes-based reasoning here, but that's what the manpage says so that's what we're saying ✨

👑 SEE ALSO 👑

• AuCloseServer
• AuServerName
• audiolib — Network Audio System C Language Interface

okay and the lil sign-off: this page is from audiolib (housekeeping section, we love a tidy legend 💖), version 1.9.4, and it's dated alongside AuOpenServer(3). go connect to something, bestie, you got this 🌟💅