From owner-svn-src-all@FreeBSD.ORG  Tue Apr 24 03:29:11 2012
Return-Path: <owner-svn-src-all@FreeBSD.ORG>
Delivered-To: svn-src-all@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 6FA841065670;
	Tue, 24 Apr 2012 03:29:11 +0000 (UTC) (envelope-from bjk@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c])
	by mx1.freebsd.org (Postfix) with ESMTP id 5A4238FC08;
	Tue, 24 Apr 2012 03:29:11 +0000 (UTC)
Received: from svn.freebsd.org (localhost [127.0.0.1])
	by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q3O3TBNw028224;
	Tue, 24 Apr 2012 03:29:11 GMT (envelope-from bjk@svn.freebsd.org)
Received: (from bjk@localhost)
	by svn.freebsd.org (8.14.4/8.14.4/Submit) id q3O3TBqV028222;
	Tue, 24 Apr 2012 03:29:11 GMT (envelope-from bjk@svn.freebsd.org)
Message-Id: <201204240329.q3O3TBqV028222@svn.freebsd.org>
From: Benjamin Kaduk <bjk@FreeBSD.org>
Date: Tue, 24 Apr 2012 03:29:11 +0000 (UTC)
To: src-committers@freebsd.org, svn-src-all@freebsd.org,
	svn-src-stable@freebsd.org, svn-src-stable-8@freebsd.org
X-SVN-Group: stable-8
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Cc: 
Subject: svn commit: r234629 - stable/8/lib/libc/sys
X-BeenThere: svn-src-all@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "SVN commit messages for the entire src tree \(except for &quot;
	user&quot; and &quot; projects&quot; \)" <svn-src-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
	<mailto:svn-src-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-all>
List-Post: <mailto:svn-src-all@freebsd.org>
List-Help: <mailto:svn-src-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
	<mailto:svn-src-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 24 Apr 2012 03:29:11 -0000

Author: bjk (doc committer)
Date: Tue Apr 24 03:29:10 2012
New Revision: 234629
URL: http://svn.freebsd.org/changeset/base/234629

Log:
  MFC r233160:
      Expound a bit more about the system maximum number of FIBs,
      how it may be set, and current limitations on the value.
  
  PR:		docs/157453
  Approved by:	hrs (mentor)

Modified:
  stable/8/lib/libc/sys/setfib.2
Directory Properties:
  stable/8/lib/libc/   (props changed)
  stable/8/lib/libc/sys/   (props changed)

Modified: stable/8/lib/libc/sys/setfib.2
==============================================================================
--- stable/8/lib/libc/sys/setfib.2	Tue Apr 24 03:27:27 2012	(r234628)
+++ stable/8/lib/libc/sys/setfib.2	Tue Apr 24 03:29:10 2012	(r234629)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd August 8, 2008
+.Dd March 19, 2012
 .Dt SETFIB 2
 .Os
 .Sh NAME
@@ -45,10 +45,28 @@ subsequent to the call, to be that of th
 The
 .Fa fib
 argument
-may be between 0 and the current system maximum which 
+must be greater than or equal to 0
+and less than the current system maximum which
 may be retrieved by the 
 .Va net.fibs
 sysctl.
+The system maximum is set in the kernel configuration file with
+.Pp
+.Dl options	ROUTETABLES= Ns Em N
+.Pp
+or in
+.Pa /boot/loader.conf
+with
+.Pp
+.Dl net.fibs= Ns Qq Em N
+.Pp
+where
+.Em N
+is an integer.
+However, this maximum is capped at 16 due to the implementation storing
+the fib number in a 4-bit field in
+.Xr mbuf 9
+flags.
 The default fib of the process will be applied to all protocol families 
 that support multiple fibs, and ignored by those that do not.
 The default fib for a process may be overridden for a socket with the use