OS Manuals

/usr/bin/pulseaudio

featureful, general-purpose sound server

From pulseaudio 17.0-r13 (os), captured 2026-11-05 by running pulseaudio --help (exit 0). permalink

pulseaudio [options]

COMMANDS:
  -h, --help                            Show this help
      --version                         Show version
      --dump-conf                       Dump default configuration
      --dump-modules                    Dump list of available modules
      --dump-resample-methods           Dump available resample methods
      --cleanup-shm                     Cleanup stale shared memory segments
      --start                           Start the daemon if it is not running
  -k  --kill                            Kill a running daemon
      --check                           Check for a running daemon (only returns exit code)

OPTIONS:
      --system[=BOOL]                   Run as system-wide instance
  -D, --daemonize[=BOOL]                Daemonize after startup
      --fail[=BOOL]                     Quit when startup fails
      --high-priority[=BOOL]            Try to set high nice level
                                        (only available as root, when SUID or
                                        with elevated RLIMIT_NICE)
      --realtime[=BOOL]                 Try to enable realtime scheduling
                                        (only available as root, when SUID or
                                        with elevated RLIMIT_RTPRIO)
      --disallow-module-loading[=BOOL]  Disallow user requested module
                                        loading/unloading after startup
      --disallow-exit[=BOOL]            Disallow user requested exit
      --exit-idle-time=SECS             Terminate the daemon when idle and this
                                        time passed
      --scache-idle-time=SECS           Unload autoloaded samples when idle and
                                        this time passed
      --log-level[=LEVEL]               Increase or set verbosity level
  -v  --verbose                         Increase the verbosity level
      --log-target={auto,syslog,stderr,file:PATH,newfile:PATH}
                                        Specify the log target
      --log-meta[=BOOL]                 Include code location in log messages
      --log-time[=BOOL]                 Include timestamps in log messages
      --log-backtrace=FRAMES            Include a backtrace in log messages
  -p, --dl-search-path=PATH             Set the search path for dynamic shared
                                        objects (plugins)
      --resample-method=METHOD          Use the specified resampling method
                                        (See --dump-resample-methods for
                                        possible values)
      --use-pid-file[=BOOL]             Create a PID file
      --no-cpu-limit[=BOOL]             Do not install CPU load limiter on
                                        platforms that support it.
      --disable-shm[=BOOL]              Disable shared memory support.
      --enable-memfd[=BOOL]             Enable memfd shared memory support.

STARTUP SCRIPT:
  -L, --load="MODULE ARGUMENTS"         Load the specified plugin module with
                                        the specified argument
  -F, --file=FILENAME                   Run the specified script
  -C                                    Open a command line on the running TTY
                                        after startup

  -n                                    Don't load default script file
Options (34)
OptionDescriptionSource
-h, --helpShow this helphelp + man
--versionShow version information.help + man
--dump-confLoad the daemon configuration file daemon.conf (see below), parse remaining configuration options on the command line and dump the resulting daemon configuration, in a format that is compatible with…help + man
--dump-modulesList available loadable modules.help + man
--dump-resample-methodsList available audio resamplers.help + man
--cleanup-shmIdentify stale PulseAudio POSIX shared memory segments in /dev/shm and remove them if possible.help + man
--startStart PulseAudio if it is not running yet.help + man
-k, --killKill an already running PulseAudio daemon of the calling user (Equivalent to sending a SIGTERM).help + man
--checkReturn 0 as return code when the PulseAudio daemon is already running for the calling user, or non-zero otherwise.help + man
--system BOOLRun as system-wide instancehelp
-D, --daemonize BOOLDaemonize after startuphelp
--fail BOOLQuit when startup failshelp
--high-priority BOOLTry to set high nice level (only available as root, when SUID or with elevated RLIMIT_NICE)help
--realtime BOOLTry to enable realtime scheduling (only available as root, when SUID or with elevated RLIMIT_RTPRIO)help
--disallow-module-loading BOOLDisallow user requested module loading/unloading after startuphelp
--disallow-exit BOOLDisallow user requested exithelp
--exit-idle-time SECSTerminate the daemon after the last client quit and this time in seconds passed.help + man
--scache-idle-time SECSUnload autoloaded samples from the cache when they haven't been used for the specified number of seconds.help + man
--log-level LEVELIncrease or set verbosity levelhelp
-v, --verboseIncrease the configured verbosity level by one (see --log-level above).help + man
--log-target autoSpecify the log target.help + man
--log-meta BOOLInclude code location in log messageshelp
--log-time BOOLInclude timestamps in log messageshelp
--log-backtrace FRAMESWhen FRAMES is greater than 0, log for each message a stack trace up to the number of specified stack frames.help + man
-p, --dl-search-path PATHSet the search path for dynamic shared objects (plugins).help + man
--resample-method METHODUse the specified resampler by default (See --dump-resample-methods above for possible values).help + man
--use-pid-file BOOLCreate a PID filehelp
--no-cpu-limit BOOLDo not install CPU load limiter on platforms that support it.help
--disable-shm BOOLDisable shared memory support.help
--enable-memfd BOOLEnable memfd shared memory support.help
-L, --load "MODULELoad the specified plugin module with the specified arguments.help + man
-F, --file FILENAMERun the specified script on startup.help + man
-COpen a command interpreter on STDIN/STDOUT after startup.help + man
-nDon't load default script file default.pa (see below) on startup.help + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.