tree eaf5077ecf3f6a5d95ca8671488459e411b3a7f4
parent cb569bc558887b9500432c8a7b987b185e5cf6fc
author Andrew Jeffery <andrew@codeconstruct.com.au> 1723365250 +0000
committer Andrew Jeffery <andrew@codeconstruct.com.au> 1725429254 +0200

msgbuf: Harden pldm_msgbuf_{insert,extract}_array()

Review of some proposed APIs suggested that correct use of the
pldm_msgbuf_{insert,extract}_array() helpers was more difficult that it
should be. In the three-parameter form, it was too tempting to provide
the length to extract as parsed out of a PLDM message. The intended
use was that the length parameter represented the length of the
user-provided data buffer.

Instead, move to a four-parameter form, provide reasonable documentation
for how these APIs should be used, fix all the call-sites, and deprecate
some existing unsafe APIs.

Change-Id: If58e5574600e80b354f383554283c4eda5d7234c
Signed-off-by: Andrew Jeffery <andrew@codeconstruct.com.au>