plugin_rest_config.c File Reference

#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 plugin_rest_config.c:

Go to the source code of this file.

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...
static void	rest_config_process_request (struct GNUNET_REST_RequestHandle *conndata_handle, GNUNET_REST_ResultProcessor proc, void *proc_cls)
	Function processing the REST call. More...
void *	libgnunet_plugin_rest_config_init (void *cls)
	Entry point for the plugin. More...
void *	libgnunet_plugin_rest_config_done (void *cls)
	Exit point from the plugin. More...

Variables
const struct GNUNET_CONFIGURATION_Handle *	cfg
	Handle to our configuration. More...

Macro Definition Documentation

GNUNET_REST_API_NS_CONFIG

#define GNUNET_REST_API_NS_CONFIG   "/config"

Definition at line 33 of file plugin_rest_config.c.

Referenced by get_cont(), libgnunet_plugin_rest_config_init(), rest_config_process_request(), and set_cont().

Function Documentation

cleanup_handle()

static void cleanup_handle ( struct RequestHandle *  handle )

static

Cleanup request handle.

Parameters

handle

Handle to clean up

Definition at line 78 of file plugin_rest_config.c.

References GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_log, and RequestHandle::url.

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

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

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
tc	scheduler context

Definition at line 94 of file plugin_rest_config.c.

References cleanup_handle(), GNUNET_REST_create_response(), handle, RequestHandle::proc, RequestHandle::proc_cls, and RequestHandle::response_code.

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

{
  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);
}

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 106 of file plugin_rest_config.c.

Referenced by get_cont().

{
  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);
}

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 126 of file plugin_rest_config.c.

Referenced by get_cont().

{
  json_t *section_obj = cls;

  json_object_set_new(section_obj, option, json_string(value));
}

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 142 of file plugin_rest_config.c.

References add_section_contents(), add_sections(), cleanup_handle(), do_error(), GNUNET_CONFIGURATION_iterate(), GNUNET_CONFIGURATION_iterate_section_values(), GNUNET_free, GNUNET_REST_API_NS_CONFIG, GNUNET_REST_create_response(), GNUNET_SCHEDULER_add_now(), handle, RequestHandle::proc, RequestHandle::proc_cls, response, RequestHandle::response_code, result, section, and RequestHandle::url.

Referenced by rest_config_process_request().

{
  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(cfg, &add_sections, result);
    }
  else
    {
      result = json_object();
      section = &handle->url[strlen(GNUNET_REST_API_NS_CONFIG) + 1];
      GNUNET_CONFIGURATION_iterate_section_values(cfg,
                                                  section,
                                                  &add_section_contents,
                                                  result);
    }
  response = json_dumps(result, 0);
  resp = GNUNET_REST_create_response(response);
  handle->proc(handle->proc_cls, resp, MHD_HTTP_OK);
  cleanup_handle(handle);
  GNUNET_free(response);
  json_decref(result);
}

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 181 of file plugin_rest_config.c.

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

Referenced by set_cont().

{
  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)
}

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 207 of file plugin_rest_config.c.

References cleanup_handle(), config_file, GNUNET_REST_RequestHandle::data, GNUNET_REST_RequestHandle::data_size, DIR_SEPARATOR_STR, do_error(), getenv(), GNUNET_asprintf(), GNUNET_CONFIGURATION_dup(), GNUNET_CONFIGURATION_write(), GNUNET_ERROR_TYPE_ERROR, 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, option, RequestHandle::proc, RequestHandle::proc_cls, RequestHandle::response_code, RequestHandle::rest_handle, section, set_value(), RequestHandle::url, and value.

Referenced by rest_config_process_request().

{
  struct RequestHandle *handle = cls;
  char term_data[handle->rest_handle->data_size + 1];
  struct GNUNET_CONFIGURATION_Handle *out = GNUNET_CONFIGURATION_dup(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);
  cfg = out;
  handle->proc(handle->proc_cls,
               GNUNET_REST_create_response(NULL),
               MHD_HTTP_OK);
  cleanup_handle(handle);
}

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 313 of file plugin_rest_config.c.

