4 * Copyright(c) 2010-2014 Intel Corporation. All rights reserved.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
11 * * Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * * Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in
15 * the documentation and/or other materials provided with the
17 * * Neither the name of Intel Corporation nor the names of its
18 * contributors may be used to endorse or promote products derived
19 * from this software without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
38 #include <sys/queue.h>
41 #include <rte_eal_memconfig.h>
42 #include <rte_string_fns.h>
43 #include <rte_tailq.h>
47 #define do_return(...) do { \
48 printf("Error at %s, line %d: ", __func__, __LINE__); \
49 printf(__VA_ARGS__); \
53 #define DEFAULT_TAILQ (RTE_TAILQ_NUM)
55 static struct rte_tailq_entry d_elem;
58 test_tailq_create(void)
60 struct rte_tailq_entry_head *d_head;
63 /* create a first tailq and check its non-null */
64 d_head = RTE_TAILQ_RESERVE_BY_IDX(DEFAULT_TAILQ, rte_tailq_entry_head);
66 do_return("Error allocating dummy_q0\n");
68 /* check we can add an item to it
70 TAILQ_INSERT_TAIL(d_head, &d_elem, next);
72 /* try allocating dummy_q0 again, and check for failure */
73 if (RTE_TAILQ_RESERVE_BY_IDX(DEFAULT_TAILQ, rte_tailq_entry_head) == NULL)
74 do_return("Error, non-null result returned when attemption to "
75 "re-allocate a tailq\n");
77 /* now fill up the tailq slots available and check we get an error */
78 for (i = RTE_TAILQ_NUM; i < RTE_MAX_TAILQ; i++){
79 if ((d_head = RTE_TAILQ_RESERVE_BY_IDX(i,
80 rte_tailq_entry_head)) == NULL)
84 /* check that we had an error return before RTE_MAX_TAILQ */
85 if (i != RTE_MAX_TAILQ)
86 do_return("Error, we did not have a reservation as expected\n");
92 test_tailq_lookup(void)
94 /* run successful test - check result is found */
95 struct rte_tailq_entry_head *d_head;
96 struct rte_tailq_entry *d_ptr;
98 d_head = RTE_TAILQ_LOOKUP_BY_IDX(DEFAULT_TAILQ, rte_tailq_entry_head);
100 do_return("Error with tailq lookup\n");
102 TAILQ_FOREACH(d_ptr, d_head, next)
103 if (d_ptr != &d_elem)
104 do_return("Error with tailq returned from lookup - "
105 "expected element not found\n");
107 /* now try a bad/error lookup */
108 d_head = RTE_TAILQ_LOOKUP_BY_IDX(RTE_MAX_TAILQ, rte_tailq_entry_head);
110 do_return("Error, lookup does not return NULL for bad tailq name\n");
115 /* test for deprecated functions - mainly for coverage */
117 test_tailq_deprecated(void)
119 struct rte_tailq_entry_head *d_head;
121 /* since TAILQ_RESERVE is not able to create new tailqs,
122 * we should find an existing one (IOW, RTE_TAILQ_RESERVE behaves identical
123 * to RTE_TAILQ_LOOKUP).
125 * PCI_RESOURCE_LIST tailq is guaranteed to
126 * be present in any DPDK app. */
127 d_head = RTE_TAILQ_RESERVE("PCI_RESOURCE_LIST", rte_tailq_entry_head);
129 do_return("Error finding PCI_RESOURCE_LIST\n");
131 d_head = RTE_TAILQ_LOOKUP("PCI_RESOURCE_LIST", rte_tailq_entry_head);
133 do_return("Error finding PCI_RESOURCE_LIST\n");
135 /* try doing that with non-existent names */
136 d_head = RTE_TAILQ_RESERVE("random name", rte_tailq_entry_head);
138 do_return("Non-existent tailq found!\n");
140 d_head = RTE_TAILQ_LOOKUP("random name", rte_tailq_entry_head);
142 do_return("Non-existent tailq found!\n");
144 /* try doing the same with NULL names */
145 d_head = RTE_TAILQ_RESERVE(NULL, rte_tailq_entry_head);
147 do_return("NULL tailq found!\n");
149 d_head = RTE_TAILQ_LOOKUP(NULL, rte_tailq_entry_head);
151 do_return("NULL tailq found!\n");
160 ret |= test_tailq_create();
161 ret |= test_tailq_lookup();
162 ret |= test_tailq_deprecated();
166 static struct test_command tailq_cmd = {
167 .command = "tailq_autotest",
168 .callback = test_tailq,
170 REGISTER_TEST_COMMAND(tailq_cmd);