ldns

Section: C Library Functions (3)
Updated: 30 May 2006
Page Index
 

NAME

ldns_dnssec_zone_sign, ldns_dnssec_zone_sign_nsec3, ldns_dnssec_zone_mark_glue, ldns_dnssec_name_node_next_nonglue, ldns_dnssec_zone_create_nsecs, ldns_dnssec_remove_signatures, ldns_dnssec_zone_create_rrsigs - sign ldns_dnssec_zone

 

SYNOPSIS

#include <stdint.h>
#include <stdbool.h>

#include <ldns/ldns.h>

ldns_status ldns_dnssec_zone_sign(ldns_dnssec_zone *zone, ldns_rr_list *new_rrs, ldns_key_list *key_list, int (*func)(ldns_rr *, void *), void *arg);

ldns_status ldns_dnssec_zone_sign_nsec3(ldns_dnssec_zone *zone, ldns_rr_list *new_rrs, ldns_key_list *key_list, int (*func)(ldns_rr *, void *), void *arg, uint8_t algorithm, uint8_t flags, uint16_t iterations, uint8_t salt_length, uint8_t *salt);


 ldns_dnssec_zone_mark_glue();

ldns_rbnode_t* ldns_dnssec_name_node_next_nonglue(ldns_rbnode_t *node);

ldns_status ldns_dnssec_zone_create_nsecs(ldns_dnssec_zone *zone, ldns_rr_list *new_rrs);

ldns_dnssec_rrs* ldns_dnssec_remove_signatures(ldns_dnssec_rrs *signatures, ldns_key_list *key_list, int (*func)(ldns_rr *, void *), void *arg);

ldns_status ldns_dnssec_zone_create_rrsigs(ldns_dnssec_zone *zone, ldns_rr_list *new_rrs, ldns_key_list *key_list, int (*func)(ldns_rr *, void*), void *arg);

 

DESCRIPTION

ldns_dnssec_zone_sign()
signs the given zone with the given keys

.br zone: the zone to sign .br key_list: the list of keys to sign the zone with .br new_rrs: newly created resource records are added to this list, to free them later .br func: callback function that decides what to do with old signatures This function takes an ldns_rr* and an optional void *arg argument, and returns one of four values: LDNS_SIGNATURE_LEAVE_ADD_NEW: leave the signature and add a new one for the corresponding key LDNS_SIGNATURE_REMOVE_ADD_NEW: remove the signature and replace is with a new one from the same key LDNS_SIGNATURE_LEAVE_NO_ADD: leave the signature and do not add a new one with the corresponding key LDNS_SIGNATURE_REMOVE_NO_ADD: remove the signature and do not replace

.br arg: optional argument for the callback function .br Returns LDNS_STATUS_OK on success, an error code otherwise

ldns_dnssec_zone_sign_nsec3()
signs the given zone with the given new zone, with NSEC3

.br zone: the zone to sign .br key_list: the list of keys to sign the zone with .br new_rrs: newly created resource records are added to this list, to free them later .br func: callback function that decides what to do with old signatures .br arg: optional argument for the callback function .br algorithm: the NSEC3 hashing algorithm to use .br flags: NSEC3 flags .br iterations: the number of NSEC3 hash iterations to use .br salt_length: the length (in octets) of the NSEC3 salt .br salt: the NSEC3 salt data .br Returns LDNS_STATUS_OK on success, an error code otherwise

ldns_dnssec_zone_mark_glue()

ldns_dnssec_name_node_next_nonglue()
Finds the first dnssec_name node in the rbtree that is not occluded. It *does* return names that are partially occluded.

.br node: the first node to check .br Returns the first node that has not been marked as glue, or NULL if not found (TODO: make that LDNS_RBTREE_NULL?)

ldns_dnssec_zone_create_nsecs()
Adds NSEC records to the given dnssec_zone

.br zone: the zone to add the records to .br new_rrs: ldns_rr's created by this function are added to this rr list, so the caller can free them later .br Returns LDNS_STATUS_OK on success, an error code otherwise

ldns_dnssec_remove_signatures()
remove signatures if callback function tells to

.br signatures: list of signatures to check, and possibly remove, depending on the value of the callback .br key_list: these are marked to be used or not, on the return value of the callback .br func: this function is called to specify what to do with each signature (and corresponding key) .br arg: Optional argument for the callback function .br Returns s pointer to the new signatures rrs (the original passed to this function may have been removed)

ldns_dnssec_zone_create_rrsigs()
Adds signatures to the zone

.br zone: the zone to add RRSIG Resource Records to .br new_rrs: the RRSIG RRs that are created are also added to this list, so the caller can free them later .br key_list: list of keys to sign with. .br func: Callback function to decide what keys to use and what to do with old signatures .br arg: Optional argument for the callback function .br Returns LDNS_STATUS_OK on success, error otherwise

 

AUTHOR

The ldns team at NLnet Labs. Which consists out of Jelte Jansen and Miek Gieben.

 

REPORTING BUGS

Please report bugs to ldns-team@nlnetlabs.nl or in our bugzilla at http://www.nlnetlabs.nl/bugs/index.html

 

COPYRIGHT

Copyright (c) 2004 - 2006 NLnet Labs.

Licensed under the BSD License. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

 

SEE ALSO

ldns_dnssec_zone. And perldoc Net::DNS, RFC1034, RFC1035, RFC4033, RFC4034 and RFC4035.  

REMARKS

This manpage was automatically generated from the ldns source code by use of Doxygen and some perl.


 

Index

NAME
SYNOPSIS
DESCRIPTION
AUTHOR
REPORTING BUGS
COPYRIGHT
SEE ALSO
REMARKS