2010-08-26 18:50:56 +00:00
|
|
|
/*
|
|
|
|
* CDDL HEADER START
|
|
|
|
*
|
|
|
|
* The contents of this file are subject to the terms of the
|
|
|
|
* Common Development and Distribution License, Version 1.0 only
|
|
|
|
* (the "License"). You may not use this file except in compliance
|
|
|
|
* with the License.
|
|
|
|
*
|
|
|
|
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
|
2022-07-11 21:16:13 +00:00
|
|
|
* or https://opensource.org/licenses/CDDL-1.0.
|
2010-08-26 18:50:56 +00:00
|
|
|
* See the License for the specific language governing permissions
|
|
|
|
* and limitations under the License.
|
|
|
|
*
|
|
|
|
* When distributing Covered Code, include this CDDL HEADER in each
|
|
|
|
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
|
|
|
|
* If applicable, add the following below this CDDL HEADER, with the
|
|
|
|
* fields enclosed by brackets "[]" replaced with your own identifying
|
|
|
|
* information: Portions Copyright [yyyy] [name of copyright owner]
|
|
|
|
*
|
|
|
|
* CDDL HEADER END
|
|
|
|
*/
|
|
|
|
/*
|
|
|
|
* Copyright 2007 Sun Microsystems, Inc. All rights reserved.
|
|
|
|
* Use is subject to license terms.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include_next <assert.h>
|
|
|
|
|
|
|
|
#ifndef _LIBSPL_ASSERT_H
|
2013-11-01 19:26:11 +00:00
|
|
|
#define _LIBSPL_ASSERT_H
|
2010-08-26 18:50:56 +00:00
|
|
|
|
|
|
|
#include <stdio.h>
|
|
|
|
#include <stdlib.h>
|
2017-07-05 17:39:13 +00:00
|
|
|
#include <stdarg.h>
|
2022-02-03 22:35:38 +00:00
|
|
|
#include <sys/types.h>
|
2010-08-26 18:50:56 +00:00
|
|
|
|
Reduce false positives from Static Analyzers
Both Clang's Static Analyzer and Synopsys' Coverity would ignore
assertions. Following Clang's advice, we annotate our assertions:
https://clang-analyzer.llvm.org/annotations.html#custom_assertions
This makes both Clang's Static Analyzer and Coverity properly identify
assertions. This change reduced Clang's reported defects from 246 to
180. It also reduced the false positives reported by Coverityi by 10,
while enabling Coverity to find 9 more defects that previously were
false negatives.
A couple examples of this would be CID-1524417 and CID-1524423. After
submitting a build to coverity with the modified assertions, CID-1524417
disappeared while the report for CID-1524423 no longer claimed that the
assertion tripped.
Coincidentally, it turns out that it is possible to more accurately
annotate our headers than the Coverity modelling file permits in the
case of format strings. Since we can do that and this patch annotates
headers whenever `__coverity_panic__()` would have been used in the
model file, we drop all models that use `__coverity_panic__()` from the
model file.
Upon seeing the success in eliminating false positives involving
assertions, it occurred to me that we could also modify our headers to
eliminate coverity's false positives involving byte swaps. We now have
coverity specific byteswap macros, that do nothing, to disable
Coverity's false positives when we do byte swaps. This allowed us to
also drop the byteswap definitions from the model file.
Lastly, a model file update has been done beyond the mentioned
deletions:
* The definitions of `umem_alloc_aligned()`, `umem_alloc()` andi
`umem_zalloc()` were originally implemented in a way that was
intended to inform coverity that when KM_SLEEP has been passed these
functions, they do not return NULL. A small error in how this was
done was found, so we correct it.
* Definitions for umem_cache_alloc() and umem_cache_free() have been
added.
In practice, no false positives were avoided by making these changes,
but in the interest of correctness from future coverity builds, we make
them anyway.
Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Reviewed-by: Ryan Moeller <ryan@iXsystems.com>
Signed-off-by: Richard Yao <richard.yao@alumni.stonybrook.edu>
Closes #13902
2022-09-30 22:30:12 +00:00
|
|
|
/* Workaround for non-Clang compilers */
|
|
|
|
#ifndef __has_feature
|
|
|
|
#define __has_feature(x) 0
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* We need to workaround libspl_set_assert_ok() that we have for zdb */
|
|
|
|
#if __has_feature(attribute_analyzer_noreturn) || defined(__COVERITY__)
|
|
|
|
#define NORETURN __attribute__((__noreturn__))
|
|
|
|
#else
|
|
|
|
#define NORETURN
|
|
|
|
#endif
|
|
|
|
|
2020-07-04 22:24:13 +00:00
|
|
|
/* Set to non-zero to avoid abort()ing on an assertion failure */
|
2022-02-03 22:35:38 +00:00
|
|
|
extern void libspl_set_assert_ok(boolean_t val);
|
2020-07-04 22:24:13 +00:00
|
|
|
|
|
|
|
/* printf version of libspl_assert */
|
|
|
|
extern void libspl_assertf(const char *file, const char *func, int line,
|
Reduce false positives from Static Analyzers
Both Clang's Static Analyzer and Synopsys' Coverity would ignore
assertions. Following Clang's advice, we annotate our assertions:
https://clang-analyzer.llvm.org/annotations.html#custom_assertions
This makes both Clang's Static Analyzer and Coverity properly identify
assertions. This change reduced Clang's reported defects from 246 to
180. It also reduced the false positives reported by Coverityi by 10,
while enabling Coverity to find 9 more defects that previously were
false negatives.
A couple examples of this would be CID-1524417 and CID-1524423. After
submitting a build to coverity with the modified assertions, CID-1524417
disappeared while the report for CID-1524423 no longer claimed that the
assertion tripped.
Coincidentally, it turns out that it is possible to more accurately
annotate our headers than the Coverity modelling file permits in the
case of format strings. Since we can do that and this patch annotates
headers whenever `__coverity_panic__()` would have been used in the
model file, we drop all models that use `__coverity_panic__()` from the
model file.
Upon seeing the success in eliminating false positives involving
assertions, it occurred to me that we could also modify our headers to
eliminate coverity's false positives involving byte swaps. We now have
coverity specific byteswap macros, that do nothing, to disable
Coverity's false positives when we do byte swaps. This allowed us to
also drop the byteswap definitions from the model file.
Lastly, a model file update has been done beyond the mentioned
deletions:
* The definitions of `umem_alloc_aligned()`, `umem_alloc()` andi
`umem_zalloc()` were originally implemented in a way that was
intended to inform coverity that when KM_SLEEP has been passed these
functions, they do not return NULL. A small error in how this was
done was found, so we correct it.
* Definitions for umem_cache_alloc() and umem_cache_free() have been
added.
In practice, no false positives were avoided by making these changes,
but in the interest of correctness from future coverity builds, we make
them anyway.
Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Reviewed-by: Ryan Moeller <ryan@iXsystems.com>
Signed-off-by: Richard Yao <richard.yao@alumni.stonybrook.edu>
Closes #13902
2022-09-30 22:30:12 +00:00
|
|
|
const char *format, ...) NORETURN __attribute__((format(printf, 4, 5)));
|
2019-11-27 18:45:56 +00:00
|
|
|
|
2016-03-01 14:45:43 +00:00
|
|
|
static inline int
|
|
|
|
libspl_assert(const char *buf, const char *file, const char *func, int line)
|
2010-08-26 18:50:56 +00:00
|
|
|
{
|
2020-07-04 22:24:13 +00:00
|
|
|
libspl_assertf(file, func, line, "%s", buf);
|
|
|
|
return (0);
|
2017-06-28 17:05:16 +00:00
|
|
|
}
|
|
|
|
|
2016-03-01 14:45:43 +00:00
|
|
|
#ifdef verify
|
|
|
|
#undef verify
|
|
|
|
#endif
|
2010-08-26 18:50:56 +00:00
|
|
|
|
2023-12-01 19:50:10 +00:00
|
|
|
#define PANIC(fmt, a...) \
|
|
|
|
libspl_assertf(__FILE__, __FUNCTION__, __LINE__, fmt, ## a)
|
|
|
|
|
2016-03-01 14:45:43 +00:00
|
|
|
#define VERIFY(cond) \
|
|
|
|
(void) ((!(cond)) && \
|
|
|
|
libspl_assert(#cond, __FILE__, __FUNCTION__, __LINE__))
|
|
|
|
#define verify(cond) \
|
|
|
|
(void) ((!(cond)) && \
|
|
|
|
libspl_assert(#cond, __FILE__, __FUNCTION__, __LINE__))
|
2010-08-26 18:50:56 +00:00
|
|
|
|
2018-10-04 03:16:45 +00:00
|
|
|
#define VERIFY3B(LEFT, OP, RIGHT) \
|
2016-03-01 14:45:43 +00:00
|
|
|
do { \
|
2018-10-04 03:16:45 +00:00
|
|
|
const boolean_t __left = (boolean_t)(LEFT); \
|
|
|
|
const boolean_t __right = (boolean_t)(RIGHT); \
|
2017-06-28 17:05:16 +00:00
|
|
|
if (!(__left OP __right)) \
|
|
|
|
libspl_assertf(__FILE__, __FUNCTION__, __LINE__, \
|
2017-07-13 00:15:24 +00:00
|
|
|
"%s %s %s (0x%llx %s 0x%llx)", #LEFT, #OP, #RIGHT, \
|
|
|
|
(u_longlong_t)__left, #OP, (u_longlong_t)__right); \
|
2010-08-26 18:50:56 +00:00
|
|
|
} while (0)
|
|
|
|
|
2018-10-04 03:16:45 +00:00
|
|
|
#define VERIFY3S(LEFT, OP, RIGHT) \
|
|
|
|
do { \
|
|
|
|
const int64_t __left = (int64_t)(LEFT); \
|
|
|
|
const int64_t __right = (int64_t)(RIGHT); \
|
|
|
|
if (!(__left OP __right)) \
|
|
|
|
libspl_assertf(__FILE__, __FUNCTION__, __LINE__, \
|
|
|
|
"%s %s %s (0x%llx %s 0x%llx)", #LEFT, #OP, #RIGHT, \
|
|
|
|
(u_longlong_t)__left, #OP, (u_longlong_t)__right); \
|
|
|
|
} while (0)
|
|
|
|
|
|
|
|
#define VERIFY3U(LEFT, OP, RIGHT) \
|
|
|
|
do { \
|
|
|
|
const uint64_t __left = (uint64_t)(LEFT); \
|
|
|
|
const uint64_t __right = (uint64_t)(RIGHT); \
|
|
|
|
if (!(__left OP __right)) \
|
|
|
|
libspl_assertf(__FILE__, __FUNCTION__, __LINE__, \
|
|
|
|
"%s %s %s (0x%llx %s 0x%llx)", #LEFT, #OP, #RIGHT, \
|
|
|
|
(u_longlong_t)__left, #OP, (u_longlong_t)__right); \
|
|
|
|
} while (0)
|
|
|
|
|
|
|
|
#define VERIFY3P(LEFT, OP, RIGHT) \
|
|
|
|
do { \
|
|
|
|
const uintptr_t __left = (uintptr_t)(LEFT); \
|
|
|
|
const uintptr_t __right = (uintptr_t)(RIGHT); \
|
|
|
|
if (!(__left OP __right)) \
|
|
|
|
libspl_assertf(__FILE__, __FUNCTION__, __LINE__, \
|
2023-08-30 15:13:06 +00:00
|
|
|
"%s %s %s (%p %s %p)", #LEFT, #OP, #RIGHT, \
|
|
|
|
(void *)__left, #OP, (void *)__right); \
|
2018-10-04 03:16:45 +00:00
|
|
|
} while (0)
|
|
|
|
|
|
|
|
#define VERIFY0(LEFT) \
|
|
|
|
do { \
|
|
|
|
const uint64_t __left = (uint64_t)(LEFT); \
|
|
|
|
if (!(__left == 0)) \
|
|
|
|
libspl_assertf(__FILE__, __FUNCTION__, __LINE__, \
|
|
|
|
"%s == 0 (0x%llx == 0)", #LEFT, \
|
|
|
|
(u_longlong_t)__left); \
|
|
|
|
} while (0)
|
2010-08-26 18:50:56 +00:00
|
|
|
|
2023-08-30 15:13:09 +00:00
|
|
|
#define VERIFY0P(LEFT) \
|
|
|
|
do { \
|
|
|
|
const uintptr_t __left = (uintptr_t)(LEFT); \
|
|
|
|
if (!(__left == 0)) \
|
|
|
|
libspl_assertf(__FILE__, __FUNCTION__, __LINE__, \
|
|
|
|
"%s == 0 (%p == 0)", #LEFT, \
|
|
|
|
(void *)__left); \
|
|
|
|
} while (0)
|
|
|
|
|
2016-03-01 14:45:43 +00:00
|
|
|
#ifdef assert
|
|
|
|
#undef assert
|
|
|
|
#endif
|
|
|
|
|
2010-08-26 18:50:56 +00:00
|
|
|
#ifdef NDEBUG
|
libspl: cast to uintptr_t instead of !!ing
This led to these two warning types:
debug.h:139:67: warning: the address of ‘ARC_anon’
will always evaluate as ‘true’ [-Waddress]
139 | #define ASSERT3P(x, y, z)
((void) sizeof (!!(x)), (void) sizeof (!!(z)))
| ^
arc.c:1591:2: note: in expansion of macro ‘ASSERT3P’
1591 | ASSERT3P(hdr->b_l1hdr.b_state, ==, arc_anon);
| ^~~~~~~~
and
arc.h:66:44: warning: ‘<<’ in boolean context,
did you mean ‘<’? [-Wint-in-bool-context]
66 | #define HDR_GET_LSIZE(hdr)
((hdr)->b_lsize << SPA_MINBLOCKSHIFT)
debug.h:138:46: note: in definition of macro ‘ASSERT3U’
138 | #define ASSERT3U(x, y, z)
((void) sizeof (!!(x)), (void) sizeof (!!(z)))
| ^
arc.c:1760:12: note: in expansion of macro ‘HDR_GET_LSIZE’
1760 | ASSERT3U(HDR_GET_LSIZE(hdr), !=, 0);
| ^~~~~~~~~~~~~
Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Closes #13009
2022-01-25 01:05:42 +00:00
|
|
|
#define ASSERT3B(x, y, z) \
|
|
|
|
((void) sizeof ((uintptr_t)(x)), (void) sizeof ((uintptr_t)(z)))
|
|
|
|
#define ASSERT3S(x, y, z) \
|
|
|
|
((void) sizeof ((uintptr_t)(x)), (void) sizeof ((uintptr_t)(z)))
|
|
|
|
#define ASSERT3U(x, y, z) \
|
|
|
|
((void) sizeof ((uintptr_t)(x)), (void) sizeof ((uintptr_t)(z)))
|
|
|
|
#define ASSERT3P(x, y, z) \
|
|
|
|
((void) sizeof ((uintptr_t)(x)), (void) sizeof ((uintptr_t)(z)))
|
|
|
|
#define ASSERT0(x) ((void) sizeof ((uintptr_t)(x)))
|
2023-08-30 15:13:09 +00:00
|
|
|
#define ASSERT0P(x) ((void) sizeof ((uintptr_t)(x)))
|
libspl: cast to uintptr_t instead of !!ing
This led to these two warning types:
debug.h:139:67: warning: the address of ‘ARC_anon’
will always evaluate as ‘true’ [-Waddress]
139 | #define ASSERT3P(x, y, z)
((void) sizeof (!!(x)), (void) sizeof (!!(z)))
| ^
arc.c:1591:2: note: in expansion of macro ‘ASSERT3P’
1591 | ASSERT3P(hdr->b_l1hdr.b_state, ==, arc_anon);
| ^~~~~~~~
and
arc.h:66:44: warning: ‘<<’ in boolean context,
did you mean ‘<’? [-Wint-in-bool-context]
66 | #define HDR_GET_LSIZE(hdr)
((hdr)->b_lsize << SPA_MINBLOCKSHIFT)
debug.h:138:46: note: in definition of macro ‘ASSERT3U’
138 | #define ASSERT3U(x, y, z)
((void) sizeof (!!(x)), (void) sizeof (!!(z)))
| ^
arc.c:1760:12: note: in expansion of macro ‘HDR_GET_LSIZE’
1760 | ASSERT3U(HDR_GET_LSIZE(hdr), !=, 0);
| ^~~~~~~~~~~~~
Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Closes #13009
2022-01-25 01:05:42 +00:00
|
|
|
#define ASSERT(x) ((void) sizeof ((uintptr_t)(x)))
|
|
|
|
#define assert(x) ((void) sizeof ((uintptr_t)(x)))
|
|
|
|
#define IMPLY(A, B) \
|
|
|
|
((void) sizeof ((uintptr_t)(A)), (void) sizeof ((uintptr_t)(B)))
|
|
|
|
#define EQUIV(A, B) \
|
|
|
|
((void) sizeof ((uintptr_t)(A)), (void) sizeof ((uintptr_t)(B)))
|
2010-08-26 18:50:56 +00:00
|
|
|
#else
|
2018-10-04 03:16:45 +00:00
|
|
|
#define ASSERT3B VERIFY3B
|
|
|
|
#define ASSERT3S VERIFY3S
|
|
|
|
#define ASSERT3U VERIFY3U
|
|
|
|
#define ASSERT3P VERIFY3P
|
|
|
|
#define ASSERT0 VERIFY0
|
2023-08-30 15:13:09 +00:00
|
|
|
#define ASSERT0P VERIFY0P
|
2018-10-04 03:16:45 +00:00
|
|
|
#define ASSERT VERIFY
|
|
|
|
#define assert VERIFY
|
2015-06-24 20:54:06 +00:00
|
|
|
#define IMPLY(A, B) \
|
|
|
|
((void)(((!(A)) || (B)) || \
|
2016-03-01 14:45:43 +00:00
|
|
|
libspl_assert("(" #A ") implies (" #B ")", \
|
|
|
|
__FILE__, __FUNCTION__, __LINE__)))
|
2015-06-24 20:54:06 +00:00
|
|
|
#define EQUIV(A, B) \
|
|
|
|
((void)((!!(A) == !!(B)) || \
|
2016-03-01 14:45:43 +00:00
|
|
|
libspl_assert("(" #A ") is equivalent to (" #B ")", \
|
|
|
|
__FILE__, __FUNCTION__, __LINE__)))
|
2015-06-24 20:54:06 +00:00
|
|
|
|
2010-08-26 18:50:56 +00:00
|
|
|
#endif /* NDEBUG */
|
|
|
|
|
|
|
|
#endif /* _LIBSPL_ASSERT_H */
|