Daemon

Command Line Arguments

The polypaudio daemon accepts several command line arguments:

-r: Set low nice value (high priority) and SCHED_FIFO scheduling if available. Works only when started as root or SUID root.

-R: Don't drop root rights if started SUID root.

-L MODULE: Load the specified module. This option may be specified more than once.

-F FILE: Run the specified script. This option may be specified more than once.

-C: Load the module module-cli after startup.

-n: Don't load the default configuration file. Normally ~/.polypaudio or /etc/polyp/polypaudio.pa are loaded on startup.

-D: Daemonize after successfully executing all scripts and loading all modules.

-d: Disallow module load and unload after startup.

-f: Unless this option is given the daemon will terminate if any of the specified modules failed to load or the script didn't execute successfully.

-v: Increase the verbosity of the daemon.

-X SECS: Terminate the daemon after the last client exited an SECS seconds passed.

-h: Show a quick help.

-l TARGET: Specify the log target (syslog, stderr, auto). Defaults to auto, which means stderr when run without -D and syslog when run with -D.

-V: Show version.

Example

It is a good idea to run the daemon like this:

polypaudio -rD

This will run /etc/polypaudio/polypaudio.pa after startup. This should be a script written in the CLI language described in cli.html.

Signals

The following signals are trapped specially:

SIGINT

The daemon is shut down cleanly.

SIGUSR1

The daemon tries to load the module module-cli, effectively providing a command line interface on the calling TTY.

SIGUSR2

The daemon tries to load the module module-cli-protocol-unix, effectively providing a command line interface on a special UNIX domain socket.


Lennart Poettering <@PACKAGE_BUGREPORT@>, September 2004
$Id$