PROTOCOL

   1 ### v8, implemented by >= 0.8
   2
   3 First version supported.
   4
   5 ### v9, implemented by >= 0.9.0
   6
   7 Reply for PA_COMMAND_CREATE_PLAYBACK_STREAM,
   8 PA_COMMAND_CREATE_RECORD_STREAM now returns buffer_attrs that are used:
   9
  10 Four new fields in reply of PA_COMMAND_CREATE_PLAYBACK_STREAM:
  11
  12    maxlength
  13    tlength
  14    prebuf
  15    minreq
  16
  17 Two new fields in reply of PA_COMMAND_CREATE_RECORD_STREAM:
  18
  19    maxlength
  20    fragsize
  21
  22 ### v10, implemented by >= 0.9.5
  23
  24 New opcodes:
  25
  26  PA_COMMAND_MOVE_SINK_INPUT
  27  PA_COMMAND_MOVE_SOURCE_OUTPUT
  28
  29 SHM data transfer support
  30
  31 ### v11, implemented by >= 0.9.7
  32
  33 Reply to to PA_COMMAND_GET_SINK_INPUT_INFO, PA_COMMAND_GET_SINK_INPUT_INFO_LIST gets new field at the end:
  34
  35  mute
  36
  37 New opcodes:
  38
  39  PA_COMMAND_SET_SINK_INPUT_MUTE
  40  PA_COMMAND_SUSPEND_SINK
  41  PA_COMMAND_SUSPEND_SOURCE
  42
  43 ### v12, implemented by >= 0.9.8
  44
  45 S32LE, S32BE is now known as sample spec.
  46
  47 Gained six new bool fields for PA_COMMAND_CREATE_PLAYBACK_STREAM, PA_COMMAND_CREATE_RECORD_STREAM request at the end:
  48
  49  no_remap_channels
  50  no_remix_channels
  51  fix_format
  52  fix_rate
  53  fix_channels
  54  no_move
  55  variable_rate
  56
  57 Reply to these opcodes now includes:
  58
  59  sample_spec
  60  channel_map
  61  device_index
  62  device_name
  63  suspended
  64
  65 New opcodes for changing buffer attrs:
  66
  67  PA_COMMAND_SET_PLAYBACK_STREAM_BUFFER_ATTR
  68  PA_COMMAND_SET_RECORD_STREAM_BUFFER_ATTR
  69
  70 New opcodes for changing sampling rate:
  71
  72  PA_COMMAND_UPDATE_PLAYBACK_STREAM_SAMPLE_RATE
  73  PA_COMMAND_UPDATE_RECORD_STREAM_SAMPLE_RATE
  74
  75 New opcodes for notifications:
  76
  77  PA_COMMAND_PLAYBACK_STREAM_SUSPENDED
  78  PA_COMMAND_CAPTURE_STREAM_SUSPENDED
  79  PA_COMMAND_PLAYBACK_STREAM_MOVED
  80  PA_COMMAND_CAPTURE_STREAM_MOVED
  81
  82 ### v13, implemented by >= 0.9.11
  83
  84 New fields for PA_COMMAND_CREATE_PLAYBACK_STREAM, PA_COMMAND_CREATE_RECORD_STREAM request at the end:
  85
  86  peak_detect (bool)
  87  adjust_latency  (bool)
  88
  89 Replace field "name" for PA_COMMAND_CREATE_PLAYBACK_STREAM, PA_COMMAND_CREATE_RECORD_STREAM at the end:
  90
  91  proplist
  92
  93 Replace field "name" for PA_COMMAND_SET_CLIENT_NAME request at the end:
  94
  95  proplist
  96
  97 On response of PA_COMMAND_SET_CLIENT_NAME:
  98
  99  client_index
 100
 101 New proplist field for sink, source, sink input, source output introspection opcodes and at the end:
 102
 103  proplist
 104
 105 New opcodes for proplist modifications
 106
 107   PA_COMMAND_UPDATE_RECORD_STREAM_PROPLIST
 108   PA_COMMAND_UPDATE_PLAYBACK_STREAM_PROPLIST
 109   PA_COMMAND_UPDATE_CLIENT_PROPLIST
 110   PA_COMMAND_REMOVE_RECORD_STREAM_PROPLIST
 111   PA_COMMAND_REMOVE_PLAYBACK_STREAM_PROPLIST
 112   PA_COMMAND_REMOVE_CLIENT_PROPLIST
 113
 114 New field for PA_COMMAND_PLAY_SAMPLE:
 115
 116   proplist
 117
 118 New field for PA_COMMAND_PLAY_SAMPLE response:
 119
 120   idx
 121
 122 New field for PA_COMMAND_CREATE_PLAYBACK_STREAM at the end:
 123
 124   start_muted
 125
 126 Buffer attributes for PA_COMMAND_CREATE_PLAYBACK_STREAM and
 127 PA_COMMAND_CREATE_RECORD_STREAM may now be 0 for default values.
 128
 129 New field for PA_COMMAND_SET_PLAYBACK_STREAM_BUFFER_ATTR,
 130 PA_COMMAND_SET_RECORD_STREAM_BUFFER_ATTR at the end:
 131
 132   adjust_latency (bool)
 133
 134 new message:
 135
 136   PA_COMMAND_STARTED
 137
 138 ### v14, implemented by >= 0.9.12
 139
 140 new message:
 141
 142   PA_COMMAND_EXTENSION
 143
 144 PA_COMMAND_CREATE_PLAYBACK_STREAM:
 145
 146   bool volume_set at the end
 147
 148 PA_COMMAND_CREATE_RECORD_STREAM, PA_COMMAND_CREATE_PLAYBACK_STREAM:
 149
 150   bool early_requests at the end
 151
 152 New field for PA_COMMAND_SET_PLAYBACK_STREAM_BUFFER_ATTR,
 153 PA_COMMAND_SET_RECORD_STREAM_BUFFER_ATTR at the end:
 154
 155   early_requests (bool)
 156
 157 ### v15, implemented by >= 0.9.15
 158
 159 PA_COMMAND_CREATE_PLAYBACK_STREAM
 160
 161   bool muted at the end
 162
 163 PA_COMMAND_CREATE_PLAYBACK_STREAM, PA_COMMAND_CREATE_RECORD_STREAM:
 164
 165   bool dont_inhibit_auto_suspend at the end
 166
 167 PA_COMMAND_GET_MODULE_INFO_LIST
 168
 169   remove bool auto_unload
 170   add proplist at the end
 171
 172 new messages:
 173
 174   PA_COMMAND_GET_CARD_INFO
 175   PA_COMMAND_GET_CARD_INFO_LIST
 176   PA_COMMAND_SET_CARD_PROFILE
 177
 178   PA_COMMAND_CLIENT_EVENT
 179   PA_COMMAND_PLAYBACK_STREAM_EVENT
 180   PA_COMMAND_RECORD_STREAM_EVENT
 181
 182   PA_COMMAND_PLAYBACK_BUFFER_ATTR_CHANGED
 183   PA_COMMAND_RECORD_BUFFER_ATTR_CHANGED
 184
 185 ### v16, implemented by >= 0.9.15
 186
 187 new messages:
 188
 189   PA_COMMAND_SET_SINK_PORT
 190   PA_COMMAND_SET_SOURCE_PORT
 191
 192 ## v17, implemented by >= 0.9.20
 193
 194 new flag at end of CREATE_PLAYBACK_STREAM:
 195
 196     bool relative_volume
 197
 198 ## v18, implemented by >= 0.9.22
 199
 200 new flag at end of CREATE_PLAYBACK_STREAM:
 201
 202     bool passthrough
 203
 204 ## v19, implemented by >= 0.9.22
 205
 206 New flag at the end of sink input and source output introspection data:
 207
 208     bool corked
 209
 210 ## v20, implemented by >= 1.0
 211
 212 Two new flags at the end of sink input introspection data:
 213
 214     bool has_volume
 215     bool volume_writable
 216
 217 ## v21, implemented by >= 1.0
 218
 219 Changes for format negotiation in the extended API.
 220
 221 New fields PA_COMMAND_CREATE_PLAYBACK_STREAM:
 222
 223     uint8_t n_formats
 224     format_info format1
 225     ...
 226     format_info formatn
 227
 228 One new field in reply from PA_COMMAND_CREATE_PLAYBACK_STREAM:
 229
 230     format_info format
 231
 232 New fields in reply from PA_COMMAND_GET_SINK_INFO (and thus
 233 PA_COMMAND_GET_SINK_INFO_LIST)
 234
 235     uint8_t n_formats
 236     format_info format1
 237     ...
 238     format_info formatn
 239
 240 One new field in reply from PA_COMMAND_GET_SINK_INPUT_INFO (and thus
 241 PA_COMMAND_GET_SINK_INPUT_INFO_LIST)
 242
 243     format_info format
 244
 245 ## v22, implemented by >= 1.0
 246
 247 New fields PA_COMMAND_CREATE_RECORD_STREAM:
 248
 249     uint8_t n_formats
 250     format_info format1
 251     ...
 252     format_info formatn
 253
 254 One new field in reply from PA_COMMAND_CREATE_RECORD_STREAM:
 255
 256     format_info format
 257
 258 New fields in reply from PA_COMMAND_GET_SOURCE_INFO (and thus
 259 PA_COMMAND_GET_SOURCE_INFO_LIST)
 260
 261     uint8_t n_formats
 262     format_info format1
 263     ...
 264     format_info formatn
 265
 266 Five new fields in reply from PA_COMMAND_GET_SOURCE_OUTPUT_INFO (and thus
 267 PA_COMMAND_GET_SOURCE_OUTPUT_INFO_LIST)
 268
 269     format_info format
 270     volume
 271     bool mute
 272     bool has_volume
 273     bool volume_writable
 274
 275 ## v23, implemented by >= 1.0
 276
 277 New field in PA_COMMAND_UNDERFLOW:
 278
 279     int64_t index
 280
 281 #### If you just changed the protocol, read this
 282 ## module-tunnel depends on the sink/source/sink-input/source-input protocol
 283 ## internals, so if you changed these, you might have broken module-tunnel.
 284 ## Don't forget to test module-tunnel-{source,sink} when pushing protocol
 285 ## changes.