1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.4//EN"
2 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
3 <!ENTITY copyright SYSTEM "copyright.xml">
4 <!ENTITY % idcommon SYSTEM "common/common.ent">
7 <refentry id="ref-http_client">
9 <productname>Metaproxy</productname>
10 <info><orgname>Index Data</orgname></info>
14 <refentrytitle>http_client</refentrytitle>
15 <manvolnum>3mp</manvolnum>
16 <refmiscinfo class="manual">Metaproxy Module</refmiscinfo>
20 <refname>http_client</refname>
21 <refpurpose>Metaproxy HTTP File Server Module</refpurpose>
24 <refsect1><title>DESCRIPTION</title>
26 This module implements HTTP client functionality. Filter frontend_net
27 + http_client in combo - acts as a normal, non-transparent, proxy.
30 The element default-host of configuration specifies the default host
31 in remote URL. If this is set, frontend_net + http_client acts as a
32 transparent HTTP proxy as well.
35 The configuration element, proxy, is optional and enables a remote
36 HTTP proxy to be in use.
40 <varlistentry><term>default-host</term>
43 Specifies host for transparant proxy mode.
47 <varlistentry><term>max-redirects</term>
50 Maximum number of HTTP redirects. Default value is 0 (HTTP redirect
55 <varlistentry><term>proxy</term>
58 Specifies HTTP proxy for outgoing connections.
62 <varlistentry><term>x-forwarded-for</term>
65 Is a boolean value (false, true). If true, the peer
66 IP address as seen in frontend_net will be added to
67 x-forwarded HTTP header.
71 <varlistentry><term>bind_host</term>
74 Is a boolean value (false, true). If true, the out going
75 TCP connection will be bound to the same as listening IP.
83 <refsect1><title>SCHEMA</title>
84 <literallayout><xi:include
85 xi:href="../xml/schema/filter_http_client.rnc"
87 xmlns:xi="http://www.w3.org/2001/XInclude" />
91 <refsect1><title>EXAMPLES</title>
93 A typical configuration looks like this:
95 <filter type="http_client">
96 <proxy>localhost:3128</proxy>
103 <refsect1><title>SEE ALSO</title>
106 <refentrytitle>metaproxy</refentrytitle>
107 <manvolnum>1</manvolnum>
115 <!-- Keep this comment at the end of the file