/usr/share/polipo/www/doc/Client-connections.html is in polipo 1.1.1-5.
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 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 2003 - 2014 by Juliusz Chroboczek. -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>The Polipo Manual: Client connections</title>
<meta name="description" content="The Polipo Manual: Client connections">
<meta name="keywords" content="The Polipo Manual: Client connections">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Variable-index.html#Variable-index" rel="index" title="Variable index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Network.html#Network" rel="up" title="Network">
<link href="Access-control.html#Access-control" rel="next" title="Access control">
<link href="Network.html#Network" rel="prev" title="Network">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Client-connections"></a>
<div class="header">
<p>
Next: <a href="Contacting-servers.html#Contacting-servers" accesskey="n" rel="next">Contacting servers</a>, Previous: <a href="Network.html#Network" accesskey="p" rel="prev">Network</a>, Up: <a href="Network.html#Network" accesskey="u" rel="up">Network</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Variable-index.html#Variable-index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Client-connections-1"></a>
<h3 class="section">3.1 Client connections</h3>
<a name="index-proxyAddress"></a>
<a name="index-proxyPort"></a>
<a name="index-proxyName"></a>
<a name="index-displayName"></a>
<a name="index-address"></a>
<a name="index-port"></a>
<a name="index-IPv6"></a>
<a name="index-proxy-loop"></a>
<a name="index-loop"></a>
<a name="index-proxy-name"></a>
<a name="index-via"></a>
<a name="index-loopback-address"></a>
<a name="index-security"></a>
<p>There are three fundamental values that control how Polipo speaks to
clients. The variable <code>proxyAddress</code>, defines the IP address on
which Polipo will listen; by default, its value is the <em>loopback
address</em> <code>"127.0.0.1"</code>, meaning that Polipo will listen on the
IPv4 loopback interface (the local host) only. By setting this
variable to a global IP address or to one of the special values
<code>"::"</code> or <code>"0.0.0.0"</code>, it is possible to allow Polipo to
serve remote clients. This is likely to be a security hole unless you
set <code>allowedClients</code> to a reasonable value (see <a href="Access-control.html#Access-control">Access control</a>).
</p>
<p>Note that the type of address that you specify for <code>proxyAddress</code>
will determine whether Polipo listens to IPv4 or IPv6. Currently, the
only way to have Polipo listen to both protocols is to specify the
IPv6 unspecified address (<code>"::"</code>) for <code>proxyAddress</code>.
</p>
<p>The variable <code>proxyPort</code>, by default 8123, defines the TCP port
on which Polipo will listen.
</p>
<p>The variable <code>proxyName</code>, which defaults to the host name of the
machine on which Polipo is running, defines the <em>name</em> of the
proxy. This can be an arbitrary string that should be unique among
all instances of Polipo that you are running. Polipo uses it in error
messages and optionally for detecting proxy loops (by using the
‘<samp>Via</samp>’ HTTP header, see <a href="Censoring-headers.html#Censoring-headers">Censoring headers</a>). Finally, the
<code>displayName</code> variable specifies the name used in user-visible
error messages (default “Polipo”).
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="Access-control.html#Access-control" accesskey="1">Access control</a>:</td><td> </td><td align="left" valign="top">Deciding who can connect.
</td></tr>
</table>
<hr>
<div class="header">
<p>
Next: <a href="Contacting-servers.html#Contacting-servers" accesskey="n" rel="next">Contacting servers</a>, Previous: <a href="Network.html#Network" accesskey="p" rel="prev">Network</a>, Up: <a href="Network.html#Network" accesskey="u" rel="up">Network</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Variable-index.html#Variable-index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|