#include "platform.h"
#include "gnunet_rest_plugin.h"
#include "gnunet_rest_lib.h"
#include "gnunet_json_lib.h"
#include "gnunet_gnsrecord_lib.h"
#include "gnunet_gnsrecord_json_lib.h"
#include "gnunet_gns_service.h"
#include "microhttpd.h"
#include <jansson.h>

Include dependency graph for gns_plugin.c:

Data Structures
struct	Plugin
	Handle for a plugin. More...

struct	RequestHandle
	The request handle. More...

Macros
#define	GNUNET_REST_API_NS_GNS "/gns"
	Rest API GNS Namespace. More...

#define	GNUNET_REST_GNS_PARAM_RECORD_TYPE "record_type"
	Rest API GNS Parameter record_type. More...

#define	GNUNET_REST_GNS_ERROR_UNKNOWN "Unknown Error"
	Rest API GNS ERROR Unknown Error. More...

#define	GNUNET_REST_GNS_NOT_FOUND "Record not found"
	Rest API GNS ERROR Record not found. More...

Functions
static void	cleanup_handle (void *cls)
	Cleanup lookup handle. More...

static void	do_error (void *cls)
	Task run on errors. More...

static void	do_timeout (void *cls)

static void	handle_gns_response (void cls, int was_gns, uint32_t rd_count, const struct GNUNET_GNSRECORD_Data rd)
	Iterator called on obtained result for a GNS lookup. More...

void	get_gns_cont (struct GNUNET_REST_RequestHandle con_handle, const char url, void *cls)
	Handle gns GET request. More...

static void	options_cont (struct GNUNET_REST_RequestHandle con_handle, const char url, void *cls)
	Respond to OPTIONS request. More...

enum GNUNET_GenericReturnValue	REST_gns_process_request (void plugin, struct GNUNET_REST_RequestHandle rest_handle, GNUNET_REST_ResultProcessor proc, void *proc_cls)
	Function processing the REST call. More...

void *	REST_gns_init (const struct GNUNET_CONFIGURATION_Handle *c)
	Entry point for the plugin. More...

void *	REST_gns_done (void *cls)
	Exit point from the plugin. More...

Variables
const struct GNUNET_CONFIGURATION_Handle *	gns_cfg
	The configuration handle. More...

static char *	allow_methods
	HTTP methods allows for this plugin. More...

static struct GNUNET_GNS_Handle *	gns
	Connection to GNS. More...

static struct RequestHandle *	requests_head
	DLL. More...

static struct RequestHandle *	requests_tail
	DLL. More...

Macro Definition Documentation

◆ GNUNET_REST_API_NS_GNS

#define GNUNET_REST_API_NS_GNS "/gns"

Rest API GNS Namespace.

Definition at line 39 of file gns_plugin.c.

◆ GNUNET_REST_GNS_PARAM_RECORD_TYPE

#define GNUNET_REST_GNS_PARAM_RECORD_TYPE "record_type"

Rest API GNS Parameter record_type.

Definition at line 44 of file gns_plugin.c.

◆ GNUNET_REST_GNS_ERROR_UNKNOWN

#define GNUNET_REST_GNS_ERROR_UNKNOWN "Unknown Error"

Rest API GNS ERROR Unknown Error.

Definition at line 49 of file gns_plugin.c.

◆ GNUNET_REST_GNS_NOT_FOUND

#define GNUNET_REST_GNS_NOT_FOUND "Record not found"

Rest API GNS ERROR Record not found.

Definition at line 54 of file gns_plugin.c.

Function Documentation

◆ cleanup_handle()

static void cleanup_handle ( void * cls )

static

Cleanup lookup handle.

Parameters

cls	`struct RequestHandle` to clean up

Definition at line 165 of file gns_plugin.c.

{
  struct RequestHandle *handle = cls;
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Cleaning up\n");
 
  if (NULL != handle->gns_lookup)
  {
    GNUNET_GNS_lookup_with_tld_cancel (handle->gns_lookup);
    handle->gns_lookup = NULL;
  }
  if (NULL != handle->timeout_task)
  {
    GNUNET_SCHEDULER_cancel (handle->timeout_task);
    handle->timeout_task = NULL;
  }
  if (NULL != handle->url)
    GNUNET_free (handle->url);
  if (NULL != handle->name)
    GNUNET_free (handle->name);
  if (NULL != handle->emsg)
    GNUNET_free (handle->emsg);
 
  GNUNET_CONTAINER_DLL_remove (requests_head,
                               requests_tail,
                               handle);
  GNUNET_free (handle);
}

References GNUNET_CONTAINER_DLL_remove, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_GNS_lookup_with_tld_cancel(), GNUNET_log, GNUNET_SCHEDULER_cancel(), handle, requests_head, and requests_tail.

Referenced by do_error(), handle_gns_response(), options_cont(), and REST_gns_process_request().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ do_error()

static void do_error ( void * cls )

static

Task run on errors.

Reports an error and cleans up everything.

Parameters

cls	the `struct RequestHandle`

Definition at line 201 of file gns_plugin.c.

{
  struct RequestHandle *handle = cls;
  struct MHD_Response *resp;
  json_t *json_error = json_object ();
  char *response;
 
  if (NULL != handle->timeout_task)
    GNUNET_SCHEDULER_cancel (handle->timeout_task);
  handle->timeout_task = NULL;
  if (NULL == handle->emsg)
    handle->emsg = GNUNET_strdup (GNUNET_REST_GNS_ERROR_UNKNOWN);
 
  json_object_set_new (json_error, "error", json_string (handle->emsg));
 
  if (0 == handle->response_code)
    handle->response_code = MHD_HTTP_INTERNAL_SERVER_ERROR;
  response = json_dumps (json_error, 0);
  resp = GNUNET_REST_create_response (response);
  MHD_add_response_header (resp, "Content-Type", "application/json");
  handle->proc (handle->proc_cls, resp, handle->response_code);
  json_decref (json_error);
  GNUNET_free (response);
  cleanup_handle (handle);
}

References cleanup_handle(), GNUNET_free, GNUNET_REST_create_response(), GNUNET_REST_GNS_ERROR_UNKNOWN, GNUNET_SCHEDULER_cancel(), GNUNET_strdup, handle, MHD_HTTP_INTERNAL_SERVER_ERROR, and response.

Referenced by do_timeout(), get_gns_cont(), handle_gns_response(), and REST_gns_done().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ do_timeout()

static void do_timeout ( void * cls )

static

Definition at line 229 of file gns_plugin.c.

{
  struct RequestHandle *handle = cls;
 
  handle->timeout_task = NULL;
  handle->response_code = MHD_HTTP_REQUEST_TIMEOUT;
  do_error (handle);
}

References do_error(), handle, and MHD_HTTP_REQUEST_TIMEOUT.

Referenced by REST_gns_process_request().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handle_gns_response()

static void handle_gns_response	(	void *	cls,
		int	was_gns,
		uint32_t	rd_count,
		const struct GNUNET_GNSRECORD_Data *	rd
	)

static

Iterator called on obtained result for a GNS lookup.

Parameters

cls	closure with the object
was_gns	GNUNET_NO if name was not a GNS name
rd_count	number of records in rd
rd	the records in reply

Definition at line 248 of file gns_plugin.c.

{
  struct RequestHandle *handle = cls;
  struct MHD_Response *resp;
  json_t *result_obj;
  char *result;
 
  handle->gns_lookup = NULL;
 
  if (GNUNET_NO == was_gns)
  {
    handle->response_code = MHD_HTTP_NOT_FOUND;
    handle->emsg = GNUNET_strdup (GNUNET_REST_GNS_NOT_FOUND);
    GNUNET_SCHEDULER_add_now (&do_error, handle);
    return;
  }
 
  result_obj = GNUNET_GNSRECORD_JSON_from_gnsrecord (handle->name, rd,
                                                     rd_count);
 
  result = json_dumps (result_obj, 0);
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Result %s\n", result);
  resp = GNUNET_REST_create_response (result);
  GNUNET_assert (MHD_NO != MHD_add_response_header (resp,
                                                    "Content-Type",
                                                    "application/json"));
  handle->proc (handle->proc_cls, resp, MHD_HTTP_OK);
  GNUNET_free (result);
  json_decref (result_obj);
  GNUNET_SCHEDULER_add_now (&cleanup_handle, handle);
}

