FNPATHFIND(3) C Programmer's Manual FNPATHFIND(3)NAMEfnpathfind - find a file in a list of directories
SYNOPSIS
#include <publib.h>
int fnpathfind(const char *path, const char *tgt,
char *res, size_t max);
DESCRIPTION
pathfind looks for a file in a list of directories. The argument
`path' is a colon separated list of directories, typically the contents
of an environment variable like PATH, MANPATH, or CDPATH. The function
will go through the directories in the path and look in each directory
for a file given in argument `target' until it finds it. Only an exact
match is reported, no wild cards or globbing.
The names that are matched are formed by taking an element from the
path and prepending it to target. An empty element means the current
directory, as does the name ".".
The function returns -1 for failure (not found or error), or the total
size for the full name (the full name may have been truncated when
stored into result).
BUGS
The function uses dynamic memory allocation and may therefore fail due
to insufficient memory.
It is not trivial to know in which directory the search ended. This
makes is difficult to continue the search.
SEE ALSOpublib(3), fname(3)AUTHOR
Lars Wirzenius (lars.wirzenius@helsinki.fi)
Publib C Programmer's Manual FNPATHFIND(3)