From owner-freebsd-doc@FreeBSD.ORG Wed Nov 29 10:20:19 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 3742216A492 for ; Wed, 29 Nov 2006 10:20:19 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [69.147.83.40]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0F8ED43CB8 for ; Wed, 29 Nov 2006 10:20:12 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id kATAKCus009989 for ; Wed, 29 Nov 2006 10:20:12 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id kATAKCKJ009988; Wed, 29 Nov 2006 10:20:12 GMT (envelope-from gnats) Resent-Date: Wed, 29 Nov 2006 10:20:12 GMT Resent-Message-Id: <200611291020.kATAKCKJ009988@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, Beat Gätzi Received: from mx1.FreeBSD.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id BA4AD16A40F for ; Wed, 29 Nov 2006 10:14:44 +0000 (UTC) (envelope-from beat@chruetertee.ch) Received: from mail16.bluewin.ch (mail16.bluewin.ch [195.186.19.63]) by mx1.FreeBSD.org (Postfix) with ESMTP id 88D9F43CAD for ; Wed, 29 Nov 2006 10:14:43 +0000 (GMT) (envelope-from beat@chruetertee.ch) Received: from [213.3.74.96] (213.3.74.96) by mail16.bluewin.ch (Bluewin 7.3.118) id 4513C85201013ACD for FreeBSD-gnats-submit@freebsd.org; Wed, 29 Nov 2006 10:14:42 +0000 Received: by _HOSTNAME_ (sSMTP sendmail emulation); Wed, 29 Nov 2006 11:14:41 +0100 Message-Id: <4513C85201013ACD@mail16.bluewin.ch> (added by postmaster@bluewin.ch) Date: Wed, 29 Nov 2006 11:14:41 +0100 From: "Beat Gaetzi" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/105997: sys/kern/sys_pipe.c refer to tuning(7), but there is no information about kern.ipc.maxpipekva in tuning(7) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Beat Gätzi List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 29 Nov 2006 10:20:19 -0000 >Number: 105997 >Category: docs >Synopsis: sys/kern/sys_pipe.c refer to tuning(7), but there is no information about kern.ipc.maxpipekva in tuning(7) >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: Wed Nov 29 10:20:12 GMT 2006 >Closed-Date: >Last-Modified: >Originator: Beat Gätzi >Release: FreeBSD 6.2-RC1 i386 >Organization: >Environment: System: FreeBSD daedalus.network.local 6.2-RC1 FreeBSD 6.2-RC1 #0: Sun Nov 19 19:23:21 CET 2006 beat@daedalus.network.local:/usr/obj/usr/src/sys/BEASTIE i386 >Description: In sys/kern/sys_pipe.c there is a refer to tuning(7): printf("kern.ipc.maxpipekva exceeded; see tuning(7)\n"); But in share/man/man7/tuning.7 there is no information about this sysctl MIB. >How-To-Repeat: >Fix: - Remove reference to tuning(7) from sys_pipe.c or - Add a paragraph about kern.ipc.maxpipekva to tuning.7. I found some information about this sysctl MIB in the comments of sys_pipe.c, but I'm not sure if this is usefull: * kern.ipc.maxpipekva - This is a hard limit on the amount of pageable * address space available to us in pipe_map. This value is normally * autotuned, but may also be loader tuned. * * kern.ipc.pipekva - This read-only sysctl tracks the current amount of * memory in use by pipes. * * Based on how large pipekva is relative to maxpipekva, the following * will happen: * * 0% - 50%: * New pipes are given 16K of memory backing, pipes may dynamically * grow to as large as 64K where needed. * 50% - 75%: * New pipes are given 4K (or PAGE_SIZE) of memory backing, * existing pipes may NOT grow. * 75% - 100%: * New pipes are given 4K (or PAGE_SIZE) of memory backing, * existing pipes will be shrunk down to 4K whenever possible. >Release-Note: >Audit-Trail: >Unformatted: