This chapter describes how to build and install the CUPS DDK.
You'll need ANSI-compliant C and C++ compilers, plus a make program and Bourne (POSIX) shell. The GNU compiler tools work well - we've tested the current DDK code against GCC 3.x with excellent results.
The makefiles used by the DDK should work with most versions of make(1). We use them successfully with GNU make as well as the make programs shipped by SGI and Sun. *BSD, HP-UX, and Tru64 users should use GNU make (gmake(1)).
Finally, you must have the CUPS 1.1.19 or higher software installed including all header files. If you are using MacOS X, Apple does not include the header files with the standard OS install or developer tools - you will need to download the Darwin CUPS sources and use the "installhdr" target to install the header files manually. Note that MacOS X 10.2.x comes with an older version of CUPS - you cannot build the DDK on a standard 10.2.x CUPS installation.
The DDK is built by first configuring the software and then compiling it.
The DDK uses GNU autoconf, so you will find the usual configure script in the main DDK source directory. Type the following command to configure the DDK for your system using the default options:
./configure ENTER
The default options will put the DDK software under the /usr directory on your system. Use the --prefix option to install the DDK software in another location:
./configure --prefix=/some/directory ENTER
If you will be distributing the DDK drivers to systems with different versions of CUPS installed on them, use the --enable-static option to link the DDK drivers against the static CUPS libraries:
./configure --enable-static ENTER
You can see all of the options supported by the configure script by using the --help option:
./configure --help ENTER
Once you have configured things, just type:
make ENTER
or:
gmake ENTER
to build the software. If you encounter any difficulties, please report them to the cups.ddk newsgroup on the CUPS web site at:
http://www.cups.org/newsgroups.php
Once you have built the software you need to install it before using it. The DDK supports installing via the makefile or using the EPM software.
The install target provides a quick way to install the software on your local system:
make install ENTER
or:
gmake install ENTER
Similarly, the uninstall target removes the DDK from the local system:
make uninstall ENTER
or:
gmake uninstall ENTER
The DDK also includes targets for building installable packages using the ESP Package Manager ("EPM") software, available separately at:
http://www.easysw.com/epm/
The EPM software creates binary packages that can be installed on other machines using the EPM list file "cupsddk.list". The top-level makefile included with the DDK provides targets for creating RPM (rpm), Debian (deb), and portable packages (epm) for installation:
make deb ENTER make epm ENTER make rpm ENTER
or
gmake deb ENTER gmake epm ENTER gmake rpm ENTER
After typing any of those commands, the corresponding software package file will be placed in the dist sub-directory. Use the corresponding commands to install the packages: