/usr/share/doc/yaz-doc/comstack.introduction.html is in yaz-doc 4.2.30-2.1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>2. Introduction</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="YAZ User's Guide and Reference"><link rel="up" href="comstack.html" title="Chapter 9. The COMSTACK Module"><link rel="prev" href="comstack.html" title="Chapter 9. The COMSTACK Module"><link rel="next" href="comstack.common.html" title="3. Common Functions"></head><body><link rel="stylesheet" type="text/css" href="common/style1.css"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2. Introduction</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="comstack.html">Prev</a> </td><th width="60%" align="center">Chapter 9. The COMSTACK Module</th><td width="20%" align="right"> <a accesskey="n" href="comstack.common.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="comstack.introduction"></a>2. Introduction</h2></div></div></div><p>
The <acronym class="acronym">COMSTACK</acronym>
subsystem provides a transparent interface to different types of transport
stacks for the exchange of BER-encoded data and HTTP packets.
At present, the RFC1729 method (BER over TCP/IP), local UNIX socket and an
experimental SSL stack are supported, but others may be added in time.
The philosophy of the
module is to provide a simple interface by hiding unused options and
facilities of the underlying libraries. This is always done at the risk
of losing generality, and it may prove that the interface will need
extension later on.
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
There hasn't been interest in the XTImOSI stack for some years.
Therefore, it is no longer supported.
</p></div><p>
The interface is implemented in such a fashion that only the
sub-layers constructed to the transport methods that you wish to
use in your application are linked in.
</p><p>
You will note that even though simplicity was a goal in the design,
the interface is still orders of magnitudes more complex than the
transport systems found in many other packages. One reason is that
the interface needs to support the somewhat different requirements of
the different lower-layer communications stacks; another important
reason is that the interface seeks to provide a more or less
industrial-strength approach to asynchronous event-handling.
When no function is allowed to block, things get more complex -
particularly on the server side.
We urge you to have a look at the demonstration client and server
provided with the package. They are meant to be easily readable and
instructive, while still being at least moderately useful.
</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="comstack.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="comstack.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="comstack.common.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 9. The COMSTACK Module </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3. Common Functions</td></tr></table></div></body></html>
|