results_set Struct Reference

#include <search_common.h>

---

Detailed Description

A results_set structure factorizes the common information from a Query Hit packet, and then has a list of individual records, one for each hit.

A single structure is created for each Query Hit packet we receive, but then it can be dispatched for displaying some of its records to the various searches in presence. Each time the structure is dispatched, the `refcount' is incremented, so that we don't free it and its content until it has been "forgotten" that many times.

Attention:

NB: we reuse the pure data structure gnet_host_vec_t from the core. It is purely descriptive anyway.

Data Fields
results_set_magic_t	magic
gint	num_recs
const gchar *	guid
	Servent's GUID (atom).
const gchar *	version
	Version information (atom).
const gchar *	hostname
	Optional: server's hostname (atom).
const gchar *	query
	Optional: original query (atom).
GSList *	records
GSList *	schl
gnet_host_vec_t *	proxies
	Optional: known push proxies.
host_addr_t	addr
host_addr_t	last_hop
	IP of delivering node.
time_t	stamp
	Reception time of the hit.
vendor_code_t	vcode
	Vendor code.
guint32	status
	Parsed status bits from trailer.
guint16	country
	Country code -- encoded ISO3166.
guint16	port
guint16	speed
guint8	hops
guint8	ttl

---

Field Documentation

host_addr_t results_set::addr

guint16 results_set::country

Country code -- encoded ISO3166.

const gchar* results_set::guid

Servent's GUID (atom).

guint8 results_set::hops

const gchar* results_set::hostname

Optional: server's hostname (atom).

host_addr_t results_set::last_hop

IP of delivering node.

results_set_magic_t results_set::magic

gint results_set::num_recs

guint16 results_set::port

gnet_host_vec_t* results_set::proxies

Optional: known push proxies.

const gchar* results_set::query

Optional: original query (atom).

GSList* results_set::records

GSList* results_set::schl

guint16 results_set::speed

time_t results_set::stamp

Reception time of the hit.

guint32 results_set::status

Parsed status bits from trailer.

guint8 results_set::ttl

vendor_code_t results_set::vcode

Vendor code.

const gchar* results_set::version

Version information (atom).

---

The documentation for this struct was generated from the following file:

• search_common.h

---