[PATCH 1/2] exec.3: Fix description of 'e' variants

[PATCH 1/2] exec.3: Fix description of 'e' variants

[Josh Triplett]

The envp argument specifies the environment of the new process image,
not "the environment of the caller".

Signed-off-by: Josh Triplett <josh@joshtriplett.org>
---
 man3/exec.3 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man3/exec.3 b/man3/exec.3
index 211e06421..3d936d08d 100644
--- a/man3/exec.3
+++ b/man3/exec.3
@@ -116,7 +116,7 @@ The array of pointers
 .I must
 be terminated by a null pointer.
 .SS e - execle(), execvpe()
-The environment of the caller is specified via the argument
+The environment of the new process image is specified via the argument
 .IR envp .
 The
 .I envp
-- 
2.30.1

[PATCH 2/2] exec.3: Clarify that execvpe uses PATH from the caller, not envp

[Josh Triplett]

Checked via the latest glibc source. execvpe calls getenv("PATH") and
searches that; the PATH in envp does not affect the search.

Signed-off-by: Josh Triplett <josh@joshtriplett.org>
---
 man3/exec.3 | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/man3/exec.3 b/man3/exec.3
index 3d936d08d..9c5b02b5c 100644
--- a/man3/exec.3
+++ b/man3/exec.3
@@ -146,6 +146,13 @@ a list that includes the directories returned by
 and possibly also the current working directory;
 see NOTES for further details.
 .PP
+.BR execvpe ()
+searches for the program using the value of
+.B PATH
+from the caller's environment, not from the
+.I envp
+argument.
+.PP
 If the specified filename includes a slash character, then
 .B PATH
 is ignored, and the file at the specified pathname is executed.
-- 
2.30.1

Re: [PATCH 1/2] exec.3: Fix description of 'e' variants

[Alejandro Colomar (man-pages)]

Hello Josh,

On 3/8/21 12:00 AM, Josh Triplett wrote:
> The envp argument specifies the environment of the new process image,
> not "the environment of the caller".
> 
> Signed-off-by: Josh Triplett <josh@joshtriplett.org>

I applied both patches.

Thanks,

Alex

> ---
>   man3/exec.3 | 2 +-
>   1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/man3/exec.3 b/man3/exec.3
> index 211e06421..3d936d08d 100644
> --- a/man3/exec.3
> +++ b/man3/exec.3
> @@ -116,7 +116,7 @@ The array of pointers
>   .I must
>   be terminated by a null pointer.
>   .SS e - execle(), execvpe()
> -The environment of the caller is specified via the argument
> +The environment of the new process image is specified via the argument
>   .IR envp .
>   The
>   .I envp
> 

-- 
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/