KUNIT_EXPECT_LT(9)
π KUNIT_EXPECT_LT β bestie's guide to "is the left one smaller??" β¨
okay so this is a page from the Kernel API Manual (like, the kernel's own little manual shelf π) and the star of the show is KUNIT_EXPECT_LT. no cap, it's a whole vibe.
π NAME π
KUNIT_EXPECT_LT β an expectation that @left is less than @right. literally that's it, that's the whole job π
β¨ SYNOPSIS β¨
KUNIT_EXPECT_LT (test , left , right );
look at her go π«Ά three little args, one big opinion about which number is smaller.
π§ ARGUMENTS π§
testβ the test context object. like, the group chat this expectation is being announced in π¬leftβ an arbitrary expression that evaluates to a primitive C type. yes bestie, arbitrary β go feral, but it's gotta be a primitive C type πrightβ an arbitrary expression that evaluates to a primitive C type. same deal, other side of the comparison πΈ
π« DESCRIPTION π«
so what it actually does: it sets an expectation that the value left evaluates to is less than the value right evaluates to. tiny, simple, iconic. π¦
and here's the tea β this is semantically equivalent to KUNIT_EXPECT_TRUE(test, (left) < (right)). like, that's not me being shady, that's literally what the page says. fr fr π
so if you wanna understand the deep lore of how this expectation behaves, go read KUNIT_EXPECT_TRUE β it's got more information for you, iykyk π
π SEE ALSO π
Kernel file ./include/kunit/test.h β the source of truth, the mothership, the main character π
and now the whole friend group, alphabetically-ish, in no particular order because chaos is a lifestyle:
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_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)
like, everyone showed up to the party π no gatekeeping here.
lowkey important:leftandrightare expressions, not values, so they get dropped into the comparison as written. don't be weird about it and you're golden π
and that's the page!! sign-off time π this one lives in ./include/kunit (the source), stamped October 2026 in the version/date corner, and honestly? she ate. periodt. π
π₯
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms