kunit_warning_suppress(9)

🎀 kunit_warning_suppress(9) — Kernel API Manual 🎀

🌸 NAME 🌸

kunit_warning_suppress — suppress WARN*() backtraces for the duration of a block. bestie, that's literally the whole serve: you get a block where the warning backtraces are muted. 💅

✨ SYNOPSIS ✨

kunit_warning_suppress (test );

🎀 ARGUMENTS 🎀

• test — the test context object. main character energy: hand it over and let the scoped suppression do its thing.

💖 DESCRIPTION 💖

This is the scoped form of the suppression API. Suppression starts when the block is entered and ends automatically when the block exits through any path — yes, ANY path — because the cleanup is built in. See the section comment above for the cleanup guarantees on each exit path. ✨

Warning, bestie: it fails the test if suppression is already active. Nesting is not supported, so don't try to stack these blocks like friendship bracelets — it's not that kind of party. 😭

While you're inside the block, the warning count can be checked via KUNIT_EXPECT_SUPPRESSED_WARNING_COUNT. The handle is not accessible after the block exits, so no sneaky peeking afterward. 🙈

Example:

kunit_warning_suppress(test) {
    trigger_warning;
    KUNIT_EXPECT_SUPPRESSED_WARNING_COUNT(test, 1);
}

🦋 SEE ALSO 🦋

Kernel file: ./include/kunit/test.h. Then the whole friend group:

• enum kunit_status(9), struct kunit_case(9), KUNIT_CASE(9), KUNIT_CASE_ATTR(9), KUNIT_CASE_SLOW(9), KUNIT_CASE_PARAM(9), KUNIT_CASE_PARAM_ATTR(9), KUNIT_CASE_PARAM_WITH_INIT(9), struct kunit_suite(9), struct kunit(9), kunit_test_suites(9), kunit_test_init_section_suites(9)
• kunit_kmalloc_array(9), kunit_kmalloc(9), kunit_kfree(9), kunit_kzalloc(9), kunit_kcalloc(9), kunit_kfree_const(9), kunit_kstrdup(9), kunit_kstrdup_const(9), kunit_attach_mm(9), kunit_vm_mmap(9), kunit_mark_skipped(9), kunit_skip(9), kunit_info(9), kunit_warn(9), kunit_err(9)
• KUNIT_SUCCEED(9), KUNIT_FAIL(9), KUNIT_EXPECT_TRUE(9), KUNIT_EXPECT_FALSE(9), KUNIT_EXPECT_EQ(9), KUNIT_EXPECT_PTR_EQ(9), KUNIT_EXPECT_NE(9), KUNIT_EXPECT_PTR_NE(9), KUNIT_EXPECT_LT(9), KUNIT_EXPECT_LE(9), KUNIT_EXPECT_GT(9), KUNIT_EXPECT_GE(9), KUNIT_EXPECT_STREQ(9), KUNIT_EXPECT_STRNEQ(9), KUNIT_EXPECT_MEMEQ(9), KUNIT_EXPECT_MEMNEQ(9), KUNIT_EXPECT_NULL(9), KUNIT_EXPECT_NOT_NULL(9), KUNIT_EXPECT_NOT_ERR_OR_NULL(9)
• KUNIT_FAIL_AND_ABORT(9), KUNIT_ASSERT_TRUE(9), KUNIT_ASSERT_FALSE(9), KUNIT_ASSERT_EQ(9), KUNIT_ASSERT_PTR_EQ(9), KUNIT_ASSERT_NE(9), KUNIT_ASSERT_PTR_NE(9), KUNIT_ASSERT_LT(9), KUNIT_ASSERT_LE(9), KUNIT_ASSERT_GT(9), KUNIT_ASSERT_GE(9), KUNIT_ASSERT_STREQ(9), KUNIT_ASSERT_STRNEQ(9), KUNIT_ASSERT_MEMEQ(9), KUNIT_ASSERT_MEMNEQ(9), KUNIT_ASSERT_NULL(9), KUNIT_ASSERT_NOT_NULL(9), KUNIT_ASSERT_NOT_ERR_OR_NULL(9)
• KUNIT_ARRAY_PARAM(9), KUNIT_ARRAY_PARAM_DESC(9), kunit_register_params_array(9), KUNIT_SUPPRESSED_WARNING_COUNT(9), KUNIT_EXPECT_SUPPRESSED_WARNING_COUNT(9), KUNIT_ASSERT_SUPPRESSED_WARNING_COUNT(9)

signed off from the Kernel API Manual — source/version: ./include/kunit · date: October 2026 ✨ stay suppressive, bestie 💅