Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 29 Aug 2008 16:25:31 +0100
From:      "Igor Mozolevsky" <igor@hybrid-lab.co.uk>
To:        "Kirk Strauser" <kirk@strauser.com>
Cc:        current@freebsd.org
Subject:   Re: System, diagnose thyself: auto-documentation for crashes
Message-ID:  <a2b6592c0808290825l53f7d80dv50f7eee5eb08c6e5@mail.gmail.com>
In-Reply-To: <BDDFB834-C15F-4E48-B1D1-B644940FBE42@strauser.com>
References:  <BDDFB834-C15F-4E48-B1D1-B644940FBE42@strauser.com>

next in thread | previous in thread | raw e-mail | index | archive | help
2008/8/29 Kirk Strauser <kirk@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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?a2b6592c0808290825l53f7d80dv50f7eee5eb08c6e5>