#include "platform.h"
#include "gnunet_rest_plugin.h"
#include <gnunet_rest_lib.h>
#include <gnunet_util_lib.h>
#include <jansson.h>

Include dependency graph for config_plugin.c:

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

struct	RequestHandle
	The request handle. More...

Macros
#define	GNUNET_REST_API_NS_CONFIG "/config"

Functions
static void	cleanup_handle (struct RequestHandle *handle)
	Cleanup request handle. More...

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

static void	add_sections (void cls, const char section, const char option, const char value)

static void	add_section_contents (void cls, const char section, const char option, const char value)

static void	get_cont (struct GNUNET_REST_RequestHandle con_handle, const char url, void *cls)
	Handle rest request. More...

struct GNUNET_CONFIGURATION_Handle *	set_value (struct GNUNET_CONFIGURATION_Handle config, const char section, const char option, json_t value)

static void	set_cont (struct GNUNET_REST_RequestHandle con_handle, const char url, void *cls)
	Handle REST POST request. More...

static void	options_cont (struct GNUNET_REST_RequestHandle con_handle, const char url, void *cls)
	Handle rest request. More...

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

void	REST_config_done (struct GNUNET_REST_Plugin *api)
	Exit point from the plugin. More...

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

Variables
const struct GNUNET_CONFIGURATION_Handle *	config_cfg

static struct RequestHandle *	requests_head
	DLL. More...

static struct RequestHandle *	requests_tail
	DLL. More...

Macro Definition Documentation

◆ GNUNET_REST_API_NS_CONFIG

#define GNUNET_REST_API_NS_CONFIG "/config"

Definition at line 33 of file config_plugin.c.

Function Documentation

◆ cleanup_handle()

static void cleanup_handle ( struct RequestHandle * handle )

static

Cleanup request handle.

Parameters

handle Handle to clean up

Definition at line 101 of file config_plugin.c.

{
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Cleaning up\n");
  if (NULL != handle->url)
    GNUNET_free (handle->url);
  GNUNET_CONTAINER_DLL_remove (requests_head,
                               requests_tail,
                               handle);
  GNUNET_free (handle);
}

References GNUNET_CONTAINER_DLL_remove, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_log, handle, requests_head, and requests_tail.

Referenced by do_error(), get_cont(), options_cont(), REST_config_done(), REST_config_process_request(), and set_cont().

Here is the caller graph for this function:

◆ do_error()

static void do_error ( void * cls )

static

Task run on shutdown.

Cleans up everything.

Parameters

cls unused

Definition at line 119 of file config_plugin.c.

{
  struct RequestHandle *handle = cls;
  struct MHD_Response *resp;
 
  resp = GNUNET_REST_create_response (NULL);
  handle->proc (handle->proc_cls, resp, handle->response_code);
  cleanup_handle (handle);
}

References cleanup_handle(), GNUNET_REST_create_response(), and handle.

Referenced by get_cont(), and set_cont().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ add_sections()

static void add_sections	(	void *	cls,
		const char *	section,
		const char *	option,
		const char *	value
	)

static

Definition at line 131 of file config_plugin.c.

{
  json_t *sections_obj = cls;
  json_t *sec_obj;
 
  sec_obj = json_object_get (sections_obj, section);
  if (NULL != sec_obj)
  {
    json_object_set_new (sec_obj, option, json_string (value));
    return;
  }
  sec_obj = json_object ();
  json_object_set_new (sec_obj, option, json_string (value));
  json_object_set_new (sections_obj, section, sec_obj);
}

References value.

Referenced by get_cont().

Here is the caller graph for this function:

◆ add_section_contents()

static void add_section_contents	(	void *	cls,
		const char *	section,
		const char *	option,
		const char *	value
	)

static

Definition at line 152 of file config_plugin.c.

{
  json_t *section_obj = cls;
 
  json_object_set_new (section_obj, option, json_string (value));
}

References value.

Referenced by get_cont().

Here is the caller graph for this function:

◆ get_cont()

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

static

Handle rest request.

Parameters

handle the lookup handle

Definition at line 169 of file config_plugin.c.

