/* Function to find a file from a path.
   Copyright (C) 2001 Free Software Foundation, Inc.


This file is part of GDB.


GDB is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option) any later
version.


GDB is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.


You should have received a copy of the GNU General Public License
along with GDB; see the file COPYING.  If not, write to the Free
Software Foundation, 59 Temple Place - Suite 330, Boston, MA
02111-1307, USA.  */

/*
 * RCS $Revision: 1.5 $
 * Checkin $Date: 1999/11/30 19:30:16 $
 * Revising $Author: sdouglas $
 */

#ifndef findfile_h
#define findfile_h

#if defined(__cplusplus) && !defined(CLX_CPP_LINKAGE)
extern "C" {
#endif

/* Find a file relating to <tool> with extension <extn>. Searches a variety of
 * paths, including <path> - which should be argv[0] - and $<xpath> if set. If
 * <extn> is null, it searches for just <tool> - so <tool> could be a complete
 * filename.
 *
 * e.g. to find the error file do clx_findfile(argv[0],"ARMERR","armsd","err");
 *                             or clx_findfile(argv[0],"ARMERR","armsd.err",NULL);
 *
 * The value of argv[0] is cached and used on future calls where argv0==NULL
 * Returns NULL (after caching argv[0]) if tool==NULL. So to cache an argv[0] do
 *    (void)clx_findfile(argv[0],NULL,NULL,NULL);
 */
const char *clx_findfile(const char *argv0,const char *xpath,
                         const char *tool,const char *extn);

#if defined(__cplusplus) && !defined(CLX_CPP_LINKAGE)
}
#endif

#endif