From owner-svn-src-all@FreeBSD.ORG  Mon Mar 19 04:46: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 E2E6E1065670;
	Mon, 19 Mar 2012 04:46: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 CE7098FC0A;
	Mon, 19 Mar 2012 04:46: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 q2J4kB1O051765;
	Mon, 19 Mar 2012 04:46:11 GMT (envelope-from bjk@svn.freebsd.org)
Received: (from bjk@localhost)
	by svn.freebsd.org (8.14.4/8.14.4/Submit) id q2J4kBoB051763;
	Mon, 19 Mar 2012 04:46:11 GMT (envelope-from bjk@svn.freebsd.org)
Message-Id: <201203190446.q2J4kBoB051763@svn.freebsd.org>
From: Benjamin Kaduk <bjk@FreeBSD.org>
Date: Mon, 19 Mar 2012 04:46:11 +0000 (UTC)
To: src-committers@freebsd.org, svn-src-all@freebsd.org,
	svn-src-head@freebsd.org
X-SVN-Group: head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Cc: 
Subject: svn commit: r233160 - head/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: Mon, 19 Mar 2012 04:46:12 -0000

Author: bjk (doc committer)
Date: Mon Mar 19 04:46:11 2012
New Revision: 233160
URL: http://svn.freebsd.org/changeset/base/233160

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

Modified:
  head/lib/libc/sys/setfib.2

Modified: head/lib/libc/sys/setfib.2
==============================================================================
--- head/lib/libc/sys/setfib.2	Mon Mar 19 03:27:08 2012	(r233159)
+++ head/lib/libc/sys/setfib.2	Mon Mar 19 04:46:11 2012	(r233160)
@@ -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