From owner-cvs-all Thu Dec 6 12:10:19 2001 Delivered-To: cvs-all@freebsd.org Received: from iguana.aciri.org (iguana.aciri.org [192.150.187.36]) by hub.freebsd.org (Postfix) with ESMTP id 22B8737B416; Thu, 6 Dec 2001 12:10:10 -0800 (PST) Received: (from rizzo@localhost) by iguana.aciri.org (8.11.3/8.11.1) id fB6KA9i75232; Thu, 6 Dec 2001 12:10:09 -0800 (PST) (envelope-from rizzo) Date: Thu, 6 Dec 2001 12:10:09 -0800 From: Luigi Rizzo To: Robert Watson Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/share/man/man7 tuning.7 Message-ID: <20011206121009.B74685@iguana.aciri.org> References: <200112061950.fB6JoZS71169@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200112061950.fB6JoZS71169@freefall.freebsd.org> User-Agent: Mutt/1.3.23i Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On Thu, Dec 06, 2001 at 11:50:35AM -0800, Robert Watson wrote: > rwatson 2001/12/06 11:50:35 PST > > Modified files: > share/man/man7 tuning.7 > Log: > o Add an additional .Pp between the send/recvbuffer comments and > the ones on ipfw. Note to self: why does ipfw/dummynet count as > a sysctl in tuning(7)? I have to admit it is the first time i read this manpage, and from the CGI interface on www.freebsd.org, so the one i see might be out of date, but I have the impression that the document should be slightly restructured, by putting a short introduction paragraph listing which subsystems are covered, mentioning that most of the subsystems can be controlled/configured using kernel config options, sysctls and boot-time tunables, and then completely removing the SYSCTL section (whose content goes into the subsystem's sections). Possible structure: STORAGE DISKS Hardware performance tuning FILESYSTEMS sizing partitions, disklabel, newfs, tunefs STRIPING vinum, ccdconfig SWAP swap size, partitioning, etc. MEMORY mbufs, something else ? NETWORK DEVICES which ones are good, which ones are bad, how to improve performances (e.g. interrupt coalescing, polling, issues related to PCI bus) FIREWALL ipfw, ipfilter, dummynet, protection against attacks, IP stack options related to the ip stack (forwarding, various tcp things etc.) SOCKET socket buffer sizes, hard limits, etc. HARDWARE (things here are not very tunable, but at least explain why performance might not be what you expect) CPU specific issues for some CPUs if any MEMORY performance differences between different types of memory BUS performance issues of the PCI/ISA/USB/IDE/SCSI buses I know it takes some work to restructure this manpage in this way, and it might even become long enough to require splitting in separate manpages, but i believe it would become a lot more readable. Also, a lot of the text from the current manpage can be recycled. cheers luigi ----------------------------------+----------------------------------------- Luigi RIZZO, luigi@iet.unipi.it . ACIRI/ICSI (on leave from Univ. di Pisa) http://www.iet.unipi.it/~luigi/ . 1947 Center St, Berkeley CA 94704 Phone: (510) 666 2927 ----------------------------------+----------------------------------------- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message