---
name: "roar_stream_exec"
section: "3"
platform: "linux"
package: "libroar-dev"
version: "1.0~beta12-4"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/roar_stream_exec"
---

# roar\_stream\_exec(3)

Set a stream as master stream of a client

## NAME

roar\_stream\_exec - Set a stream as master stream of a client

## SYNOPSIS

\#include \<roaraudio.h\>

int roar\_stream\_exec(struct roar\_connection \* con, struct roar\_stream \* s);

## DESCRIPTION

This sets a stream to be the master stream of a client. A master stream is a stream send via the client's control channel. If a master stream is closed the client and all it's streams are closed. Setting a master stream can not be undone nor can any control commands be send anymore. This is used mainly for opening a connection for just playback without need to change things later like [**roar\_simple\_play**(3)](/roar_simple_play/3.md) does it.

## PARAMETERS

- **con**

  The connection to the server.

- **s**

  The stream to be set as master stream.

## RETURN VALUE

On success these calls return 0.  On error, -1 is returned.

## EXAMPLES

FIXME

## SEE ALSO

[**roar\_simple\_play**(3)](/roar_simple_play/3.md), [**libroar**(7)](/libroar/7.md), [**RoarAudio**(7)](/RoarAudio/7.md).