yiff(8) Y sound system server

SYNTAX

yiff [config_file] [options]

DESCRIPTION

The YIFF sound server is a Y compliant sound server providing Y compliant client applications with sound support. Uses either OSS or ALSA sound drivers and follows OSS compliancy.

CONFIG FILE

The location of the config_file should be specified as the first argument. The default value is /etc/yiff/yiffrc.

OPTIONS

--device <device>
Specifies the digital signal processor (DSP) device. The default value is /dev/dsp.
--mixer <device>
Specifies the mixer device. The default value is /dev/dsp. Note that more than one non-Y compliant application can open the mixer in accordance with the OSS standard.
--mixer_rc <file>
Specifies alternate Y mixer settings file. The default is located in /var/state/yiff/mixer.
--port <port>
Specifies the port number to accept incoming connections on. This value overrides the value set in the config_file. The default value is 9433.
--path <path>
Adds a sound path to the Y server's list of sound paths (this option can be specified multiple times).
--foreground
Run in foreground, do not fork into background. The default behavour is to fork and run in the background.
--help
Prints help and exits.
--version
Prints version information and exits.

Note that host access lists are modified after the yiff server is running. Use yhost(1) to add or remove addresses to the Y server's host access list. It's helpful to include yhost(1) commands along with other startup commands in /etc/init.d/yiff (the Y server startup script).

FILES

/etc/yiff/yiffrc
/dev/dsp
/dev/mixer
/var/state/yiff/mixer

ENVIRONMENT VARIABLES

HOME
Specifies the user's home directory.

EXAMPLES

To run the YIFF sound server using the configuration file /usr/etc/yiffrc, type:

# /usr/sbin/yiff /usr/etc/yiffrc

It is more common to start the YIFF sound server by invoking the startup script (make sure it is written properly), type:

# /usr/sbin/starty

Note that yiff will automatically fork itself to run in the background so adding a & after the command is not needed. If you want yiff to run in the foreground, then type:

# /usr/sbin/yiff /usr/etc/yiffrc --foreground