root/maint/gnulib/lib/execvpe.c

/* */

DEFINITIONS

1. execvpe

   1 /* execvpe() function: Execute a program, replacing the current process.
   2    Copyright (C) 2020-2021 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 <stdbool.h>
  30 #include <stdlib.h>
  31 
  32 #include "findprog.h"
  33 
  34 int
  35 execvpe (const char *program, char * const *argv, char * const *env)
     /*  */
  36 {
  37   if (program == NULL
  38       || argv == NULL
  39       /* The callee is not expecting a NULL argv[0].  */
  40       || argv[0] == NULL
  41       || env == NULL)
  42     {
  43       errno = EINVAL;
  44       return -1;
  45     }
  46 
  47   const char *resolved_progname =
  48     find_in_given_path (program, getenv ("PATH"), NULL, true);
  49   if (resolved_progname == NULL)
  50     return -1;
  51 
  52   /* Invoke execve.  */
  53   execve (resolved_progname, argv, env);
  54 
  55   /* If execve returned, it must have failed.  */
  56   if (resolved_progname != program)
  57     free ((char *) resolved_progname);
  58   return -1;
  59 }

/* */