execve: Convert docs to docparse

Also use link to man (as :man2:`execve`) in already converted tests.
Remove unused headers in execve01.c.

Signed-off-by: Petr Vorel <[email protected]>

Author: pevik

testcases/kernel/syscalls/execve/execve01.c

@@ -1,22 +1,20 @@
 // SPDX-License-Identifier: GPL-2.0-or-later
 /*
- * Copyright (c) 2018 Linux Test Project
+ * Copyright (c) 2018-2025 Linux Test Project
  * Copyright (C) 2015 Cyril Hrubis <[email protected]>
  * Copyright (c) 2000 Silicon Graphics, Inc.  All Rights Reserved.
- *    AUTHOR		: William Roske
- *    CO-PILOT		: Dave Fenner
+ * Authors: William Roske, Dave Fenner
  */
 
-#include <errno.h>
 #include <string.h>
-#include <signal.h>
 #include <stdio.h>
-#include <stdlib.h>
-#include <sys/types.h>
-#include <sys/wait.h>
-
 #include "tst_test.h"
 
+/*\
+ * Test :man2:`execve` passes correctly argv[1] and environment variable to the
+ * executed binary.
+ */
+
 static void verify_execve(void)
 {
 	pid_t pid;

testcases/kernel/syscalls/execve/execve02.c

@@ -8,10 +8,10 @@
  *  21/04/2008 Renaud Lottiaux ([email protected])
  */
 
-/*
- * Attempt to execve(2) an executable owned by root with no execute permissions
- * for the other users, fails when execve(2) is used as a non-root user, the
- * errno should be EACCES.
+/*\
+ * Attempt to :man2:`execve` an executable owned by root with no execute
+ * permissions for the other users, fails when :man2:`execve` is used as
+ * a non-root user, the errno should be EACCES.
  */
 
 #define _GNU_SOURCE

testcases/kernel/syscalls/execve/execve03.c

@@ -6,33 +6,15 @@
  * Ported to LTP: Wayne Boyer
  */
 
-/*
- *	Testcase to check execve sets the following errnos correctly:
- *	1.	ENAMETOOLONG
- *	2.	ENOENT
- *	3.	ENOTDIR
- *	4.	EFAULT
- *	5.	EACCES
- *	6.	ENOEXEC
- *
- * ALGORITHM
- *	1.	Attempt to execve(2) a file whose name is more than
- *		VFS_MAXNAMLEN fails with ENAMETOOLONG.
- *
- *	2.	Attempt to execve(2) a file which doesn't exist fails with
- *		ENOENT.
- *
- *	3.	Attempt to execve(2) a pathname (executabl) comprising of a
- *		directory, which doesn't exist fails with ENOTDIR.
- *
- *	4.	Attempt to execve(2) a filename not within the address space
- *		of the process fails with EFAULT.
- *
- *	5.	Attempt to execve(2) a filename that does not have executable
- *		permission - fails with EACCES.
+/*\
+ * Test to check :man2:`execve` sets the following errnos correctly:
  *
- *	6.	Attempt to execve(2) a zero length file with executable
- *		permissions - fails with ENOEXEC.
+ * 1. ENAMETOOLONG -- the file name is greater than VFS_MAXNAMELEN
+ * 2. ENOENT -- the filename does not exist
+ * 3. ENOTDIR -- the path contains a directory name which doesn't exist
+ * 4. EFAULT -- the filename isn't part of the process address space
+ * 5. EACCES -- the filename does not have execute permission
+ * 6. ENOEXEC -- the file is zero length with execute permissions
  */
 
 #define _GNU_SOURCE
@@ -66,11 +48,8 @@ static struct tcase {
 	{no_dir, ENOENT},
 	/* the path contains a directory name which doesn't exist - ENOTDIR */
 	{test_name3, ENOTDIR},
-	/* the filename isn't part of the process address space - EFAULT */
 	{NULL, EFAULT},
-	/* the filename does not have execute permission - EACCES */
 	{test_name5, EACCES},
-	/* the file is zero length with execute permissions - ENOEXEC */
 	{test_name6, ENOEXEC}
 };
 

testcases/kernel/syscalls/execve/execve04.c

@@ -9,7 +9,7 @@
  */
 
 /*\
- * Attempt to execve(2) a file which is being opened by another process for
+ * Attempt to :man2:`execve` a file which is being opened by another process for
  * writing fails with ETXTBSY.
  */
 

testcases/kernel/syscalls/execve/execve05.c

@@ -7,8 +7,8 @@
  */
 
 /*\
- * This tests the functionality of the execve(2) system call by spawning
- * a few children, each of which would execute "execve_child" simultaneously,
+ * This tests the functionality of the execve(2) :man2:`execve` call by spawning
+ * a few children, each of which would execute "execve_child" binary simultaneously,
  * and finally the parent ensures that they terminated correctly.
  */
 

testcases/kernel/syscalls/execve/execve06.c

@@ -5,7 +5,7 @@
 
 /*\
  * Test that kernel adds dummy argv[0] if empty argument list was passed to
- * execve(). This fixes at least one CVE where userspace programs start to
+ * :man2:`execve`. This fixes at least one CVE where userspace programs start to
  * process argument list blindly from argv[1] such as polkit pkexec
  * CVE-2021-4034.
  *