1ldns(3)                    Library Functions Manual                    ldns(3)
2
3
4

NAME

6       ldns_key_new, ldns_key_new_frm_algorithm, ldns_key_new_frm_fp,
7       ldns_key_new_frm_fp_l, ldns_key_new_frm_fp_rsa,
8       ldns_key_new_frm_fp_rsa_l, ldns_key_new_frm_fp_dsa,
9       ldns_key_new_frm_fp_dsa_l - create a ldns_key
10
11

SYNOPSIS

13       #include <stdint.h>
14       #include <stdbool.h>
15
16       #include <ldns/ldns.h>
17
18       ldns_key* ldns_key_new(void);
19
20       ldns_key* ldns_key_new_frm_algorithm(ldns_signing_algorithm a, uint16_t
21       size);
22
23       ldns_status ldns_key_new_frm_fp(ldns_key **k, FILE *fp);
24
25       ldns_status ldns_key_new_frm_fp_l(ldns_key **k, FILE *fp, int
26       *line_nr);
27
28       RSA* ldns_key_new_frm_fp_rsa(FILE *fp);
29
30       RSA* ldns_key_new_frm_fp_rsa_l(FILE *fp, int *line_nr);
31
32       DSA* ldns_key_new_frm_fp_dsa(FILE *fp);
33
34       DSA* ldns_key_new_frm_fp_dsa_l(FILE *fp, int *line_nr);
35

DESCRIPTION

37       ldns_key_new() Creates a new empty key structure
38              Returns a new ldns_key * structure
39
40       ldns_key_new_frm_algorithm() Creates a new key based on the algorithm
41
42              a: The algorithm to use
43              size: the number of bytes for the keysize
44              Returns a new ldns_key structure with the key
45
46       ldns_key_new_frm_fp() Creates a new priv key based on the contents of
47              the file pointed by fp.
48
49              The file should be in Private-key-format v1.x.
50
51              k: the new ldns_key structure
52              fp: the file pointer to use
53              Returns an error or LDNS_STATUS_OK
54
55       ldns_key_new_frm_fp_l() Creates a new private key based on the contents
56              of the file pointed by fp
57
58              The file should be in Private-key-format v1.x.
59
60              k: the new ldns_key structure
61              fp: the file pointer to use
62              line_nr: pointer to an integer containing the current line num‐
63              ber (for debugging purposes)
64              Returns an error or LDNS_STATUS_OK
65
66       ldns_key_new_frm_fp_rsa() frm_fp helper function. This function parses
67              the remainder of the (RSA) priv. key file generated from bind9
68              fp: the file to parse
69              Returns NULL on failure otherwise a RSA structure
70
71       ldns_key_new_frm_fp_rsa_l() frm_fp helper function. This function
72              parses the remainder of the (RSA) priv. key file generated from
73              bind9
74              fp: the file to parse
75              line_nr: pointer to an integer containing the current line num‐
76              ber (for debugging purposes)
77              Returns NULL on failure otherwise a RSA structure
78
79       ldns_key_new_frm_fp_dsa() frm_fp helper function. This function parses
80              the remainder of the (DSA) priv. key file
81              fp: the file to parse
82              Returns NULL on failure otherwise a RSA structure
83
84       ldns_key_new_frm_fp_dsa_l() frm_fp helper function. This function
85              parses the remainder of the (DSA) priv. key file
86              fp: the file to parse
87              line_nr: pointer to an integer containing the current line num‐
88              ber (for debugging purposes)
89              Returns NULL on failure otherwise a RSA structure
90

AUTHOR

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

REPORTING BUGS

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

102       Copyright (c) 2004 - 2006 NLnet Labs.
103
104       Licensed under the BSD License. There is NO warranty; not even for MER‐
105       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
106
107

SEE ALSO

109       ldns_key.  And perldoc Net::DNS, RFC1034, RFC1035, RFC4033, RFC4034
110       and RFC4035.
111

REMARKS

113       This manpage was automatically generated from the ldns source code by
114       use of Doxygen and some perl.
115
116
117
118                                  30 May 2006                          ldns(3)
Impressum