YAZ User's Guide and Reference
Prev | Chapter 2. Compilation and Installation | Next

# 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`.

Prev | Home | Next
Compilation and Installation | Up | WIN32