[PATCH] man/man3/posix_spawn.3: Check for executable name in example

[PATCH] man/man3/posix_spawn.3: Check for executable name in example

[dave]

From: "Dr. David Alan Gilbert" <dave@treblig.org>

Make the example check for an executable name on the command line
rather than segfaulting in the child.

Signed-off-by: Dr. David Alan Gilbert <dave@treblig.org>
---
 man/man3/posix_spawn.3 | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/man/man3/posix_spawn.3 b/man/man3/posix_spawn.3
index 3aaf3873e..0d238f51c 100644
--- a/man/man3/posix_spawn.3
+++ b/man/man3/posix_spawn.3
@@ -730,6 +730,11 @@ .SS Program source
             break;
         }
     }
+\&
+    if (!argv[optind]) {
+        fprintf(stderr, "Usage: %s [\-cs] executable [args]\[rs]n", argv[0]);
+        exit(EXIT_FAILURE);
+    }
 \&
     /* Spawn the child. The name of the program to execute and the
        command\-line arguments are taken from the command\-line arguments
-- 
2.50.1

Re: [PATCH] man/man3/posix_spawn.3: Check for executable name in example

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 1102 bytes --]

Hi Dave,

On Mon, Aug 18, 2025 at 11:59:10PM +0100, dave@treblig.org wrote:
> From: "Dr. David Alan Gilbert" <dave@treblig.org>
> 
> Make the example check for an executable name on the command line
> rather than segfaulting in the child.
> 
> Signed-off-by: Dr. David Alan Gilbert <dave@treblig.org>

Thanks!  I've applied the patch.


Have a lovely day!
Alex

> ---
>  man/man3/posix_spawn.3 | 5 +++++
>  1 file changed, 5 insertions(+)
> 
> diff --git a/man/man3/posix_spawn.3 b/man/man3/posix_spawn.3
> index 3aaf3873e..0d238f51c 100644
> --- a/man/man3/posix_spawn.3
> +++ b/man/man3/posix_spawn.3
> @@ -730,6 +730,11 @@ .SS Program source
>              break;
>          }
>      }
> +\&
> +    if (!argv[optind]) {
> +        fprintf(stderr, "Usage: %s [\-cs] executable [args]\[rs]n", argv[0]);
> +        exit(EXIT_FAILURE);
> +    }
>  \&
>      /* Spawn the child. The name of the program to execute and the
>         command\-line arguments are taken from the command\-line arguments
> -- 
> 2.50.1
> 
> 

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]