References cleanup_handle(), GNUNET_REST_create_response(), handle, RequestHandle::proc, and RequestHandle::proc_cls.

Referenced by rest_config_process_request().

{
  struct MHD_Response *resp;
  struct RequestHandle *handle = cls;

  resp = GNUNET_REST_create_response(NULL);
  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);
}

Here is the call graph for this function:

Here is the caller graph for this function:

rest_config_process_request()

static void rest_config_process_request ( struct GNUNET_REST_RequestHandle *  conndata_handle, GNUNET_REST_ResultProcessor  proc, void *  proc_cls  )

static

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 341 of file plugin_rest_config.c.

References do_error(), GNUNET_REST_RequestHandlerError::error_code, get_cont(), GNUNET_new, GNUNET_NO, GNUNET_REST_API_NS_CONFIG, GNUNET_REST_handle_request(), GNUNET_REST_HANDLER_END, GNUNET_SCHEDULER_add_now(), GNUNET_strdup, handle, options_cont(), RequestHandle::proc, RequestHandle::proc_cls, RequestHandle::response_code, RequestHandle::rest_handle, set_cont(), GNUNET_REST_RequestHandle::url, and RequestHandle::url.

Referenced by libgnunet_plugin_rest_config_init().

{
  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
  };
  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';

  if (GNUNET_NO ==
      GNUNET_REST_handle_request(conndata_handle, handlers, &err, handle))
    {
      handle->response_code = err.error_code;
      GNUNET_SCHEDULER_add_now(&do_error, handle);
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

libgnunet_plugin_rest_config_init()

void* libgnunet_plugin_rest_config_init

(

void *

cls

)

Entry point for the plugin.

Parameters

cls	the "struct GNUNET_NAMESTORE_PluginEnvironment*"

Returns

NULL on error, otherwise the plugin context

Definition at line 377 of file plugin_rest_config.c.

References _, Plugin::api, Plugin::cfg, GNUNET_REST_Plugin::cls, GNUNET_ERROR_TYPE_INFO, GNUNET_log, GNUNET_new, GNUNET_REST_API_NS_CONFIG, GNUNET_REST_Plugin::name, plugin, GNUNET_REST_Plugin::process_request, and rest_config_process_request().

{
  static struct Plugin plugin;

  cfg = cls;
  struct GNUNET_REST_Plugin *api;

  if (NULL != plugin.cfg)
    return NULL; /* can only initialize once! */
  memset(&plugin, 0, sizeof(struct Plugin));
  plugin.cfg = cfg;
  api = GNUNET_new(struct GNUNET_REST_Plugin);
  api->cls = &plugin;
  api->name = GNUNET_REST_API_NS_CONFIG;
  api->process_request = &rest_config_process_request;
  GNUNET_log(GNUNET_ERROR_TYPE_INFO, _("CONFIG REST API initialized\n"));
  return api;
}

Here is the call graph for this function:

libgnunet_plugin_rest_config_done()

void* libgnunet_plugin_rest_config_done

(

void *

cls

)

Exit point from the plugin.

Parameters

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

Returns

always NULL

Definition at line 404 of file plugin_rest_config.c.

References Plugin::api, Plugin::cfg, GNUNET_REST_Plugin::cls, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_log, and plugin.

{
  struct GNUNET_REST_Plugin *api = cls;
  struct Plugin *plugin = api->cls;

  plugin->cfg = NULL;
  GNUNET_free(api);
  GNUNET_log(GNUNET_ERROR_TYPE_DEBUG, "CONFIG REST plugin is finished\n");
  return NULL;
}

Variable Documentation

cfg

const struct GNUNET_CONFIGURATION_Handle* cfg

Handle to our configuration.

Handle to our configuration.

Definition at line 42 of file plugin_rest_config.c.