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

# roar\_get\_standby(3)

Get and set RoarAudio's sound servers standby state

## NAME

roar\_get\_standby, roar\_set\_standby - Get and set RoarAudio's sound servers standby state

## SYNOPSIS

\#include \<roaraudio.h\>

int roar\_get\_standby(struct roar\_connection \* con);

int roar\_set\_standby(struct roar\_connection \* con, int state);

## DESCRIPTION

Get or set the standby state of the server. If the server is in standby no audio is played. The audio device may be released depending on configuration.

## PARAMETERS

- **con**

  The connection to the server.

- **state**

  The new state. This may be **ROAR\_STANDBY\_ACTIVE** for standby to be set active or **ROAR\_STANDBY\_INACTIVE** for normal operating mode.

## RETURN VALUE

**roar\_get\_standby** returns **ROAR\_STANDBY\_ACTIVE**, **ROAR\_STANDBY\_INACTIVE** or -1 on error. **roar\_set\_standby** returns on success 0.  On error, -1 is returned.

## EXAMPLES

FIXME

## SEE ALSO

[**roar\_simple\_get\_standby**(3)](/roar_simple_get_standby/3.md), [**libroar**(7)](/libroar/7.md), [**RoarAudio**(7)](/RoarAudio/7.md).