+2019-09-15 Paul Smith <psmith@gnu.org>
+ Bruno Haible <bruno@clisp.org>
+
+ findprog-in: Set errno when the search fails.
+ * lib/findprog-in.c: Include <errno.h>.
+ (find_in_given_path): Set errno before returning NULL.
+ * lib/findprog.h (find_in_given_path): Update comment accordingly.
+ Define the term "slash".
+
2019-09-15 Bruno Haible <bruno@clisp.org>
findprog, findprog-lgpl, findprog-in: Fix crash on MSVC.
/* Specification. */
#include "findprog.h"
+#include <errno.h>
#include <stdbool.h>
#include <stdlib.h>
#include <string.h>
{
/* Try the various suffixes and see whether one of the files
with such a suffix is actually executable. */
+ int failure_errno;
size_t i;
#if defined _WIN32 && !defined __CYGWIN__ /* Native Windows */
const char *progbasename;
#endif
/* Try all platform-dependent suffixes. */
+ failure_errno = ENOENT;
for (i = 0; i < sizeof (suffixes) / sizeof (suffixes[0]); i++)
{
const char *suffix = suffixes[i];
return progpathname;
}
+ if (errno != ENOENT)
+ failure_errno = errno;
+
free (progpathname);
}
}
+ errno = failure_errno;
return NULL;
}
}
path = "";
{
+ int failure_errno;
/* Make a copy, to prepare for destructive modifications. */
char *path_copy = xstrdup (path);
char *path_rest;
char *cp;
+ failure_errno = ENOENT;
for (path_rest = path_copy; ; path_rest = cp + 1)
{
const char *dir;
return progpathname;
}
+ if (errno != ENOENT)
+ failure_errno = errno;
+
free (progpathname);
}
}
/* Not found in PATH. */
free (path_copy);
- }
- return NULL;
+ errno = failure_errno;
+ return NULL;
+ }
}
extern const char *find_in_path (const char *progname);
/* Looks up a program in the given PATH-like string.
+
The PATH argument consists of a list of directories, separated by ':' or
(on native Windows) by ';'. An empty PATH element designates the current
directory. A null PATH is equivalent to an empty PATH, that is, to the
singleton list that contains only the current directory.
+
Determines the pathname that would be called by execlp/execvp of PROGNAME.
- If successful, it returns a pathname containing a slash (either absolute
or relative to the current directory). The returned string can be used
with either execl/execv or execlp/execvp. It is freshly malloc()ed if it
is != PROGNAME.
- - Otherwise, it returns NULL.
+ - Otherwise, it sets errno and returns NULL.
+ Specific errno values include:
+ - ENOENT: means that the program's file was not found.
+ - EACCESS: means that the program's file was found but lacks the
+ execute permissions.
If OPTIMIZE_FOR_EXEC is true, the function saves some work, under the
assumption that the resulting pathname will not be accessed directly,
- only through execl/execv or execlp/execvp. */
+ only through execl/execv or execlp/execvp.
+
+ Here, a "slash" means:
+ - On POSIX systems excluding Cygwin: a '/',
+ - On Windows, OS/2, DOS platforms: a '/' or '\'. */
extern const char *find_in_given_path (const char *progname, const char *path,
bool optimize_for_exec);