Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
RPLAYD(8)		    System Manager's Manual		     RPLAYD(8)

       rplayd -	rplay sound server

       rplayd [options]

       rplayd is the sound server for the rplay	audio system.  The server lis-
       tens 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 de-
       vice 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:

	   G.721 4-bit,	G.723 3-bit, G.723 5-bit

       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  di-
       rectly  from CDROM using	CDDA.  The special sound name cdrom: will play
       the entire CDROM.  cdrom:3-5 will play tracks 3 through 5.

       -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.

	      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 time-

	      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  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

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

	      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).

	      Remove the cache directory and all its contents when rplayd  ex-

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

       --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.

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

       -d, --debug
	      Enable debug mode.

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

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

	      Run with GROUP privs. (audio)

       --help Display helpful information.

	      Use FILE for rplay.helpers.

       -H FILE,	--hosts=FILE
	      Use FILE for rplay.hosts.

	      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.

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

	      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.

	      Disable host access authentication.

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

	      Disable backgrounding rplayd at startup. (enabled)

	      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)

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

       -S FILE,	--servers=FILE
	      Use FILE for rplay.servers.

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

	      Run with USER privs. (nobody)

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


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

				    6/29/98			     RPLAYD(8)


Want to link to this manual page? Use this URL:

home | help