Owen Kirby osk@exegin.com writes:
Here's a first stab at assembling some documentation about CCM mode and its API. It's probably still in need some some good proofreading for grammar and consistency.
I've checked in these docs now, with fixes as below. Thanks!
Some minor nits that I noticed about the API while writing it:
- ccm_decrypt_message uses const void * for the cipher context, but all the other interfaces use void * for this.
Fixed to document const void *.
- passing the clength rather mlength to ccm_decrypt_message could be a little confusing when compared to the rest of the API. In retrospect, I think Neils's initial suggestion on this API was probably the better way to go.
Fixed, both in the docs and the code.
Not yet done: Fixing the logic for deriving the maxumum mesage size from the nocne size. Public macros for computing maximum message size for a given nonce, and documentation of these and general nonce size issues.
Do you think you can have a look at that soon?
Regards, /Niels