RPLAY.HOSTS(5)

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.