2004-07-17 14:06:13 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								<?xml version="1.0" encoding="iso-8859-1"?>  <!--   - * - html - helper - * -   -->  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< html  xmlns = "http://www.w3.org/1999/xhtml" >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< head >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< title > polypaudio: Daemon< / title >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< link  rel = "stylesheet"  type = "text/css"  href = "style.css"  / >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< / head >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< body >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< h1 > Daemon< / h1 >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< h2 > Command Line Arguments< / h2 >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								The < tt > polypaudio< / tt >  daemon accepts several command line arguments:
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2004-09-20 20:52:35 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								< pre >  
						 
					
						
							
								
									
										
										
										
											2004-11-21 22:07:47 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								COMMANDS:
							 
						 
					
						
							
								
									
										
										
										
											2004-09-20 20:52:35 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								  -h, --help                            Show this help
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								      --version                         Show version
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								      --dump-conf                       Dump default configuration
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								      --dump-modules                    Dump list of available modules
							 
						 
					
						
							
								
									
										
										
										
											2004-11-21 22:07:47 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								  -k  --kill                            Kill a running daemon
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								      --check                           Check for a running daemon
							 
						 
					
						
							
								
									
										
										
										
											2004-09-20 20:52:35 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2004-11-21 22:07:47 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								OPTIONS:
							 
						 
					
						
							
								
									
										
										
										
											2004-09-20 20:52:35 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								  -D, --daemonize[=BOOL]                Daemonize after startup
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								      --fail[=BOOL]                     Quit when startup fails
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								      --verbose[=BOOL]                  Be slightly more verbose
							 
						 
					
						
							
								
									
										
										
										
											2004-11-21 22:07:47 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								      --high-priority[=BOOL]            Try to set high process priority
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								                                        (only available as root)
							 
						 
					
						
							
								
									
										
										
										
											2004-09-20 20:52:35 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								      --disallow-module-loading[=BOOL]  Disallow module loading after startup
							 
						 
					
						
							
								
									
										
										
										
											2004-11-21 22:07:47 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								      --exit-idle-time=SECS             Terminate the daemon when idle and this
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								                                        time passed
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								      --module-idle-time=SECS           Unload autoloaded modules when idle and
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								                                        this time passed
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								      --scache-idle-time=SECS           Unload autoloaded samples when idle and
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								                                        this time passed
							 
						 
					
						
							
								
									
										
										
										
											2004-09-20 20:52:35 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								      --log-target={auto,syslog,stderr} Specify the log target
							 
						 
					
						
							
								
									
										
										
										
											2004-11-21 22:07:47 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								  -p, --dl-search-path=PATH             Set the search path for dynamic shared
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								                                        objects (plugins)
							 
						 
					
						
							
								
									
										
										
										
											2004-09-20 20:52:35 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								      --resample-method=[METHOD]        Use the specified resampling method
							 
						 
					
						
							
								
									
										
										
										
											2004-11-21 22:07:47 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								                                        (one of src-sinc-medium-quality,
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								                                        src-sinc-best-quality,src-sinc-fastest
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								                                        src-zero-order-hold,src-linear,trivial)
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								      --use-pid-file[=BOOL]             Create a PID file
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								STARTUP SCRIPT:
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								  -L, --load="MODULE ARGUMENTS"         Load the specified plugin module with
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								                                        the specified argument
							 
						 
					
						
							
								
									
										
										
										
											2004-09-20 20:52:35 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								  -F, --file=FILENAME                   Run the specified script
							 
						 
					
						
							
								
									
										
										
										
											2004-11-21 22:07:47 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								  -C                                    Open a command line on the running TTY
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								                                        after startup
							 
						 
					
						
							
								
									
										
										
										
											2004-09-20 20:52:35 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								  -n                                    Don't load default script file
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< / pre >  
						 
					
						
							
								
									
										
										
										
											2004-07-17 14:06:13 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< h3 > Example< / h3 >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< p > It is a good idea to run the daemon like this:< / p >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2004-09-20 20:52:35 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								< pre > polypaudio -D< / pre >  
						 
					
						
							
								
									
										
										
										
											2004-07-17 14:06:13 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2004-09-20 20:52:35 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								< p > This will run < tt > /etc/polypaudio/default.pa< / tt >  after startup. This should be a script written in the CLI language described in < a  href = "cli.html" > cli.html< / a > . < / p >  
						 
					
						
							
								
									
										
										
										
											2004-07-17 14:06:13 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< h2 > Signals< / h2 >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< p > The following signals are trapped specially:< / p >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< h3 > SIGINT< / h3 >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< p > The daemon is shut down cleanly.< / p >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< h3 > SIGUSR1< / h3 >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< p > The daemon tries to load the module < a  href = "modules.html#module-cli" > < tt > module-cli< / tt > < / a > , effectively providing a command line interface on the calling TTY.< / p >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< h3 > SIGUSR2< / h3 >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< p > The daemon tries to load the module < a  href = "modules.html#module-cli-protocol-unix" > < tt > module-cli-protocol-unix< / tt > < / a > , effectively providing a command line interface on a special UNIX domain socket.< / p >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2004-10-27 22:43:36 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								< h3 > SIGHUP< / h3 >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< p > The daemon logs the current server layout.< / p >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								
							 
						 
					
						
							
								
									
										
										
										
											2004-07-17 14:06:13 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								< hr / >  
						 
					
						
							
								
									
										
										
										
											2004-11-21 22:07:47 +00:00 
										
									 
								 
							 
							
								
									
										 
								
							 
							
								 
							
							
								< address  class = "grey" > Lennart Poettering < @PACKAGE_BUGREPORT@> , November 2004< / address >  
						 
					
						
							
								
									
										
										
										
											2004-07-17 14:06:13 +00:00 
										
									 
								 
							 
							
								
							 
							
								 
							
							
								< div  class = "grey" > < i > $Id$< / i > < / div >  
						 
					
						
							
								
							 
							
								
							 
							
								 
							
							
								< / body >  < / html >