UNIX

Note that if your system doesn't have a native ANSI C compiler, you may have to acquire one separately. We recommend GCC.

For UNIX, the GNU tools Autoconf, Automake and Libtool is used to generate Makefiles and configure YAZ for the system. You do not these tools unless you're using the CVS version of YAZ. Generally it should be sufficient to run configure without options, like this:


    ./configure
   

The configure script attempts to use use the C compiler specified by the CC environment variable. If not set, GNU C will be used if it is available. The CFLAGS environment variable holds options to be passed to the C compiler. If you're using Bourne-compatible shell you may pass something like this to use a particular C compiler with optimization enabled:


    CC=/opt/ccs/bin/cc CFLAGS=-O ./configure
   

To customize YAZ the configure script also accepts a set of options. The most important are:

--prefix path

Specifies installation prefix. This is only needed if you run make install later to perform a "system" installation. The prefix is /usr/local if not specified.

--enable-tcpd

The front end server will be built using Wietse's TCP wrapper library. It allows you to allow/deny clients depending on IP number. The TCP wrapper library is commonly used in Linux/BSD distributions.

--enable-threads

YAZ will be built using POSIX threads. Specifically, _REENTRANT will be defined during compilation.

When configured, build the software by typing:

     make
    

The following files are generated by the make process:

lib/libyaz.la

Main YAZ library. This is no ordinary library. It's a Libtool archive. By default, YAZ creates a static library in lib/.libs/libyaz.a.

lib/libyazthread.la

When threading is supported/enabled by configure this GNU libtool library is created. It includes functions that allows YAZ to use threads.

ztest/yaz-ztest

Test Z39.50 server.

client/yaz-client

Z39.50 client for testing the protocol. See chapter YAZ client for more information.

yaz-config

A Bourne-shell script, generate by configure, that specifies how external applications should compile - and link with YAZ.

yaz-comp

The ASN.1 compiler for YAZ. Requires the Tcl Shell, tclsh, in PATH to operate.

zoom/zoomsh

A simple shell implemented on top of the ZOOM functions. The shell is a command line application that allows you to enter simple commands perform to perform ZOOM operations.

zoom/zoomtst1, zoom/zoomtst2, ..

Several small applications that demonstrates the use of ZOOM.

If you wish to install YAZ in system directories such as /usr/local/bin, /usr/local/lib you can type:


    make install
   

You probably need to have root access in order to perform this. You must specify the --prefix option for configure if you wish to install YAZ in other directories than the default /usr/local/.

If you wish to perform an un-installation of YAZ use:


    make uninstall
   

This will only work if you haven't reconfigured YAZ (and therefore changed installation prefix). Note that uninstall will not remove directories created by make install, e.g. /usr/local/include/yaz.