blob: e085d1c5ef67ecc498539a6e09cf25b5915e978a (
plain)
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
|
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision : 1717063 -->
<!-- French translation : Lucien GENTIS -->
<!-- $LastChangedRevision: 2015120501 $ -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<modulesynopsis metafile="mod_proxy_fdpass.xml.meta">
<name>mod_proxy_fdpass</name>
<description>Module fournissant le support des processus externes fdpass
à <module>mod_proxy</module></description>
<status>Extension</status>
<sourcefile>mod_proxy_fdpass.c</sourcefile>
<identifier>proxy_fdpass_module</identifier>
<compatibility>Disponible pour unix depuis la version 2.3
du serveur HTTP Apache</compatibility>
<summary>
<p>Pour fonctionner, ce module <em>nécessite</em> le chargement de
<module>mod_proxy</module>. Il permet le passage du socket du client
vers un autre processus.</p>
<p><code>mod_proxy_fdpass</code> utilise la capacité des sockets de
domaine AF_UNIX à <a
href="http://www.freebsd.org/cgi/man.cgi?query=recv">transmettre un
descripteur de fichier ouvert</a> afin de permettre à un autre
processus de terminer le traitement de la requête.
</p>
<p>Le module possède une interface de fournisseur
<code>proxy_fdpass_flusher</code> qui permet éventuellement à un
autre module d'envoyer les en-têtes de la réponse, ou même le début
du corps de la réponse. Le fournisseur par défaut <code>flush</code> désactive la
persistence, et envoie les en-têtes de la réponse, laissant le soin
au processus externe d'envoyer le corps de la réponse.</p>
<p>Pour utiliser un autre fournisseur, vous devez définir le paramètre
<code>flusher</code> de la directive <directive
module="mod_proxy">ProxyPass</directive>.
</p>
<p>A l'heure actuelle, la seule donnée transmise au processus
externe est le socket du client. Pour recevoir un socket client,
appelez recvfrom avec une structure <a
href="http://www.kernel.org/doc/man-pages/online/pages/man3/
cmsg.3.html"><code>struct cmsghdr</code></a> allouée. Les versions
futures de ce module pourront transmettre d'autres données que le
socket client.
</p>
</summary>
<seealso><module>mod_proxy</module></seealso>
</modulesynopsis>
|
