---
name: "muroar_connect"
section: "3"
platform: "linux"
package: "libmuroar-dev"
version: "0.1.13-7"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/muroar_connect"
---

# muroar\_connect(3)

Opens a connection to a RoarAudio sound daemon

## 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

This function opens a connection to sound server supporting the RoarAudio protocol.

## PARAMETERS

- **server**

  The address of the server to connect to. May be set to NULL to connect to the default server.

- **name**

  **The name for the application.** **Should be set to some a string the user will recognize.** **For example use "OpenOffice Impress" not "soffice.bin" (process name).** **This can be set to NULL to use a generaic default string. However it is** **strongly recommended to set this to some useful string.**

## RETURN VALUE

**On success this call returns a file handle to a open connection.** **On error, MUROAR\_HANDLE\_INVALID is returned.**

## BUGS

**This function does currently not support DECnet (UNIX Sockets and IPv4 is supported).**

## HISTORY

**This function first appeared in muRoar version 0.1beta0.**

## SEE ALSO

[**muroar\_connect**(3)](/muroar_connect/3.md), [**muroar\_quit**(3)](/muroar_quit/3.md), [**RoarAudio**(7)](/RoarAudio/7.md).