[alsa-devel] [RFC 1/4] ASoC: topology: Add topology UAPI header.

[Lars-Peter Clausen]

On 04/21/2015 06:35 PM, Mark Brown wrote:
> On Tue, Apr 21, 2015 at 05:23:36PM +0200, Takashi Iwai wrote:
>> Mark Brown wrote:
>
>>> That's sounding like an awfully small number if we're trying to be
>>> infititely future proof (obviously the default value for that is 640k!).
>>> We'd also need to go through and give *all* the structures padding.  How
>>> about just adding length fields instead with a rule that if the
>>> structure is bigger than you know about just ignore anything at the end?
>
>> In theory, having only "abi" field should be enough, as we can know
>> the size predefined for each ABI version.  But I agree that it'd be
>> friendlier for a parser if the header itself declares its size,
>> e.g. via a header_size field or embedding the size into some check
>> field like ioctl.
>
> The trouble with the ABI version information is that it tells new
> kernels how to handle old tables but old kernels will have no idea what
> to do with new firmwares.

What I did for the SigmaDSP firmware format (which can hopefully be 
superseded by this) is to have a header which a block type and the block 
length for each block for exactly this reason. It allows fully backward and 
forward compatibility between kernel versions and does not require a change 
in the ABI each time a new type of block is added. It also keeps the parser 
simple since it does not have to know the size and also makes support for 
vendor blocks quite easy, since the processing of those can be offloaded to 
some vendor callbacks without the core having to be informed what the 
content or size of those vendor blocks is.

- Lars