gnunet-peerinfo_plugins.h File Reference

plugin management API More...

#include "gnunet_util_lib.h"

Include dependency graph for gnunet-peerinfo_plugins.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
void	GPI_plugins_load (const struct GNUNET_CONFIGURATION_Handle *cfg)
	Load transport plugins. More...
void	GPI_plugins_unload (void)
	Unload all plugins. More...
struct GNUNET_TRANSPORT_PluginFunctions *	GPI_plugins_find (const char *name)
	Obtain the plugin API based on a plugin name. More...

Detailed Description

plugin management API

Author

Christian Grothoff

Definition in file gnunet-peerinfo_plugins.h.

Function Documentation

GPI_plugins_load()

void GPI_plugins_load

(

const struct GNUNET_CONFIGURATION_Handle *

cfg

)

Load transport plugins.

Parameters

cfg	configuration to use

Load transport plugins.

The respective functions will be invoked by the plugins when the respective events happen. The closure will be set to a 'const char*' containing the name of the plugin that caused the call.

Parameters

cfg	configuration to use

Definition at line 89 of file gnunet-peerinfo_plugins.c.

{
  struct TransportPlugin *plug;
  struct TransportPlugin *next;
  char *libname;
  char *plugs;
  char *pos;
 
  if (NULL != plugins_head)
    return; /* already loaded */
  if (GNUNET_OK !=
      GNUNET_CONFIGURATION_get_value_string (cfg, "TRANSPORT", "PLUGINS",
                                             &plugs))
    return;
  GNUNET_log (GNUNET_ERROR_TYPE_INFO, _ ("Starting transport plugins `%s'\n"),
              plugs);
  for (pos = strtok (plugs, " "); pos != NULL; pos = strtok (NULL, " "))
  {
    GNUNET_log (GNUNET_ERROR_TYPE_INFO, _ ("Loading `%s' transport plugin\n"),
                pos);
    GNUNET_asprintf (&libname, "libgnunet_plugin_transport_%s", pos);
    plug = GNUNET_new (struct TransportPlugin);
    plug->short_name = GNUNET_strdup (pos);
    plug->lib_name = libname;
    plug->env.cfg = cfg;
    plug->env.cls = plug->short_name;
    GNUNET_CONTAINER_DLL_insert (plugins_head, plugins_tail, plug);
  }
  GNUNET_free (plugs);
  next = plugins_head;
  while (next != NULL)
  {
    plug = next;
    next = plug->next;
    plug->api = GNUNET_PLUGIN_load (plug->lib_name, &plug->env);
    if (plug->api == NULL)
    {
      GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                  _ ("Failed to load transport plugin for `%s'\n"),
                  plug->lib_name);
      GNUNET_CONTAINER_DLL_remove (plugins_head, plugins_tail, plug);
      GNUNET_free (plug->short_name);
      GNUNET_free (plug->lib_name);
      GNUNET_free (plug);
    }
  }
}

References _, TransportPlugin::api, cfg, GNUNET_TRANSPORT_PluginEnvironment::cfg, GNUNET_TRANSPORT_PluginEnvironment::cls, TransportPlugin::env, GNUNET_asprintf(), GNUNET_CONFIGURATION_get_value_string(), GNUNET_CONTAINER_DLL_insert, GNUNET_CONTAINER_DLL_remove, GNUNET_ERROR_TYPE_ERROR, GNUNET_ERROR_TYPE_INFO, GNUNET_free, GNUNET_log, GNUNET_new, GNUNET_OK, GNUNET_PLUGIN_load(), GNUNET_strdup, TransportPlugin::lib_name, TransportPlugin::next, plugins_head, plugins_tail, and TransportPlugin::short_name.

Referenced by libgnunet_plugin_dhtu_gnunet_init(), and state_machine().

Here is the call graph for this function:

Here is the caller graph for this function:

GPI_plugins_unload()

void GPI_plugins_unload

(

void

)

Unload all plugins.

Definition at line 142 of file gnunet-peerinfo_plugins.c.

{
  struct TransportPlugin *plug;
 
  while (NULL != (plug = plugins_head))
  {
    GNUNET_break (NULL == GNUNET_PLUGIN_unload (plug->lib_name, plug->api));
    GNUNET_free (plug->lib_name);
    GNUNET_free (plug->short_name);
    GNUNET_CONTAINER_DLL_remove (plugins_head, plugins_tail, plug);
    GNUNET_free (plug);
  }
}

References TransportPlugin::api, GNUNET_break, GNUNET_CONTAINER_DLL_remove, GNUNET_free, GNUNET_PLUGIN_unload(), TransportPlugin::lib_name, plugins_head, plugins_tail, and TransportPlugin::short_name.

Referenced by libgnunet_plugin_dhtu_gnunet_done(), and shutdown_task().

Here is the call graph for this function:

Here is the caller graph for this function:

GPI_plugins_find()

struct GNUNET_TRANSPORT_PluginFunctions* GPI_plugins_find

(

const char *

name

)

Obtain the plugin API based on a plugin name.

Parameters

name	name of the plugin

Returns

the plugin's API, NULL if the plugin is not loaded

Definition at line 164 of file gnunet-peerinfo_plugins.c.

{
  struct TransportPlugin *head = plugins_head;
 
  char *stripped = GNUNET_strdup (name);
  char *head_stripped;
  char *sep = strchr (stripped, '_');
 
  if (NULL != sep)
    sep[0] = '\0';
 
  while (head != NULL)
  {
    head_stripped = GNUNET_strdup (head->short_name);
    char *head_sep = strchr (head_stripped, '_');
    if (NULL != head_sep)
      head_sep[0] = '\0';
    if (0 == strcmp (head_stripped, stripped))
    {
      GNUNET_free (head_stripped);
      break;
    }
    GNUNET_free (head_stripped);
    head = head->next;
  }
  GNUNET_free (stripped);
  if (NULL == head)
    return NULL;
  return head->api;
}

References GNUNET_free, GNUNET_strdup, head, name, PendingResolutions::next, and plugins_head.

Referenced by gnunet_try_connect(), parse_hello_uri(), peerinfo_cb(), and print_my_uri().

Here is the caller graph for this function: