projects / egate.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
Run latex
[egate.git] / doc / egate.sgml
diff --git a/doc/egate.sgml b/doc/egate.sgml
index 72963b6..acc7860 100644 (file)
--- a/doc/egate.sgml
+++ b/doc/egate.sgml
@@ -1,13 +1,14 @@
-<!doctype linuxdoc system>
-
-<!--
-  $Id: egate.sgml,v 1.9 1996/04/25 10:21:53 adam Exp $
+        <!doctype linuxdoc system>
+        
+<!--    
+  $Id: egate.sgml,v 1.14 2001/02/26 14:32:36 adam Exp $
 -->
 
 <article>
 -->
 
 <article>
-<title>Email/Z39.50 gateway guide
-<author>Europagate, 1995
-<date>$Revision: 1.9 $
+<title>Email - Z39.50 gateway guide 
+<author>Europagate, 1996 <htmlurl url="http://europagate.dtv.dk"
+ name="http://europagate.dtv.dk">
+<date>$Revision: 1.14 $
 <abstract>
 This document describes a Email server that provides access to the
 Z39.50 protocol.
 <abstract>
 This document describes a Email server that provides access to the
 Z39.50 protocol.
@@ -18,14 +19,15 @@ Z39.50 protocol.
 <sect>Introduction
 
 <p>
 <sect>Introduction
 
 <p>
-This document describes an email server subsystem developed
-within the EUROPAGATE project. The first part of this document
+This document describes an email server (ES) system developed
+within the <htmlurl url="http://europagate.dtv.dk" name="EUROPAGATE">
+project. The first part of this document
 serves as an administrators guide, while the second part is a 
 serves as an administrators guide, while the second part is a 
-follow-up on the Design deliverable (WP4.1) that outline the
+follow-up on the Design deliverable (WP4.1) that outlines the
 deviations from the design. Also, the second part contains
 a quick overview of the source code.
 
 deviations from the design. Also, the second part contains
 a quick overview of the source code.
 
-<sect>Compilation
+<sect>Installation
 
 <p>
 An ANSI C compiler is required in order to compile the ES software.
 
 <p>
 An ANSI C compiler is required in order to compile the ES software.
@@ -37,49 +39,50 @@ one of these first.
 The zdist package can be found in:
 
 <htmlurl
 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">
+url="ftp://ftp.cnidr.org/pub/NIDR.tools/zdist/archive/1.02/zdist102b1-1.tar.Z" 
+name="ftp://ftp.cnidr.org/pub/NIDR.tools/zdist/archive/1.02/zdist102b1-1.tar.Z">
 
 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/:
 
 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/:
-<tscreen><verb>
-$ patch <zdist.patch
-</verb></tscreen>
-
+<verb>patch <zdist.path</verb>
 The ES server only depends on <tt>libz3950.a</tt> so you only need
 to build the zdist software in the directory <tt/libz3950/.
 
 YAZ can be found at the FTP host:
 
 The ES server only depends on <tt>libz3950.a</tt> so you only need
 to build the zdist software in the directory <tt/libz3950/.
 
 YAZ can be found at the FTP host:
 
-<htmlurl url="ftp://ftp.indexdata.dk/index/yaz"
- name="ftp://ftp.indexdata.dk/index/yaz">
+<htmlurl url="ftp://ftp.indexdata.dk/pub/yaz/"
+ name="ftp://ftp.indexdata.dk/pub/yaz/">
 
 
-The ES also use GNU's regex package to parse regular expressions. 
+The ES also uses GNU's regex package to parse regular expressions. 
 The ES has been tested with regex-0.12. Some systems, such as Linux,
 come with the regex package preinstalled.
 
 The ES has been tested with regex-0.12. Some systems, such as Linux,
 come with the regex package preinstalled.
 
-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
-well.
+Unpack <tt>email-z39-...tar.gz</tt> and edit the top level
+<tt/Makefile/. Specify where the GNU regex package is located by
+setting the variables <tt/REGEXOBJ/ and <tt/REGXINC/. 
 
 
-The shell variables <tt/CC/ and <tt/CFLAGS/ are used by the
-<tt/Makefile/ so you may modify these before compiling.
+Some systems need you to add libraries for socket access. In this
+case specify the <tt/ELIB/ variable.
 
 
-Now, type <tt/make email/. 
+The next section of the <tt/Makefile/ you specify the location of your
+Z39.50 library - zdist or YAZ.
 
 
-<sect>Installation
+The shell variables <tt/CC/ and <tt/CFLAGS/ are used by the
+<tt/Makefile/ so you may set these in your shell before you start
+compiling.
+
+Now, run <tt/make/. 
 
 <p>
 If the compilation succeeds, you should install the software in some
 
 <p>
 If the compilation succeeds, you should install the software in some
-system location.
+standard 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.
 
 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.email/.
+When satisfied, type <tt/make install/.
 
 Three executables are installed in EMAILLIBDIR:
 <descrip>
 
 Three executables are installed in EMAILLIBDIR:
 <descrip>
@@ -106,10 +109,10 @@ 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>usr/lib/aliases</tt>). Now add the following line:
 
 as the ES user and edit <tt/aliases/ used by your mail system (usually 
 <tt>usr/lib/aliases</tt>). Now add the following line:
 
-<tt>es:"|/usr/local/lib/es/eti </tt><em>options</em><tt>"</tt>
+<tt>es:"|/usr/local/lib/emailgw/eti </tt><em>options</em><tt>"</tt>
 
 In this example the mail user name is <tt/es/ and the EMAILLIBDIR is
 
 In this example the mail user name is <tt/es/ and the EMAILLIBDIR is
-<tt>/usr/local/lib/es</tt>.
+<tt>/usr/local/lib/emailgw</tt>.
 
 The ES system can operate with or without the monitor. When using
 the monitor the number of simultanous running kernels can be
 
 The ES system can operate with or without the monitor. When using
 the monitor the number of simultanous running kernels can be
@@ -126,7 +129,7 @@ start the monitor in one of your boot scripts (rc). For example this
 might be put in a boot script:
 
 <tscreen><verb>
 might be put in a boot script:
 
 <tscreen><verb>
-(cd /usr/local/lib/es; ./monitor -d -l mon.log -- -d -l kernel.log &)
+(cd /usr/local/lib/emailgw; ./monitor -d -l mon.log -- -d -l kernel.log &)
 </verb></tscreen>
 
 Here the monitor is started with the options <tt>-d -l mon.log</tt>
 </verb></tscreen>
 
 Here the monitor is started with the options <tt>-d -l mon.log</tt>
@@ -135,7 +138,7 @@ kernel. In this mode, the eti should contact the monitor (and not
 the kernel), so the following might be put in the aliases file:
 
 <tscreen><verb>
 the kernel), so the following might be put in the aliases file:
 
 <tscreen><verb>
-es:"|/usr/local/lib/es/eti -c /usr/local/lib/es"
+es:"|/usr/local/lib/emailgw/eti -c /usr/local/lib/emailgw"
 </verb></tscreen>
 
 The eti sets current directory to the path specified by option <tt>-c</tt>.
 </verb></tscreen>
 
 The eti sets current directory to the path specified by option <tt>-c</tt>.
@@ -148,7 +151,7 @@ The eti will contact the kernel directly. The following line could
 be put in your aliases file:
 
 <tscreen><verb>
 be put in your aliases file:
 
 <tscreen><verb>
-es:"|/usr/local/lib/es/eti -c /usr/local/lib/es -- -d -l kernel.log"
+es:"|/usr/local/lib/emailgw/eti -c /usr/local/lib/emailgw -- -d -l kernel.log"
 </verb></tscreen>
 
 <sect1>eti
 </verb></tscreen>
 
 <sect1>eti
@@ -478,9 +481,6 @@ standalone Zdist package</em>
 During the work with the Zdist package a few bugs were discovered.
 Fortunately, they could be solved within a few days. We also
 discovered that the package lacks result-set references.
 During the work with the Zdist package a few bugs were discovered.
 Fortunately, they could be solved within a few days. We also
 discovered that the package lacks result-set references.
-We posted the bug fixes to Kevin Gamiel who is responsible for 
-the package but we didn't get responses. So, eventually, we weren't
-satisfied with the package after all.
 
 In February some of us began the development of a new Z39.50 package 
 called YAZ &mdash; in retrospect somewhat motivated by the 
 
 In February some of us began the development of a new Z39.50 package 
 called YAZ &mdash; in retrospect somewhat motivated by the 
@@ -651,7 +651,7 @@ is a public header file.
 <sect>LICENSE
 
 <p>
 <sect>LICENSE
 
 <p>
- Copyright &copy; 1995, the EUROPAGATE consortium (see below).
+ Copyright &copy; 1995-1996, the EUROPAGATE consortium (see below).
 
  The EUROPAGATE consortium members are:
 
 
  The EUROPAGATE consortium members are:
 
Europgate