code.delx.au - pulseaudio/blob - man/pasuspender.1.xml.in

   1 <?xml version="1.0"?><!--*-nxml-*-->
   2 <!DOCTYPE manpage SYSTEM "xmltoman.dtd">
   3 <?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
   4
   5 <!--
   6 This file is part of PulseAudio.
   7
   8 PulseAudio is free software; you can redistribute it and/or modify it
   9 under the terms of the GNU Lesser General Public License as
  10 published by the Free Software Foundation; either version 2.1 of the
  11 License, or (at your option) any later version.
  12
  13 PulseAudio is distributed in the hope that it will be useful, but WITHOUT
  14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  15 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
  16 Public License for more details.
  17
  18 You should have received a copy of the GNU Lesser General Public
  19 License along with PulseAudio; if not, write to the Free Software
  20 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  21 USA.
  22 -->
  23
  24 <manpage name="pasuspender" section="1" desc="Temporarily suspend PulseAudio">
  25
  26   <synopsis>
  27     <cmd>pasuspender [<arg>options</arg>] -- <arg>PROGRAM</arg> [<arg>ARGUMENTS ...</arg>]</cmd>
  28     <cmd>pasuspender <opt>--help</opt></cmd>
  29     <cmd>pasuspender <opt>--version</opt></cmd>
  30   </synopsis>
  31
  32   <description>
  33     <p><file>pasuspender</file> is a tool that can be used to tell a
  34     local PulseAudio sound server to temporarily suspend access to the
  35     audio devices, to allow other
  36     applications access them directly. <file>pasuspender</file> will
  37     suspend access to the audio devices, fork a child process, and
  38     when the child process terminates, resume access again.</p>
  39
  40     <p>Make sure to include <opt>--</opt> in
  41     your <file>pasuspender</file> command line before passing the
  42     subprocess command line (as shown
  43     above). Otherwise <file>pasuspender</file> itself might end up
  44     interpreting the command line switches and options you intended to
  45     pass to the subprocess.</p>
  46   </description>
  47
  48   <options>
  49
  50     <option>
  51       <p><opt>-h | --help</opt></p>
  52
  53       <optdesc><p>Show help.</p></optdesc>
  54     </option>
  55
  56     <option>
  57       <p><opt>--version</opt></p>
  58
  59       <optdesc><p>Show version information.</p></optdesc>
  60     </option>
  61
  62     <option>
  63       <p><opt>-s | --server=</opt><arg>SERVER</arg></p>
  64
  65       <optdesc><p>Specify the sound server to connect to.</p></optdesc>
  66     </option>
  67
  68   </options>
  69
  70   <section name="Authors">
  71     <p>The PulseAudio Developers &lt;@PACKAGE_BUGREPORT@&gt;; PulseAudio is available from <url href="@PACKAGE_URL@"/></p>
  72   </section>
  73
  74   <section name="See also">
  75     <p>
  76       <manref name="pulseaudio" section="1"/>, <manref name="padsp" section="1"/>, <manref name="pacmd" section="1"/>, <manref name="pactl" section="1"/>
  77     </p>
  78   </section>
  79
  80 </manpage>