{
  struct MHD_Response *resp;
  struct RequestHandle *handle = cls;
  const char *section;
  char *response;
  json_t *result;
 
  if (strlen (GNUNET_REST_API_NS_CONFIG) > strlen (handle->url))
  {
    handle->response_code = MHD_HTTP_BAD_REQUEST;
    GNUNET_SCHEDULER_add_now (&do_error, handle);
    return;
  }
  if (strlen (GNUNET_REST_API_NS_CONFIG) == strlen (handle->url))
  {
    result = json_object ();
    GNUNET_CONFIGURATION_iterate (config_cfg, &add_sections, result);
  }
  else
  {
    result = json_object ();
    section = &handle->url[strlen (GNUNET_REST_API_NS_CONFIG) + 1];
    GNUNET_CONFIGURATION_iterate_section_values (config_cfg,
                                                 section,
                                                 &add_section_contents,
                                                 result);
  }
  response = json_dumps (result, 0);
  resp = GNUNET_REST_create_response (response);
  GNUNET_assert (MHD_NO != MHD_add_response_header (resp,
                                                    "Content-Type",
                                                    "application/json"));
  handle->proc (handle->proc_cls, resp, MHD_HTTP_OK);
  cleanup_handle (handle);
  GNUNET_free (response);
  json_decref (result);
}

References add_section_contents(), add_sections(), cleanup_handle(), config_cfg, do_error(), GNUNET_assert, GNUNET_CONFIGURATION_iterate(), GNUNET_CONFIGURATION_iterate_section_values(), GNUNET_free, GNUNET_REST_API_NS_CONFIG, GNUNET_REST_create_response(), GNUNET_SCHEDULER_add_now(), handle, MHD_HTTP_BAD_REQUEST, MHD_HTTP_OK, response, and result.

Referenced by REST_config_process_request().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ set_value()

struct GNUNET_CONFIGURATION_Handle * set_value	(	struct GNUNET_CONFIGURATION_Handle *	config,
		const char *	section,
		const char *	option,
		json_t *	value
	)

Definition at line 212 of file config_plugin.c.

{
  if (json_is_string (value))
    GNUNET_CONFIGURATION_set_value_string (config, section, option,
                                           json_string_value (value));
  else if (json_is_number (value))
    GNUNET_CONFIGURATION_set_value_number (config, section, option,
                                           json_integer_value (value));
  else if (json_is_null (value))
    GNUNET_CONFIGURATION_set_value_string (config, section, option, NULL);
  else if (json_is_true (value))
    GNUNET_CONFIGURATION_set_value_string (config, section, option, "yes");
  else if (json_is_false (value))
    GNUNET_CONFIGURATION_set_value_string (config, section, option, "no");
  else
    return NULL;
  return config; // for error handling (0 -> success, 1 -> error)
}

References config, GNUNET_CONFIGURATION_set_value_number(), GNUNET_CONFIGURATION_set_value_string(), and value.

Referenced by set_cont().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ set_cont()

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

static

Handle REST POST request.

Parameters

handle the lookup handle

Definition at line 241 of file config_plugin.c.

