Use execvpe when available (#16294)

This is a first step towards migrating to `execvpe` with a pre-created environment pointer.
This doesn't change any behaviour yet, but it adds the bindings and provides the field for further enhancements.

Co-authored-by: Julien Portalier <[email protected]>

Author: straight-shoota

src/crystal/system/unix/process.cr

@@ -352,7 +352,25 @@ struct Crystal::System::Process
     argv = command_args.map &.check_no_null_byte.to_unsafe
     argv << Pointer(UInt8).null
 
-    lock_write { LibC.execvp(command, argv) }
+    lock_write { execvpe(command, argv, LibC.environ) }
+  end
+
+  private def self.execvpe(command, argv, envp)
+    {% if LibC.has_method?("execvpe") %}
+      LibC.execvpe(command, argv, envp)
+    {% else %}
+      execvpe_impl(command, argv, envp)
+    {% end %}
+  end
+
+  # Darwin, DragonflyBSD, and FreeBSD < 14 don't have an `execvpe` function, so
+  # we need to implement it ourselves.
+  # FIXME: This is a stub implementation which simply sets the environment
+  # pointer. That's the same behaviour as before, but not correct. Will fix in a
+  # follow-up.
+  private def self.execvpe_impl(command, argv, envp)
+    LibC.environ = envp
+    LibC.execvp(command, argv)
   end
 
   def self.replace(command_args, env, clear_env, input, output, error, chdir)

src/lib_c/aarch64-android/c/unistd.cr

@@ -20,6 +20,7 @@ lib LibC
   fun dup3(__old_fd : Int, __new_fd : Int, __flags : Int) : Int
   fun _exit(__status : Int) : NoReturn
   fun execvp(__file : Char*, __argv : Char**) : Int
+  fun execvpe(file : Char*, argv : Char**, envp : Char**) : Int
   fun fdatasync(__fd : Int) : Int
   @[ReturnsTwice]
   fun fork : PidT

src/lib_c/aarch64-linux-gnu/c/unistd.cr

@@ -20,6 +20,7 @@ lib LibC
   fun dup3(fd : Int, fd2 : Int, flags : Int) : Int
   fun _exit(status : Int) : NoReturn
   fun execvp(file : Char*, argv : Char**) : Int
+  fun execvpe(file : Char*, argv : Char**, envp : Char**) : Int
   fun fdatasync(fd : Int) : Int
   @[ReturnsTwice]
   fun fork : PidT

src/lib_c/aarch64-linux-musl/c/unistd.cr

@@ -20,6 +20,7 @@ lib LibC
   fun dup3(x0 : Int, x1 : Int, x2 : Int) : Int
   fun _exit(x0 : Int) : NoReturn
   fun execvp(x0 : Char*, x1 : Char**) : Int
+  fun execvpe(file : Char*, argv : Char**, envp : Char**) : Int
   fun fdatasync(fd : Int) : Int
   @[ReturnsTwice]
   fun fork : PidT

src/lib_c/arm-linux-gnueabihf/c/unistd.cr

@@ -20,6 +20,7 @@ lib LibC
   fun dup3(fd : Int, fd2 : Int, flags : Int) : Int
   fun _exit(status : Int) : NoReturn
   fun execvp(file : Char*, argv : Char**) : Int
+  fun execvpe(file : Char*, argv : Char**, envp : Char**) : Int
   fun fdatasync(fd : Int) : Int
   @[ReturnsTwice]
   fun fork : PidT

src/lib_c/i386-linux-gnu/c/unistd.cr

@@ -20,6 +20,7 @@ lib LibC
   fun dup3(fd : Int, fd2 : Int, flags : Int) : Int
   fun _exit(status : Int) : NoReturn
   fun execvp(file : Char*, argv : Char**) : Int
+  fun execvpe(file : Char*, argv : Char**, envp : Char**) : Int
   fun fdatasync(fd : Int) : Int
   @[ReturnsTwice]
   fun fork : PidT

src/lib_c/i386-linux-musl/c/unistd.cr

@@ -20,6 +20,7 @@ lib LibC
   fun dup3(x0 : Int, x1 : Int, x2 : Int) : Int
   fun _exit(x0 : Int) : NoReturn
   fun execvp(x0 : Char*, x1 : Char**) : Int
+  fun execvpe(file : Char*, argv : Char**, envp : Char**) : Int
   fun fdatasync(x0 : Int) : Int
   @[ReturnsTwice]
   fun fork : PidT

src/lib_c/x86_64-freebsd/c/unistd.cr

@@ -19,6 +19,10 @@ lib LibC
   fun dup3(x0 : Int, x1 : Int, x2 : Int) : Int
   fun _exit(x0 : Int) : NoReturn
   fun execvp(x0 : Char*, x1 : Char**) : Int
+  # `execvpe` is introduced in FreeBSD 15, but it already seems to be available in 14.
+  {% unless flag?("freebsd12.0") || flag?("freebsd13.0") %}
+    fun execvpe(file : Char*, argv : Char**, envp : Char**) : Int
+  {% end %}
   fun fdatasync(fd : Int) : Int
   @[ReturnsTwice]
   fun fork : PidT

src/lib_c/x86_64-linux-gnu/c/unistd.cr

@@ -20,6 +20,7 @@ lib LibC
   fun dup3(fd : Int, fd2 : Int, flags : Int) : Int
   fun _exit(status : Int) : NoReturn
   fun execvp(file : Char*, argv : Char**) : Int
+  fun execvpe(file : Char*, argv : Char**, envp : Char**) : Int
   fun fdatasync(fd : Int) : Int
   @[ReturnsTwice]
   fun fork : PidT

src/lib_c/x86_64-linux-musl/c/unistd.cr

@@ -20,6 +20,7 @@ lib LibC
   fun dup3(x0 : Int, x1 : Int, x2 : Int) : Int
   fun _exit(x0 : Int) : NoReturn
   fun execvp(x0 : Char*, x1 : Char**) : Int
+  fun execvpe(file : Char*, argv : Char**, envp : Char**) : Int
   fun fdatasync(x0 : Int) : Int
   @[ReturnsTwice]
   fun fork : PidT