mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-10-30 08:02:30 +00:00
1ff522b6ef
Add KUnit tests to the hlist linked-list structure which is used by hashtables. This should give coverage of every function and macro in list.h, as well as (combined with the KUnit tests for the hash functions) get very close to having tests for the hashtable structure. The tests here mirror the existing list tests, and are found in a new suite titled 'hlist'. Signed-off-by: David Gow <davidgow@google.com> Reviewed-by: Brendan Higgins <brendanhiggins@google.com> Signed-off-by: Shuah Khan <skhan@linuxfoundation.org>
1204 lines
28 KiB
C
1204 lines
28 KiB
C
// SPDX-License-Identifier: GPL-2.0
|
|
/*
|
|
* KUnit test for the Kernel Linked-list structures.
|
|
*
|
|
* Copyright (C) 2019, Google LLC.
|
|
* Author: David Gow <davidgow@google.com>
|
|
*/
|
|
#include <kunit/test.h>
|
|
|
|
#include <linux/list.h>
|
|
|
|
struct list_test_struct {
|
|
int data;
|
|
struct list_head list;
|
|
};
|
|
|
|
static void list_test_list_init(struct kunit *test)
|
|
{
|
|
/* Test the different ways of initialising a list. */
|
|
struct list_head list1 = LIST_HEAD_INIT(list1);
|
|
struct list_head list2;
|
|
LIST_HEAD(list3);
|
|
struct list_head *list4;
|
|
struct list_head *list5;
|
|
|
|
INIT_LIST_HEAD(&list2);
|
|
|
|
list4 = kzalloc(sizeof(*list4), GFP_KERNEL | __GFP_NOFAIL);
|
|
INIT_LIST_HEAD(list4);
|
|
|
|
list5 = kmalloc(sizeof(*list5), GFP_KERNEL | __GFP_NOFAIL);
|
|
memset(list5, 0xFF, sizeof(*list5));
|
|
INIT_LIST_HEAD(list5);
|
|
|
|
/* list_empty_careful() checks both next and prev. */
|
|
KUNIT_EXPECT_TRUE(test, list_empty_careful(&list1));
|
|
KUNIT_EXPECT_TRUE(test, list_empty_careful(&list2));
|
|
KUNIT_EXPECT_TRUE(test, list_empty_careful(&list3));
|
|
KUNIT_EXPECT_TRUE(test, list_empty_careful(list4));
|
|
KUNIT_EXPECT_TRUE(test, list_empty_careful(list5));
|
|
|
|
kfree(list4);
|
|
kfree(list5);
|
|
}
|
|
|
|
static void list_test_list_add(struct kunit *test)
|
|
{
|
|
struct list_head a, b;
|
|
LIST_HEAD(list);
|
|
|
|
list_add(&a, &list);
|
|
list_add(&b, &list);
|
|
|
|
/* should be [list] -> b -> a */
|
|
KUNIT_EXPECT_PTR_EQ(test, list.next, &b);
|
|
KUNIT_EXPECT_PTR_EQ(test, b.prev, &list);
|
|
KUNIT_EXPECT_PTR_EQ(test, b.next, &a);
|
|
}
|
|
|
|
static void list_test_list_add_tail(struct kunit *test)
|
|
{
|
|
struct list_head a, b;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&a, &list);
|
|
list_add_tail(&b, &list);
|
|
|
|
/* should be [list] -> a -> b */
|
|
KUNIT_EXPECT_PTR_EQ(test, list.next, &a);
|
|
KUNIT_EXPECT_PTR_EQ(test, a.prev, &list);
|
|
KUNIT_EXPECT_PTR_EQ(test, a.next, &b);
|
|
}
|
|
|
|
static void list_test_list_del(struct kunit *test)
|
|
{
|
|
struct list_head a, b;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&a, &list);
|
|
list_add_tail(&b, &list);
|
|
|
|
/* before: [list] -> a -> b */
|
|
list_del(&a);
|
|
|
|
/* now: [list] -> b */
|
|
KUNIT_EXPECT_PTR_EQ(test, list.next, &b);
|
|
KUNIT_EXPECT_PTR_EQ(test, b.prev, &list);
|
|
}
|
|
|
|
static void list_test_list_replace(struct kunit *test)
|
|
{
|
|
struct list_head a_old, a_new, b;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&a_old, &list);
|
|
list_add_tail(&b, &list);
|
|
|
|
/* before: [list] -> a_old -> b */
|
|
list_replace(&a_old, &a_new);
|
|
|
|
/* now: [list] -> a_new -> b */
|
|
KUNIT_EXPECT_PTR_EQ(test, list.next, &a_new);
|
|
KUNIT_EXPECT_PTR_EQ(test, b.prev, &a_new);
|
|
}
|
|
|
|
static void list_test_list_replace_init(struct kunit *test)
|
|
{
|
|
struct list_head a_old, a_new, b;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&a_old, &list);
|
|
list_add_tail(&b, &list);
|
|
|
|
/* before: [list] -> a_old -> b */
|
|
list_replace_init(&a_old, &a_new);
|
|
|
|
/* now: [list] -> a_new -> b */
|
|
KUNIT_EXPECT_PTR_EQ(test, list.next, &a_new);
|
|
KUNIT_EXPECT_PTR_EQ(test, b.prev, &a_new);
|
|
|
|
/* check a_old is empty (initialized) */
|
|
KUNIT_EXPECT_TRUE(test, list_empty_careful(&a_old));
|
|
}
|
|
|
|
static void list_test_list_swap(struct kunit *test)
|
|
{
|
|
struct list_head a, b;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&a, &list);
|
|
list_add_tail(&b, &list);
|
|
|
|
/* before: [list] -> a -> b */
|
|
list_swap(&a, &b);
|
|
|
|
/* after: [list] -> b -> a */
|
|
KUNIT_EXPECT_PTR_EQ(test, &b, list.next);
|
|
KUNIT_EXPECT_PTR_EQ(test, &a, list.prev);
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, &a, b.next);
|
|
KUNIT_EXPECT_PTR_EQ(test, &list, b.prev);
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, &list, a.next);
|
|
KUNIT_EXPECT_PTR_EQ(test, &b, a.prev);
|
|
}
|
|
|
|
static void list_test_list_del_init(struct kunit *test)
|
|
{
|
|
struct list_head a, b;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&a, &list);
|
|
list_add_tail(&b, &list);
|
|
|
|
/* before: [list] -> a -> b */
|
|
list_del_init(&a);
|
|
/* after: [list] -> b, a initialised */
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, list.next, &b);
|
|
KUNIT_EXPECT_PTR_EQ(test, b.prev, &list);
|
|
KUNIT_EXPECT_TRUE(test, list_empty_careful(&a));
|
|
}
|
|
|
|
static void list_test_list_del_init_careful(struct kunit *test)
|
|
{
|
|
/* NOTE: This test only checks the behaviour of this function in
|
|
* isolation. It does not verify memory model guarantees.
|
|
*/
|
|
struct list_head a, b;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&a, &list);
|
|
list_add_tail(&b, &list);
|
|
|
|
/* before: [list] -> a -> b */
|
|
list_del_init_careful(&a);
|
|
/* after: [list] -> b, a initialised */
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, list.next, &b);
|
|
KUNIT_EXPECT_PTR_EQ(test, b.prev, &list);
|
|
KUNIT_EXPECT_TRUE(test, list_empty_careful(&a));
|
|
}
|
|
|
|
static void list_test_list_move(struct kunit *test)
|
|
{
|
|
struct list_head a, b;
|
|
LIST_HEAD(list1);
|
|
LIST_HEAD(list2);
|
|
|
|
list_add_tail(&a, &list1);
|
|
list_add_tail(&b, &list2);
|
|
|
|
/* before: [list1] -> a, [list2] -> b */
|
|
list_move(&a, &list2);
|
|
/* after: [list1] empty, [list2] -> a -> b */
|
|
|
|
KUNIT_EXPECT_TRUE(test, list_empty(&list1));
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, &a, list2.next);
|
|
KUNIT_EXPECT_PTR_EQ(test, &b, a.next);
|
|
}
|
|
|
|
static void list_test_list_move_tail(struct kunit *test)
|
|
{
|
|
struct list_head a, b;
|
|
LIST_HEAD(list1);
|
|
LIST_HEAD(list2);
|
|
|
|
list_add_tail(&a, &list1);
|
|
list_add_tail(&b, &list2);
|
|
|
|
/* before: [list1] -> a, [list2] -> b */
|
|
list_move_tail(&a, &list2);
|
|
/* after: [list1] empty, [list2] -> b -> a */
|
|
|
|
KUNIT_EXPECT_TRUE(test, list_empty(&list1));
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, &b, list2.next);
|
|
KUNIT_EXPECT_PTR_EQ(test, &a, b.next);
|
|
}
|
|
|
|
static void list_test_list_bulk_move_tail(struct kunit *test)
|
|
{
|
|
struct list_head a, b, c, d, x, y;
|
|
struct list_head *list1_values[] = { &x, &b, &c, &y };
|
|
struct list_head *list2_values[] = { &a, &d };
|
|
struct list_head *ptr;
|
|
LIST_HEAD(list1);
|
|
LIST_HEAD(list2);
|
|
int i = 0;
|
|
|
|
list_add_tail(&x, &list1);
|
|
list_add_tail(&y, &list1);
|
|
|
|
list_add_tail(&a, &list2);
|
|
list_add_tail(&b, &list2);
|
|
list_add_tail(&c, &list2);
|
|
list_add_tail(&d, &list2);
|
|
|
|
/* before: [list1] -> x -> y, [list2] -> a -> b -> c -> d */
|
|
list_bulk_move_tail(&y, &b, &c);
|
|
/* after: [list1] -> x -> b -> c -> y, [list2] -> a -> d */
|
|
|
|
list_for_each(ptr, &list1) {
|
|
KUNIT_EXPECT_PTR_EQ(test, ptr, list1_values[i]);
|
|
i++;
|
|
}
|
|
KUNIT_EXPECT_EQ(test, i, 4);
|
|
i = 0;
|
|
list_for_each(ptr, &list2) {
|
|
KUNIT_EXPECT_PTR_EQ(test, ptr, list2_values[i]);
|
|
i++;
|
|
}
|
|
KUNIT_EXPECT_EQ(test, i, 2);
|
|
}
|
|
|
|
static void list_test_list_is_head(struct kunit *test)
|
|
{
|
|
struct list_head a, b, c;
|
|
|
|
/* Two lists: [a] -> b, [c] */
|
|
INIT_LIST_HEAD(&a);
|
|
INIT_LIST_HEAD(&c);
|
|
list_add_tail(&b, &a);
|
|
|
|
KUNIT_EXPECT_TRUE_MSG(test, list_is_head(&a, &a),
|
|
"Head element of same list");
|
|
KUNIT_EXPECT_FALSE_MSG(test, list_is_head(&a, &b),
|
|
"Non-head element of same list");
|
|
KUNIT_EXPECT_FALSE_MSG(test, list_is_head(&a, &c),
|
|
"Head element of different list");
|
|
}
|
|
|
|
|
|
static void list_test_list_is_first(struct kunit *test)
|
|
{
|
|
struct list_head a, b;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&a, &list);
|
|
list_add_tail(&b, &list);
|
|
|
|
KUNIT_EXPECT_TRUE(test, list_is_first(&a, &list));
|
|
KUNIT_EXPECT_FALSE(test, list_is_first(&b, &list));
|
|
}
|
|
|
|
static void list_test_list_is_last(struct kunit *test)
|
|
{
|
|
struct list_head a, b;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&a, &list);
|
|
list_add_tail(&b, &list);
|
|
|
|
KUNIT_EXPECT_FALSE(test, list_is_last(&a, &list));
|
|
KUNIT_EXPECT_TRUE(test, list_is_last(&b, &list));
|
|
}
|
|
|
|
static void list_test_list_empty(struct kunit *test)
|
|
{
|
|
struct list_head a;
|
|
LIST_HEAD(list1);
|
|
LIST_HEAD(list2);
|
|
|
|
list_add_tail(&a, &list1);
|
|
|
|
KUNIT_EXPECT_FALSE(test, list_empty(&list1));
|
|
KUNIT_EXPECT_TRUE(test, list_empty(&list2));
|
|
}
|
|
|
|
static void list_test_list_empty_careful(struct kunit *test)
|
|
{
|
|
/* This test doesn't check correctness under concurrent access */
|
|
struct list_head a;
|
|
LIST_HEAD(list1);
|
|
LIST_HEAD(list2);
|
|
|
|
list_add_tail(&a, &list1);
|
|
|
|
KUNIT_EXPECT_FALSE(test, list_empty_careful(&list1));
|
|
KUNIT_EXPECT_TRUE(test, list_empty_careful(&list2));
|
|
}
|
|
|
|
static void list_test_list_rotate_left(struct kunit *test)
|
|
{
|
|
struct list_head a, b;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&a, &list);
|
|
list_add_tail(&b, &list);
|
|
|
|
/* before: [list] -> a -> b */
|
|
list_rotate_left(&list);
|
|
/* after: [list] -> b -> a */
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, list.next, &b);
|
|
KUNIT_EXPECT_PTR_EQ(test, b.prev, &list);
|
|
KUNIT_EXPECT_PTR_EQ(test, b.next, &a);
|
|
}
|
|
|
|
static void list_test_list_rotate_to_front(struct kunit *test)
|
|
{
|
|
struct list_head a, b, c, d;
|
|
struct list_head *list_values[] = { &c, &d, &a, &b };
|
|
struct list_head *ptr;
|
|
LIST_HEAD(list);
|
|
int i = 0;
|
|
|
|
list_add_tail(&a, &list);
|
|
list_add_tail(&b, &list);
|
|
list_add_tail(&c, &list);
|
|
list_add_tail(&d, &list);
|
|
|
|
/* before: [list] -> a -> b -> c -> d */
|
|
list_rotate_to_front(&c, &list);
|
|
/* after: [list] -> c -> d -> a -> b */
|
|
|
|
list_for_each(ptr, &list) {
|
|
KUNIT_EXPECT_PTR_EQ(test, ptr, list_values[i]);
|
|
i++;
|
|
}
|
|
KUNIT_EXPECT_EQ(test, i, 4);
|
|
}
|
|
|
|
static void list_test_list_is_singular(struct kunit *test)
|
|
{
|
|
struct list_head a, b;
|
|
LIST_HEAD(list);
|
|
|
|
/* [list] empty */
|
|
KUNIT_EXPECT_FALSE(test, list_is_singular(&list));
|
|
|
|
list_add_tail(&a, &list);
|
|
|
|
/* [list] -> a */
|
|
KUNIT_EXPECT_TRUE(test, list_is_singular(&list));
|
|
|
|
list_add_tail(&b, &list);
|
|
|
|
/* [list] -> a -> b */
|
|
KUNIT_EXPECT_FALSE(test, list_is_singular(&list));
|
|
}
|
|
|
|
static void list_test_list_cut_position(struct kunit *test)
|
|
{
|
|
struct list_head entries[3], *cur;
|
|
LIST_HEAD(list1);
|
|
LIST_HEAD(list2);
|
|
int i = 0;
|
|
|
|
list_add_tail(&entries[0], &list1);
|
|
list_add_tail(&entries[1], &list1);
|
|
list_add_tail(&entries[2], &list1);
|
|
|
|
/* before: [list1] -> entries[0] -> entries[1] -> entries[2] */
|
|
list_cut_position(&list2, &list1, &entries[1]);
|
|
/* after: [list2] -> entries[0] -> entries[1], [list1] -> entries[2] */
|
|
|
|
list_for_each(cur, &list2) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 2);
|
|
|
|
list_for_each(cur, &list1) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
i++;
|
|
}
|
|
}
|
|
|
|
static void list_test_list_cut_before(struct kunit *test)
|
|
{
|
|
struct list_head entries[3], *cur;
|
|
LIST_HEAD(list1);
|
|
LIST_HEAD(list2);
|
|
int i = 0;
|
|
|
|
list_add_tail(&entries[0], &list1);
|
|
list_add_tail(&entries[1], &list1);
|
|
list_add_tail(&entries[2], &list1);
|
|
|
|
/* before: [list1] -> entries[0] -> entries[1] -> entries[2] */
|
|
list_cut_before(&list2, &list1, &entries[1]);
|
|
/* after: [list2] -> entries[0], [list1] -> entries[1] -> entries[2] */
|
|
|
|
list_for_each(cur, &list2) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 1);
|
|
|
|
list_for_each(cur, &list1) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
i++;
|
|
}
|
|
}
|
|
|
|
static void list_test_list_splice(struct kunit *test)
|
|
{
|
|
struct list_head entries[5], *cur;
|
|
LIST_HEAD(list1);
|
|
LIST_HEAD(list2);
|
|
int i = 0;
|
|
|
|
list_add_tail(&entries[0], &list1);
|
|
list_add_tail(&entries[1], &list1);
|
|
list_add_tail(&entries[2], &list2);
|
|
list_add_tail(&entries[3], &list2);
|
|
list_add_tail(&entries[4], &list1);
|
|
|
|
/* before: [list1]->e[0]->e[1]->e[4], [list2]->e[2]->e[3] */
|
|
list_splice(&list2, &entries[1]);
|
|
/* after: [list1]->e[0]->e[1]->e[2]->e[3]->e[4], [list2] uninit */
|
|
|
|
list_for_each(cur, &list1) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 5);
|
|
}
|
|
|
|
static void list_test_list_splice_tail(struct kunit *test)
|
|
{
|
|
struct list_head entries[5], *cur;
|
|
LIST_HEAD(list1);
|
|
LIST_HEAD(list2);
|
|
int i = 0;
|
|
|
|
list_add_tail(&entries[0], &list1);
|
|
list_add_tail(&entries[1], &list1);
|
|
list_add_tail(&entries[2], &list2);
|
|
list_add_tail(&entries[3], &list2);
|
|
list_add_tail(&entries[4], &list1);
|
|
|
|
/* before: [list1]->e[0]->e[1]->e[4], [list2]->e[2]->e[3] */
|
|
list_splice_tail(&list2, &entries[4]);
|
|
/* after: [list1]->e[0]->e[1]->e[2]->e[3]->e[4], [list2] uninit */
|
|
|
|
list_for_each(cur, &list1) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 5);
|
|
}
|
|
|
|
static void list_test_list_splice_init(struct kunit *test)
|
|
{
|
|
struct list_head entries[5], *cur;
|
|
LIST_HEAD(list1);
|
|
LIST_HEAD(list2);
|
|
int i = 0;
|
|
|
|
list_add_tail(&entries[0], &list1);
|
|
list_add_tail(&entries[1], &list1);
|
|
list_add_tail(&entries[2], &list2);
|
|
list_add_tail(&entries[3], &list2);
|
|
list_add_tail(&entries[4], &list1);
|
|
|
|
/* before: [list1]->e[0]->e[1]->e[4], [list2]->e[2]->e[3] */
|
|
list_splice_init(&list2, &entries[1]);
|
|
/* after: [list1]->e[0]->e[1]->e[2]->e[3]->e[4], [list2] empty */
|
|
|
|
list_for_each(cur, &list1) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 5);
|
|
|
|
KUNIT_EXPECT_TRUE(test, list_empty_careful(&list2));
|
|
}
|
|
|
|
static void list_test_list_splice_tail_init(struct kunit *test)
|
|
{
|
|
struct list_head entries[5], *cur;
|
|
LIST_HEAD(list1);
|
|
LIST_HEAD(list2);
|
|
int i = 0;
|
|
|
|
list_add_tail(&entries[0], &list1);
|
|
list_add_tail(&entries[1], &list1);
|
|
list_add_tail(&entries[2], &list2);
|
|
list_add_tail(&entries[3], &list2);
|
|
list_add_tail(&entries[4], &list1);
|
|
|
|
/* before: [list1]->e[0]->e[1]->e[4], [list2]->e[2]->e[3] */
|
|
list_splice_tail_init(&list2, &entries[4]);
|
|
/* after: [list1]->e[0]->e[1]->e[2]->e[3]->e[4], [list2] empty */
|
|
|
|
list_for_each(cur, &list1) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 5);
|
|
|
|
KUNIT_EXPECT_TRUE(test, list_empty_careful(&list2));
|
|
}
|
|
|
|
static void list_test_list_entry(struct kunit *test)
|
|
{
|
|
struct list_test_struct test_struct;
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, &test_struct, list_entry(&(test_struct.list),
|
|
struct list_test_struct, list));
|
|
}
|
|
|
|
static void list_test_list_entry_is_head(struct kunit *test)
|
|
{
|
|
struct list_test_struct test_struct1, test_struct2, test_struct3;
|
|
|
|
INIT_LIST_HEAD(&test_struct1.list);
|
|
INIT_LIST_HEAD(&test_struct3.list);
|
|
|
|
list_add_tail(&test_struct2.list, &test_struct1.list);
|
|
|
|
KUNIT_EXPECT_TRUE_MSG(test,
|
|
list_entry_is_head((&test_struct1), &test_struct1.list, list),
|
|
"Head element of same list");
|
|
KUNIT_EXPECT_FALSE_MSG(test,
|
|
list_entry_is_head((&test_struct2), &test_struct1.list, list),
|
|
"Non-head element of same list");
|
|
KUNIT_EXPECT_FALSE_MSG(test,
|
|
list_entry_is_head((&test_struct3), &test_struct1.list, list),
|
|
"Head element of different list");
|
|
}
|
|
|
|
static void list_test_list_first_entry(struct kunit *test)
|
|
{
|
|
struct list_test_struct test_struct1, test_struct2;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&test_struct1.list, &list);
|
|
list_add_tail(&test_struct2.list, &list);
|
|
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, &test_struct1, list_first_entry(&list,
|
|
struct list_test_struct, list));
|
|
}
|
|
|
|
static void list_test_list_last_entry(struct kunit *test)
|
|
{
|
|
struct list_test_struct test_struct1, test_struct2;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&test_struct1.list, &list);
|
|
list_add_tail(&test_struct2.list, &list);
|
|
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, &test_struct2, list_last_entry(&list,
|
|
struct list_test_struct, list));
|
|
}
|
|
|
|
static void list_test_list_first_entry_or_null(struct kunit *test)
|
|
{
|
|
struct list_test_struct test_struct1, test_struct2;
|
|
LIST_HEAD(list);
|
|
|
|
KUNIT_EXPECT_FALSE(test, list_first_entry_or_null(&list,
|
|
struct list_test_struct, list));
|
|
|
|
list_add_tail(&test_struct1.list, &list);
|
|
list_add_tail(&test_struct2.list, &list);
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, &test_struct1,
|
|
list_first_entry_or_null(&list,
|
|
struct list_test_struct, list));
|
|
}
|
|
|
|
static void list_test_list_next_entry(struct kunit *test)
|
|
{
|
|
struct list_test_struct test_struct1, test_struct2;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&test_struct1.list, &list);
|
|
list_add_tail(&test_struct2.list, &list);
|
|
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, &test_struct2, list_next_entry(&test_struct1,
|
|
list));
|
|
}
|
|
|
|
static void list_test_list_prev_entry(struct kunit *test)
|
|
{
|
|
struct list_test_struct test_struct1, test_struct2;
|
|
LIST_HEAD(list);
|
|
|
|
list_add_tail(&test_struct1.list, &list);
|
|
list_add_tail(&test_struct2.list, &list);
|
|
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, &test_struct1, list_prev_entry(&test_struct2,
|
|
list));
|
|
}
|
|
|
|
static void list_test_list_for_each(struct kunit *test)
|
|
{
|
|
struct list_head entries[3], *cur;
|
|
LIST_HEAD(list);
|
|
int i = 0;
|
|
|
|
list_add_tail(&entries[0], &list);
|
|
list_add_tail(&entries[1], &list);
|
|
list_add_tail(&entries[2], &list);
|
|
|
|
list_for_each(cur, &list) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 3);
|
|
}
|
|
|
|
static void list_test_list_for_each_prev(struct kunit *test)
|
|
{
|
|
struct list_head entries[3], *cur;
|
|
LIST_HEAD(list);
|
|
int i = 2;
|
|
|
|
list_add_tail(&entries[0], &list);
|
|
list_add_tail(&entries[1], &list);
|
|
list_add_tail(&entries[2], &list);
|
|
|
|
list_for_each_prev(cur, &list) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
i--;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, -1);
|
|
}
|
|
|
|
static void list_test_list_for_each_safe(struct kunit *test)
|
|
{
|
|
struct list_head entries[3], *cur, *n;
|
|
LIST_HEAD(list);
|
|
int i = 0;
|
|
|
|
|
|
list_add_tail(&entries[0], &list);
|
|
list_add_tail(&entries[1], &list);
|
|
list_add_tail(&entries[2], &list);
|
|
|
|
list_for_each_safe(cur, n, &list) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
list_del(&entries[i]);
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 3);
|
|
KUNIT_EXPECT_TRUE(test, list_empty(&list));
|
|
}
|
|
|
|
static void list_test_list_for_each_prev_safe(struct kunit *test)
|
|
{
|
|
struct list_head entries[3], *cur, *n;
|
|
LIST_HEAD(list);
|
|
int i = 2;
|
|
|
|
list_add_tail(&entries[0], &list);
|
|
list_add_tail(&entries[1], &list);
|
|
list_add_tail(&entries[2], &list);
|
|
|
|
list_for_each_prev_safe(cur, n, &list) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
list_del(&entries[i]);
|
|
i--;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, -1);
|
|
KUNIT_EXPECT_TRUE(test, list_empty(&list));
|
|
}
|
|
|
|
static void list_test_list_for_each_entry(struct kunit *test)
|
|
{
|
|
struct list_test_struct entries[5], *cur;
|
|
LIST_HEAD(list);
|
|
int i = 0;
|
|
|
|
for (i = 0; i < 5; ++i) {
|
|
entries[i].data = i;
|
|
list_add_tail(&entries[i].list, &list);
|
|
}
|
|
|
|
i = 0;
|
|
|
|
list_for_each_entry(cur, &list, list) {
|
|
KUNIT_EXPECT_EQ(test, cur->data, i);
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 5);
|
|
}
|
|
|
|
static void list_test_list_for_each_entry_reverse(struct kunit *test)
|
|
{
|
|
struct list_test_struct entries[5], *cur;
|
|
LIST_HEAD(list);
|
|
int i = 0;
|
|
|
|
for (i = 0; i < 5; ++i) {
|
|
entries[i].data = i;
|
|
list_add_tail(&entries[i].list, &list);
|
|
}
|
|
|
|
i = 4;
|
|
|
|
list_for_each_entry_reverse(cur, &list, list) {
|
|
KUNIT_EXPECT_EQ(test, cur->data, i);
|
|
i--;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, -1);
|
|
}
|
|
|
|
static struct kunit_case list_test_cases[] = {
|
|
KUNIT_CASE(list_test_list_init),
|
|
KUNIT_CASE(list_test_list_add),
|
|
KUNIT_CASE(list_test_list_add_tail),
|
|
KUNIT_CASE(list_test_list_del),
|
|
KUNIT_CASE(list_test_list_replace),
|
|
KUNIT_CASE(list_test_list_replace_init),
|
|
KUNIT_CASE(list_test_list_swap),
|
|
KUNIT_CASE(list_test_list_del_init),
|
|
KUNIT_CASE(list_test_list_del_init_careful),
|
|
KUNIT_CASE(list_test_list_move),
|
|
KUNIT_CASE(list_test_list_move_tail),
|
|
KUNIT_CASE(list_test_list_bulk_move_tail),
|
|
KUNIT_CASE(list_test_list_is_head),
|
|
KUNIT_CASE(list_test_list_is_first),
|
|
KUNIT_CASE(list_test_list_is_last),
|
|
KUNIT_CASE(list_test_list_empty),
|
|
KUNIT_CASE(list_test_list_empty_careful),
|
|
KUNIT_CASE(list_test_list_rotate_left),
|
|
KUNIT_CASE(list_test_list_rotate_to_front),
|
|
KUNIT_CASE(list_test_list_is_singular),
|
|
KUNIT_CASE(list_test_list_cut_position),
|
|
KUNIT_CASE(list_test_list_cut_before),
|
|
KUNIT_CASE(list_test_list_splice),
|
|
KUNIT_CASE(list_test_list_splice_tail),
|
|
KUNIT_CASE(list_test_list_splice_init),
|
|
KUNIT_CASE(list_test_list_splice_tail_init),
|
|
KUNIT_CASE(list_test_list_entry),
|
|
KUNIT_CASE(list_test_list_entry_is_head),
|
|
KUNIT_CASE(list_test_list_first_entry),
|
|
KUNIT_CASE(list_test_list_last_entry),
|
|
KUNIT_CASE(list_test_list_first_entry_or_null),
|
|
KUNIT_CASE(list_test_list_next_entry),
|
|
KUNIT_CASE(list_test_list_prev_entry),
|
|
KUNIT_CASE(list_test_list_for_each),
|
|
KUNIT_CASE(list_test_list_for_each_prev),
|
|
KUNIT_CASE(list_test_list_for_each_safe),
|
|
KUNIT_CASE(list_test_list_for_each_prev_safe),
|
|
KUNIT_CASE(list_test_list_for_each_entry),
|
|
KUNIT_CASE(list_test_list_for_each_entry_reverse),
|
|
{},
|
|
};
|
|
|
|
static struct kunit_suite list_test_module = {
|
|
.name = "list-kunit-test",
|
|
.test_cases = list_test_cases,
|
|
};
|
|
|
|
struct hlist_test_struct {
|
|
int data;
|
|
struct hlist_node list;
|
|
};
|
|
|
|
static void hlist_test_init(struct kunit *test)
|
|
{
|
|
/* Test the different ways of initialising a list. */
|
|
struct hlist_head list1 = HLIST_HEAD_INIT;
|
|
struct hlist_head list2;
|
|
HLIST_HEAD(list3);
|
|
struct hlist_head *list4;
|
|
struct hlist_head *list5;
|
|
|
|
INIT_HLIST_HEAD(&list2);
|
|
|
|
list4 = kzalloc(sizeof(*list4), GFP_KERNEL | __GFP_NOFAIL);
|
|
INIT_HLIST_HEAD(list4);
|
|
|
|
list5 = kmalloc(sizeof(*list5), GFP_KERNEL | __GFP_NOFAIL);
|
|
memset(list5, 0xFF, sizeof(*list5));
|
|
INIT_HLIST_HEAD(list5);
|
|
|
|
KUNIT_EXPECT_TRUE(test, hlist_empty(&list1));
|
|
KUNIT_EXPECT_TRUE(test, hlist_empty(&list2));
|
|
KUNIT_EXPECT_TRUE(test, hlist_empty(&list3));
|
|
KUNIT_EXPECT_TRUE(test, hlist_empty(list4));
|
|
KUNIT_EXPECT_TRUE(test, hlist_empty(list5));
|
|
|
|
kfree(list4);
|
|
kfree(list5);
|
|
}
|
|
|
|
static void hlist_test_unhashed(struct kunit *test)
|
|
{
|
|
struct hlist_node a;
|
|
HLIST_HEAD(list);
|
|
|
|
INIT_HLIST_NODE(&a);
|
|
|
|
/* is unhashed by default */
|
|
KUNIT_EXPECT_TRUE(test, hlist_unhashed(&a));
|
|
|
|
hlist_add_head(&a, &list);
|
|
|
|
/* is hashed once added to list */
|
|
KUNIT_EXPECT_FALSE(test, hlist_unhashed(&a));
|
|
|
|
hlist_del_init(&a);
|
|
|
|
/* is again unhashed after del_init */
|
|
KUNIT_EXPECT_TRUE(test, hlist_unhashed(&a));
|
|
}
|
|
|
|
/* Doesn't test concurrency guarantees */
|
|
static void hlist_test_unhashed_lockless(struct kunit *test)
|
|
{
|
|
struct hlist_node a;
|
|
HLIST_HEAD(list);
|
|
|
|
INIT_HLIST_NODE(&a);
|
|
|
|
/* is unhashed by default */
|
|
KUNIT_EXPECT_TRUE(test, hlist_unhashed_lockless(&a));
|
|
|
|
hlist_add_head(&a, &list);
|
|
|
|
/* is hashed once added to list */
|
|
KUNIT_EXPECT_FALSE(test, hlist_unhashed_lockless(&a));
|
|
|
|
hlist_del_init(&a);
|
|
|
|
/* is again unhashed after del_init */
|
|
KUNIT_EXPECT_TRUE(test, hlist_unhashed_lockless(&a));
|
|
}
|
|
|
|
static void hlist_test_del(struct kunit *test)
|
|
{
|
|
struct hlist_node a, b;
|
|
HLIST_HEAD(list);
|
|
|
|
hlist_add_head(&a, &list);
|
|
hlist_add_behind(&b, &a);
|
|
|
|
/* before: [list] -> a -> b */
|
|
hlist_del(&a);
|
|
|
|
/* now: [list] -> b */
|
|
KUNIT_EXPECT_PTR_EQ(test, list.first, &b);
|
|
KUNIT_EXPECT_PTR_EQ(test, b.pprev, &list.first);
|
|
}
|
|
|
|
static void hlist_test_del_init(struct kunit *test)
|
|
{
|
|
struct hlist_node a, b;
|
|
HLIST_HEAD(list);
|
|
|
|
hlist_add_head(&a, &list);
|
|
hlist_add_behind(&b, &a);
|
|
|
|
/* before: [list] -> a -> b */
|
|
hlist_del_init(&a);
|
|
|
|
/* now: [list] -> b */
|
|
KUNIT_EXPECT_PTR_EQ(test, list.first, &b);
|
|
KUNIT_EXPECT_PTR_EQ(test, b.pprev, &list.first);
|
|
|
|
/* a is now initialised */
|
|
KUNIT_EXPECT_PTR_EQ(test, a.next, NULL);
|
|
KUNIT_EXPECT_PTR_EQ(test, a.pprev, NULL);
|
|
}
|
|
|
|
/* Tests all three hlist_add_* functions */
|
|
static void hlist_test_add(struct kunit *test)
|
|
{
|
|
struct hlist_node a, b, c, d;
|
|
HLIST_HEAD(list);
|
|
|
|
hlist_add_head(&a, &list);
|
|
hlist_add_head(&b, &list);
|
|
hlist_add_before(&c, &a);
|
|
hlist_add_behind(&d, &a);
|
|
|
|
/* should be [list] -> b -> c -> a -> d */
|
|
KUNIT_EXPECT_PTR_EQ(test, list.first, &b);
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, c.pprev, &(b.next));
|
|
KUNIT_EXPECT_PTR_EQ(test, b.next, &c);
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, a.pprev, &(c.next));
|
|
KUNIT_EXPECT_PTR_EQ(test, c.next, &a);
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, d.pprev, &(a.next));
|
|
KUNIT_EXPECT_PTR_EQ(test, a.next, &d);
|
|
}
|
|
|
|
/* Tests both hlist_fake() and hlist_add_fake() */
|
|
static void hlist_test_fake(struct kunit *test)
|
|
{
|
|
struct hlist_node a;
|
|
|
|
INIT_HLIST_NODE(&a);
|
|
|
|
/* not fake after init */
|
|
KUNIT_EXPECT_FALSE(test, hlist_fake(&a));
|
|
|
|
hlist_add_fake(&a);
|
|
|
|
/* is now fake */
|
|
KUNIT_EXPECT_TRUE(test, hlist_fake(&a));
|
|
}
|
|
|
|
static void hlist_test_is_singular_node(struct kunit *test)
|
|
{
|
|
struct hlist_node a, b;
|
|
HLIST_HEAD(list);
|
|
|
|
INIT_HLIST_NODE(&a);
|
|
KUNIT_EXPECT_FALSE(test, hlist_is_singular_node(&a, &list));
|
|
|
|
hlist_add_head(&a, &list);
|
|
KUNIT_EXPECT_TRUE(test, hlist_is_singular_node(&a, &list));
|
|
|
|
hlist_add_head(&b, &list);
|
|
KUNIT_EXPECT_FALSE(test, hlist_is_singular_node(&a, &list));
|
|
KUNIT_EXPECT_FALSE(test, hlist_is_singular_node(&b, &list));
|
|
}
|
|
|
|
static void hlist_test_empty(struct kunit *test)
|
|
{
|
|
struct hlist_node a;
|
|
HLIST_HEAD(list);
|
|
|
|
/* list starts off empty */
|
|
KUNIT_EXPECT_TRUE(test, hlist_empty(&list));
|
|
|
|
hlist_add_head(&a, &list);
|
|
|
|
/* list is no longer empty */
|
|
KUNIT_EXPECT_FALSE(test, hlist_empty(&list));
|
|
}
|
|
|
|
static void hlist_test_move_list(struct kunit *test)
|
|
{
|
|
struct hlist_node a;
|
|
HLIST_HEAD(list1);
|
|
HLIST_HEAD(list2);
|
|
|
|
hlist_add_head(&a, &list1);
|
|
|
|
KUNIT_EXPECT_FALSE(test, hlist_empty(&list1));
|
|
KUNIT_EXPECT_TRUE(test, hlist_empty(&list2));
|
|
hlist_move_list(&list1, &list2);
|
|
KUNIT_EXPECT_TRUE(test, hlist_empty(&list1));
|
|
KUNIT_EXPECT_FALSE(test, hlist_empty(&list2));
|
|
|
|
}
|
|
|
|
static void hlist_test_entry(struct kunit *test)
|
|
{
|
|
struct hlist_test_struct test_struct;
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, &test_struct,
|
|
hlist_entry(&(test_struct.list),
|
|
struct hlist_test_struct, list));
|
|
}
|
|
|
|
static void hlist_test_entry_safe(struct kunit *test)
|
|
{
|
|
struct hlist_test_struct test_struct;
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, &test_struct,
|
|
hlist_entry_safe(&(test_struct.list),
|
|
struct hlist_test_struct, list));
|
|
|
|
KUNIT_EXPECT_PTR_EQ(test, NULL,
|
|
hlist_entry_safe((struct hlist_node *)NULL,
|
|
struct hlist_test_struct, list));
|
|
}
|
|
|
|
static void hlist_test_for_each(struct kunit *test)
|
|
{
|
|
struct hlist_node entries[3], *cur;
|
|
HLIST_HEAD(list);
|
|
int i = 0;
|
|
|
|
hlist_add_head(&entries[0], &list);
|
|
hlist_add_behind(&entries[1], &entries[0]);
|
|
hlist_add_behind(&entries[2], &entries[1]);
|
|
|
|
hlist_for_each(cur, &list) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 3);
|
|
}
|
|
|
|
|
|
static void hlist_test_for_each_safe(struct kunit *test)
|
|
{
|
|
struct hlist_node entries[3], *cur, *n;
|
|
HLIST_HEAD(list);
|
|
int i = 0;
|
|
|
|
hlist_add_head(&entries[0], &list);
|
|
hlist_add_behind(&entries[1], &entries[0]);
|
|
hlist_add_behind(&entries[2], &entries[1]);
|
|
|
|
hlist_for_each_safe(cur, n, &list) {
|
|
KUNIT_EXPECT_PTR_EQ(test, cur, &entries[i]);
|
|
hlist_del(&entries[i]);
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 3);
|
|
KUNIT_EXPECT_TRUE(test, hlist_empty(&list));
|
|
}
|
|
|
|
static void hlist_test_for_each_entry(struct kunit *test)
|
|
{
|
|
struct hlist_test_struct entries[5], *cur;
|
|
HLIST_HEAD(list);
|
|
int i = 0;
|
|
|
|
entries[0].data = 0;
|
|
hlist_add_head(&entries[0].list, &list);
|
|
for (i = 1; i < 5; ++i) {
|
|
entries[i].data = i;
|
|
hlist_add_behind(&entries[i].list, &entries[i-1].list);
|
|
}
|
|
|
|
i = 0;
|
|
|
|
hlist_for_each_entry(cur, &list, list) {
|
|
KUNIT_EXPECT_EQ(test, cur->data, i);
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 5);
|
|
}
|
|
|
|
static void hlist_test_for_each_entry_continue(struct kunit *test)
|
|
{
|
|
struct hlist_test_struct entries[5], *cur;
|
|
HLIST_HEAD(list);
|
|
int i = 0;
|
|
|
|
entries[0].data = 0;
|
|
hlist_add_head(&entries[0].list, &list);
|
|
for (i = 1; i < 5; ++i) {
|
|
entries[i].data = i;
|
|
hlist_add_behind(&entries[i].list, &entries[i-1].list);
|
|
}
|
|
|
|
/* We skip the first (zero-th) entry. */
|
|
i = 1;
|
|
|
|
cur = &entries[0];
|
|
hlist_for_each_entry_continue(cur, list) {
|
|
KUNIT_EXPECT_EQ(test, cur->data, i);
|
|
/* Stamp over the entry. */
|
|
cur->data = 42;
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 5);
|
|
/* The first entry was not visited. */
|
|
KUNIT_EXPECT_EQ(test, entries[0].data, 0);
|
|
/* The second (and presumably others), were. */
|
|
KUNIT_EXPECT_EQ(test, entries[1].data, 42);
|
|
}
|
|
|
|
static void hlist_test_for_each_entry_from(struct kunit *test)
|
|
{
|
|
struct hlist_test_struct entries[5], *cur;
|
|
HLIST_HEAD(list);
|
|
int i = 0;
|
|
|
|
entries[0].data = 0;
|
|
hlist_add_head(&entries[0].list, &list);
|
|
for (i = 1; i < 5; ++i) {
|
|
entries[i].data = i;
|
|
hlist_add_behind(&entries[i].list, &entries[i-1].list);
|
|
}
|
|
|
|
i = 0;
|
|
|
|
cur = &entries[0];
|
|
hlist_for_each_entry_from(cur, list) {
|
|
KUNIT_EXPECT_EQ(test, cur->data, i);
|
|
/* Stamp over the entry. */
|
|
cur->data = 42;
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 5);
|
|
/* The first entry was visited. */
|
|
KUNIT_EXPECT_EQ(test, entries[0].data, 42);
|
|
}
|
|
|
|
static void hlist_test_for_each_entry_safe(struct kunit *test)
|
|
{
|
|
struct hlist_test_struct entries[5], *cur;
|
|
struct hlist_node *tmp_node;
|
|
HLIST_HEAD(list);
|
|
int i = 0;
|
|
|
|
entries[0].data = 0;
|
|
hlist_add_head(&entries[0].list, &list);
|
|
for (i = 1; i < 5; ++i) {
|
|
entries[i].data = i;
|
|
hlist_add_behind(&entries[i].list, &entries[i-1].list);
|
|
}
|
|
|
|
i = 0;
|
|
|
|
hlist_for_each_entry_safe(cur, tmp_node, &list, list) {
|
|
KUNIT_EXPECT_EQ(test, cur->data, i);
|
|
hlist_del(&cur->list);
|
|
i++;
|
|
}
|
|
|
|
KUNIT_EXPECT_EQ(test, i, 5);
|
|
KUNIT_EXPECT_TRUE(test, hlist_empty(&list));
|
|
}
|
|
|
|
|
|
static struct kunit_case hlist_test_cases[] = {
|
|
KUNIT_CASE(hlist_test_init),
|
|
KUNIT_CASE(hlist_test_unhashed),
|
|
KUNIT_CASE(hlist_test_unhashed_lockless),
|
|
KUNIT_CASE(hlist_test_del),
|
|
KUNIT_CASE(hlist_test_del_init),
|
|
KUNIT_CASE(hlist_test_add),
|
|
KUNIT_CASE(hlist_test_fake),
|
|
KUNIT_CASE(hlist_test_is_singular_node),
|
|
KUNIT_CASE(hlist_test_empty),
|
|
KUNIT_CASE(hlist_test_move_list),
|
|
KUNIT_CASE(hlist_test_entry),
|
|
KUNIT_CASE(hlist_test_entry_safe),
|
|
KUNIT_CASE(hlist_test_for_each),
|
|
KUNIT_CASE(hlist_test_for_each_safe),
|
|
KUNIT_CASE(hlist_test_for_each_entry),
|
|
KUNIT_CASE(hlist_test_for_each_entry_continue),
|
|
KUNIT_CASE(hlist_test_for_each_entry_from),
|
|
KUNIT_CASE(hlist_test_for_each_entry_safe),
|
|
{},
|
|
};
|
|
|
|
static struct kunit_suite hlist_test_module = {
|
|
.name = "hlist",
|
|
.test_cases = hlist_test_cases,
|
|
};
|
|
|
|
kunit_test_suites(&list_test_module, &hlist_test_module);
|
|
|
|
MODULE_LICENSE("GPL v2");
|