This README file describes the DRMAA Condor UNIX C library (version 1.2).  

Most parts of this code were written by Nicholas Geib, a former member of the Condor development team. Peter Troeger from the DRMAA working group is now responsible for the finalization and ongoing improvement of the code. 
Major contributions are from Piotr Domagalski and Greg Quinn.

In case of problems, please use the feedback mechanisms on the according Sourceforge project page:

http://sf.net/projects/condor-ext

This library was developed from the Distributed Resource Management Application API Specification 1.0 of January 2004 and the DRMAA C Bindings v1.0.  Both were available at time of writing at www.drmaa.org. 

The library expects a POSIX-compliant Unix system, with support for the pthread library. It contains support only for the Condor system, and has been tested with the latest releases from the Condor 6.7 series.

The library supports all mandatory parts of the DRMAA 1.0 API. See the STATUS file for details about what has not yet been fully implemented.

REQUIREMENTS:

The library requires the following in order to operate.  The program linked to the library is referred to as the "user process".

1) A local schedd must be running. If you have installed this machine as Condor submission host, this should be the case.
2) The user process must have sufficient spool space.  This space should be in /tmp or specified by the environment variables TEMP, TMP, or SPOOL.
3) The user process and local schedd must have read, write, and traverse rights to the spool space.
4) On platforms where libpthread, the POSIX threading library, is supported the user process must be linked with libpthread when it uses the static DRMAA library.

BUILD & INSTALLATION:

This package can be build independently from Condor with the usual autoconf stuff. Currently, there is no install target, so you have to copy one of the resulting libraries to the right place:

./configure
make
cp libdrmaa.so /usr/lib/ 
cp drmaa.h /usr/include/

The build process was tested on Linux (X86 and IA64) and MacOS X, but might also work on other Unix platforms.

CAUTION:

The libcondordrmaa.a static library is build for backward-compatibility to the first version of DRMAA in Condor. Please note that the DRMAA specification expects a shared library, so your application should rely on libdrmaa.so instead.

The DRMAA library submits jobs in the Vanilla universe. If you want to work with jobs in the standard universe, please provide an according specification ("universe=standard") in the 'native specification' attribute of the job template.
