From beat@chruetertee.ch  Wed Nov 29 10:14:44 2006
Return-Path: <beat@chruetertee.ch>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id BA4AD16A40F
	for <FreeBSD-gnats-submit@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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" <beat@chruetertee.ch>
Reply-To: Beat Gtzi <beat@chruetertee.ch>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: sys/kern/sys_pipe.c refer to tuning(7), but there is no information about kern.ipc.maxpipekva in tuning(7)
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>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:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Nov 29 10:20:12 GMT 2006
>Closed-Date:    Sat Jul 21 15:44:58 UTC 2012
>Last-Modified:  Sat Jul 21 15:44:58 UTC 2012
>Originator:     Beat Gtzi
>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:
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Sat Jan 24 01:47:08 UTC 2009 
State-Changed-Why:  
Comment added to the tuning.7 manual page.  Thanks. 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Sat Jan 24 01:47:08 UTC 2009 
Responsible-Changed-Why:  
Over to me. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=105997 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/105997: commit references a PR
Date: Sat, 24 Jan 2009 01:47:00 +0000 (UTC)

 Author: trhodes
 Date: Sat Jan 24 01:46:46 2009
 New Revision: 187661
 URL: http://svn.freebsd.org/changeset/base/187661
 
 Log:
   Add a comment on kern.ipc.maxpipekva.
   
   PR:		105997
   Reviewed by:	keramida
 
 Modified:
   head/share/man/man7/tuning.7
 
 Modified: head/share/man/man7/tuning.7
 ==============================================================================
 --- head/share/man/man7/tuning.7	Sat Jan 24 01:34:22 2009	(r187660)
 +++ head/share/man/man7/tuning.7	Sat Jan 24 01:46:46 2009	(r187661)
 @@ -23,7 +23,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd November 19, 2007
 +.Dd January 23, 2009
  .Dt TUNING 7
  .Os
  .Sh NAME
 @@ -402,6 +402,16 @@ In this document we will only cover the 
  on the system.
  .Pp
  The
 +.Va kern.ipc.maxpipekva
 +loader tunable is used to set a hard limit on the amount of pageable
 +address space available.
 +This value is auto tuned by the system, but may require manual tuning
 +in a few rare cases.
 +Increasing this value to a higher setting, such as `25165824' might
 +improve performance on systems where pageable address space is
 +quickly exhausted.
 +.Pp
 +The
  .Va kern.ipc.shm_use_phys
  sysctl defaults to 0 (off) and may be set to 0 (off) or 1 (on).
  Setting
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Sat Jul 21 15:44:42 UTC 2012 
State-Changed-Why:  
Changes have been merged for awhile now, thanks. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=105997 
>Unformatted:
