<!doctype linuxdoc system>
<!--
- $Id: egate.sgml,v 1.8 1996/01/18 16:07:58 adam Exp $
+ $Id: egate.sgml,v 1.9 1996/04/25 10:21:53 adam Exp $
-->
<article>
<title>Email/Z39.50 gateway guide
<author>Europagate, 1995
-<date>$Revision: 1.8 $
+<date>$Revision: 1.9 $
<abstract>
This document describes a Email server that provides access to the
Z39.50 protocol.
Index Data to interface the Z39.50 protocol. So you need to obtain
one of these first.
-The Zdist package can be found in:
+The zdist package can be found in:
<htmlurl
url="ftp://ftp.cnidr.org/pub/NIDR.tools/zdist/zdist102b1-1.tar.Z"
name="ftp://ftp.cnidr.org/pub/NIDR.tools/zdist/zdist102b1-1.tar.Z">
-The Zdist package doesn't support result-set references. Also, it has a few
+The zdist package doesn't support result-set references. Also, it has a few
bugs. Therefore we've included a patch <tt/zdist.patch/ which fixes
some of these bugs.
Run patch in the directory above <tt/zdist102b1-1/:
</verb></tscreen>
The ES server only depends on <tt>libz3950.a</tt> so you only need
-to build the Zdist software in the directory <tt/libz3950/.
+to build the zdist software in the directory <tt/libz3950/.
YAZ can be found at the FTP host:
-<htmlurl url="ftp://130.225.252.168/index/yaz"
- name="ftp://130.225.252.168/index/yaz">
+<htmlurl url="ftp://ftp.indexdata.dk/index/yaz"
+ name="ftp://ftp.indexdata.dk/index/yaz">
The ES also use GNU's regex package to parse regular expressions.
The ES has been tested with regex-0.12. Some systems, such as Linux,
Unpack <tt>egate.tar.gz</tt> and edit the top level <tt/Makefile/. Specify
where the GNU regex package is located and specify whether you use
-YAZ or Zdist. One some systems, you may have to set the <tt/NETLIB/ as
+YAZ or zdist. One some systems, you may have to set the <tt/NETLIB/ as
well.
The shell variables <tt/CC/ and <tt/CFLAGS/ are used by the
<tt/Makefile/ so you may modify these before compiling.
-Now, type <tt/make/.
+Now, type <tt/make email/.
<sect>Installation
<p>
-If the compilation succeeds, you should install the software.
-Edit the <tt/Makefile/ and set the LIBDIR to the installation
+If the compilation succeeds, you should install the software in some
+system location.
+Edit the <tt/Makefile/ and set EMAILLIBDIR to the installation
directory. Since, the ES is executed by the mail system, and not by a
user, this directory shouldn't be globally executable.
-When satisfied, type <tt/make install/.
+When satisfied, type <tt/make install.email/.
-Three executables are installed in LIBDIR:
+Three executables are installed in EMAILLIBDIR:
<descrip>
<tag/eti/ The email transport interface. This program receives
incoming mail, identifies the user, and delivers the mail request
you create a special user and group for the ES software. In this case
you should use <tt/chmod/ to and set the 'set user ID on execution'
bits on the executable files and give that user read/write/execute
-permissions in LIBDIR.
+permissions in EMAILLIBDIR.
The mail system needs to know about the ES. Pick some name that serves
as the ES user and edit <tt/aliases/ used by your mail system (usually
<tt>es:"|/usr/local/lib/es/eti </tt><em>options</em><tt>"</tt>
-In this example the mail user name is <tt/es/ and the LIBDIR is
+In this example the mail user name is <tt/es/ and the EMAILLIBDIR is
<tt>/usr/local/lib/es</tt>.
The ES system can operate with or without the monitor. When using