-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.4//EN"
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY copyright SYSTEM "copyright.xml">
<!ENTITY % idcommon SYSTEM "common/common.ent">
<manvolnum>3mp</manvolnum>
<refmiscinfo class="manual">Metaproxy Module</refmiscinfo>
</refmeta>
-
+
<refnamediv>
<refname>multi</refname>
<refpurpose>Metaproxy Package Multiplexer Module</refpurpose>
</refnamediv>
-
+
<refsect1><title>DESCRIPTION</title>
<para>
This filter multiplexes packages.
<literal><target></literal> elements.
If a target matches a given target specified as CDATA in the
target element, the multi filter will route traffic to the route
- given by the route attribute.
+ given by the route attribute. The target element may also apply
+ credentials to be sent to the target. This is given by the
+ <literal>auth</literal> attribute.
</para>
<para>
A target element is not required for multi-plexing to work.
- It merely serves as a way to route differently.
+ It merely serves as a way to route differently.
</para>
<para>
If an empty
but simply ignored (unless every one of the databases is
unavailable).
</para>
+ <para>
+ If an empty
+ <literal><hideerrors></literal>
+ element is placed inside the
+ <literal>multi</literal>
+ filter, then databases that reports diagnostics are not reported back
+ to the client, but simply ignored (unless every one of the databases report
+ diagnostics).
+ </para>
</refsect1>
-
+
<refsect1><title>SCHEMA</title>
<literallayout><xi:include
xi:href="../xml/schema/filter_multi.rnc"
- xi:parse="text"
+ xi:parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude" />
</literallayout>
</refsect1>
-
+
<refsect1><title>EXAMPLES</title>
<para>
A typical configuration looks like this:
<screen><![CDATA[
<filter type="multi">
- <target route="route1">z3950.loc.gov:7090/voyager</target>
- <target route="route2">bagel.indexdata.dk/gils</target>
+ <target route="route1">lx2.loc.gov:210/LCDB_MARC8</target>
+ <target route="route2">z3950.indexdata.com/gils</target>
+ <target route="route3" auth="myuser/mypass">localhost:9999</target>
<target route="other">*</target>
</filter>
]]>
</screen>
</para>
- </refsect1>
-
+ </refsect1>
+
<refsect1><title>SEE ALSO</title>
<para>
<citerefentry>
</citerefentry>
</para>
</refsect1>
-
+
©right;
</refentry>