References cleanup_handle(), do_error(), GNUNET_assert, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_GNSRECORD_JSON_from_gnsrecord(), GNUNET_log, GNUNET_NO, GNUNET_REST_create_response(), GNUNET_REST_GNS_NOT_FOUND, GNUNET_SCHEDULER_add_now(), GNUNET_strdup, handle, MHD_HTTP_NOT_FOUND, MHD_HTTP_OK, rd, rd_count, and result.

Referenced by get_gns_cont().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ get_gns_cont()

void get_gns_cont	(	struct GNUNET_REST_RequestHandle *	con_handle,
		const char *	url,
		void *	cls
	)

Handle gns GET request.

Parameters

con_handle	the connection handle
url	the url
cls	the RequestHandle

Definition at line 292 of file gns_plugin.c.

{
  struct RequestHandle *handle = cls;
  struct GNUNET_HashCode key;
  char *record_type;
  char *name;
 
  name = NULL;
  handle->name = NULL;
  if (strlen (GNUNET_REST_API_NS_GNS) < strlen (handle->url))
  {
    name = &handle->url[strlen (GNUNET_REST_API_NS_GNS) + 1];
  }
 
  if (NULL == name)
  {
    handle->response_code = MHD_HTTP_NOT_FOUND;
    handle->emsg = GNUNET_strdup (GNUNET_REST_GNS_NOT_FOUND);
    GNUNET_SCHEDULER_add_now (&do_error, handle);
    return;
  }
  if (0 >= strlen (name))
  {
    handle->response_code = MHD_HTTP_NOT_FOUND;
    handle->emsg = GNUNET_strdup (GNUNET_REST_GNS_NOT_FOUND);
    GNUNET_SCHEDULER_add_now (&do_error, handle);
    return;
  }
  handle->name = GNUNET_strdup (name);
 
  handle->record_type = UINT32_MAX;
  GNUNET_CRYPTO_hash (GNUNET_REST_GNS_PARAM_RECORD_TYPE,
                      strlen (GNUNET_REST_GNS_PARAM_RECORD_TYPE),
                      &key);
  if (GNUNET_YES ==
      GNUNET_CONTAINER_multihashmap_contains (con_handle->url_param_map, &key))
  {
    record_type =
      GNUNET_CONTAINER_multihashmap_get (con_handle->url_param_map, &key);
    handle->record_type = GNUNET_GNSRECORD_typename_to_number (record_type);
  }
 
  if (UINT32_MAX == handle->record_type)
  {
    handle->record_type = GNUNET_GNSRECORD_TYPE_ANY;
  }
 
  handle->gns_lookup = GNUNET_GNS_lookup_with_tld (gns,
                                                   handle->name,
                                                   handle->record_type,
                                                   GNUNET_GNS_LO_DEFAULT,
                                                   &handle_gns_response,
                                                   handle);
}

References do_error(), gns, GNUNET_CONTAINER_multihashmap_contains(), GNUNET_CONTAINER_multihashmap_get(), GNUNET_CRYPTO_hash(), GNUNET_GNS_LO_DEFAULT, GNUNET_GNS_lookup_with_tld(), GNUNET_GNSRECORD_TYPE_ANY, GNUNET_GNSRECORD_typename_to_number(), GNUNET_REST_API_NS_GNS, GNUNET_REST_GNS_NOT_FOUND, GNUNET_REST_GNS_PARAM_RECORD_TYPE, GNUNET_SCHEDULER_add_now(), GNUNET_strdup, GNUNET_YES, handle, handle_gns_response(), key, MHD_HTTP_NOT_FOUND, name, and GNUNET_REST_RequestHandle::url_param_map.

