Installation



NOTE: If you're running a 64 bit version of Linux, then use libBounceStudio64.so, instead of libBounceStudio32.so.
  1. Extract the tarball to a directory where you want to install BounceStudio API. This will create a BounceStudioAPI subdirectory within that directory.
    tar -xzvf BounceStudioAPI.tar.gz
  2. Copy the extracted BounceStudio.h header file to /usr/local/include.
  3. Copy the extracted libBounceStudio32.so.3.x.x.x shared object file to /usr/local/lib.
  4. Make a symbolic link in the /usr/local/lib/ directory that points to libBounceStudio32.so.3.x.x.x.
    ln -s /usr/local/lib/libBounceStudio32.so.3.x.x.x /usr/local/lib/libBounceStudio32.so
  5. Execute the following command to add the /usr/local/lib path to a new file called BounceStudio.conf within the /etc/ld.so.conf.d directory.
    echo /usr/local/lib > /etc/ld.so.conf.d/BounceStudio.conf
  6. Run ldconfig. ldconfig creates the necessary links and cache (for use by the run-time linker, ld.so) to the most recent shared libraries found in the directories specified on the command line, in the file /etc/ld.so.conf, and in the trusted directories (/usr/lib and /lib). ldconfig should normally be run by the super-user as it may require write permission on some root owned directories and files. For more information on ldconfig, please see it's man page.
    ldconfig
  7. Read Section 6 of this help file, entitled "Raw Message Format".
  8. Explore the rest of this help file, and the included sample source code.

Compiling Example

Below is an example illustrating how to link the BounceStudio API shared object when compiling the included sample C application.
cc test.c -o test -lBounceStudio32