diff mbox series

splice03: Convert docs to docparse

Message ID 20240913074743.171417-1-maxj.fnst@fujitsu.com
State Accepted
Headers show
Series splice03: Convert docs to docparse | expand

Commit Message

Ma Xinjian Sept. 13, 2024, 7:47 a.m. UTC 
Signed-off-by: Ma Xinjian <maxj.fnst@fujitsu.com>
---
 testcases/kernel/syscalls/splice/splice03.c | 30 +++++++++------------
 1 file changed, 13 insertions(+), 17 deletions(-)

Comments

Petr Vorel Nov. 12, 2024, 9:54 p.m. UTC | #1 
Hi Ma Xinjian, Wei,

thanks, merged!

Kind regards,
Petr
diff mbox series

Patch

diff --git a/testcases/kernel/syscalls/splice/splice03.c b/testcases/kernel/syscalls/splice/splice03.c
index c054e6c1c..91e9bf9e7 100644
--- a/testcases/kernel/syscalls/splice/splice03.c
+++ b/testcases/kernel/syscalls/splice/splice03.c
@@ -3,23 +3,19 @@ 
  * Copyright (c) 2014 Fujitsu Ltd.
  * Author: Xing Gu <gux.fnst@cn.fujitsu.com>
  */
-/*
- * Description:
- *   Verify that,
- *   1) splice() returns -1 and sets errno to EBADF if the file
- *      descriptor fd_in is not valid.
- *   2) splice() returns -1 and sets errno to EBADF if the file
- *      descriptor fd_out is not valid.
- *   3) splice() returns -1 and sets errno to EBADF if the file
- *      descriptor fd_in does not have proper read-write mode.
- *   4) splice() returns -1 and sets errno to EINVAL if target
- *      file is opened in append mode.
- *   5) splice() returns -1 and sets errno to EINVAL if neither
- *      of the descriptors refer to a pipe.
- *   6) splice() returns -1 and sets errno to ESPIPE if off_in is
- *      not NULL when the file descriptor fd_in refers to a pipe.
- *   7) splice() returns -1 and sets errno to ESPIPE if off_out is
- *      not NULL when the file descriptor fd_out refers to a pipe.
+
+/*\
+ * [Description]
+ *
+ * Verify that, splice(2) returns -1 and sets errno to
+ *
+ * 1. EBADF if the file descriptor fd_in is not valid.
+ * 2. EBADF if the file descriptor fd_out is not valid.
+ * 3. EBADF if the file descriptor fd_in does not have proper read-write mode.
+ * 4. EINVAL if target file is opened in append mode.
+ * 5. EINVAL if neither of the descriptors refer to a pipe.
+ * 6. ESPIPE if off_in is not NULL when the file descriptor fd_in refers to a pipe.
+ * 7. ESPIPE if off_out is not NULL when the file descriptor fd_out refers to a pipe.
  */
 
 #define _GNU_SOURCE