lib/execvpe.c

   1 /* execvpe() function: Execute a program, replacing the current process.
   2    Copyright (C) 2020-2024 Free Software Foundation, Inc.
   3
   4    This file is free software: you can redistribute it and/or modify
   5    it under the terms of the GNU Lesser General Public License as
   6    published by the Free Software Foundation; either version 2.1 of the
   7    License, or (at your option) any later version.
   8
   9    This file is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12    GNU Lesser General Public License for more details.
  13
  14    You should have received a copy of the GNU Lesser General Public License
  15    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
  16
  17 /* Written by Bruno Haible <bruno@clisp.org>, 2020.  */
  18
  19 /* Don't use __attribute__ __nonnull__ in this compilation unit.  Otherwise gcc
  20    may optimize away the program == NULL and argv == NULL tests below.  */
  21 #define _GL_ARG_NONNULL(params)
  22
  23 #include <config.h>
  24
  25 /* Specification.  */
  26 #include <unistd.h>
  27
  28 #include <errno.h>
  29 #include <stdlib.h>
  30
  31 #include "findprog.h"
  32
  33 int
  34 execvpe (const char *program, char * const *argv, char * const *env)
  35 {
  36   if (program == NULL
  37       || argv == NULL
  38       /* The callee is not expecting a NULL argv[0].  */
  39       || argv[0] == NULL
  40       || env == NULL)
  41     {
  42       errno = EINVAL;
  43       return -1;
  44     }
  45
  46   const char *resolved_progname =
  47     find_in_given_path (program, getenv ("PATH"), NULL, true);
  48   if (resolved_progname == NULL)
  49     return -1;
  50
  51   /* Invoke execve.  */
  52   execve (resolved_progname, argv, env);
  53
  54   /* If execve returned, it must have failed.  */
  55   if (resolved_progname != program)
  56     free ((char *) resolved_progname);
  57   return -1;
  58 }