+ The <literal>server</literal> describes a server and the parameters
+ for this server type. Content for a server:
+ <variablelist>
+ <varlistentry><term>attribute <literal>id</literal> (optional)</term>
+ <listitem>
+ <para>
+ Identifier for this server. Currently not used for anything,
+ but it might be for logging purposes.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term>attribute <literal>listenref</literal> (optional)</term>
+ <listitem>
+ <para>
+ Specifies one or more listeners for this server. Each server ID is
+ separated by a comma.
+ If this attribute is not given, the server is accessible from all
+ listeners. In order for the server to be used for real, however, the
+ virtual host must match if specified in the configuration.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term>element <literal>config</literal> (optional)</term>
+ <listitem>
+ <para>
+ Specifies the server configuration. This is equivalent
+ to the config specified using command line option
+ <literal>-c</literal>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term>element <literal>directory</literal> (optional)</term>
+ <listitem>
+ <para>
+ Specifies a working directory for this backend server. If
+ specified, the YAZ frontend changes current working directory
+ to this directory whenever a backend of this type is
+ started (backend handler bend_start), stopped (backend handler hand_stop)
+ and initialized (bend_init).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term>element <literal>host</literal> (optional)</term>
+ <listitem>
+ <para>
+ Specifies the virtual host for this server. If this is specified
+ a client <emphasis>must</emphasis> specify this host string in
+ order to use this backend.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term>element <literal>cql2rpn</literal> (optional)</term>
+ <listitem>
+ <para>
+ Specifies a filename that includes CQL to RPN conversion for this
+ backend server. See &reference-tools-cql-map;.
+ If given, the backend server will only "see" a Type-1/RPN query.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term>element <literal>ccl2rpn</literal> (optional)</term>
+ <listitem>
+ <para>
+ Specifies a filename that includes CCL to RPN conversion for this
+ backend server. See &reference-tools-ccl-qualifiers;.
+ If given, the backend server will only "see" a Type-1/RPN query.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term>element <literal>stylesheet</literal> (optional)</term>
+ <listitem>
+ <para>
+ Specifies the stylesheet reference to be part of SRU HTTP responses
+ when the client does not specify one. If none is given, then if
+ the client does not specify one, then no stylesheet reference is part of the
+ SRU HTTP response.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term>element <literal>client_query_charset</literal> (optional)</term>
+ <listitem>
+ <para>
+ If specified, a conversion from the character set given to UTF-8 is
+ performed by the generic frontend server. It is only executed for
+ Z39.50 search requests (SRU/Solr are assumed to be UTF-8 encoded already).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term>element <literal>docpath</literal> (optional)</term>
+ <listitem>
+ <para>
+ Specifies a path for local file access using HTTP. All URLs with
+ a leading prefix (/ excluded) that matches the value of <literal>docpath</literal>
+ are used for file access. For example, if the server is to offer
+ access in directory <literal>xsl</literal>, the docpath would be
+ <literal>xsl</literal> and all URLs of the form
+ <literal>http://host/xsl</literal> will result in a local file access.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term>element <literal>explain</literal> (optional)</term>
+ <listitem>
+ <para>
+ Specifies SRW/SRU ZeeRex content for this server. Copied verbatim
+ to the client. As things are now, some of the Explain content
+ seem redundant because host information, etc. is also stored
+ elsewhere.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term>element <literal>maximumrecordsize</literal> (optional)</term>
+ <listitem>
+ <para>
+ Specifies maximum record size/message size, in bytes. This
+ value also serves as the maximum size of <emphasis>incoming</emphasis>
+ packages (for Record Updates etc). It's the same value as that
+ given by the <literal>-k</literal> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term>element <literal>retrievalinfo</literal> (optional)</term>
+ <listitem>
+ <para>
+ Enables the retrieval facility to support conversions and
+ specifications of record formats/types.
+ See <xref linkend="tools.retrieval"/> for
+ more information.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>