carta
roar_connectionref(3)

roar_connectionref3

Change reference counter for roaraudio connections

Usage

int roar_connectionref(struct roar_connection * con);

int roar_connectionunref(struct roar_connection * con);

Overview

Those functions change the reference counter for connection objects previously opend via roar_connect(3), roar_connect_fh(3) or roar_simple_connect(3). If the reference counter hints zero the connection is closed and the object is destroyed.

The roar_disconnect(3) macro is provided to be source compatible (recompile needed) with RoarAudio 0.4 or older.

Parameters

con

The connection to be altered.

Return value

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

Examples

FIXME

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