Referenced by REST_gns_process_request().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ options_cont()

static void options_cont	(	struct GNUNET_REST_RequestHandle *	con_handle,
		const char *	url,
		void *	cls
	)

static

Respond to OPTIONS request.

Parameters

con_handle	the connection handle
url	the url
cls	the RequestHandle

Definition at line 358 of file gns_plugin.c.

{
  struct MHD_Response *resp;
  struct RequestHandle *handle = cls;
 
  // independent of path return all options
  resp = GNUNET_REST_create_response (NULL);
  MHD_add_response_header (resp, "Access-Control-Allow-Methods", allow_methods);
  handle->proc (handle->proc_cls, resp, MHD_HTTP_OK);
  GNUNET_SCHEDULER_add_now (&cleanup_handle, handle);
  return;
}

References allow_methods, cleanup_handle(), GNUNET_REST_create_response(), GNUNET_SCHEDULER_add_now(), handle, and MHD_HTTP_OK.

Referenced by REST_gns_process_request().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ REST_gns_process_request()

enum GNUNET_GenericReturnValue REST_gns_process_request	(	void *	plugin,
		struct GNUNET_REST_RequestHandle *	rest_handle,
		GNUNET_REST_ResultProcessor	proc,
		void *	proc_cls
	)

Function processing the REST call.

Parameters

method	HTTP method
url	URL of the HTTP request
data	body of the HTTP request (optional)
data_size	length of the body
proc	callback function for the result
proc_cls	closure for callback function

Returns: GNUNET_OK if request accepted

Definition at line 386 of file gns_plugin.c.

{
  struct RequestHandle *handle = GNUNET_new (struct RequestHandle);
  struct GNUNET_REST_RequestHandlerError err;
  static const struct GNUNET_REST_RequestHandler handlers[] =
  { { MHD_HTTP_METHOD_GET, GNUNET_REST_API_NS_GNS, &get_gns_cont },
    { MHD_HTTP_METHOD_OPTIONS, GNUNET_REST_API_NS_GNS, &options_cont },
    GNUNET_REST_HANDLER_END };
 
  handle->response_code = 0;
  handle->timeout =
    GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 60);
  handle->proc_cls = proc_cls;
  handle->proc = proc;
  handle->rest_handle = rest_handle;
  handle->url = GNUNET_strdup (rest_handle->url);
  handle->timeout_task =
    GNUNET_SCHEDULER_add_delayed (handle->timeout, &do_timeout, handle);
  GNUNET_CONTAINER_DLL_insert (requests_head,
                               requests_tail,
                               handle);
  if (handle->url[strlen (handle->url) - 1] == '/')
    handle->url[strlen (handle->url) - 1] = '\0';
  if (GNUNET_NO ==
      GNUNET_REST_handle_request (handle->rest_handle, handlers, &err, handle))
  {
    cleanup_handle (handle);
    return GNUNET_NO;
  }
 
 
  return GNUNET_YES;
}

References cleanup_handle(), do_timeout(), get_gns_cont(), GNUNET_CONTAINER_DLL_insert, GNUNET_new, GNUNET_NO, GNUNET_REST_API_NS_GNS, GNUNET_REST_handle_request(), GNUNET_REST_HANDLER_END, GNUNET_SCHEDULER_add_delayed(), GNUNET_strdup, GNUNET_TIME_relative_multiply(), GNUNET_TIME_UNIT_SECONDS, GNUNET_YES, handle, handlers, options_cont(), GNUNET_REST_RequestHandler::proc, requests_head, requests_tail, and GNUNET_REST_RequestHandle::url.

Referenced by run().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ REST_gns_init()

void * REST_gns_init ( const struct GNUNET_CONFIGURATION_Handle * c )

Entry point for the plugin.

Parameters

cls	Config info

Returns: NULL on error, otherwise the plugin context

