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

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

[Ma Xinjian via ltp]

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
+ */
 
 #include "config.h"
 #include <errno.h>
-- 
2.42.0


-- 
Mailing list info: https://lists.linux.it/listinfo/ltp

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

[Wei Gao via ltp]

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

-- 
Mailing list info: https://lists.linux.it/listinfo/ltp

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

[Petr Vorel]

Hi Ma Xinjian, Wei,

thanks, merged this and second patch!

Kind regards,
Petr

-- 
Mailing list info: https://lists.linux.it/listinfo/ltp