From owner-freebsd-doc@FreeBSD.ORG Tue May 31 05:00:23 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3F339106566C for ; Tue, 31 May 2011 05:00:23 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 0463A8FC16 for ; Tue, 31 May 2011 05:00:23 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p4V50MRQ036783 for ; Tue, 31 May 2011 05:00:22 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p4V50Mkw036782; Tue, 31 May 2011 05:00:22 GMT (envelope-from gnats) Resent-Date: Tue, 31 May 2011 05:00:22 GMT Resent-Message-Id: <201105310500.p4V50Mkw036782@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Ben Kaduk Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4BDFB1065673 for ; Tue, 31 May 2011 04:59:32 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 3C49B8FC1F for ; Tue, 31 May 2011 04:59:32 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p4V4xWJB000380 for ; Tue, 31 May 2011 04:59:32 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id p4V4xV3Y000379; Tue, 31 May 2011 04:59:31 GMT (envelope-from nobody) Message-Id: <201105310459.p4V4xV3Y000379@red.freebsd.org> Date: Tue, 31 May 2011 04:59:31 GMT From: Ben Kaduk To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/157453: Document 16-fib cap in setfib.2 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 31 May 2011 05:00:23 -0000 >Number: 157453 >Category: docs >Synopsis: Document 16-fib cap in setfib.2 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue May 31 05:00:22 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Ben Kaduk >Release: 9-current >Organization: MIT SIPB >Environment: n/a >Description: ipfw.8 currently references setfib.1 (though see docs/157452 which changes this to setfib.2) for explaining why the maximum fib value is 15. But the setfib manual page does not describe this at all. The attached patch provides the requisite documentation, per sys/net/route.h:96. >How-To-Repeat: >Fix: Patch attached with submission follows: --- setfib.2.orig 2011-05-31 00:48:50.000000000 -0400 +++ setfib.2 2011-05-31 00:54:57.000000000 -0400 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD: src/lib/libc/sys/setfib.2,v 1.6 2009/09/18 14:17:00 brueffer Exp $ .\" -.Dd August 8, 2008 +.Dd May 31, 2011 .Dt SETFIB 2 .Os .Sh NAME @@ -49,6 +49,10 @@ may be retrieved by the .Va net.fibs sysctl. +The system maximum is set in the kernel configuration file with +.Pq Cd "options ROUTETABLES=N" . +However, this maximum is capped at 15 due to the implementation storing +the fib number in a 4-bit field in mbuf 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 >Release-Note: >Audit-Trail: >Unformatted: