1 <chapter id="installation">
2 <!-- $Id: installation.xml,v 1.3 2002-10-22 08:23:57 adam Exp $ -->
3 <title>Installation</title>
5 You need a C++ compiler to compile and use YAZ++.
6 The software was implemented using GCC so we know that works
7 well with YAZ++. From time to time the software has been
8 compiled on Windows using Visual C++. Other compilers should
9 work too. Let us know of portability problems, etc. with
13 YAZ++ is built on top of the
14 <ulink url="http://indexdata.dk/yaz/">YAZ</ulink>
16 You need to install that first.
17 For some platforms there are binary packages for YAZ.
21 <para>On UNIX, the software is compiled as follows:
30 You can supply options for the configure script.
31 The most useful ones are:
34 <term><literal>--prefix </literal>directory</term>
36 Specifies installation prefix. By default
37 <literal>/usr/local</literal> is used.
41 <term><literal>--with-yazconfig </literal>directory</term>
43 Specifies location of <filename>yaz-config</filename>.
44 The <filename>yaz-config</filename> is generated in
45 the source directory of YAZ as well as the binaries
46 directory when YAZ is installed (via make install).
49 If you don't supply this option, configure, will
50 look for <filename>yaz-config</filename> in directories of the
51 <literal>PATH</literal> environment.
55 For the whole list of configure options, refer to the help:
56 <literal>./configure --help</literal>.
59 This is a list of what you have after successful compilation:
62 <term>src/yaz-proxy</term>
64 Z39.50 Proxy. This program gets installed in
65 your binaries directory (prefix<literal>/bin</literal>).
69 <term>lib/libyaz++.la</term>
71 YAZ++ library. This library gets installed in your
72 libraries directory (prefix<literal>/lib</literal>).
77 <term>include/yaz++/*.h</term>
79 Various header files. All these are installed in
80 your header files area (prefix<literal>/include/yaz++</literal>).
85 <term>yaz++-config</term>
87 Bourne shell script utility that returns CFLAGS/LIBS
88 needed in order to compile with the YAZ++ library.
89 This script gets installed in your binaries directory
90 (prefix<literal>/bin</literal>).
95 <term>zoom/zclient</term>
97 ZOOM C++ demonstration client. This client does not
98 get installed in the system directories.
103 <term>src/yaz-my-client</term>
105 YAZ C++ demonstration client. This client does not
106 get installed in the system directories.
111 <term>src/yaz-my-server</term>
113 YAZ C++ demonstration server. This server does not
114 get installed in the system directories.
121 <!-- Keep this comment at the end of the file
126 sgml-minimize-attributes:nil
127 sgml-always-quote-attributes:t
130 sgml-parent-document: "yaz++.xml"
131 sgml-local-catalogs: nil
132 sgml-namecase-general:t