Definition at line 431 of file gns_plugin.c.

{
  static struct Plugin plugin;
  struct GNUNET_REST_Plugin *api;
 
  gns_cfg = c;
  memset (&plugin, 0, sizeof(struct Plugin));
  plugin.cfg = gns_cfg;
  api = GNUNET_new (struct GNUNET_REST_Plugin);
  api->cls = &plugin;
  api->name = GNUNET_REST_API_NS_GNS;
  GNUNET_asprintf (&allow_methods,
                   "%s, %s, %s, %s, %s",
                   MHD_HTTP_METHOD_GET,
                   MHD_HTTP_METHOD_POST,
                   MHD_HTTP_METHOD_PUT,
                   MHD_HTTP_METHOD_DELETE,
                   MHD_HTTP_METHOD_OPTIONS);
  gns = GNUNET_GNS_connect (gns_cfg);
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, _ ("Gns REST API initialized\n"));
  return api;
}

References _, allow_methods, GNUNET_REST_Plugin::cls, gns, gns_cfg, GNUNET_asprintf(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_GNS_connect(), GNUNET_log, GNUNET_new, GNUNET_REST_API_NS_GNS, GNUNET_REST_Plugin::name, and plugin.

Referenced by run().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ REST_gns_done()

void * REST_gns_done ( void * cls )

Exit point from the plugin.

Parameters

cls	the plugin context (as returned by "init")

Returns: always NULL

Definition at line 463 of file gns_plugin.c.

{
  struct GNUNET_REST_Plugin *api = cls;
  struct RequestHandle *request;
  struct Plugin *plugin;
 
  while (NULL != (request = requests_head))
    do_error (request);
 
  if (NULL != gns)
    GNUNET_GNS_disconnect (gns);
 
  plugin = api->cls;
 
  plugin->cfg = NULL;
 
  GNUNET_free (allow_methods);
  GNUNET_free (api);
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Gns REST plugin is finished\n");
  return NULL;
}

References allow_methods, Plugin::api, GNUNET_BLOCK_PluginFunctions::cls, GNUNET_REST_Plugin::cls, do_error(), gns, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_GNS_disconnect(), GNUNET_log, plugin, request, and requests_head.

Referenced by do_shutdown().

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

◆ gns_cfg

const struct GNUNET_CONFIGURATION_Handle* gns_cfg

The configuration handle.

Definition at line 59 of file gns_plugin.c.

Referenced by REST_gns_init().

◆ allow_methods

char* allow_methods

static

HTTP methods allows for this plugin.

Definition at line 64 of file gns_plugin.c.

Referenced by options_cont(), REST_gns_done(), and REST_gns_init().

◆ gns

struct GNUNET_GNS_Handle* gns

static

Connection to GNS.

Definition at line 69 of file gns_plugin.c.

Referenced by get_gns_cont(), REST_gns_done(), and REST_gns_init().

◆ requests_head

struct RequestHandle* requests_head

static

DLL.

Definition at line 153 of file gns_plugin.c.

Referenced by cleanup_handle(), REST_gns_done(), and REST_gns_process_request().

◆ requests_tail

struct RequestHandle* requests_tail

static

DLL.

Definition at line 158 of file gns_plugin.c.

Referenced by cleanup_handle(), and REST_gns_process_request().

Data Structures

Macros

Functions

Variables

Macro Definition Documentation

◆ GNUNET_REST_API_NS_GNS

◆ GNUNET_REST_GNS_PARAM_RECORD_TYPE

◆ GNUNET_REST_GNS_ERROR_UNKNOWN

◆ GNUNET_REST_GNS_NOT_FOUND

Function Documentation

◆ cleanup_handle()

◆ do_error()

◆ do_timeout()

◆ handle_gns_response()

◆ get_gns_cont()

◆ options_cont()

◆ REST_gns_process_request()

◆ REST_gns_init()

◆ REST_gns_done()

Variable Documentation

◆ gns_cfg

◆ allow_methods

◆ gns

◆ requests_head

◆ requests_tail