/usr/share/polipo/www/doc/POST-and-PUT.html is in polipo 1.0.4.1-1.2.
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 | <html lang="en">
<head>
<title>POST and PUT - The Polipo Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="The Polipo Manual">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Background.html#Background" title="Background">
<link rel="prev" href="Partial-instances.html#Partial-instances" title="Partial instances">
<link rel="next" href="Other-HTTP-proxies.html#Other-HTTP-proxies" title="Other HTTP proxies">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 2003 -- 2006 by Juliusz Chroboczek.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="POST-and-PUT"></a>
<p>
Next: <a rel="next" accesskey="n" href="Other-HTTP-proxies.html#Other-HTTP-proxies">Other HTTP proxies</a>,
Previous: <a rel="previous" accesskey="p" href="Partial-instances.html#Partial-instances">Partial instances</a>,
Up: <a rel="up" accesskey="u" href="Background.html#Background">Background</a>
<hr>
</div>
<h3 class="section">1.6 Other requests</h3>
<p><a name="index-GET-request-17"></a><a name="index-HEAD-request-18"></a><a name="index-PUT-request-19"></a><a name="index-POST-request-20"></a><a name="index-OPTIONS-request-21"></a><a name="index-PROPFIND-request-22"></a>
The previous sections pretend that there is only one kind of request
in HTTP — the ‘<samp><span class="samp">GET</span></samp>’ request. In fact, there are some others.
<p>The ‘<samp><span class="samp">HEAD</span></samp>’ request method retrieves data about an resource. Polipo
does not normally use ‘<samp><span class="samp">HEAD</span></samp>’, but will fall back to using it for
validation it if finds that a given server fails to cooperate with its
standard validation methods (see <a href="Cache-transparency.html#Cache-transparency">Cache transparency</a>). Polipo will
correctly reply to a client's ‘<samp><span class="samp">HEAD</span></samp>’ request.
<p>The ‘<samp><span class="samp">POST</span></samp>’ method is used to request that the server should do
something rather than merely sending an entity; it is usually used
with HTML forms that have an effect<a rel="footnote" href="#fn-1" name="fnd-1"><sup>1</sup></a>. The ‘<samp><span class="samp">PUT</span></samp>’ method is used to replace an
resource with a different instance; it is typically used by web
publishing applications.
<p>‘<samp><span class="samp">POST</span></samp>’ and ‘<samp><span class="samp">PUT</span></samp>’ requests are handled by Polipo pretty much
like ‘<samp><span class="samp">GET</span></samp>’ and ‘<samp><span class="samp">HEAD</span></samp>’; however, for various reasons, some
precautions must be taken. In particular, any cached data for the
resource they refer to must be discarded, and they can never be
pipelined.
<p>Finally, HTTP/1.1 includes a convenient backdoor with the
‘<samp><span class="samp">CONNECT</span></samp>’ method. For more information, please see
<a href="Tunnelling-connections.html#Tunnelling-connections">Tunnelling connections</a>.
<p>Polipo does not currently handle the more exotic methods such as
‘<samp><span class="samp">OPTIONS</span></samp>’ and ‘<samp><span class="samp">PROPFIND</span></samp>’.
<div class="footnote">
<hr>
<h4>Fußnoten</h4><p class="footnote"><small>[<a name="fn-1" href="#fnd-1">1</a>]</small> HTML forms should use the
‘<samp><span class="samp">GET</span></samp>’ method when the form has no side-effect as this makes the
results cacheable.</p>
<hr></div>
</body></html>
|