NAME
__pmFindPMDA - search for the filename of a PMDA
C SYNOPSIS
#include <pcp/pmapi.h>
#include <pcp/impl.h>
char *__pmFindPMDA(const char *name)
cc ... -lpcp
DESCRIPTION
Given the name of a PMDA (may be a DSO PMDA or a daemon
PMDA), search for a file of that name in a number of well
known places.
If name exists, __pmFindPMDA returns immediately. Other
wise, a search is conducted.
If name is an absolute path (i.e. begins with ``/''), then
the only searching involves the equivalence of
/usr/pcp/lib and /var/pcp/lib. If name begins with either
of these prefixes, then the name formed by translating
name to use the other prefix is checked.
If name is a relative path (i.e. does not begin with
``/''), then searching involves scanning each directory in
the colon ``:'' separated list defined by the value of the
environment variable PMDA_PATH. If PMDA_PATH is not set,
the default search path is ``/var/pcp/lib:/usr/pcp/lib''.
The return value is NULL if the search fails, otherwise
the path to the PMDA file is returned. For success with
out searching, the return value is name, otherwise, the
return value is the address of a static buffer within
__pmFindPMDA.
SEE ALSO
pmcd(1), PMAPI(3) and pmNewContext(3).
CAVEAT
__pmFindPMDA searches for a file base on the supplied
name. Success is defined by existence of a file with the
matching name, according to the search algorithm. In the
case of a successful search, the resultant file may not be
a PMDA at all, and a subsequent attempt to dlopen(3) or
exec(2) this file may well fail.
Man(1) output converted with
man2html