github.com/krum110487/go-htaccess@v0.0.0-20240316004156-60641c8e7598/tests/data/apache_2_2_34/manual/vhosts/fd-limits.html.en (about)

     1  <?xml version="1.0" encoding="ISO-8859-1"?>
     2  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
     3  <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
     4  <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
     5  <!--
     6          XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
     7                This file is generated from xml source: DO NOT EDIT
     8          XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
     9        -->
    10  <title>File Descriptor Limits - Apache HTTP Server Version 2.2</title>
    11  <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
    12  <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
    13  <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" />
    14  <script src="../style/scripts/prettify.min.js" type="text/javascript">
    15  </script>
    16  
    17  <link href="../images/favicon.ico" rel="shortcut icon" /><link href="http://httpd.apache.org/docs/current/vhosts/fd-limits.html" rel="canonical" /></head>
    18  <body id="manual-page" class="no-sidebar"><div id="page-header">
    19  <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
    20  <p class="apache">Apache HTTP Server Version 2.2</p>
    21  <img alt="" src="../images/feather.gif" /></div>
    22  <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
    23  <div id="path">
    24  <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.2</a> &gt; <a href="./">Virtual Hosts</a></div><div id="page-content"><div class="retired"><h4>Please note</h4>
    25              <p> This document refers to a legacy release (<strong>2.2</strong>) of Apache httpd. The active release (<strong>2.4</strong>) is documented <a href="http://httpd.apache.org/docs/current">here</a>. If you have not already upgraded, please follow <a href="http://httpd.apache.org/docs/current/upgrading.html">this link</a> for more information.</p>
    26          <p>You may follow <a href="http://httpd.apache.org/docs/current/vhosts/fd-limits.html">this link</a> to go to the current version of this document.</p></div><div id="preamble"><h1>File Descriptor Limits</h1>
    27  <div class="toplang">
    28  <p><span>Available Languages: </span><a href="../en/vhosts/fd-limits.html" title="English">&nbsp;en&nbsp;</a> |
    29  <a href="../fr/vhosts/fd-limits.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
    30  <a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
    31  <a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
    32  <a href="../tr/vhosts/fd-limits.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
    33  </div>
    34  
    35  
    36      <p>When using a large number of Virtual Hosts, Apache may run
    37      out of available file descriptors (sometimes called <cite>file
    38      handles</cite>) if each Virtual Host specifies different log
    39      files. The total number of file descriptors used by Apache is
    40      one for each distinct error log file, one for every other log
    41      file directive, plus 10-20 for internal use. Unix operating
    42      systems limit the number of file descriptors that may be used
    43      by a process; the limit is typically 64, and may usually be
    44      increased up to a large hard-limit.</p>
    45  
    46      <p>Although Apache attempts to increase the limit as required,
    47      this may not work if:</p>
    48  
    49      <ol>
    50        <li>Your system does not provide the <code>setrlimit()</code>
    51        system call.</li>
    52  
    53        <li>The <code>setrlimit(RLIMIT_NOFILE)</code> call does not
    54        function on your system (such as Solaris 2.3)</li>
    55  
    56        <li>The number of file descriptors required exceeds the hard
    57        limit.</li>
    58        
    59        <li>Your system imposes other limits on file descriptors,
    60        such as a limit on stdio streams only using file descriptors
    61        below 256. (Solaris 2)</li>
    62      </ol>
    63  
    64  	<p>In the event of problems you can:</p>
    65  
    66      <ul>
    67        <li>Reduce the number of log files; don't specify log files
    68        in the <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
    69        sections, but only log to the main log files. (See <a href="#splitlogs">Splitting up your log files</a>, below, for more
    70        information on doing this.)</li>
    71  
    72        <li>
    73          If you system falls into 1 or 2 (above), then increase the
    74          file descriptor limit before starting Apache, using a
    75          script like
    76  
    77          <div class="example"><p><code>
    78            <code>#!/bin/sh<br />
    79             ulimit -S -n 100<br />
    80             exec httpd</code>
    81          </code></p></div>
    82        </li>
    83      </ul>
    84  
    85  </div>
    86  <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
    87  <div class="section">
    88  <h2><a name="splitlogs" id="splitlogs">Splitting up your log files</a></h2>
    89  
    90  <p>If you want to log multiple virtual hosts to the same log file, you
    91  may want to split up the log files afterwards in order to run
    92  statistical analysis of the various virtual hosts. This can be
    93  accomplished in the following manner.</p>
    94  
    95  <p>First, you will need to add the virtual host information to the log
    96  entries. This can be done using the <code class="directive"><a href="../mod/mod_log_config.html#logformat">
    97  LogFormat</a></code>
    98  directive, and the <code>%v</code> variable. Add this to the beginning
    99  of your log format string:</p>
   100  
   101  <div class="example"><p><code>
   102  LogFormat "%v %h %l %u %t \"%r\" %&gt;s %b" vhost<br />
   103  CustomLog logs/multiple_vhost_log vhost
   104  </code></p></div>
   105  
   106  <p>This will create a log file in the common log format, but with the
   107  canonical virtual host (whatever appears in the
   108  <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> directive) prepended to
   109  each line. (See <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> for
   110  more about customizing your log files.)</p>
   111  
   112  <p>When you wish to split your log file into its component parts (one
   113  file per virtual host) you can use the program <code><a href="../programs/other.html">split-logfile</a></code> to accomplish
   114  this. You'll find this program in the <code>support</code> directory
   115  of the Apache distribution.</p>
   116  
   117  <p>Run this program with the command:</p>
   118  
   119  <div class="example"><p><code>
   120  split-logfile &lt; /logs/multiple_vhost_log
   121  </code></p></div>
   122  
   123  <p>This program, when run with the name of your vhost log file, will
   124  generate one file for each virtual host that appears in your log file.
   125  Each file will be called <code>hostname.log</code>.</p>
   126  
   127  </div></div>
   128  <div class="bottomlang">
   129  <p><span>Available Languages: </span><a href="../en/vhosts/fd-limits.html" title="English">&nbsp;en&nbsp;</a> |
   130  <a href="../fr/vhosts/fd-limits.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
   131  <a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
   132  <a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
   133  <a href="../tr/vhosts/fd-limits.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
   134  </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
   135  <script type="text/javascript"><!--//--><![CDATA[//><!--
   136  var comments_shortname = 'httpd';
   137  var comments_identifier = 'http://httpd.apache.org/docs/2.2/vhosts/fd-limits.html';
   138  (function(w, d) {
   139      if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
   140          d.write('<div id="comments_thread"><\/div>');
   141          var s = d.createElement('script');
   142          s.type = 'text/javascript';
   143          s.async = true;
   144          s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
   145          (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
   146      }
   147      else { 
   148          d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
   149      }
   150  })(window, document);
   151  //--><!]]></script></div><div id="footer">
   152  <p class="apache">Copyright 2017 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>
   153  <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
   154  if (typeof(prettyPrint) !== 'undefined') {
   155      prettyPrint();
   156  }
   157  //--><!]]></script>
   158  </body></html>