[LTP] [PATCH] syscalls/sched_rr_get_interval: Convert to docparse

[LTP] [PATCH] syscalls/sched_rr_get_interval: Convert to docparse

[Cyril Hrubis]

Signed-off-by: Cyril Hrubis <chrubis@suse.cz>
---
 .../sched_rr_get_interval01.c                 | 19 +++++++++++++++---
 .../sched_rr_get_interval02.c                 |  3 +++
 .../sched_rr_get_interval03.c                 | 20 ++++++++++++-------
 3 files changed, 32 insertions(+), 10 deletions(-)

diff --git a/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval01.c b/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval01.c
index 597de4665..520f44fe0 100644
--- a/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval01.c
+++ b/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval01.c
@@ -2,13 +2,26 @@
 /*
  * Copyright (c) Wipro Technologies Ltd, 2002.  All Rights Reserved.
  *    AUTHOR		: Saji Kumar.V.R <saji.kumar@wipro.com>
+ */
+/*\
+ * [Description]
  *
  * Gets round-robin time quantum by calling sched_rr_get_interval() and
  * checks that the value is sane.
  *
- * It is also a regression test for kernel
- * commit 975e155ed873 ("sched/rt: Show the 'sched_rr_timeslice' SCHED_RR
- * timeslice tuning knob in milliseconds").
+ * It is also a regression test for:
+ *
+ *  commit 975e155ed8732cb81f55c021c441ae662dd040b5
+ *  Author: Shile Zhang <shile.zhang@nokia.com>
+ *  Date:   Sat Jan 28 22:00:49 2017 +0800
+ *
+ *    sched/rt: Show the 'sched_rr_timeslice' SCHED_RR timeslice tuning knob in milliseconds
+ *
+ *  commit c7fcb99877f9f542c918509b2801065adcaf46fa
+ *  Author: Cyril Hrubis <chrubis@suse.cz>
+ *  Date:   Wed Aug 2 17:19:05 2023 +0200
+ *
+ *    sched/rt: Fix sysctl_sched_rr_timeslice intial value
  */
 
 #include "time64_variants.h"
diff --git a/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval02.c b/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval02.c
index 15e4a3053..a61e2969b 100644
--- a/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval02.c
+++ b/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval02.c
@@ -2,6 +2,9 @@
 /*
  * Copyright (c) Wipro Technologies Ltd, 2002.  All Rights Reserved.
  *    AUTHOR		: Saji Kumar.V.R <saji.kumar@wipro.com>
+ */
+/*\
+ * [Description]
  *
  * Verify that for a process with scheduling policy SCHED_FIFO,
  * sched_rr_get_interval() writes zero into timespec structure
diff --git a/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval03.c b/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval03.c
index f5a88f084..731c50082 100644
--- a/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval03.c
+++ b/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval03.c
@@ -2,14 +2,20 @@
 /*
  * Copyright (c) Wipro Technologies Ltd, 2002.  All Rights Reserved.
  *    AUTHOR		: Saji Kumar.V.R <saji.kumar@wipro.com>
+ */
+/*\
+ * [Description]
+ *
+ * Verify that:
+ *
+ * - sched_rr_get_interval() fails with errno set to EINVAL for an
+ *   invalid pid
+ *
+ * - sched_rr_get_interval() fails with errno set to ESRCH if the
+ *   process with specified pid does not exists
  *
- * Verify that
- *  1) sched_rr_get_interval() fails with errno set to EINVAL for an
- *     invalid pid
- *  2) sched_rr_get_interval() fails with errno set to ESRCH if the
- *     process with specified pid does not exists
- *  3) sched_rr_get_interval() fails with errno set to EFAULT if the
- *     address specified as &tp is invalid
+ * - sched_rr_get_interval() fails with errno set to EFAULT if the
+ *   address specified as &tp is invalid
  */
 
 #include "time64_variants.h"
-- 
2.41.0


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

Re: [LTP] [PATCH] syscalls/sched_rr_get_interval: Convert to docparse

[Cyril Hrubis]

Hi!
Ping?

-- 
Cyril Hrubis
chrubis@suse.cz

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

Re: [LTP] [PATCH] syscalls/sched_rr_get_interval: Convert to docparse

[Avinesh Kumar]

Hi,

Reviewed-by: Avinesh Kumar <akumar@suse.de>


--
Regards,
Avinesh




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

Re: [LTP] [PATCH] syscalls/sched_rr_get_interval: Convert to docparse

[Petr Vorel]

Hi Cyril,


