magnet.c File Reference

---

Detailed Description

Handling of magnet links.

Todo:

TODO: Utilize hashlists to prevent duplicate sources.

Author:

Christian Biere

Date:

2006

#include "common.h"
#include "lib/atoms.h"
#include "lib/glib-missing.h"
#include "lib/magnet.h"
#include "lib/tm.h"
#include "lib/url.h"
#include "lib/urn.h"
#include "lib/utf8.h"
#include "lib/walloc.h"
#include "lib/override.h"

Enumerations
enum	magnet_key {   MAGNET_KEY_NONE, MAGNET_KEY_DISPLAY_NAME, MAGNET_KEY_KEYWORD_TOPIC, MAGNET_KEY_EXACT_LENGTH,   MAGNET_KEY_EXACT_SOURCE, MAGNET_KEY_EXACT_TOPIC, MAGNET_KEY_PARQ_ID, NUM_MAGNET_KEYS }
Functions
void	clear_error_str (const gchar ***error_str)
enum magnet_key	magnet_key_get (const gchar *s)
void	plus_to_space (gchar *s)
magnet_source *	magnet_parse_location (const gchar *uri, const gchar **error_str)
magnet_source *	magnet_parse_http_source (const gchar *uri, const gchar **error_str)
magnet_source *	magnet_parse_push_source (const gchar *uri, const gchar **error_str)
magnet_source *	magnet_parse_exact_source (const gchar *uri, const gchar **error_str)
void	magnet_handle_key (struct magnet_resource *res, const gchar *name, const gchar *value)
magnet_resource *	magnet_parse (const gchar *url, const gchar **error_str)
void	magnet_source_free (struct magnet_source **ms_ptr)
void	magnet_resource_free (struct magnet_resource **res_ptr)
magnet_resource *	magnet_resource_new (void)
magnet_source *	magnet_source_new (void)
void	magnet_add_source (struct magnet_resource *res, struct magnet_source *s)
void	magnet_add_source_by_url (struct magnet_resource *res, const gchar *url)
void	magnet_add_sha1_source (struct magnet_resource *res, const struct sha1 *sha1, const host_addr_t addr, const guint16 port, const gchar *guid)
void	magnet_add_search (struct magnet_resource *res, const gchar *search)
void	magnet_set_sha1 (struct magnet_resource *res, const struct sha1 *sha1)
void	magnet_set_tth (struct magnet_resource *res, const struct tth *tth)
gboolean	magnet_set_exact_topic (struct magnet_resource *res, const gchar *topic)
void	magnet_set_display_name (struct magnet_resource *res, const gchar *name)
void	magnet_set_filesize (struct magnet_resource *res, filesize_t size)
void	magnet_append_item (GString **gs_ptr, gboolean escape_value, const gchar *key, const gchar *value)
gchar *	magnet_source_to_string (struct magnet_source *s)
gchar *	magnet_to_string (struct magnet_resource *res)
void	magnet_set_parq_id (struct magnet_resource *res, const gchar *parq_id)
	This is a bit of a hack (an extension anyway) and should only be used for magnets with a single logical source because the PARQ ID is only valid for a certain source.
Variables
struct {
const char *const   key
}	magnet_keys []

---

Enumeration Type Documentation

enum magnet_key

Enumeration values: MAGNET_KEY_NONE  MAGNET_KEY_DISPLAY_NAME  MAGNET_KEY_KEYWORD_TOPIC  MAGNET_KEY_EXACT_LENGTH  MAGNET_KEY_EXACT_SOURCE  MAGNET_KEY_EXACT_TOPIC  MAGNET_KEY_PARQ_ID  NUM_MAGNET_KEYS

---

Function Documentation

void clear_error_str (  const gchar ***  error_str  )  [static]

void magnet_add_search (  struct magnet_resource *  res, const gchar *  search )

void magnet_add_sha1_source (  struct magnet_resource *  res, const struct sha1 *  sha1, const host_addr_t  addr, const guint16  port, const gchar *  guid )

void magnet_add_source (  struct magnet_resource *  res, struct magnet_source *  s )

void magnet_add_source_by_url (  struct magnet_resource *  res, const gchar *  url )

void magnet_append_item (  GString **  gs_ptr, gboolean  escape_value, const gchar *  key, const gchar *  value )  [inline, static]

void magnet_handle_key (  struct magnet_resource *  res, const gchar *  name, const gchar *  value )  [static]

enum magnet_key magnet_key_get (  const gchar *  s  )  [static]

struct magnet_resource* magnet_parse (  const gchar *  url, const gchar **  error_str )

struct magnet_source* magnet_parse_exact_source (  const gchar *  uri, const gchar **  error_str )

struct magnet_source* magnet_parse_http_source (  const gchar *  uri, const gchar **  error_str )  [static]

struct magnet_source* magnet_parse_location (  const gchar *  uri, const gchar **  error_str )  [static]

struct magnet_source* magnet_parse_push_source (  const gchar *  uri, const gchar **  error_str )  [static]

void magnet_resource_free (  struct magnet_resource **  res_ptr  )

struct magnet_resource* magnet_resource_new (  void   )

void magnet_set_display_name (  struct magnet_resource *  res, const gchar *  name )

gboolean magnet_set_exact_topic (  struct magnet_resource *  res, const gchar *  topic )

void magnet_set_filesize (  struct magnet_resource *  res, filesize_t  size )

void magnet_set_parq_id (  struct magnet_resource *  res, const gchar *  parq_id )

This is a bit of a hack (an extension anyway) and should only be used for magnets with a single logical source because the PARQ ID is only valid for a certain source.

void magnet_set_sha1 (  struct magnet_resource *  res, const struct sha1 *  sha1 )

void magnet_set_tth (  struct magnet_resource *  res, const struct tth *  tth )

void magnet_source_free (  struct magnet_source **  ms_ptr  )

struct magnet_source* magnet_source_new (  void   )

gchar* magnet_source_to_string (  struct magnet_source *  s  )

gchar* magnet_to_string (  struct magnet_resource *  res  )

void plus_to_space (  gchar *  s  )  [static]

---

Variable Documentation

const char* const key

const { ... } magnet_keys[] [static]

---