INSTALL

Print

User instructions

Windows Windows

Just unzip gpmid.dll in the directory of the host application before running it. You can also move the library in the system directories if you want it to be shared among multiple applications. Applications using the library may already do it for you when installing them.

Linux Linux

Just untar libgpmid.so in the directory of your choice before running the host application. This application will require that the environment variable LD_LIBRARY_PATH is set to the directory where libgpmid.so resides. For example, if both your application and libgpmid.so are in the current directory, to run your application from a shell, you can type: LD_LIBRARY_PATH=. ./yourapp

You can also install the library on your system by moving it in the library directory (/lib on most systems); you will probably need root permissions to do this. Once installed, you don't have to set LD_LIBRARY_PATH when running your application. Applications using the library may already do it for you when installing them.

Developer instructions

To import the functions contained in gpmid.dll/libgpmid.so you have two possibilities:

  • If your application is written in C/C++, you can include gpmid.h in any source file to call the functions directly in your application. You will have to link your binary against libgpmid.a. The header file gpmid.h and the import library libgpmid.a should compile/link properly using any flavour of GCC.
  • Use "run-time dynamic linking" and use the LoadLibrary(), GetProcAddress() and FreeLibrary() (on Windows), or dlopen(), dlsym() and dlclose() (on Linux) API functions.

The first method is simpler and safer whereas the second does not require that you write your application in C/C++ and it allows it to load the library on demand (as a plugin, for example).

In any case, do not forget to ship gpmid.dll/libgpmid.so for your users with your distribution.