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
gint	refcount
	Number of "struct search" this belongs to.
gchar *	guid
	Servent's GUID (atom).
host_addr_t	addr
guint16	port
guint16	status
	Parsed status bits from trailer.
guint16	speed
time_t	stamp
	Reception time of the hit.
vendor_code	vcode
	Vendor code.
gchar *	version
	Version information (atom).
gint	country
	Country code -- encoded ISO3166.
gnet_host_vec_t *	proxies
	Optional: known push proxies.
gchar *	hostname
	Optional: server's hostname (atom).
host_addr_t	udp_addr
	IP of delivering node, if hit from UDP.
host_addr_t	last_hop
	IP of delivering node.
guint32	num_recs
GSList *	records
GSList *	schl

---

Field Documentation

host_addr_t results_set::addr

gint results_set::country

Country code -- encoded ISO3166.

gchar* results_set::guid

Servent's GUID (atom).

gchar* results_set::hostname

Optional: server's hostname (atom).

host_addr_t results_set::last_hop

IP of delivering node.

guint32 results_set::num_recs

guint16 results_set::port

gnet_host_vec_t* results_set::proxies

Optional: known push proxies.

GSList* results_set::records

gint results_set::refcount

Number of "struct search" this belongs to.

GSList* results_set::schl

guint16 results_set::speed

time_t results_set::stamp

Reception time of the hit.

guint16 results_set::status

Parsed status bits from trailer.

host_addr_t results_set::udp_addr

IP of delivering node, if hit from UDP.

union vendor_code results_set::vcode

Vendor code.

gchar* results_set::version

Version information (atom).

---

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

• search_common.h

---