{
  struct RequestHandle *handle = cls;
  char term_data[handle->rest_handle->data_size + 1];
  struct GNUNET_CONFIGURATION_Handle *out = GNUNET_CONFIGURATION_dup (config_cfg);
 
  json_error_t err;
  json_t *data_json;
  const char *section;
  const char *option;
  json_t *sec_obj;
  json_t *value;
  char *cfg_fn;
 
  // invalid url
  if (strlen (GNUNET_REST_API_NS_CONFIG) > strlen (handle->url))
  {
    handle->response_code = MHD_HTTP_BAD_REQUEST;
    GNUNET_SCHEDULER_add_now (&do_error, handle);
    return;
  }
 
  // extract data from handle
  term_data[handle->rest_handle->data_size] = '\0';
  GNUNET_memcpy (term_data,
                 handle->rest_handle->data,
                 handle->rest_handle->data_size);
  data_json = json_loads (term_data, JSON_DECODE_ANY, &err);
 
  if (NULL == data_json)
  {
    GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                "Unable to parse JSON Object from %s\n",
                term_data);
    GNUNET_SCHEDULER_add_now (&do_error, handle);
    return;
  }
 
  // POST /config => {<section> : {<option> : <value>}}
  if (strlen (GNUNET_REST_API_NS_CONFIG) == strlen (handle->url))   // POST /config
  {
    // iterate over sections
    json_object_foreach (data_json, section, sec_obj)
    {
      // iterate over options
      json_object_foreach (sec_obj, option, value)
      {
        out = set_value (out, section, option, value);
        if (NULL == out)
        {
          handle->response_code = MHD_HTTP_BAD_REQUEST;
          GNUNET_SCHEDULER_add_now (&do_error, handle);
          json_decref (data_json);
          return;
        }
      }
    }
  }
  else // POST /config/<section> => {<option> : <value>}
  {
    // extract the "<section>" part from the url
    section = &handle->url[strlen (GNUNET_REST_API_NS_CONFIG) + 1];
    // iterate over options
    json_object_foreach (data_json, option, value)
    {
      out = set_value (out, section, option, value);
      if (NULL == out)
      {
        handle->response_code = MHD_HTTP_BAD_REQUEST;
        GNUNET_SCHEDULER_add_now (&do_error, handle);
        json_decref (data_json);
        return;
      }
    }
  }
  json_decref (data_json);
 
 
  // get cfg file path
  cfg_fn = NULL;
  const char *xdg = getenv ("XDG_CONFIG_HOME");
  if (NULL != xdg)
    GNUNET_asprintf (&cfg_fn,
                     "%s%s%s",
                     xdg,
                     DIR_SEPARATOR_STR,
                     GNUNET_OS_project_data_get ()->config_file);
  else
    cfg_fn = GNUNET_strdup (GNUNET_OS_project_data_get ()->user_config_file);
 
  GNUNET_CONFIGURATION_write (out, cfg_fn);
  config_cfg = out;
  handle->proc (handle->proc_cls,
                GNUNET_REST_create_response (NULL),
                MHD_HTTP_OK);
  GNUNET_free (cfg_fn);
  cleanup_handle (handle);
}

References cleanup_handle(), config_cfg, config_file, DIR_SEPARATOR_STR, do_error(), getenv(), GNUNET_asprintf(), GNUNET_CONFIGURATION_dup(), GNUNET_CONFIGURATION_write(), GNUNET_ERROR_TYPE_ERROR, GNUNET_free, GNUNET_log, GNUNET_memcpy, GNUNET_OS_project_data_get(), GNUNET_REST_API_NS_CONFIG, GNUNET_REST_create_response(), GNUNET_SCHEDULER_add_now(), GNUNET_strdup, handle, MHD_HTTP_BAD_REQUEST, MHD_HTTP_OK, set_value(), and value.

Referenced by REST_config_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

Handle rest request.

Parameters

handle the lookup handle

Definition at line 349 of file config_plugin.c.

{
  struct MHD_Response *resp;
  struct RequestHandle *handle = cls;
 
  resp = GNUNET_REST_create_response (NULL);
  GNUNET_assert (MHD_NO != MHD_add_response_header (resp,
                                                    "Access-Control-Allow-Methods",
                                                    MHD_HTTP_METHOD_GET));
  handle->proc (handle->proc_cls, resp, MHD_HTTP_OK);
  cleanup_handle (handle);
}

References cleanup_handle(), GNUNET_assert, GNUNET_REST_create_response(), handle, and MHD_HTTP_OK.

Referenced by REST_config_process_request().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ REST_config_process_request()

