- * Resoltion status indicator
- * EXISTS: the name to lookup exists
- * EXPIRED: the name in the record expired
- */
-enum ResolutionStatus
-{
- EXISTS = 1,
- EXPIRED = 2
-};
-
-/**
- * Handle to a currenty pending resolution
- */
-struct ResolverHandle
-{
- /* The name to resolve */
- char *name;
-
- /* has this query been answered? how many matches */
- int answered;
-
- /* the authoritative zone to query */
- GNUNET_HashCode authority;
-
- /* the name of the authoritative zone to query */
- char *authority_name;
-
- /**
- * we have an authority in namestore that
- * may be able to resolve
- */
- int authority_found;
-
- /* a handle for dht lookups. should be NULL if no lookups are in progress */
- struct GNUNET_DHT_GetHandle *get_handle;
-
- /* timeout task for dht lookups */
- GNUNET_SCHEDULER_TaskIdentifier dht_timeout_task;
-
- /* called when resolution phase finishes */
- ResolutionResultProcessor proc;
-
- /* closure passed to proc */
- void* proc_cls;
-
- /* DLL to store the authority chain */
- struct AuthorityChain *authority_chain_head;
-
- /* DLL to store the authority chain */
- struct AuthorityChain *authority_chain_tail;
-
- /* status of the resolution result */
- enum ResolutionStatus status;
-
-};
-
-
-/**
- * Handle to a record lookup
+ * Lookup of a record in a specific zone
+ * calls RecordLookupProcessor on result or timeout
+ *
+ * @param zone the zone to perform the lookup in
+ * @param record_type the record type to look up
+ * @param name the name to look up
+ * @param shorten_key optional private key for authority caching, can be NULL
+ * @param only_cached GNUNET_NO to only check locally not DHT for performance
+ * @param proc the processor to call
+ * @param proc_cls the closure to pass to @a proc
+ * @return handle to cancel operation