svn commit: r41036 - head/en_US.ISO8859-1/books/faq

[Warren Block]

On Sat, 23 Feb 2013, Eitan Adler wrote:

> 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 at ose.nl>
>  Reviewed by:	Erich Dollansky <erichsfreebsdlist at 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 -> 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>

I do not recall being involved with this particular question at all.