Re: System, diagnose thyself: auto-documentation for crashes

From: Igor Mozolevsky <igor_at_hybrid-lab.co.uk>
Date: Fri, 29 Aug 2008 16:25:31 +0100
2008/8/29 Kirk Strauser <kirk_at_strauser.com>:
>
> For instance, suppose the comments in sys/vm/uma_core.c looked like:
>
> /*
>  * Frees an item to an INTERNAL zone or allocates a free bucket
>  *
>  * Arguments:
>  *      zone   The zone to free to
>  *      item   The item we're freeing
>  *      udata  User supplied data for the dtor
>  *      skip   Skip dtors and finis
>  *
>  * Failure:
>  *      Failures in this function are commonly due to defective RAM.
>  */

'Crash' would probably be a more meaningful word instead of 'failure'

;-)

--
igor
Received on Fri Aug 29 2008 - 13:46:57 UTC

This archive was generated by hypermail 2.4.0 : Wed May 19 2021 - 11:39:34 UTC