X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Finstallation.xml;h=59e7c8216eb888f950699bd4d4447261ecd86252;hb=20f83e699d4868d263393996bd4b98fee045e360;hp=e07f1c944b88400a037e31ccfb0fce820d9a2dc4;hpb=e26f2eaefc5fae6784beb45a1435a4fbfa25f25c;p=yaz-moved-to-github.git diff --git a/doc/installation.xml b/doc/installation.xml index e07f1c9..59e7c82 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -1,7 +1,7 @@ - + Compilation and Installation - Introduction + Introduction The latest version of the software will generally be found at: @@ -42,7 +42,7 @@ let us know about it. If you run into difficulties, we will try to help if we can, and if you solve the problems, we would be happy to include your fixes in the next release. So far, we have mostly avoided - #ifdefs for individual platforms, and we'd + #ifdefs for individual platforms, and we'd like to keep it that way as far as it makes sense. @@ -106,6 +106,15 @@ + YAZ can optionally be compiled with + libpcap support. By default, + configure enables libpcap if it is available. + The libpcap library is required for + ziffy. And without libpcap, + ziffy will not be built. + + + The CQL parser for &yaz; is built using GNU Bison. This tool is only needed if you're using the CVS version of &yaz;. @@ -180,11 +189,11 @@ - --enable-shared - The make process will create shared + --disable-shared + The make process will not create shared libraries (also known as shared objects .so). - By default, no shared libraries are created - - equivalent to --disable-shared. + By default, shared libraries are created - + equivalent to --enable-shared. @@ -231,6 +240,15 @@ experimental. + + + --with-libpcap[=prefix] + + Compile &yaz; with + libpcap support and the + ziffy utility. + + @@ -254,11 +272,11 @@ - src/libyazthread.la + src/libyaz_server.la - When threading is supported/enabled by configure this Libtool - library is created. It includes functions that allows &yaz; - to use threads. + Generic Frontend server. This is an add-on for libyaz.la. + Code in this library uses POSIX threads functions - if they + available on the platform. @@ -273,7 +291,14 @@ YAZ client for more information. - + + ziffy/ziffy + A promiscuous Z39.50 APDU sniffer. + ziffy is only built on systems where libpcap is available. + See for more information. + + + util/yaz-config A Bourne-shell script, generated by configure, that specifies how external applications should compile - and link with @@ -353,7 +378,8 @@ - How to make apps using YAZ on UNIX + + How to make apps using YAZ on UNIX This section describes how to compile - and link your own applications using the &yaz; toolkit. @@ -578,24 +604,24 @@ The following files are generated upon successful compilation: - bin/yaz.dll + bin/yaz3.dll &yaz; release mode multi-threaded Dynamic Link Library. lib/yaz.lib - Import library for yaz.dll. + Import library for yaz3.dll. - bin/yazd.dll + bin/yaz3d.dll &yaz; debug mode multi-threaded Dynamic Link Library. lib/yazd.lib - Import library for yazd.dll. + Import library for yaz3d.dll. bin/yaz-client.exe @@ -630,7 +656,8 @@ - How to make apps using YAZ on WIN32 + + How to make apps using YAZ on WIN32 This section will go though the process of linking your WIN32 applications with &yaz;. @@ -653,9 +680,9 @@ You must link with this library. It's located in the sub directory lib of &yaz;. If you want to link with the debug version of &yaz;, you must - link with yazd.dll instead. + link against yazd.lib instead. - dynamic link library yaz.dll + dynamic link library yaz3.dll This DLL must be in your execution path when you invoke your application. Specifically, you should distribute this