Re: [PATCH] docs: crypto: async-tx-api: fix broken code example

From: Ahmad Fatoum
Date: Wed May 29 2024 - 04:19:16 EST


Hello Andre,

On 23.05.24 16:17, Andre Noll wrote:
> On Thu, May 23, 15:18, Ahmad Fatoum wrote
>> The code example fails to compile:
>>
>> 1) ddr_conv is defined twice, once as a VLA, which have been phased out
>
> addr_conv
>>
>> 2) submit is not a pointer, but is still dereferenced with ->
>
> 3) The first call to async_xor() lacked the trailing semicolon.
>
>> Fix these issues and while at it, make the functions static as users
>> are unlikely to export them.
>
> No objections, but please don't consider me authoritative. Two nits
> below, FWIW.

Oh, thanks for catching these. I just sent a v2 with your feedback
incorporated including the nitpicks.

Cheers,
Ahmad

>
>> --- a/Documentation/crypto/async-tx-api.rst
>> +++ b/Documentation/crypto/async-tx-api.rst
>> @@ -150,38 +150,38 @@ of an operation.
>> Perform a xor->copy->xor operation where each operation depends on the
>> result from the previous operation::
>
> Maybe add
>
> #include <linux/async_tx.h>
>
>>
>> - void callback(void *param)
>> + static void callback(void *param)
>> {
>> struct completion *cmp = param;
>>
>> complete(cmp);
>> }
>
> This could be simplified to
>
> static void callback(void *param)
> {
> complete(param);
> }
>
> Best
> Andre

--
Pengutronix e.K. | |
Steuerwalder Str. 21 | http://www.pengutronix.de/ |
31137 Hildesheim, Germany | Phone: +49-5121-206917-0 |
Amtsgericht Hildesheim, HRA 2686 | Fax: +49-5121-206917-5555 |