Provided by: rplay-server_3.3.2-17build1_amd64 bug

NAME

       rplayd - rplay sound server

SYNOPSIS

       rplayd [options]

DESCRIPTION

       rplayd is the sound server for the rplay audio system.  The server listens for requests to
       play, pause, continue, and stop sounds using both the RPLAY and RPTP protocols.   Normally
       RPLAY requests are received on port 5555/udp and RPTP on 5556/tcp.  (Older ports 55555/udp
       and 55556/tcp  are  also  supported)   Access  to  the  server  is  restricted  using  the
       rplay.hosts file.

       rplayd  can  be started during the system boot process, via inetd, or by individual users.
       root access may be required depending on audio device permissions.

       In most causes rplayd will play sounds that are available on  the  local  disk.   However,
       rplayd  can  be  sent  sounds via the network and rplayd can also contact other rplayds to
       share sound files.  The index of all the local sound files is  stored  in  rplay.conf  and
       remote rplayds are specified in rplay.servers.  Sounds received from other rplayds will be
       stored in a cache directory normally located  in  /tmp/.rplay-cache.   Cache  entries  are
       expired on an LRU basis.

       Many sound file formats are supported by rplayd.  These include:

           AU AIFF WAV VOC UB UL
           G.721 4-bit, G.723 3-bit, G.723 5-bit
           GSM

       Other  formats can be played using external helper applications which convert unknown file
       formats to CD quality data which can then be played by rplayd.  See rplay.helpers(5)

       Several sounds can be played at once and sounds can be played at any sample rate.   rplayd
       can be configured to output many different formats using the various --audio options.

       On  some  systems,  namely  Solaris  and Linux, rplayd can read sounds directly from CDROM
       using CDDA.  The special sound name cdrom: will play the  entire  CDROM.   cdrom:3-5  will
       play tracks 3 through 5.

OPTIONS

       -A DEVICE, --audio-device=DEVICE
              Use DEVICE for the audio device (/dev/dsp).

       -B N, --audio-bits=N
              Audio device bits per sample, 8 or 16.

       --audio-channels=N
              Number of audio channels to use, 1 == mono, 2 == stereo.

       -c N, --audio-close=N
              Close /dev/dsp after N idle seconds, disabled with 0 (5).

       -F N, --audio_flush=N
              Flush  /dev/dsp  after  N  idle seconds, disabled with 0 (-1).  N = -1 : flush when
              spool is empty.  N = -2 : flush after each audio write. (not recommended) N  should
              be <= to the audio close timeout.

       --audio-format=FORMAT
              Tell  rplayd  to write audio data using FORMAT, where FORMAT can be ulaw, linear-8,
              ulinear-8, linear-16, or ulinear-16.  (linear = signed, ulinear = unsigned)

       --audio-fragsize=N
              Audio fragment size (0).  The default size is zero which lets the audio driver pick
              the  "best"  size.   The  size  specified  must  be  a  power of 2 greater than 16.
              Example:  256, 1024, 4096.

       --audio-info=INFO, --info=INFO, -i INFO
              Specify complete audio device information with one option.  INFO is  of  the  form:
              format,sample-rate,bits,channels        Examples:        `ulaw,8000,8,1'        and
              `linear-16,44100,16,2' Also provided are:
                  --audio-info-ulaw, --info-ulaw -> ulaw,8000,8,1

       --audio-match
              Attempt to match the sample rate of the audio device with the sample  rate  of  the
              current   sound   when   no   other  sounds  are  playing.   If  the  match  fails,
              --audio-sample-rate is used.  This option overrides --audio-bufsize.

       --audio-port=PORT[,PORT...]
              Output  audio  to  the  specified  audio  port(s).   Valid  ports  are   `speaker',
              `headphone',    and   `lineout'.    Multiple   ports   can   be   specified   using
              `speaker,headphone,lineout'

       -r N, --audio-rate=N
              Write the audio buffer N times per second (0).

       -R N, --audio-sample-rate=N
              Sample rate of the audio device.

       --auth Enable host access authentication.

       -D DIR, --cache-directory=DIR
              Use DIR for rplay.cache (/tmp/.rplay-cache).

       --cache-remove
              Remove the cache directory and all its contents when rplayd exists.

       -s N, --cache-size=N
              Maximum size in bytes of the rplay cache, disabled with 0 (8388608).

       --cdrom0=DEVICE, --cdrom1=DEVICE, --cdrom2=DEVICE, --cdrom3=DEVICE
              Specify the cdrom[0-3] to DEVICE mapping.  For Solaris 2.x the default  mapping  is
              cdrom[0-3]    ->    /vol/dev/aliases/cdrom[0-3].     Linux   uses   cdrom[0-3]   ->
              /dev/cdrom[0-3].

       -C FILE, --conf=FILE
              Use FILE for rplay.conf (/etc/rplay/rplay.conf).

       -T N, --connection-timeout=N
              Close idle RPTP connections after N seconds, disabled with 0 (300).

       -d, --debug
              Enable debug mode.

       -f HOST, --forward=HOST
              Forward all RPLAY packets to HOST.

       --fork Enable backgrounding rplayd at startup. (enabled)

       --group=GROUP
              Run with GROUP privs. (audio)

       --help Display helpful information.

       --helpers=FILE
              Use FILE for rplay.helpers (/etc/rplay/rplay.helpers).

       -H FILE, --hosts=FILE
              Use FILE for rplay.hosts (/etc/rplay/rplay.hosts).

       --inetd
              Enable inetd mode. (disabled)

       -L FILE, --log-file=FILE
              Use file for rplay.log (/tmp/rplay.log).

       -l N, --log-level=N
              Use logging level N where 0 <= n <= 4.

       --memory-cache-size=N
              Maximum size in bytes of the memory cache, disable caching with 0 (4194304).

       --memory-cache-sound-size=N
              Maximum size in bytes of a sound that can be cached in memory.  A value of 0  means
              to try and cache all sounds. (2097152)

       -N, --no-audio
              Disable audio, RPTP file server mode.

       --no-auth
              Disable host access authentication.

       -n, --no-inetd
              Disable inetd mode. (disabled)

       --no-fork
              Disable backgrounding rplayd at startup. (enabled)

       --options-file=FILE
              Read rplayd options from FILE.

       --port=PORT, --rplay-port=PORT
              Use PORT as the RPLAY/UDP port. (5555) (--other-rplay-port may also be available)

       --rptp-port=PORT
              Use PORT as the RPTP/TCP port. (5556) (--other-rptp-port may also be available)

       -S FILE, --servers=FILE
              Use FILE for rplay.servers (/etc/rplay/rplay.servers).

       -t N, --timeout=N
              Exit after N idle seconds, disabled with 0 (0).

       --user=USER
              Run with USER privs. (nobody)

       -v, --version
              Print the rplay version and exit.

FILES

       ~/.rplaydrc
       /tmp/.rplay-cache
       /usr/local/etc/rplay.conf
       /usr/local/etc/rplay.helpers
       /usr/local/etc/rplay.hosts
       /usr/local/etc/rplay.servers

SEE ALSO

       rplay.conf(5), rplay.helpers(5), rplay.hosts(5), rplay.servers(5), rplay(1), rptp(1)

                                             6/29/98                                    RPLAYD(8)