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

Ma Xinjian maxj.fnst@fujitsu.com
Tue Aug 20 10:04:13 CEST 2024


Signed-off-by: Ma Xinjian <maxj.fnst@fujitsu.com>
---
 .../kernel/syscalls/readlink/readlink03.c     | 35 +++++++++----------
 1 file changed, 16 insertions(+), 19 deletions(-)

diff --git a/testcases/kernel/syscalls/readlink/readlink03.c b/testcases/kernel/syscalls/readlink/readlink03.c
index 01ff304d8..dce636664 100644
--- a/testcases/kernel/syscalls/readlink/readlink03.c
+++ b/testcases/kernel/syscalls/readlink/readlink03.c
@@ -4,25 +4,22 @@
  * Ported to LTP: Wayne Boyer
  */
 
-/*
- * Test Description :
- *   1) readlink(2) returns -1 and sets errno to EACCES if search/write
- *	permission is denied in the directory where the symbolic link
- *	resides.
- *   2) readlink(2) returns -1 and sets errno to EINVAL if the buffer size
- *	is not positive.
- *   3) readlink(2) returns -1 and sets errno to EINVAL if the specified
- *	file is not a symbolic link file.
- *   4) readlink(2) returns -1 and sets errno to ENAMETOOLONG if the
- *	pathname component of symbolic link is too long (ie, > PATH_MAX).
- *   5) readlink(2) returns -1 and sets errno to ENOENT if the component of
- *	symbolic link points to an empty string.
- *   6) readlink(2) returns -1 and sets errno to ENOTDIR if a component of
- *	the path prefix is not a directory.
- *   7) readlink(2) returns -1 and sets errno to ELOOP if too many symbolic
- *	links were encountered in translating the pathname.
- *   8) readlink(2) returns -1 and sets errno to EFAULT if buf outside the
- *	process allocated address space.
+/*\
+ * [Description]
+ *
+ * Verify that, readlink(2) returns -1 and sets errno to
+ *
+ * 1. EACCES if search/write permission is denied in the directory where the
+ * symbolic link esides.
+ * 2. EINVAL if the buffer size is not positive.
+ * 3. EINVAL if the specified file is not a symbolic link file.
+ * 4. ENAMETOOLONG if the pathname component of symbolic link is too long
+ * (ie, > PATH_MAX).
+ * 5. ENOENT if the component of symbolic link points to an empty string.
+ * 6. ENOTDIR if a component of the path prefix is not a directory.
+ * 7. ELOOP if too many symbolic links were encountered in translating the
+ * pathname.
+ * 8. EFAULT if buf outside the process allocated address space.
  */
 
 #include <pwd.h>
-- 
2.42.0



More information about the ltp mailing list