opendll.h

PNX系列设备驱动 PNX系列设备驱动

/*
 *  +-------------------------------------------------------------------+
 *  | Copyright (c) 1995,1996,1997 by Philips Semiconductors.           |
 *  |                                                                   |
 *  | This software  is furnished under a license  and may only be used |
 *  | and copied in accordance with the terms  and conditions of such a |
 *  | license  and with  the inclusion of this  copyright notice.  This |
 *  | software or any other copies of this software may not be provided |
 *  | or otherwise  made available  to any other person.  The ownership |
 *  | and title of this software is not transferred.                    |
 *  |                                                                   |
 *  | The information  in this software  is subject  to change  without |
 *  | any  prior notice  and should not be construed as a commitment by |
 *  | Philips Semiconductors.                                           |
 *  |                                                                   |
 *  | This  code  and  information  is  provided  "as is"  without  any |
 *  | warranty of any kind,  either expressed or implied, including but |
 *  | not limited  to the implied warranties  of merchantability and/or |
 *  | fitness for any particular purpose.                               |
 *  +-------------------------------------------------------------------+
 *
 *
 *  Module name              : OpenDll.h    1.4
 *
 *  Title                    : Dll search path handling and opening of DLLs.
 *
 *  Last update              : 10:56:06 - 98/04/28
 *
 *  Description              :  
 *
 *		This module is written to support the opening of
 *              DLL given a certain search path. The user of the 
 *              module can pass the OpenDll_open_dll into an RPC 
 *              server as the function to open DLLs. The user is 
 *              supposed to build a DLL search path in reverse order.
 *              
 *              OpenDll_add_dll_path can be used to add path's to
 *              the search path. Two search paths should always be
 *              added, thoise are the system library paths, for instance
 *              OpenDll_add_dll_path("/usr/local/tcs/lib/eb/SunOS");
 *              OpenDll_add_dll_path("/usr/local/tcs/lib/eb");
 *              We see that the user is responsible for the TCS root
 *              and the endianess that the target is running in.
 *
 *              After the building the search path, one can just call
 *              OpenDll_open_dll which seaches the directories and
 *              returns an opened file descriptor when the file is found\
 *
 *		This module is not thread safe in the sense that the
 * 		dll search paths are shared for all threads.
 */

#ifndef	OpenDLL_INCLUDED
#define	OpenDLL_INCLUDED

#include "tmtypes.h"
#include "RPCServ.h"

#if	defined(__cplusplus)
extern	"C"	{
#endif	/* defined(__cplusplus) */

/*
 * Function         : add a certain directory name for dll searching;
 * Parameters       : pathlist (I) directory
 * Function result  : 
 * Postcondition    : can abort on malloc failure
 */

extern void 
OpenDll_add_dll_path( String path );



/*
 * Function         : remove a certain directory name for dll searching;
 * Parameters       : pathlist (I) directory
 * Function result  : 
 */

extern void 
OpenDll_remove_dll_path( String path );


/*
 * Function         : returns an open dll according to previously
 *                    set search paths. First the current directory
 *                    is searched for then the directories (in 
 *                    reverse order of addition) added to
 *                    the search path by RPCServ_add_dll_path. 
 * Parameters       : path (I) filename to be searched for
 * Function result  : open file descriptor (RDONLY | BINARY) on 
 *                    success or -1 on failure.
 */

extern int 
OpenDll_open_dll( String path, RPCServ_OpenFunc My_open, Endian endian );

#if	defined(__cplusplus)
}
#endif	/* defined(__cplusplus) */

#endif	/* OpenDLL_INCLUDED */