svn commit: r234629 - stable/8/lib/libc/sys

[Benjamin Kaduk]

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