mod_cgid.html.en revision 23255b04d466bf2621c4dd4ae1b025a9c5639e1a
beaad6ac31022179c44d88536811e9ccd9425696nd<?xml version="1.0" encoding="ISO-8859-1"?>
beaad6ac31022179c44d88536811e9ccd9425696nd<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
beaad6ac31022179c44d88536811e9ccd9425696nd<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
db878466c5e95073429dda0bdd001f45e9486e16fielding XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
db878466c5e95073429dda0bdd001f45e9486e16fielding This file is generated from xml source: DO NOT EDIT
db878466c5e95073429dda0bdd001f45e9486e16fielding XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
db878466c5e95073429dda0bdd001f45e9486e16fielding -->
db878466c5e95073429dda0bdd001f45e9486e16fielding<title>mod_cgid - Apache HTTP Server</title>
db878466c5e95073429dda0bdd001f45e9486e16fielding<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
beaad6ac31022179c44d88536811e9ccd9425696nd<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
beaad6ac31022179c44d88536811e9ccd9425696nd<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
beaad6ac31022179c44d88536811e9ccd9425696nd<script src="/style/scripts/prettify.js" type="text/javascript">
beaad6ac31022179c44d88536811e9ccd9425696nd</script>
beaad6ac31022179c44d88536811e9ccd9425696nd
beaad6ac31022179c44d88536811e9ccd9425696nd<link href="/images/favicon.ico" rel="shortcut icon" /></head>
beaad6ac31022179c44d88536811e9ccd9425696nd<body>
beaad6ac31022179c44d88536811e9ccd9425696nd<div id="page-header">
beaad6ac31022179c44d88536811e9ccd9425696nd<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
beaad6ac31022179c44d88536811e9ccd9425696nd<p class="apache">Apache HTTP Server Version 2.5</p>
01c674544bd4c211141bcd9fb09b96ffc18c6c3dnd<img alt="" src="/images/feather.gif" /></div>
01c674544bd4c211141bcd9fb09b96ffc18c6c3dnd<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<div id="path">
d7e78dbedfc2093a291c4e52eda53c4cbdd606a1nd<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
d7e78dbedfc2093a291c4e52eda53c4cbdd606a1nd<div id="page-content">
01c674544bd4c211141bcd9fb09b96ffc18c6c3dnd<div id="preamble"><h1>Apache Module mod_cgid</h1>
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<div class="toplang">
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<p><span>Available Languages: </span><a href="/en/mod/mod_cgid.html" title="English">&nbsp;en&nbsp;</a> |
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<a href="/ja/mod/mod_cgid.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<a href="/ko/mod/mod_cgid.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</div>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Execution of CGI scripts using an
7e68fce3cbd2246164e045a51ecd77f9f26680ednd external CGI daemon</td></tr>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Base</td></tr>
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<tr><th><a href="module-dict.html#ModuleIdentifier">Module�Identifier:</a></th><td>cgid_module</td></tr>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<tr><th><a href="module-dict.html#SourceFile">Source�File:</a></th><td>mod_cgid.c</td></tr>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<tr><th><a href="module-dict.html#Compatibility">Compatibility:</a></th><td>Unix threaded MPMs only</td></tr></table>
e5343521634b71f10f0e88374d88bd5a45f75f68nd<h3>Summary</h3>
66e48875fca2df6669dab4f2690ee36c6913c0ffnd
66e48875fca2df6669dab4f2690ee36c6913c0ffnd <p>Except for the optimizations and the additional <code class="directive"><a href="#scriptsock">ScriptSock</a></code> directive noted below,
7e68fce3cbd2246164e045a51ecd77f9f26680ednd <code class="module"><a href="/mod/mod_cgid.html">mod_cgid</a></code> behaves similarly to <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code>.
7e68fce3cbd2246164e045a51ecd77f9f26680ednd <strong>See the <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code> summary for additional details
3726777f47ac4bba3e21b075905959bbea47e72eerikabele about Apache and CGI.</strong></p>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd
7e68fce3cbd2246164e045a51ecd77f9f26680ednd <p>On certain unix operating systems, forking a process from a
7e68fce3cbd2246164e045a51ecd77f9f26680ednd multi-threaded server is a very expensive operation because the
bdbf46e4950b6f633073f803486962e82c2f086and new process will replicate all the threads of the parent
7e68fce3cbd2246164e045a51ecd77f9f26680ednd process. In order to avoid incurring this expense on each CGI
7e68fce3cbd2246164e045a51ecd77f9f26680ednd invocation, <code class="module"><a href="/mod/mod_cgid.html">mod_cgid</a></code> creates an external daemon that is
7e68fce3cbd2246164e045a51ecd77f9f26680ednd responsible for forking child processes to run CGI scripts. The
fffabed77cd6264da64fa3d267243d1d76897049nd main server communicates with this daemon using a unix domain
7e68fce3cbd2246164e045a51ecd77f9f26680ednd socket.</p>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd
7e68fce3cbd2246164e045a51ecd77f9f26680ednd <p>This module is used by default instead of
f4a6ce7d0d0311e4da2d4df6812263c562a05a3end <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code> whenever a multi-threaded MPM
f4a6ce7d0d0311e4da2d4df6812263c562a05a3end is selected during the compilation process. At the user level,
7e68fce3cbd2246164e045a51ecd77f9f26680ednd this module is identical in configuration and operation to
7e68fce3cbd2246164e045a51ecd77f9f26680ednd <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code>. The only exception is the
7e68fce3cbd2246164e045a51ecd77f9f26680ednd additional directive <code>ScriptSock</code> which gives the
7e68fce3cbd2246164e045a51ecd77f9f26680ednd name of the socket to use for communication with the cgi
7e68fce3cbd2246164e045a51ecd77f9f26680ednd daemon.</p>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</div>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<div id="quickview"><h3 class="directives">Directives</h3>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<ul id="toc">
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<li><img alt="" src="/images/right.gif" /> <a href="mod_cgi.html#scriptlog">ScriptLog</a></li>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<li><img alt="" src="/images/right.gif" /> <a href="mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></li>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<li><img alt="" src="/images/right.gif" /> <a href="mod_cgi.html#scriptloglength">ScriptLogLength</a></li>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<li><img alt="" src="/images/down.gif" /> <a href="#scriptsock">ScriptSock</a></li>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</ul>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<h3>See also</h3>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<ul class="seealso">
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<li><code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code></li>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<li><a href="/suexec.html">Running CGI programs under different
7e68fce3cbd2246164e045a51ecd77f9f26680ednd user IDs</a></li>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</ul></div>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
e5343521634b71f10f0e88374d88bd5a45f75f68nd<div class="directive-section"><h2><a name="ScriptSock" id="ScriptSock">ScriptSock</a> <a name="scriptsock" id="scriptsock">Directive</a></h2>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<table class="directive">
bdbf46e4950b6f633073f803486962e82c2f086and<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The filename prefix of the socket to use for communication with
7e68fce3cbd2246164e045a51ecd77f9f26680edndthe cgi daemon</td></tr>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ScriptSock <var>file-path</var></code></td></tr>
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ScriptSock logs/cgisock</code></td></tr>
11c3b428f0fc9b03f353ed9b66347c5deb567052nd<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
11c3b428f0fc9b03f353ed9b66347c5deb567052nd<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
11c3b428f0fc9b03f353ed9b66347c5deb567052nd<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cgid</td></tr>
11c3b428f0fc9b03f353ed9b66347c5deb567052nd</table>
11c3b428f0fc9b03f353ed9b66347c5deb567052nd <p>This directive sets the filename prefix of the socket to use for
11c3b428f0fc9b03f353ed9b66347c5deb567052nd communication with the CGI daemon, an extension corresponding to
11c3b428f0fc9b03f353ed9b66347c5deb567052nd the process ID of the server will be appended. The socket will be opened
11c3b428f0fc9b03f353ed9b66347c5deb567052nd using the permissions of the user who starts Apache (usually
11c3b428f0fc9b03f353ed9b66347c5deb567052nd root). To maintain the security of communications with CGI
11c3b428f0fc9b03f353ed9b66347c5deb567052nd scripts, it is important that no other user has permission to
11c3b428f0fc9b03f353ed9b66347c5deb567052nd write in the directory where the socket is located.</p>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd
7e68fce3cbd2246164e045a51ecd77f9f26680ednd <div class="example"><h3>Example</h3><p><code>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd <pre class="prettyprint lang-config">
3726777f47ac4bba3e21b075905959bbea47e72eerikabele ScriptSock /var/run/cgid.sock
7e68fce3cbd2246164e045a51ecd77f9f26680ednd </pre>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd
7e68fce3cbd2246164e045a51ecd77f9f26680ednd </code></p></div>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd
7e68fce3cbd2246164e045a51ecd77f9f26680ednd
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</div>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</div>
e5343521634b71f10f0e88374d88bd5a45f75f68nd<div class="bottomlang">
bdbf46e4950b6f633073f803486962e82c2f086and<p><span>Available Languages: </span><a href="/en/mod/mod_cgid.html" title="English">&nbsp;en&nbsp;</a> |
bdbf46e4950b6f633073f803486962e82c2f086and<a href="/ja/mod/mod_cgid.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<a href="/ko/mod/mod_cgid.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</div><div id="footer">
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<p class="apache">Copyright 2012 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div><script type="text/javascript">
7e68fce3cbd2246164e045a51ecd77f9f26680ednd if (typeof(prettyPrint) !== undefined) {
fd46b0fed4351924170b4db5859dc35b771ee16dnd prettyPrint();
fd46b0fed4351924170b4db5859dc35b771ee16dnd }
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</script>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</body></html>