1 /* Locating a program in PATH. 2 Copyright (C) 2001-2003 Free Software Foundation, Inc. 3 Written by Bruno Haible <haible@clisp.cons.org>, 2001. 4 5 This program is free software; you can redistribute it and/or modify 6 it under the terms of the GNU General Public License as published by 7 the Free Software Foundation; either version 2, or (at your option) 8 any later version. 9 10 This program is distributed in the hope that it will be useful, 11 but WITHOUT ANY WARRANTY; without even the implied warranty of 12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 GNU General Public License for more details. 14 15 You should have received a copy of the GNU General Public License 16 along with this program; if not, write to the Free Software Foundation, 17 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ 18 19 20 #ifdef __cplusplus 21 extern "C" { 22 #endif 23 24 25 /* Look up a program in the PATH. 26 Attempt to determine the pathname that would be called by execlp/execvp 27 of PROGNAME. If successful, return a pathname containing a slash 28 (either absolute or relative to the current directory). Otherwise, 29 return PROGNAME unmodified. 30 Because of the latter case, callers should use execlp/execvp, not 31 execl/execv on the returned pathname. 32 The returned string is freshly malloc()ed if it is != PROGNAME. */ 33 extern const char *find_in_path (const char *progname); 34 35 36 #ifdef __cplusplus 37 } 38 #endif 39