---
name: "rplay.hosts"
section: "5"
platform: "linux"
package: "rplay-server"
version: "3.3.2-20"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rplay.hosts"
---

# rplay.hosts(5)

rplay host authentication database

## NAME

rplay.hosts - rplay host authentication database

## SYNOPSIS

**/usr/local/etc/rplay.hosts**

## DESCRIPTION

The *rplay.hosts* file contains a list of hosts and access permissions which *rplayd* uses to validate incoming connections.  Each line is of the form:

-

  hostname\[:permission\]

where

- **hostname**

  is the name of a remote host or a host's IP address. Wildcards can be used within IP addresses to match multiple hosts.  The wildcard character is "\*".

- **permission**

  is an optional field containing any combination of the following characters:

  - **r**

    the host can read sounds.

  - **w**

    the host can write sounds.

  - **x**

    the host can play, stop, pause, and continue sounds.  This is normally called execute permission.

  - **m**

    the host can monitor the audio stream written by rplayd to the audio device.

- "rx" permissions are used when no permissions are specified.

  ## EXAMPLE

```
#
# All hosts have read access:
#
*:r
#
# Trusted hosts:
#
nice-guy.sdsu.edu:rwx
friend.sdsu.edu:rwx
amigo.sdsu.edu:rwx
130.191.224.224:rwx
#
# Hosts which can read and execute:
#
foo.bar.com:rx
130.190.*:rx
146.244.234.*:rx
using.default.perms.edu
#
# Hosts which can monitor the audio stream
#
nsa.sdsu.edu:m
```

## FILES

**/usr/local/etc/rplay.hosts**

## SEE ALSO

**rplayd**(1)

## BUGS

The permissions for an "\*" entry apply to **all** matching hosts. The order of this file does not matter. Specific hosts can have access disabled with entries like:

```
bad.guy.edu:
```

however, any matching "\*" entries will still apply.