src/testbed/testbed_api_operations.c

   1 /*
   2       This file is part of GNUnet
   3       (C) 2008--2012 Christian Grothoff (and other contributing authors)
   4
   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.
   9
  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.
  14
  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.
  19  */
  20
  21 /**
  22  * @file testing/new_testing_api_operations.c
  23  * @brief functions to manage operation queues
  24  * @author Christian Grothoff
  25  */
  26 #include "platform.h"
  27 #include "new_testing_api_operations.h"
  28
  29
  30 /**
  31  * Opaque handle to an abstract operation to be executed by the testing framework.
  32  */
  33 struct GNUNET_TESTBED_Operation
  34 {
  35   // FIXME!
  36 };
  37
  38
  39
  40 /**
  41  * Cancel a pending operation.  Releases all resources
  42  * of the operation and will ensure that no event
  43  * is generated for the operation.  Does NOT guarantee
  44  * that the operation will be fully undone (or that
  45  * nothing ever happened).
  46  *
  47  * @param operation operation to cancel
  48  */
  49 void
  50 GNUNET_TESTBED_operation_cancel (struct GNUNET_TESTBED_Operation *operation)
  51 {
  52   GNUNET_break (0);
  53
  54 }
  55
  56
  57 /**
  58  * Signal that the information from an operation has been fully
  59  * processed.  This function MUST be called for each event
  60  * of type 'operation_finished' to fully remove the operation
  61  * from the operation queue.  After calling this function, the
  62  * 'op_result' becomes invalid (!).
  63  *
  64  * @param operation operation to signal completion for
  65  */
  66 void
  67 GNUNET_TESTBED_operation_done (struct GNUNET_TESTBED_Operation *operation)
  68 {
  69   GNUNET_break (0);
  70 }
  71
  72
  73
  74 /* end of new_testing_api_operations.c */