src/include/gnunet_monkey_edb.h

   1 /*
   2       This file is part of GNUnet
   3       (C) 2009, 2010 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 include/gnunet_monkey_edb.h
  23  * @brief Monkey API for accessing the Expression Database (edb)
  24  */
  25
  26 #ifndef GNUNET_MONKEY_EDB_H
  27 #define GNUNET_MONKEY_EDB_H
  28
  29 #ifdef __cplusplus
  30 extern "C"
  31 {
  32 #if 0                           /* keep Emacsens' auto-indent happy */
  33 }
  34 #endif
  35 #endif
  36
  37
  38 struct GNUNET_MONKEY_EDB_Context;
  39
  40 /**
  41  * Establish a connection to the Expression Database
  42  *
  43  * @param db_file_name path the Expression Database file
  44  * @return context to use for Accessing the Expression Database, NULL on error
  45  */
  46 struct GNUNET_MONKEY_EDB_Context *GNUNET_MONKEY_EDB_connect (const char
  47                                                              *db_file_name);
  48
  49
  50 /**
  51  * Disconnect from Database, and cleanup resources
  52  *
  53  * @param context context
  54  * @return GNUNET_OK on success, GNUNET_NO on failure
  55  */
  56 int GNUNET_MONKEY_EDB_disconnect (struct GNUNET_MONKEY_EDB_Context *context);
  57
  58
  59 typedef int (*GNUNET_MONKEY_ExpressionIterator)(void *cls, const char *expression, int begin_line);
  60
  61
  62 /**
  63  * Update the context with a list of expressions.
  64  * The list is the initializations of sub-expressions
  65  * of the expression pointed to by start_line_no and end_line_no
  66  * For example, consider the following code snippet:
  67  * {
  68  *   struct Something whole; // line no.1
  69  *   struct SomethingElse part; // line no.2
  70  *   whole.part = &part; // line no.3
  71  *   whole.part->member = 1; // line no.4
  72  * }
  73  * If the expression supplied to the function is that of line no.4 "whole.part->member = 1;"
  74  * The returned list of expressions will be: whole.part = part (line no.3),
  75  * struct SomethingElse part (line no.2), and struct Something whole (line no.1),
  76  * which are the initialization expressions of the building components of the expression in question
  77  *
  78  * @param context the returned expessions will be available in it.
  79  * expression_list_head, and expression_list_tail must be null,
  80  * otherwise GNUNET_NO will be returned
  81  * @param file_name path to the file in which the expression in question exists
  82  * @param start_line_no expression beginning line
  83  * @param end_line_no expression end line
  84  * @param iter callback function, iterator for expressions returned from the Database
  85  * @param iter_cls closure for the expression iterator
  86  * @return GNUNET_OK success, GNUNET_NO failure
  87  */
  88 int
  89 GNUNET_MONKEY_EDB_get_expressions (struct GNUNET_MONKEY_EDB_Context *context,
  90                                    const char *file_name, int start_line_no,
  91                                    int end_line_no,
  92                                    GNUNET_MONKEY_ExpressionIterator iter, void *iter_cls);
  93
  94
  95
  96 #if 0                           /* keep Emacsens' auto-indent happy */
  97 {
  98 #endif
  99 #ifdef __cplusplus
 100 }
 101 #endif
 102
 103 #endif
 104