protocol-native: extend v3 protocol with message footers

Extend version 3 protocol with message footers, which are for passing
around global state data that is not addressed to a specific object.

The extension is backward compatible with previous v3 clients, and won't
e.g. result to error spam in logs.

The footer is a single SPA POD, appended after the main message POD.
Because both the protocol message and the message POD record their
length, it's possible to append trailing data. Earlier clients will
ignore any data trailing the message POD.

The footer POD contains a sequence [Id opcode, Struct {...}]*,
so there is room to extend with new opcodes later as necessary.

There are separate marshal/demarshal routines for messages aimed at
resources and proxies.
This commit is contained in:
Pauli Virtanen 2022-02-20 14:03:41 +02:00
parent c4997fc46d
commit 680c33d3eb
7 changed files with 253 additions and 1 deletions

View file

@ -197,6 +197,7 @@ pipewire_module_protocol_native = shared_library('pipewire-module-protocol-nativ
'module-protocol-native/portal-screencast.c',
'module-protocol-native/protocol-native.c',
'module-protocol-native/v0/protocol-native.c',
'module-protocol-native/protocol-footer.c',
'module-protocol-native/connection.c' ],
include_directories : [configinc],
install : true,