[LTP] [PATCH] llistxattr02: Convert docs to docparse

[Wei Gao]

On Thu, Oct 31, 2024 at 04:59:04PM +0800, Ma Xinjian via ltp wrote:
> Signed-off-by: Ma Xinjian <maxj.fnst@fujitsu.com>
> ---
>  .../kernel/syscalls/llistxattr/llistxattr02.c | 34 ++++++++-----------
>  1 file changed, 14 insertions(+), 20 deletions(-)
> 
> diff --git a/testcases/kernel/syscalls/llistxattr/llistxattr02.c b/testcases/kernel/syscalls/llistxattr/llistxattr02.c
> index 6974f013b..c91d05f35 100644
> --- a/testcases/kernel/syscalls/llistxattr/llistxattr02.c
> +++ b/testcases/kernel/syscalls/llistxattr/llistxattr02.c
> @@ -1,25 +1,19 @@
>  // SPDX-License-Identifier: GPL-2.0-or-later
>  /*
> -* Copyright (c) 2016 Fujitsu Ltd.
> -* Author: Xiao Yang <yangx.jy@cn.fujitsu.com>
> -*/
> -
> -/*
> -* Test Name: llistxattr02
> -*
> -* Description:
> -* 1) llistxattr(2) fails if the size of the list buffer is too small
> -* to hold the result.
> -* 2) llistxattr(2) fails if path is an empty string.
> -* 3) llistxattr(2) fails when attempted to read from a invalid address.
> -* 4) llistxattr(2) fails if path is longer than allowed.
> -*
> -* Expected Result:
> -* 1) llistxattr(2) should return -1 and set errno to ERANGE.
> -* 2) llistxattr(2) should return -1 and set errno to ENOENT.
> -* 3) llistxattr(2) should return -1 and set errno to EFAULT.
> -* 4) llistxattr(2) should return -1 and set errno to ENAMETOOLONG.
> -*/
> + * Copyright (c) 2016 Fujitsu Ltd.
> + * Author: Xiao Yang <yangx.jy@cn.fujitsu.com>
> + */
> +
> +/*\
> + * [Description]
> + *
> + * Verify llistxattr(2) returns -1 and set proper errno:
> + *
> + * - ERANGE if the size of the list buffer is too small to hold the result
> + * - ENOENT if path is an empty string
> + * - EFAULT when attempted to read from a invalid address
> + * - ENAMETOOLONG if path is longer than allowed
> + */
>  
Reviewed-by: Wei Gao <wegao@suse.com>
>  #include "config.h"
>  #include <errno.h>
> -- 
> 2.42.0
> 
> 
> -- 
> Mailing list info: https://lists.linux.it/listinfo/ltp