KUNIT_FAIL(9)

💅 KUNIT_FAIL(9) 💅

Okay bestie, welcome to Kernel API Manual section 9, where we meet KUNIT_FAIL — the icon that always fails on purpose. No cap. 💖

---

🌸 NAME 🌸

KUNIT_FAIL — always causes a test to fail when evaluated. That's it. That's the tweet. 💀

---

✨ SYNOPSIS ✨

KUNIT_FAIL (test , fmt , ... );

---

🎀 ARGUMENTS 🎀

• test — the test context object. It's the little context bubble your assertion lives in. 🫶
• fmt — an informational message to be printed when the assertion is made. Say what you need to say, bestie. 💬
• ... — string format arguments. The rest of the format-string squad. ✨

---

💖 DESCRIPTION 💖

Okay so picture KUNIT_SUCCEED, right? Now flip it. KUNIT_FAIL is the opposite of KUNIT_SUCCEED: it is an expectation that always fails. In other words, it always results in a failed expectation, and consequently it always causes the test case to fail when evaluated. Periodt. 🌈💅

For more information, see KUNIT_EXPECT_TRUE. Go off, queen. 👑

---

👀 SEE ALSO 👀

Kernel file ./include/kunit/test.h — and the whole crew:

• 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_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_warning_suppress(9)
• KUNIT_SUPPRESSED_WARNING_COUNT(9)
• KUNIT_EXPECT_SUPPRESSED_WARNING_COUNT(9)
• KUNIT_ASSERT_SUPPRESSED_WARNING_COUNT(9)

---

Later, bestie — this page is signed by the Kernel API Manual, source/version ./include/kunit, date October 2026. Mwah 💋✨