Lines Matching +full:- +full:- +full:option
1 <?xml version="1.0"?><!--*-nxml-*-->
3 <?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
5 <!--
11 License, or (at your option) any later version.
20 -->
22 <manpage name="pulse-daemon.conf" section="5" desc="PulseAudio daemon configuration file">
33 a configuration file on startup. If the per-user file
42 order. In case the same option is set in multiple files, the last file to
43 set an option overrides earlier files. The main daemon.conf file is
63 <option>
65 boolean value, defaults to <opt>no</opt>. The <opt>--daemonize</opt>
66 command line option takes precedence.</p>
67 </option>
69 <option>
72 fail. Takes a boolean argument, defaults to <opt>yes</opt>. The <opt>--fail</opt> command line
73 option takes precedence.</p>
74 </option>
76 <option>
77 <p><opt>allow-module-loading=</opt> Allow/disallow module
81 to disable this when <opt>system-instance</opt> is
83 hot-plug support will not work if this option is enabled. Takes
85 <opt>--disallow-module-loading</opt> command line option takes
87 </option>
89 <option>
90 <p><opt>allow-exit=</opt> Allow/disallow exit on user
92 </option>
94 <option>
95 <p><opt>resample-method=</opt> The resampling algorithm to
96 use. Use one of <opt>src-sinc-best-quality</opt>,
97 <opt>src-sinc-medium-quality</opt>, <opt>src-sinc-fastest</opt>,
98 <opt>src-zero-order-hold</opt>, <opt>src-linear</opt>,
99 <opt>trivial</opt>, <opt>speex-float-N</opt>,
100 <opt>speex-fixed-N</opt>, <opt>ffmpeg</opt>, <opt>soxr-mq</opt>,
101 <opt>soxr-hq</opt>, <opt>soxr-vhq</opt>. See the
103 different src- and speex- methods, respectively. The method
111 also offers slightly better quality. The soxr-family methods
119 See the output of <opt>dump-resample-methods</opt> for a complete list of all
120 available resamplers. Defaults to <opt>speex-float-1</opt>. The
121 <opt>--resample-method</opt> command line option takes precedence.
124 </option>
126 <option>
127 <p><opt>avoid-resampling=</opt> If set, try to configure the
133 </option>
135 <option>
136 <p><opt>enable-remixing=</opt> If disabled never upmix or
138 name-based matching only. Defaults to <opt>yes</opt>.
139 There is no known valid use case for setting this option to
140 <opt>no</opt>, therefore, this option is deprecated and may be
142 </option>
144 <option>
145 <p><opt>remixing-use-all-sink-channels=</opt> If enabled, use
150 </option>
152 <option>
153 <p><opt>enable-lfe-remixing=</opt> This is a way to set
154 <opt>remixing-produce-lfe</opt> and <opt>remixing-consume-lfe</opt>
155 to the same value at once. This option only exists for backward
157 </option>
159 <option>
160 <p><opt>remixing-produce-lfe=</opt> If enabled, and the sink input
162 as a (lowpass-filtered, if <opt>lfe-crossover-freq</opt> is not 0)
163 average of all input channels. Also, when <opt>lfe-crossover-freq</opt>
168 </option>
170 <option>
171 <p><opt>remixing-consume-lfe=</opt> If enabled, and the sink does not
175 </option>
177 <option>
178 <p><opt>lfe-crossover-freq=</opt> The crossover frequency (in Hz) for the
180 </option>
182 <option>
183 <p><opt>use-pid-file=</opt> Create a PID file in the runtime directory
185 use commands like <opt>--kill</opt> or <opt>--check</opt>. If
187 user, you better disable this option since it effectively
189 to <opt>yes</opt>. The <opt>--use-pid-file</opt> command line
190 option takes precedence.</p>
191 </option>
193 <option>
194 <p><opt>cpu-limit=</opt> If disabled do not install the CPU load
195 limiter, even on platforms where it is supported. This option is
198 <opt>no</opt>. The <opt>--no-cpu-limit</opt> command line
200 </option>
202 <option>
203 <p><opt>system-instance=</opt> Run the daemon as system-wide
205 defaults to <opt>no</opt>. The <opt>--system</opt> command line
207 </option>
209 <option>
210 <p><opt>local-server-type=</opt> Please don't use this option if
211 you don't have to! This option is currently only useful when you
212 want D-Bus clients to use a remote server. This option may be
214 in the system mode, use the <opt>system-instance</opt> option.
215 This option takes one of <opt>user</opt>, <opt>system</opt> or
217 for the <opt>system-instance</opt> option. The difference is the
218 <opt>none</opt> option, which is useful when you want to use a
219 remote server with D-Bus clients. If both this and
220 <opt>system-instance</opt> are defined, this option takes
221 precedence. Defaults to whatever the <opt>system-instance</opt>
223 </option>
225 <option>
226 <p><opt>enable-shm=</opt> Enable data transfer via POSIX
228 <opt>yes</opt>. The <opt>--disable-shm</opt> command line
230 </option>
232 <option>
233 <p><opt>enable-memfd=</opt>. Enable memfd shared memory. Takes
235 </option>
237 <option>
238 <p><opt>shm-size-bytes=</opt> Sets the shared memory segment
240 it will default to some system-specific default, usually 64
244 </option>
246 <option>
247 <p><opt>lock-memory=</opt> Locks the entire PulseAudio process
248 into memory. While this might increase drop-out safety when used
249 in conjunction with real-time scheduling this takes away a lot
252 </option>
254 <option>
255 <p><opt>flat-volumes=</opt> Enable 'flat' volumes, i.e. where
259 </option>
261 <option>
262 <p><opt>rescue-streams=</opt> Enable rescuing of streams if the
268 </option>
274 <option>
275 <p><opt>high-priority=</opt> Renice the daemon after startup to
276 become a high-priority process. This a good idea if you
277 experience drop-outs during playback. However, this is a certain
282 … information. Takes a boolean argument, defaults to <opt>yes</opt>. The <opt>--high-priority</opt>
283 command line option takes precedence.</p>
284 </option>
286 <option>
287 <p><opt>realtime-scheduling=</opt> Try to acquire SCHED_FIFO
293 real-time. The controlling thread is left a normally scheduled
294 thread. Thus enabling the high-priority option is orthogonal.
297 <opt>--realtime</opt> command line option takes precedence.</p>
298 </option>
300 <option>
301 <p><opt>realtime-priority=</opt> The realtime priority to
302 acquire, if <opt>realtime-scheduling</opt> is enabled. Note: JACK uses 10
304 PulseAudio real-time priorities lower. Some PulseAudio threads
307 </option>
309 <option>
310 <p><opt>nice-level=</opt> The nice level to acquire for the
311 daemon, if <opt>high-priority</opt> is enabled. Note: on some
312 distributions X11 uses -10 by default. Defaults to -11.</p>
313 </option>
319 <option>
320 <p><opt>exit-idle-time=</opt> Terminate the daemon after the
322 disable this feature. Defaults to 20. The <opt>--exit-idle-time</opt>
323 command line option takes precedence.</p>
325 <p>When PulseAudio runs in the per-user mode and detects a login
334 disabled, so this option does nothing.</p>
335 </option>
337 <option>
338 <p><opt>scache-idle-time=</opt> Unload autoloaded sample cache
340 20. The <opt>--scache-idle-time</opt> command line option takes
342 </option>
348 <option>
349 <p><opt>dl-search-path=</opt> The path where to look for dynamic
352 time settings. The <opt>--dl-search-path</opt> command line
353 option takes precedence. </p>
354 </option>
356 <option>
357 <p><opt>default-script-file=</opt> The default configuration
362 <file>@PA_DEFAULT_CONFIG_DIR@/default.pa</file>. If run in system-wide
364 instead. If <opt>-n</opt> is passed on the command line
365 or <opt>default-script-file=</opt> is disabled the default
367 </option>
369 <option>
370 <p><opt>load-default-script-file=</opt> Load the default
372 in <opt>default-script-file=</opt>. Defaults to <opt>yes</opt>.</p>
373 </option>
379 <option>
380 <p><opt>log-target=</opt> The default log target. Use either
383 systems <opt>auto</opt> is equivalent to <opt>syslog</opt>. On systemd-enabled
390 <opt>--log-target</opt> command line option takes precedence.</p>
391 </option>
393 <option>
394 <p><opt>log-level=</opt> Log level, one of <opt>debug</opt>,
398 <opt>notice</opt>. The <opt>--log-level</opt> command line
399 option takes precedence. The <opt>-v</opt> command line option
401 </option>
403 <option>
404 <p><opt>log-meta=</opt> With each logged message log the code
407 </option>
409 <option>
410 <p><opt>log-time=</opt> With each logged message log the
412 </option>
414 <option>
415 <p><opt>log-backtrace=</opt> When greater than 0, with each
418 </option>
425 more information. Set to -1 if PulseAudio shall not touch the resource
429 <option>
430 <p><opt>rlimit-as</opt> Defaults to -1.</p>
431 </option>
432 <option>
433 <p><opt>rlimit-rss</opt> Defaults to -1.</p>
434 </option>
435 <option>
436 <p><opt>rlimit-core</opt> Defaults to -1.</p>
437 </option>
438 <option>
439 <p><opt>rlimit-data</opt> Defaults to -1.</p>
440 </option>
441 <option>
442 <p><opt>rlimit-fsize</opt> Defaults to -1.</p>
443 </option>
444 <option>
445 <p><opt>rlimit-nofile</opt> Defaults to 256.</p>
446 </option>
447 <option>
448 <p><opt>rlimit-stack</opt> Defaults to -1.</p>
449 </option>
450 <option>
451 <p><opt>rlimit-nproc</opt> Defaults to -1.</p>
452 </option>
453 <option>
454 <p><opt>rlimit-locks</opt> Defaults to -1.</p>
455 </option>
456 <option>
457 <p><opt>rlimit-sigpending</opt> Defaults to -1.</p>
458 </option>
459 <option>
460 <p><opt>rlimit-msgqueue</opt> Defaults to -1.</p>
461 </option>
462 <option>
463 <p><opt>rlimit-memlock</opt> Defaults to 16 KiB. Please note
466 </option>
467 <option>
468 <p><opt>rlimit-nice</opt> Defaults to 31. Please make sure that
469 the default nice level as configured with <opt>nice-level</opt>
470 fits in this resource limit, if <opt>high-priority</opt> is
472 </option>
473 <option>
474 <p><opt>rlimit-rtprio</opt> Defaults to 9. Please make sure that
475 the default real-time priority level as configured with
476 <opt>realtime-priority=</opt> fits in this resource limit, if
477 <opt>realtime-scheduling</opt> is enabled. The JACK client
478 libraries require a real-time priority of 9 by default.</p>
479 </option>
480 <option>
481 <p><opt>rlimit-rttime</opt> Defaults to 1000000.</p>
482 </option>
492 <option>
493 <p><opt>default-sample-format=</opt> The default sampling
497 </option>
499 <option>
500 <p><opt>default-sample-rate=</opt> The default sample frequency.</p>
501 </option>
503 <option>
504 <p><opt>default-sample-channels</opt> The default number of channels.</p>
505 </option>
507 <option>
508 <p><opt>default-channel-map</opt> The default channel map.</p>
509 </option>
511 <option>
512 <p><opt>alternate-sample-rate</opt> The alternate sample
514 default-sample-rate value or this alternate value, typically 44.1
516 enabled only when the sinks/sources are suspended. This option
520 </option>
531 setting supported. Modern drivers that support timer-based
534 <option>
535 <p><opt>default-fragments=</opt> The default number of
537 </option>
538 <option>
539 <p><opt>default-fragment-size-msec=</opt>The duration of a
542 </option>
559 <option>
560 <p><opt>enable-deferred-volume=</opt> Enable deferred volume for the sinks that
562 </option>
563 <option>
564 <p><opt>deferred-volume-safety-margin-usec=</opt> The amount of time (in
567 </option>
568 <option>
569 <p><opt>deferred-volume-extra-delay-usec=</opt> The amount of time (in usec)
572 </option>
582 …<manref name="pulse-client.conf" section="5"/>, <manref name="default.pa" section="5"/>, <manref n…