From 132c5a8937b0c711769ce97085dbb57d73b75ff6 Mon Sep 17 00:00:00 2001
From: Murray Stokely <murray@FreeBSD.org>
Date: Fri, 13 Apr 2001 03:30:09 +0000
Subject: [PATCH] Add a section about "file table is full" errors.

Submitted by:	Chern Lee <chern@osd.bsdi.com>
---
 en_US.ISO8859-1/books/faq/book.sgml  | 40 +++++++++++++++++++++++++++-
 en_US.ISO_8859-1/books/faq/book.sgml | 40 +++++++++++++++++++++++++++-
 2 files changed, 78 insertions(+), 2 deletions(-)

diff --git a/en_US.ISO8859-1/books/faq/book.sgml b/en_US.ISO8859-1/books/faq/book.sgml
index 06484818ef..519699d765 100644
--- a/en_US.ISO8859-1/books/faq/book.sgml
+++ b/en_US.ISO8859-1/books/faq/book.sgml
@@ -14,7 +14,7 @@
 
     <corpauthor>The FreeBSD Documentation Project</corpauthor>
 
-    <pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.171 2001/04/12 23:13:47 murray Exp $</pubdate>
+    <pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.172 2001/04/13 02:28:23 dd Exp $</pubdate>
 
     <copyright>
       <year>1995</year>
@@ -4439,6 +4439,44 @@ IO range check 0x00 activate 0x01</screen>
             your problem.</para>
         </answer>
       </qandaentry>
+      <qandaentry>
+        <question>
+          <para><errorname>file: table is full</errorname> shows up
+            repeatedly in dmesg.
+          </para>
+        </question>
+        <answer>
+          <para>
+            This error is caused when you have exhausted the number of
+            available file descriptors on your system.  The file table in
+            memory is full.
+          </para>
+          <para>The solution:</para>
+          <para>
+            Manually adjust the <varname>kern.maxfiles</varname> kernel limit
+            setting.
+          </para>
+          <screen>&prompt.root; <userinput>sysctl -w kern.maxfiles=n</userinput></screen>
+          <para>Adjust <varname>n</varname> according to your system needs.
+            Each open file, socket, or fifo uses one file descriptor.
+            A large-scale server may easily require tens of thousands of
+            file descriptors (10,000+), depending on the kind and number
+            of services running concurrently.</para>
+          <para>The number of default file descriptors set in the kernel is
+            dictated by the</para>
+          <programlisting>maxusers        32</programlisting>
+          <para><varname>maxusers</varname> line in your kernel
+            config file.  Increasing this will proportionally increase
+            <varname>kern.maxfiles</varname>.
+          </para>
+          <para>You can see what <varname>kern.maxfiles</varname> is
+            currently set to by:
+          </para>
+          <screen>&prompt.root; <userinput>sysctl kern.maxfiles</userinput>
+kern.maxfiles: 1064
+          </screen>
+        </answer>
+      </qandaentry>
     </qandaset>
   </chapter>
 
diff --git a/en_US.ISO_8859-1/books/faq/book.sgml b/en_US.ISO_8859-1/books/faq/book.sgml
index 06484818ef..519699d765 100644
--- a/en_US.ISO_8859-1/books/faq/book.sgml
+++ b/en_US.ISO_8859-1/books/faq/book.sgml
@@ -14,7 +14,7 @@
 
     <corpauthor>The FreeBSD Documentation Project</corpauthor>
 
-    <pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.171 2001/04/12 23:13:47 murray Exp $</pubdate>
+    <pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.172 2001/04/13 02:28:23 dd Exp $</pubdate>
 
     <copyright>
       <year>1995</year>
@@ -4439,6 +4439,44 @@ IO range check 0x00 activate 0x01</screen>
             your problem.</para>
         </answer>
       </qandaentry>
+      <qandaentry>
+        <question>
+          <para><errorname>file: table is full</errorname> shows up
+            repeatedly in dmesg.
+          </para>
+        </question>
+        <answer>
+          <para>
+            This error is caused when you have exhausted the number of
+            available file descriptors on your system.  The file table in
+            memory is full.
+          </para>
+          <para>The solution:</para>
+          <para>
+            Manually adjust the <varname>kern.maxfiles</varname> kernel limit
+            setting.
+          </para>
+          <screen>&prompt.root; <userinput>sysctl -w kern.maxfiles=n</userinput></screen>
+          <para>Adjust <varname>n</varname> according to your system needs.
+            Each open file, socket, or fifo uses one file descriptor.
+            A large-scale server may easily require tens of thousands of
+            file descriptors (10,000+), depending on the kind and number
+            of services running concurrently.</para>
+          <para>The number of default file descriptors set in the kernel is
+            dictated by the</para>
+          <programlisting>maxusers        32</programlisting>
+          <para><varname>maxusers</varname> line in your kernel
+            config file.  Increasing this will proportionally increase
+            <varname>kern.maxfiles</varname>.
+          </para>
+          <para>You can see what <varname>kern.maxfiles</varname> is
+            currently set to by:
+          </para>
+          <screen>&prompt.root; <userinput>sysctl kern.maxfiles</userinput>
+kern.maxfiles: 1064
+          </screen>
+        </answer>
+      </qandaentry>
     </qandaset>
   </chapter>