summaryrefslogtreecommitdiff
path: root/man/pax11publish.1.xml.in
blob: 6f6039ab33d4010150910fffc188800840abbea9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
<?xml version="1.0"?><!--*-nxml-*-->
<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>

<!--
This file is part of PulseAudio.

PulseAudio is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 2.1 of the
License, or (at your option) any later version.

PulseAudio is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with PulseAudio; if not, see <http://www.gnu.org/licenses/>.
-->

<manpage name="pax11publish" section="1" desc="PulseAudio X11 Credential Utility">

  <synopsis>
    <cmd>pax11publish <opt>-h</opt></cmd>
    <cmd>pax11publish [<arg>options</arg>] [<opt>-d</opt>]</cmd>
    <cmd>pax11publish [<arg>options</arg>] <opt>-e</opt></cmd>
    <cmd>pax11publish [<arg>options</arg>] <opt>-i</opt></cmd>
    <cmd>pax11publish [<arg>options</arg>] <opt>-r</opt></cmd>
  </synopsis>

  <description>
    <p>The <file>pax11publish</file> utility can be used to dump or
    manipulate the PulseAudio server credentials that can be stored as
    properties on the X11 root window.</p>

    <p>Please note that the loadable module
    <file>module-x11-publish</file> exports the same information
    directly from the PulseAudio sound server, and should in most
    cases be used in preference over this tool.</p>

    <p>Use the following command to dump the raw
    PulseAudio-specific data that is stored in your X11 root
    window:</p>

    <p>xprop -root | grep ^PULSE_</p>

  </description>

  <options>

    <option>
      <p><opt>-h</opt></p>

      <optdesc><p>Show help.</p></optdesc>
    </option>

    <option>
      <p><opt>-d</opt></p>

      <optdesc><p>Read the PulseAudio server credentials currently set
      on the X11 root window and dump them in a human readable form. This reads the
      PULSE_SERVER, PULSE_SINK, PULSE_SOURCE and PULSE_COOKIE
      properties.</p></optdesc>
    </option>

    <option>
      <p><opt>-i</opt></p>
      <optdesc><p>Similar to <opt>-d</opt>, however dumps them in a
      Bourne shell compatible format so they may be used together with
      the <file>eval</file> shell command to set the $PULSE_SERVER,
      $PULSE_SINK, $PULSE_SOURCE environment variables. Also reads the
      authentication cookie from the root window and stores it in
      <file>~/.config/pulse/cookie</file>. </p></optdesc>
    </option>

    <option>
      <p><opt>-e</opt></p>

      <optdesc><p>Export the currently locally used sound server,
      sink, source configuration to the X11 root window. This takes
      the data from the $PULSE_SERVER, $PULSE_SINK, $PULSE_SOURCE
      environment variables and combines them with the data from
      <file>~/.config/pulse/client.conf</file> (or
      <file>@PA_DEFAULT_CONFIG_DIR@/client.conf</file> if that file does not
      exist). If specific options are passed on the command line
      (<opt>-S</opt>, <opt>-O</opt>, <opt>-I</opt>, <opt>-c</opt>, see
      below), they take precedence. Also uploads the local
      authentication cookie <file>~/.config/pulse/cookie</file> to the X11
      server.</p></optdesc>
    </option>

    <option>
      <p><opt>-r</opt></p>

      <optdesc><p>Removes the configured PulseAudio configuration from the X11 root window.</p></optdesc>
    </option>

    <option>
      <p><opt>-D</opt> <arg>DISPLAY</arg></p>

      <optdesc><p>Connect to the specified X11 display, instead of the default one configured in $DISPLAY.</p></optdesc>
    </option>

    <option>
      <p><opt>-S</opt> <arg>SERVER</arg></p>

      <optdesc><p>Only valid for <opt>-e</opt>: export the specified
      PulseAudio server as default to the X11 display instead of the
      one configured via local configuration.</p></optdesc>
    </option>

    <option>
      <p><opt>-O</opt> <arg>SINK</arg></p>

      <optdesc><p>Only valid for <opt>-e</opt>: export the specified
      sink as default sink to the X11 display instead of the one
      configured via local configuration.</p></optdesc>
    </option>

    <option>
      <p><opt>-I</opt> <arg>SOURCE</arg></p>

      <optdesc><p>Only valid for <opt>-e</opt>: export the specified
      source as default to the X11 display instead of the one
      configured via local configuration.</p></optdesc>
    </option>

    <option>
      <p><opt>-c</opt> <arg>FILE</arg></p>

      <optdesc><p>Only valid for <opt>-e</opt>: export the PulseAudio
      authentication cookie stored in the specified file to the X11
      display instead of the one stored in <file>~/.config/pulse/cookie</file>.</p></optdesc>
    </option>

  </options>

  <section name="Authors">
    <p>The PulseAudio Developers &lt;@PACKAGE_BUGREPORT@&gt;; PulseAudio is available from <url href="@PACKAGE_URL@"/></p>
  </section>

  <section name="See also">
    <p>
      <manref name="pulseaudio" section="1"/>, <manref name="xprop" section="1"/>
    </p>
  </section>

</manpage>