> Signed-off-by: Cyril Hrubis <chrubis@suse.cz>
> ---
>  .../sched_rr_get_interval01.c                 | 19 +++++++++++++++---
>  .../sched_rr_get_interval02.c                 |  3 +++
>  .../sched_rr_get_interval03.c                 | 20 ++++++++++++-------
>  3 files changed, 32 insertions(+), 10 deletions(-)

> diff --git a/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval01.c b/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval01.c
> index 597de4665..520f44fe0 100644
> --- a/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval01.c
> +++ b/testcases/kernel/syscalls/sched_rr_get_interval/sched_rr_get_interval01.c
> @@ -2,13 +2,26 @@
>  /*
>   * Copyright (c) Wipro Technologies Ltd, 2002.  All Rights Reserved.
>   *    AUTHOR		: Saji Kumar.V.R <saji.kumar@wipro.com>
> + */
> +/*\
> + * [Description]
>   *
>   * Gets round-robin time quantum by calling sched_rr_get_interval() and
>   * checks that the value is sane.
>   *
> - * It is also a regression test for kernel
> - * commit 975e155ed873 ("sched/rt: Show the 'sched_rr_timeslice' SCHED_RR
> - * timeslice tuning knob in milliseconds").
> + * It is also a regression test for:
> + *
> + *  commit 975e155ed8732cb81f55c021c441ae662dd040b5
> + *  Author: Shile Zhang <shile.zhang@nokia.com>
> + *  Date:   Sat Jan 28 22:00:49 2017 +0800
> + *
> + *    sched/rt: Show the 'sched_rr_timeslice' SCHED_RR timeslice tuning knob in milliseconds
> + *
> + *  commit c7fcb99877f9f542c918509b2801065adcaf46fa
> + *  Author: Cyril Hrubis <chrubis@suse.cz>
> + *  Date:   Wed Aug 2 17:19:05 2023 +0200
> + *
> + *    sched/rt: Fix sysctl_sched_rr_timeslice intial value

I was going to merge, but this is really ugly formatting in html.

If the dates and authors are important, could this comment be inside normal
comments (e.g. info is in the sources, but not in docparse doc)? Because we have
that info in docs as linux-git tags.

Or, if this is not important, could we use just:

/*\
 * [Description]
....
 * It is also a regression test for:
 * * 975e155ed8732 ("sched/rt: Show the 'sched_rr_timeslice' SCHED_RR timeslice tuning knob in milliseconds")
 * * c7fcb99877f9f ("sched/rt: Fix sysctl_sched_rr_timeslice intial value")
 */

Also, for me would be instead of year enough just to add also kernel release to the hash.

Reviewed-by: Petr Vorel <pvorel@suse.cz>

Kind regards,
Petr

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

Re: [LTP] [PATCH] syscalls/sched_rr_get_interval: Convert to docparse

[Petr Vorel]

Hi Cyril,

> Hi Cyril,
...
> I was going to merge, but this is really ugly formatting in html.

> If the dates and authors are important, could this comment be inside normal
> comments (e.g. info is in the sources, but not in docparse doc)? Because we have
> that info in docs as linux-git tags.

> Or, if this is not important, could we use just:

> /*\
>  * [Description]
> ....
>  * It is also a regression test for:
I'm sorry, also I miss blank line before list. I need to write check for that.
>  * * 975e155ed8732 ("sched/rt: Show the 'sched_rr_timeslice' SCHED_RR timeslice tuning knob in milliseconds")
>  * * c7fcb99877f9f ("sched/rt: Fix sysctl_sched_rr_timeslice intial value")

But feel free to merge either in list in docparse or original version, but with
commits in plain /* */ (will not be in docparse.

Kind regards,
Petr

>  */

> Also, for me would be instead of year enough just to add also kernel release to the hash.

> Reviewed-by: Petr Vorel <pvorel@suse.cz>

> Kind regards,
> Petr

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

Re: [LTP] [PATCH] syscalls/sched_rr_get_interval: Convert to docparse

[Cyril Hrubis]

Hi!
> Or, if this is not important, could we use just:
> 
> /*\
>  * [Description]
> ....
>  * It is also a regression test for:
>  * * 975e155ed8732 ("sched/rt: Show the 'sched_rr_timeslice' SCHED_RR timeslice tuning knob in milliseconds")
>  * * c7fcb99877f9f ("sched/rt: Fix sysctl_sched_rr_timeslice intial value")
>  */
>
> Reviewed-by: Petr Vorel <pvorel@suse.cz>

I've changed the this as proposed (added empty line and used '-' instead
of '*' though) and pushed, thanks.

-- 
Cyril Hrubis
chrubis@suse.cz

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