From owner-freebsd-doc@FreeBSD.ORG Tue Jun 8 08:09:43 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5B38816A4CE for ; Tue, 8 Jun 2004 08:09:43 +0000 (GMT) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 306CE43D49 for ; Tue, 8 Jun 2004 08:09:43 +0000 (GMT) (envelope-from linimon@lonesome.com) Received: from [192.160.235.2] (cs242743-143.austin.rr.com [24.27.43.143]) (using TLSv1 with cipher RC4-MD5 (128/128 bits)) (No client certificate requested) by mail.soaustin.net (Postfix) with ESMTP id 4548514312 for ; Tue, 8 Jun 2004 03:09:31 -0500 (CDT) From: Mark Linimon Organization: Lonesome Dove Computing Services To: freebsd-doc@FreeBSD.org Date: Tue, 8 Jun 2004 03:07:31 -0500 User-Agent: KMail/1.6.2 MIME-Version: 1.0 Content-Disposition: inline Content-Type: Multipart/Mixed; boundary="Boundary-00=_DPXxAS5CzgjUOeS" Message-Id: <200406080307.31235.linimon@lonesome.com> Subject: RFC: additions to the Glossary X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 08 Jun 2004 08:09:43 -0000 --Boundary-00=_DPXxAS5CzgjUOeS Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Content-Disposition: inline This patch adds definitions for Giant, LOR, NDISulator, OBE, pointyhat, and Project Evil, and expands the entry for BSD. Unless anyone objects, I would like to go ahead and commit these changes. mcl --Boundary-00=_DPXxAS5CzgjUOeS Content-Type: text/x-diff; charset="us-ascii"; name="diff.out" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="diff.out" Index: freebsd-glossary.sgml =================================================================== RCS file: /home/FreeBSD/dcvs/doc/en_US.ISO8859-1/share/sgml/glossary/freebsd-glossary.sgml,v retrieving revision 1.5 diff -u -r1.5 freebsd-glossary.sgml --- freebsd-glossary.sgml 28 Sep 2003 20:25:42 -0000 1.5 +++ freebsd-glossary.sgml 6 Jun 2004 02:07:06 -0000 @@ -17,8 +17,10 @@ BSD This is the name that the Computer Systems Research Group - at Berkeley gave to their improvements and modifications to - AT&T's 32V &unix;. + (CSRG) at The University + of California at Berkeley gave to their improvements + and modifications to + AT&T's 32V &unix;. &os; is a descendant of that work. @@ -40,6 +42,27 @@ + G + + + Giant + + The name of a kernel resource lock that protects a large + set of kernel resources. It is an unwanted remnant of much + earlier BSD kernels which used very coarse + locking mechanisms (for instance, if any process was in the + network stack, every other process was locked out). While + this was adequate in the days where a machine might have only + a few dozen processes, one networking card, and certainly only + one processor, in current times it is an unacceptable + performance bottleneck. &os; developers are actively working + on replacing every occurrence with fine-grained locks that + protect individual resources. + + + + + K @@ -59,6 +82,36 @@ + L + + + Lock Order Reversal + LOR + + The &os; kernel uses a number of resource locks to + arbitrate contention for those resources. A run-time + lock diagnostic system found in &os.current; kernels + (but removed for releases), called &man.witness.4;, + detects the potential for deadlocks due to locking errors. + (&man.witness.4; is actually slightly conservative, so + it is possible to get false positives.) A true positive + report indicates "if you were unlucky, a deadlock would + have happened here". + + True positive LORs tend to get fixed quickly, so + check &a.current.url; and the + + LORs Seen page before posting to the mailing lists. + + + + + LOR + + + + + M @@ -94,12 +147,54 @@ MFS + + + + N + + + NDISUlator + + + O + + + Overtaken By Events + OBE + + Indicates a suggested change (such as a Problem Report + or a feature request) which is no longer relevant or + applicable due to passage of time or more recent changes + to &os;. + + + + + OBE + + + + + P + + Pointy Hat + + A mythical piece of headgear, much like a + dunce cap, awarded to any &os; + committer who breaks the build, makes revision numbers + go backwards, or creates any other kind of havoc in + the source base. Any committer worth his or her salt + will soon accumulate a large collection. The usage is + (almost always?) humorous. + + + Principle Of Least Astonishment POLA @@ -118,6 +213,22 @@ POLA + + + Project Evil + + The working title for the NDISulator, + written by Bill Paul, who named it referring to how awful + it is (from a philosophical standpoint) to need to have + something like this in the first place. The + NDISulator is a special compatibility + module to allow Microsoft Windows™ NDIS miniport + network drivers to be used with &os;/x86. This is usually + the only way to use cards where the driver is closed-source. + See src/sys/compat/ndis/subr_ndis.c. + + + --Boundary-00=_DPXxAS5CzgjUOeS--