roar_exit(3)

roar_exit3

Let roaraudio's sound server quit roar_terminate - let roaraudio's sound server quit as soon as all clients quit

Usage

#include <roaraudio.h>

int roar_exit(struct roar_connection * con);

int roar_terminate(struct roar_connection * con, int terminate);

Overview

Ask the sound server to quit.

roar_exit() let the server quit without waiting for any clients. All streams and client connections will be closed cleanly.

roar_terminate() will let the server quit as soon as all clients disconnects and all input streams ended. The listening socket will be closed. This is useful in case of restarting roard.

Parameters

con

An open control connection to the server.

terminate

Wait for all clients to disconnect and all streams to EOF in case of 1. In case of 0 roar_terminate() is equal to roar_exit().

Return value

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

Notes

Even when the call was successful you have to use roar_disconnect(3) to disconnect from the server.

Examples

FIXME

Releases

6 releases since Debian 6.0 (Squeeze); the text changed 2 times.

  1. 6.0
  2. 7–8
  3. 9–11

From libroar-dev 1.0~beta12-4 in Debian 11 (Bullseye). Parsed by carta from the page's man source.