1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164
|
<HTML>
<BODY>
<DIV ALIGN='JUSTIFY'>
<H1 ALIGN="RIGHT"><A NAME="INSTALL">1 - Building and Installing
the CUPS DDK</A></H1>
<P>This chapter describes how to build and install the CUPS
DDK. Unsupported Mac OS X Universal Binary and Linux (i386 + x86_64) packages of the CUPS DDK are available for download from the CUPS web site (www.cups.org).</P>
<H2>Before You Begin</H2>
<P>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.
<P>The makefiles used by the DDK should work with most versions
of <TT>make(1)</TT>. 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 (<TT>gmake(1)</TT>).
<p>Finally, you <b>must</b> have the CUPS 1.2 or higher
software installed including all header files. If you are using
MacOS X 10.4 or earlier, you will need to install CUPS 1.2 on your system. An unsupported Universal Binary package for Mac OS X 10.4.x is available on the CUPS web site (www.cups.org) that you can install for this purpose. Drivers created using the DDK can be used on any system with CUPS 1.1.19 or higher installed.</p>
<H2>Building the DDK</H2>
<P>The DDK is built by first configuring the software and then
compiling it.
<H3>Configuring the Software</H3>
<P>The DDK uses GNU autoconf, so you will find the usual
<TT>configure</TT> script in the main DDK source
directory. Type the following command to configure the DDK
for your system using the default options:
<PRE>
<KBD>./configure ENTER</KBD>
</PRE>
<P>The default options will put the DDK software under the
<VAR>/usr</VAR> directory on your system. Use the
<TT>--prefix</TT> option to install the DDK software in
another location:
<PRE>
<KBD>./configure --prefix=/some/directory ENTER</KBD>
</PRE>
<P>If you will be distributing the DDK drivers to systems
with different versions of CUPS installed on them, use the
<TT>--enable-static</TT> option to link the DDK drivers
against the static CUPS libraries:
<PRE>
<KBD>./configure --enable-static ENTER</KBD>
</PRE>
<P>You can see all of the options supported by the
<TT>configure</TT> script by using the <TT>--help</TT> option:
<PRE>
<KBD>./configure --help ENTER</KBD>
</PRE>
<H3>Compiling the Software</H3>
<P>Once you have configured things, just type:
<PRE>
<KBD>make ENTER</KBD>
</PRE>
<P>or:
<PRE>
<KBD>gmake ENTER</KBD>
</PRE>
<P>to build the software. If you encounter any difficulties, please report
them to the <TT>cups.ddk</TT> newsgroup on the CUPS web site at:
<PRE>
<A HREF="http://www.cups.org/newsgroups.php">http://www.cups.org/newsgroups.php</A>
</PRE>
<!-- NEED 10 -->
<H2>Installing the DDK</H2>
<P>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.
<H3>Installing Using the Makefile</H3>
<P>The <TT>install</TT> target provides a quick way to install
the software on your local system:
<PRE>
<KBD>make install ENTER</KBD>
</PRE>
<P>or:
<PRE>
<KBD>gmake install ENTER</KBD>
</PRE>
<P>Similarly, the <TT>uninstall</TT> target removes the DDK from
the local system:
<PRE>
<KBD>make uninstall ENTER</KBD>
</PRE>
<P>or:
<PRE>
<KBD>gmake uninstall ENTER</KBD>
</PRE>
<H3>Installing Using EPM</H3>
<P>The DDK also includes targets for building installable
packages using the ESP Package Manager ("EPM") software,
available separately at:
<PRE>
<A HREF="http://www.easysw.com/epm/">http://www.easysw.com/epm/</A>
</PRE>
<P>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 (<TT>rpm</TT>), Debian
(<TT>deb</TT>), and portable packages (<TT>epm</TT>) for
installation:
<PRE>
<KBD>make deb ENTER</KBD>
<KBD>make epm ENTER</KBD>
<KBD>make rpm ENTER</KBD>
</PRE>
<P>After typing any of those commands, the corresponding
software package file will be placed in the <VAR>dist</VAR>
sub-directory. Use the corresponding commands to install the
packages:
<PRE>
<KBD>dpkg -i cupsddk-1.0-linux-2.4-intel.deb ENTER</KBD>
<KBD>./cupsddk.install ENTER</KBD>
<KBD>rpm -i cupsddk-1.0-linux-2.4-intel.rpm ENTER</KBD>
</PRE>
</DIV>
</BODY>
</HTML>
|