enum GNUNET_GenericReturnValue REST_config_process_request	(	void *	plugin,
		struct GNUNET_REST_RequestHandle *	conndata_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 proc

Returns: GNUNET_OK if request accepted

Definition at line 366 of file config_plugin.c.

{
  static const struct GNUNET_REST_RequestHandler handlers[] = {
    { MHD_HTTP_METHOD_GET, GNUNET_REST_API_NS_CONFIG, &get_cont },
    { MHD_HTTP_METHOD_POST, GNUNET_REST_API_NS_CONFIG, &set_cont },
    { MHD_HTTP_METHOD_OPTIONS, GNUNET_REST_API_NS_CONFIG, &options_cont },
    GNUNET_REST_HANDLER_END
  };
  (void) plugin;
  struct RequestHandle *handle = GNUNET_new (struct RequestHandle);
  struct GNUNET_REST_RequestHandlerError err;
 
  handle->proc_cls = proc_cls;
  handle->proc = proc;
  handle->rest_handle = conndata_handle;
  handle->url = GNUNET_strdup (conndata_handle->url);
  if (handle->url[strlen (handle->url) - 1] == '/')
    handle->url[strlen (handle->url) - 1] = '\0';
  GNUNET_CONTAINER_DLL_insert (requests_head,
                               requests_tail,
                               handle);
  if (GNUNET_NO ==
      GNUNET_REST_handle_request (conndata_handle, handlers, &err, handle))
  {
    cleanup_handle (handle);
    return GNUNET_NO;
  }
  return GNUNET_YES;
}

References cleanup_handle(), get_cont(), GNUNET_CONTAINER_DLL_insert, GNUNET_new, GNUNET_NO, GNUNET_REST_API_NS_CONFIG, GNUNET_REST_handle_request(), GNUNET_REST_HANDLER_END, GNUNET_strdup, GNUNET_YES, handle, handlers, options_cont(), plugin, requests_head, requests_tail, set_cont(), 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_config_done()

void REST_config_done ( struct GNUNET_REST_Plugin * api )

Exit point from the plugin.

Parameters

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

Returns: always NULL

Definition at line 400 of file config_plugin.c.

{
  struct Plugin *plugin;
 
  while (NULL != requests_head)
    cleanup_handle (requests_head);
  plugin = api->cls;
  plugin->cfg = NULL;
  GNUNET_free (api);
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "CONFIG REST plugin is finished\n");
}

References Plugin::api, cleanup_handle(), GNUNET_BLOCK_PluginFunctions::cls, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_log, plugin, and requests_head.

Referenced by do_shutdown().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ REST_config_init()

void * REST_config_init ( const struct GNUNET_CONFIGURATION_Handle * c )

Entry point for the plugin.

Parameters

cls	the "struct GNUNET_NAMESTORE_PluginEnvironment*"

Returns: NULL on error, otherwise the plugin context

Definition at line 420 of file config_plugin.c.

{
  static struct Plugin plugin;
 
  config_cfg = c;
  struct GNUNET_REST_Plugin *api;
 
  memset (&plugin, 0, sizeof(struct Plugin));
  plugin.cfg = c;
  api = GNUNET_new (struct GNUNET_REST_Plugin);
  api->cls = &plugin;
  api->name = GNUNET_REST_API_NS_CONFIG;
  GNUNET_log (GNUNET_ERROR_TYPE_INFO, _ ("CONFIG REST API initialized\n"));
  return api;
}

References _, GNUNET_REST_Plugin::cls, config_cfg, GNUNET_ERROR_TYPE_INFO, GNUNET_log, GNUNET_new, GNUNET_REST_API_NS_CONFIG, GNUNET_REST_Plugin::name, and plugin.

Referenced by run().

Here is the caller graph for this function:

Variable Documentation

◆ config_cfg

const struct GNUNET_CONFIGURATION_Handle* config_cfg

Definition at line 43 of file config_plugin.c.

Referenced by get_cont(), REST_config_init(), and set_cont().

◆ requests_head

struct RequestHandle* requests_head

static

DLL.

Definition at line 87 of file config_plugin.c.

Referenced by cleanup_handle(), REST_config_done(), and REST_config_process_request().

◆ requests_tail

struct RequestHandle* requests_tail

static

DLL.

Definition at line 92 of file config_plugin.c.

Referenced by cleanup_handle(), and REST_config_process_request().

Data Structures

Macros

Functions

Variables

Macro Definition Documentation

◆ GNUNET_REST_API_NS_CONFIG

Function Documentation

◆ cleanup_handle()

◆ do_error()

◆ add_sections()

◆ add_section_contents()

◆ get_cont()

◆ set_value()

◆ set_cont()

◆ options_cont()

◆ REST_config_process_request()

◆ REST_config_done()

◆ REST_config_init()

Variable Documentation

◆ config_cfg

◆ requests_head

◆ requests_tail