validator.h File Reference

This file contains a module that performs validation of DNS queries. More...

#include "util/module.h"
#include "util/data/msgreply.h"
#include "validator/val_utils.h"

Data Structures
struct	val_env
	Global state for the validator. More...
struct	val_qstate
	Per query state for the validator module. More...
Defines
#define	NULL_KEY_TTL   900
	This is the TTL to use when a trust anchor fails to prime.
Enumerations
enum	val_state { VAL_INIT_STATE = 0, VAL_FINDKEY_STATE, VAL_VALIDATE_STATE, VAL_FINISHED_STATE }
	State of the validator for a query. More...
Functions
struct module_func_block *	val_get_funcblock ()
	Get the validator function block.
const char *	val_state_to_string (enum val_state state)
	Get validator state as a string.
int	val_init (struct module_env *env, int id)
	validator init
void	val_deinit (struct module_env *env, int id)
	validator deinit
void	val_operate (struct module_qstate *qstate, enum module_ev event, int id, struct outbound_entry *outbound)
	validator operate on a query
void	val_inform_super (struct module_qstate *qstate, int id, struct module_qstate *super)
	inform validator super.
void	val_clear (struct module_qstate *qstate, int id)
	validator cleanup query state
size_t	val_get_mem (struct module_env *env, int id)
	Debug helper routine that assists worker in determining memory in use.

---

Detailed Description

This file contains a module that performs validation of DNS queries.

According to RFC 4034.

---

Define Documentation

#define NULL_KEY_TTL   900

This is the TTL to use when a trust anchor fails to prime.

A trust anchor will be primed no more often than this interval.

Referenced by primeResponseToKE().

---

Enumeration Type Documentation

enum val_state

State of the validator for a query.

Enumerator:

VAL_INIT_STATE	initial state for validation
VAL_FINDKEY_STATE	find the proper keys for validation, follow trust chain
VAL_VALIDATE_STATE	validate the answer, using found key entry
VAL_FINISHED_STATE	finish up

---

Function Documentation

struct module_func_block* val_get_funcblock

(

)

[read]

Get the validator function block.

Returns:

: function block with function pointers to validator methods.

Referenced by checkconf(), and module_factory().

const char* val_state_to_string

(

enum val_state

state

)

Get validator state as a string.

Parameters:

state,:

to convert

Returns:

constant string that is printable.

References VAL_FINDKEY_STATE, VAL_FINISHED_STATE, VAL_INIT_STATE, and VAL_VALIDATE_STATE.

Referenced by val_handle().

void val_inform_super	(	struct module_qstate *	qstate,
		int	id,
		struct module_qstate *	super
	)

inform validator super.

Parameters:

	qstate,:	query state that finished.
	id,:	module id.
	super,:	the qstate to inform.

References log_err(), log_query_info(), module_qstate::minfo, process_dnskey_response(), process_ds_response(), process_prime_response(), module_qstate::qinfo, query_info::qtype, module_qstate::return_msg, module_qstate::return_rcode, VERB_ALGO, verbose(), and val_qstate::wait_prime_ta.

Referenced by fptr_whitelist_mod_inform_super().

size_t val_get_mem	(	struct module_env *	env,
		int	id
	)

Debug helper routine that assists worker in determining memory in use.

Parameters:

	env,:	module environment
	id,:	module id.

Returns:

memory in use in bytes.

References module_env::anchors, anchors_get_mem(), val_env::kcache, key_cache_get_mem(), module_env::modinfo, and val_env::nsec3_keyiter_count.

Referenced by fptr_whitelist_mod_get_mem().