Take a look at the general notes on installation before continuing with installing the DIGFileSnark library.


Contents:
  1. Downloading Source Code
  2. Unpacking Source Code
  3. Building and Installing
  4. Setting Environmental Variables


  1. Downloading Source Code:

    Click on any of the following link(s) to download a tarball of the DIGFileSnark source code:


       (This is the latest versions currently available)


  2. Unpacking Source Code:

    Once you've downloaded the DIGFileSnark tarball, you need to unpack the source code from that tarball and then cd into that newly unpacked directory. Visit the general installation page to see the note regarding unpacking source code.



  3. Building and Installing:

    Once you've downloaded, unpacked, and moved into the DIGFileSnark directory, you are ready to build and install the library. Building the DIGFileSnark library consists of invoking a configure script, followed by invoking make. Installation consists of invoking make install. Examples are given below. First, though, we list a few notes regarding isntallation location and library dependencies, and what the user must specify when invoking the configure script.

    The default installation location for the DIGFileSnark library is /usr/local/. (i.e. Shared object files will be placed in /usr/local/lib/, and header files will be placed in /usr/local/include/.) Root permission is required in order to install in this directory. A local (or any other non-default) installation is also possible by specifying the --prefix option to configure (see below).

    Due to the DIGFileSnark library's dependency on both the DIGFile and xerces-c libraries, the user must specify the installation location of DIGFile and xerces-c by setting the XERCES_DIR and DIGFILE_DIR environmental variables when invoking the configure script (see below). For example, if the xerces-c shared object files are located in /usr/lib/ and its header files are located in /usr/include/, while the DIGFile shared object files are located in /usr/local/lib/ and its header files are located in /usr/local/include/, then the user would set XERCES_DIR to /usr/ and set DIGFILE_DIR to /usr/local/

    As an example, the following instructions assume xerces-c to be installed in /usr/ and DIGFile to be installed in /usr/local, and can be used to build and install DIGFileSnark in /usr/local/:
    $ ./configure XERCES_DIR=/usr/ DIGFILE_DIR=/usr/local/
    $ make
    $ su
    $ make install

    As another example, the following instructions assume xerces-c to be installed in /usr/ and DIGFile to be installed in /usr/local, and can be used to build and install DIGFileSnark in the non-default installation location /home/jdoe/mylocaldir/:
    $ ./configure XERCES_DIR=/usr/ DIGFILE_DIR=/usr/local/ \
           --prefix=/home/jdoe/mylocaldir/
    $ make
    $ make install



  4. Setting Environmental Variables:

    See the note regarding setting environmental variables  on the general installation page