Bug 174226

Summary: [patch] faq: lock-order-reversal
Product: Documentation Reporter: Bas Smeelen <b.smeelen>
Component: Books & ArticlesAssignee: Eitan Adler <eadler>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Bas Smeelen 2012-12-06 11:50:00 UTC

    
Comment 1 Eitan Adler freebsd_committer freebsd_triage 2012-12-06 12:37:58 UTC
Responsible Changed
From-To: freebsd-doc->eadler

I'll take it.
Comment 2 dfilter service freebsd_committer freebsd_triage 2013-02-23 14:50:47 UTC
Author: eadler
Date: Sat Feb 23 14:50:24 2013
New Revision: 41036
URL: http://svnweb.freebsd.org/changeset/doc/41036

Log:
  Update the lock-order-reversal question
  
  PR:		docs/174226
  Submitted by:	Bas Smeelen <b.smeelen@ose.nl>
  Reviewed by:	Erich Dollansky <erichsfreebsdlist@alogt.com>
  Reviewed by:	avg
  Reviewed by:	bjk
  Discussed with:	wblock
  Approved by:	??? (mentor)

Modified:
  head/en_US.ISO8859-1/books/faq/book.xml

Modified: head/en_US.ISO8859-1/books/faq/book.xml
==============================================================================
--- head/en_US.ISO8859-1/books/faq/book.xml	Sat Feb 23 14:49:59 2013	(r41035)
+++ head/en_US.ISO8859-1/books/faq/book.xml	Sat Feb 23 14:50:24 2013	(r41036)
@@ -2493,9 +2493,19 @@ kern.timecounter.hardware: TSC -&gt; i82
 	</question>
 
 	<answer>
-	  <para>An answer for this question can be found in the &os;
-	    Glossary, see <ulink
-	      url="&url.books.handbook;/freebsd-glossary.html#lor-glossary">LOR</ulink>.</para>
+	  <para>The &os; kernel uses a number of resource locks to
+	    arbitrate contention for certain 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.
+	    (It is possible to get false positives, as &man.witness.4;
+	    is slightly conservative.) A true positive report
+	    indicates that "if you were unlucky, a deadlock would have
+	    happened here">.</para>
+
+	  <para>Problematic <acronym>LOR</acronym>s tend to get fixed
+	    quickly, so check &a.current.url; before posting to the
+	    mailing lists.</para>
 	</answer>
       </qandaentry>
 
_______________________________________________
svn-doc-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
Comment 3 Eitan Adler freebsd_committer freebsd_triage 2013-02-23 15:00:42 UTC
State Changed
From-To: open->closed

Committed. Thanks!