2 This file is part of GNUnet
3 (C) 2008--2013 Christian Grothoff (and other contributing authors)
5 GNUnet is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published
7 by the Free Software Foundation; either version 3, or (at your
8 option) any later version.
10 GNUnet is distributed in the hope that it will be useful, but
11 WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with GNUnet; see the file COPYING. If not, write to the
17 Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 Boston, MA 02111-1307, USA.
22 * @file testbed/test_testbed_api_operations.c
23 * @brief tests cases for testbed_api_operations.c
24 * @author Sree Harsha Totakura
28 #include "gnunet_util_lib.h"
29 #include "testbed_api_operations.h"
32 * Generic logging shortcut
34 #define LOG(kind,...) \
35 GNUNET_log (kind, __VA_ARGS__)
38 * Delay to start step task
41 GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MILLISECONDS, 500)
44 * Queue A. Initially the max active is set to 2 and then reduced to 0 - this
45 * should block op2 even after op1 has finished. Later the max active is set to
46 * 2 and this should start op2
48 struct OperationQueue *q1;
51 * Queue B. Max active set to 2 is not changed throughout the test
53 struct OperationQueue *q2;
56 * This operation should go into both queues and block op2 until it is done
58 struct GNUNET_TESTBED_Operation *op1;
61 * This operation should go into q1 and q2
63 struct GNUNET_TESTBED_Operation *op2;
66 * This operation should go into both queues and should consume 2 units of
67 * resources on both queues. Since op2 needs a resource from both queues and is
68 * queues before this operation, it will be blocked until op2 is released even
69 * though q1 has enough free resources
71 struct GNUNET_TESTBED_Operation *op3;
74 * Just like op3, this operation also consumes 2 units of resources on both
75 * queues. Since this is queued after op3 and both queues are at max active
76 * 2. This will be blocked until op3 is done.
78 struct GNUNET_TESTBED_Operation *op4;
81 * This operation is started after op4 is released and should consume only 1
82 * resource on queue q1. It should be started along with op6 and op7
84 struct GNUNET_TESTBED_Operation *op5;
87 * This operation is started after op4 is released and should consume only 1
88 * resource on q2. It should be started along with op5 and op7
90 struct GNUNET_TESTBED_Operation *op6;
93 * This operation is started after op4 is released and should consume 1 resource
94 * on both queues q1 and q1. It should be started along with op5 and op6. It is
95 * then inactivated when op6 is released. op8's start should release this
96 * operation implicitly.
98 struct GNUNET_TESTBED_Operation *op7;
101 * This operation is started after op6 is finished in step task. It consumes 2
102 * resources on both queues q1 and q2. This operation should evict op7. After
103 * starting, it should be made inactive, active and inactive again in the step task.
105 struct GNUNET_TESTBED_Operation *op8;
108 * This opration is started after activating op8. It should consume a resource
109 * on queues q1 and q2. It should not be started until op8 is again made
110 * inactive at which point it should be released. It can be released as soon as
113 struct GNUNET_TESTBED_Operation *op9;
116 * The delay task identifier
118 GNUNET_SCHEDULER_TaskIdentifier step_task;
122 * Enumeration of test stages
132 * op1 has been started
137 * op1 has been released
142 * Temporary pause where no operations should start as we set max active in q1
143 * to 0 in stage TEST_OP1_STARTED
178 * op5, op6, op7 started
180 TEST_OP5_6_7_STARTED,
193 * op8 has began waiting
218 * op8 has been released
228 * op9 has been released
240 * Function to call to start an operation once all
241 * queues the operation is part of declare that the
242 * operation can be activated.
245 start_cb (void *cls);
249 * Function to cancel an operation (release all associated resources). This can
250 * be because of a call to "GNUNET_TESTBED_operation_cancel" (before the
251 * operation generated an event) or AFTER the operation generated an event due
252 * to a call to "GNUNET_TESTBED_operation_done". Thus it is not guaranteed that
253 * a callback to the 'OperationStart' preceeds the call to 'OperationRelease'.
254 * Implementations of this function are expected to clean up whatever state is
255 * in 'cls' and release all resources associated with the operation.
258 release_cb (void *cls);
262 * Task to simulate artificial delay and change the test stage
265 * @param tc the task context
268 step (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
270 GNUNET_assert (GNUNET_SCHEDULER_NO_TASK != step_task);
271 step_task = GNUNET_SCHEDULER_NO_TASK;
274 case TEST_OP1_STARTED:
275 GNUNET_TESTBED_operation_release_ (op1);
276 GNUNET_TESTBED_operation_queue_reset_max_active_ (q1, 0);
277 op3 = GNUNET_TESTBED_operation_create_ (&op3, &start_cb, &release_cb);
278 GNUNET_TESTBED_operation_queue_insert2_ (q1, op3, 2);
279 GNUNET_TESTBED_operation_queue_insert2_ (q2, op3, 2);
280 GNUNET_TESTBED_operation_begin_wait_ (op3);
281 op4 = GNUNET_TESTBED_operation_create_ (&op4, &start_cb, &release_cb);
282 GNUNET_TESTBED_operation_queue_insert2_ (q1, op4, 2);
283 GNUNET_TESTBED_operation_queue_insert2_ (q2, op4, 2);
284 GNUNET_TESTBED_operation_begin_wait_ (op4);
286 case TEST_OP1_RELEASED:
288 GNUNET_TESTBED_operation_queue_reset_max_active_ (q1, 2);
290 case TEST_OP2_STARTED:
291 GNUNET_TESTBED_operation_release_ (op2);
293 case TEST_OP3_STARTED:
294 GNUNET_TESTBED_operation_release_ (op3);
296 case TEST_OP4_STARTED:
297 GNUNET_TESTBED_operation_release_ (op4);
299 case TEST_OP6_RELEASED:
300 op8 = GNUNET_TESTBED_operation_create_ (&op8, &start_cb, &release_cb);
301 GNUNET_TESTBED_operation_queue_insert2_ (q1, op8, 2);
302 GNUNET_TESTBED_operation_queue_insert2_ (q2, op8, 2);
303 result = TEST_OP8_WAITING;
304 GNUNET_TESTBED_operation_begin_wait_ (op8);
306 case TEST_OP8_STARTED:
307 GNUNET_TESTBED_operation_inactivate_ (op8);
308 result = TEST_OP8_INACTIVE_1;
309 step_task = GNUNET_SCHEDULER_add_delayed (STEP_DELAY, &step, NULL);
311 case TEST_OP8_INACTIVE_1:
312 GNUNET_TESTBED_operation_activate_ (op8);
313 result = TEST_OP8_ACTIVE;
314 op9 = GNUNET_TESTBED_operation_create_ (&op9, &start_cb, &release_cb);
315 GNUNET_TESTBED_operation_queue_insert2_ (q1, op9, 1);
316 GNUNET_TESTBED_operation_queue_insert2_ (q2, op9, 1);
317 GNUNET_TESTBED_operation_begin_wait_ (op9);
318 step_task = GNUNET_SCHEDULER_add_delayed (STEP_DELAY, &step, NULL);
320 case TEST_OP8_ACTIVE:
321 GNUNET_TESTBED_operation_inactivate_ (op8);
322 /* op8 should be released by now due to above call */
323 GNUNET_assert (TEST_OP8_RELEASED == result);
325 case TEST_OP9_STARTED:
326 GNUNET_TESTBED_operation_release_ (op9);
335 * Function to call to start an operation once all
336 * queues the operation is part of declare that the
337 * operation can be activated.
345 GNUNET_assert (&op1 == cls);
346 result = TEST_OP1_STARTED;
347 GNUNET_assert (GNUNET_SCHEDULER_NO_TASK == step_task);
349 GNUNET_SCHEDULER_add_delayed (STEP_DELAY, &step, NULL);
352 GNUNET_assert (&op2 == cls);
353 result = TEST_OP2_STARTED;
354 GNUNET_assert (GNUNET_SCHEDULER_NO_TASK == step_task);
356 GNUNET_SCHEDULER_add_delayed (STEP_DELAY, &step, NULL);
358 case TEST_OP2_RELEASED:
359 GNUNET_assert (&op3 == cls);
360 result = TEST_OP3_STARTED;
361 GNUNET_assert (GNUNET_SCHEDULER_NO_TASK == step_task);
363 GNUNET_SCHEDULER_add_delayed (STEP_DELAY, &step, NULL);
365 case TEST_OP3_RELEASED:
366 GNUNET_assert (&op4 == cls);
367 result = TEST_OP4_STARTED;
368 GNUNET_assert (GNUNET_SCHEDULER_NO_TASK == step_task);
370 GNUNET_SCHEDULER_add_delayed (STEP_DELAY, &step, NULL);
372 case TEST_OP4_RELEASED:
379 result = TEST_OP5_6_7_STARTED;
380 GNUNET_TESTBED_operation_release_ (op5);
385 case TEST_OP7_RELEASED:
386 GNUNET_assert (&op8 == cls);
387 result = TEST_OP8_STARTED;
388 step_task = GNUNET_SCHEDULER_add_delayed (STEP_DELAY, &step, NULL);
390 case TEST_OP8_RELEASED:
391 GNUNET_assert (&op9 == cls);
392 result = TEST_OP9_STARTED;
393 step_task = GNUNET_SCHEDULER_add_delayed (STEP_DELAY, &step, NULL);
402 * Function to cancel an operation (release all associated resources). This can
403 * be because of a call to "GNUNET_TESTBED_operation_cancel" (before the
404 * operation generated an event) or AFTER the operation generated an event due
405 * to a call to "GNUNET_TESTBED_operation_done". Thus it is not guaranteed that
406 * a callback to the 'OperationStart' preceeds the call to 'OperationRelease'.
407 * Implementations of this function are expected to clean up whatever state is
408 * in 'cls' and release all resources associated with the operation.
411 release_cb (void *cls)
415 case TEST_OP1_STARTED:
416 GNUNET_assert (&op1 == cls);
417 result = TEST_OP1_RELEASED;
420 GNUNET_SCHEDULER_add_delayed (STEP_DELAY, &step, NULL);
422 case TEST_OP2_STARTED:
423 GNUNET_assert (&op2 == cls);
424 result = TEST_OP2_RELEASED;
425 GNUNET_assert (GNUNET_SCHEDULER_NO_TASK == step_task);
427 case TEST_OP3_STARTED:
428 GNUNET_assert (&op3 == cls);
429 result = TEST_OP3_RELEASED;
430 GNUNET_assert (GNUNET_SCHEDULER_NO_TASK == step_task);
432 case TEST_OP4_STARTED:
433 GNUNET_assert (&op4 == cls);
434 result = TEST_OP4_RELEASED;
435 GNUNET_assert (GNUNET_SCHEDULER_NO_TASK == step_task);
436 op5 = GNUNET_TESTBED_operation_create_ (&op5, &start_cb, &release_cb);
437 GNUNET_TESTBED_operation_queue_insert2_ (q1, op5, 1);
438 GNUNET_TESTBED_operation_begin_wait_ (op5);
439 op6 = GNUNET_TESTBED_operation_create_ (&op6, &start_cb, &release_cb);
440 GNUNET_TESTBED_operation_queue_insert2_ (q2, op6, 1);
441 GNUNET_TESTBED_operation_begin_wait_ (op6);
442 op7 = GNUNET_TESTBED_operation_create_ (&op7, &start_cb, &release_cb);
443 GNUNET_TESTBED_operation_queue_insert2_ (q1, op7, 1);
444 GNUNET_TESTBED_operation_queue_insert2_ (q2, op7, 1);
445 GNUNET_TESTBED_operation_begin_wait_ (op7);
447 case TEST_OP5_6_7_STARTED:
448 result = TEST_OP5_RELEASED;
450 GNUNET_TESTBED_operation_release_ (op6);
452 case TEST_OP5_RELEASED:
454 result = TEST_OP6_RELEASED;
455 GNUNET_TESTBED_operation_inactivate_ (op7);
456 step_task = GNUNET_SCHEDULER_add_now (&step, NULL);
458 case TEST_OP8_WAITING:
459 GNUNET_assert (&op7 == cls);
461 result = TEST_OP7_RELEASED;
463 case TEST_OP8_ACTIVE:
464 result = TEST_OP8_RELEASED;
467 case TEST_OP9_STARTED:
468 GNUNET_assert (&op9 == cls);
469 result = TEST_OP9_RELEASED;
470 GNUNET_TESTBED_operation_queue_destroy_ (q1);
471 GNUNET_TESTBED_operation_queue_destroy_ (q2);
485 * @param args arguments passed to GNUNET_PROGRAM_run
486 * @param cfgfile the path to configuration file
487 * @param cfg the configuration file handle
490 run (void *cls, char *const *args, const char *cfgfile,
491 const struct GNUNET_CONFIGURATION_Handle *config)
493 q1 = GNUNET_TESTBED_operation_queue_create_ (1);
494 GNUNET_assert (NULL != q1);
495 q2 = GNUNET_TESTBED_operation_queue_create_ (2);
496 GNUNET_assert (NULL != q2);
497 op1 = GNUNET_TESTBED_operation_create_ (&op1, start_cb, release_cb);
498 GNUNET_assert (NULL != op1);
499 op2 = GNUNET_TESTBED_operation_create_ (&op2, start_cb, release_cb);
500 GNUNET_TESTBED_operation_queue_insert_ (q1, op1);
501 GNUNET_TESTBED_operation_queue_insert_ (q2, op1);
502 GNUNET_TESTBED_operation_begin_wait_ (op1);
503 GNUNET_TESTBED_operation_queue_insert_ (q1, op2);
504 GNUNET_TESTBED_operation_queue_insert_ (q2, op2);
505 GNUNET_TESTBED_operation_begin_wait_ (op2);
514 main (int argc, char **argv)
517 char *const argv2[] =
518 { "test_testbed_api_operations", "-c", "test_testbed_api.conf", NULL };
519 struct GNUNET_GETOPT_CommandLineOption options[] =
520 { GNUNET_GETOPT_OPTION_END };
523 GNUNET_PROGRAM_run ((sizeof (argv2) / sizeof (char *)) - 1, argv2,
524 "test_testbed_api_operations", "nohelp", options,
526 if ((GNUNET_OK != ret) || (TEST_OP9_RELEASED != result))
542 /* end of test_testbed_api_operations.c */