Source-Changes-D archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
Re: CVS commit: src/share/man/man9
How about ABI? KASSERT(9) should preserve ABI IMO.
On Tue, Jan 25, 2011 at 11:46:48PM +0000, YAMAMOTO Takashi wrote:
> Module Name: src
> Committed By: yamt
> Date: Tue Jan 25 23:46:48 UTC 2011
>
> Modified Files:
> src/share/man/man9: KASSERT.9
>
> Log Message:
> - add some random notes
>
> Basically, KASSERT() should be used for light-weight checks and
> KDASSERT() should be used for heavier ones.
>
> Callers should not rely on the side effects of expression because,
> depending on the kernel compile options mentioned above, expression might
> not be evaluated at all.
>
> - Xr options(4)
> - bump date
>
>
> To generate a diff of this commit:
> cvs rdiff -u -r1.9 -r1.10 src/share/man/man9/KASSERT.9
>
> Please note that diffs are not public domain; they are subject to the
> copyright notices on the relevant files.
>
> Modified files:
>
> Index: src/share/man/man9/KASSERT.9
> diff -u src/share/man/man9/KASSERT.9:1.9 src/share/man/man9/KASSERT.9:1.10
> --- src/share/man/man9/KASSERT.9:1.9 Fri Oct 29 09:34:03 2010
> +++ src/share/man/man9/KASSERT.9 Tue Jan 25 23:46:48 2011
> @@ -1,4 +1,4 @@
> -.\" $NetBSD: KASSERT.9,v 1.9 2010/10/29 09:34:03 wiz Exp $
> +.\" $NetBSD: KASSERT.9,v 1.10 2011/01/25 23:46:48 yamt Exp $
> .\"
> .\" Copyright (c) 2006 Igor Sobrado
> .\" All rights reserved.
> @@ -24,7 +24,7 @@
> .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
> THE
> .\" POSSIBILITY OF SUCH DAMAGE.
> .\"
> -.Dd October 28, 2010
> +.Dd Janurary 26, 2011
> .Dt KASSERT 9
> .Os
> .Sh NAME
> @@ -63,11 +63,24 @@
> vs
> .Dv DIAGNOSTIC ) .
> .Pp
> +Basically,
> +.Fn KASSERT
> +should be used for light-weight checks and
> +.Fn KDASSERT
> +should be used for heavier ones.
> +.Pp
> +Callers should not rely on the side effects of
> +.Ar expression
> +because, depending on the kernel compile options mentioned above,
> +.Ar expression
> +might not be evaluated at all.
> +.Pp
> The panic message will display the style of assertion (debugging
> vs. diagnostic), the expression that failed and the filename, and line
> number the failure happened on.
> .Sh SEE ALSO
> .Xr config 1 ,
> +.Xr options 4 ,
> .Xr CTASSERT 9 ,
> .Xr panic 9 ,
> .Xr printf 9
>
--
Masao Uebayashi / Tombi Inc. / Tel: +81-90-9141-4635
Home |
Main Index |
Thread Index |
Old Index