From owner-freebsd-current Thu Dec 13 17:40:12 2001 Delivered-To: freebsd-current@freebsd.org Received: from rwcrmhc51.attbi.com (rwcrmhc51.attbi.com [204.127.198.38]) by hub.freebsd.org (Postfix) with ESMTP id 3C5C837B41B for ; Thu, 13 Dec 2001 17:40:07 -0800 (PST) Received: from InterJet.elischer.org ([12.232.206.8]) by rwcrmhc51.attbi.com (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP id <20011214014006.YYIC5010.rwcrmhc51.attbi.com@InterJet.elischer.org> for ; Fri, 14 Dec 2001 01:40:06 +0000 Received: from localhost (localhost.elischer.org [127.0.0.1]) by InterJet.elischer.org (8.9.1a/8.9.1) with ESMTP id RAA17746 for ; Thu, 13 Dec 2001 17:23:12 -0800 (PST) Date: Thu, 13 Dec 2001 17:23:11 -0800 (PST) From: Julian Elischer To: current@freebsd.org Subject: change to ZALLOC(9) man page Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-current@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG By my reading of the code I would like to make the following changes to the documentation for the zone(9) man page; Index: zone.9 =================================================================== RCS file: /home/ncvs/src/share/man/man9/zone.9,v retrieving revision 1.6 diff -u -r1.6 zone.9 --- zone.9 1 Oct 2001 16:09:25 -0000 1.6 +++ zone.9 14 Dec 2001 01:20:08 -0000 @@ -63,8 +63,11 @@ aren't, and provides functions for allocating items from the zone and for releasing them back (which makes them available for later use). .Pp -The zone allocator stores state information inside the items proper, -so structures that will be managed by the zone allocator must reserve +The zone allocator stores state information inside the items proper +while they are not allocated, +so structures that will be managed by the zone allocator +and wish to use the type stable property of zones by leaving some fields +pre-filled between allocations, must reserve two pointers at the very beginning for internal use by the zone allocator, as follows: .Bd -literal @@ -74,6 +77,12 @@ /* rest of structure */ }; .Ed +.Pp +Alternatively they should assume those entries corrupted +after each allocation. After the first allocation of an item, +it will bave been cleared to zeroes, however subsequent allocations +will retain the contents as of the last free, with the exception of the +fields mentionned above. .Pp Zones are created in one of two fashions, depending how far along the boot process is. There is always the chance I'm reading the code wrongly so if you think I'm smoking something, let me know, because there is code in the kernel relying on the fact that these changes are correct. (why I made them). To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message