1dane_query_to_raw_tlsa(3)           gnutls           dane_query_to_raw_tlsa(3)
2
3
4

NAME

6       dane_query_to_raw_tlsa - API function
7

SYNOPSIS

9       #include <gnutls/dane.h>
10
11       int dane_query_to_raw_tlsa(dane_query_t q, unsigned int * data_entries,
12       char *** dane_data, int ** dane_data_len, int * secure, int * bogus);
13

ARGUMENTS

15       dane_query_t q
16                   The query result structure
17
18       unsigned int * data_entries
19                   Pointer set to the number of entries in the query
20
21       char *** dane_data
22                   Pointer to contain an array of DNS rdata items,  terminated
23                   with  a NULL pointer; caller must guarantee that the refer‐
24                   enced  data  remains  valid  until  dane_query_deinit()  is
25                   called.
26
27       int ** dane_data_len
28                   Pointer  to  contain  the  length  n bytes of the dane_data
29                   items
30
31       int * secure
32                   Pointer set true if the result is validated securely, false
33                   if  validation failed or the domain queried has no security
34                   info
35
36       int * bogus Pointer set true if the result was not secure due to a  se‐
37                   curity failure
38

DESCRIPTION

40       This function will provide the DANE data from the query response.
41
42       The pointers dane_data and dane_data_len are allocated with gnutls_mal‐
43       loc() to contain the data from the query result structure (individual
44        dane_data items simply point to the original data and  are  not  allo‐
45       cated  separately).   The returned  dane_data are only valid during the
46       lifetime of  q .
47

RETURNS

49       On success, DANE_E_SUCCESS (0) is returned, otherwise a negative  error
50       value.
51

REPORTING BUGS

53       Report bugs to <bugs@gnutls.org>.
54       Home page: https://www.gnutls.org
55
56

58       Copyright © 2001- Free Software Foundation, Inc., and others.
59       Copying  and  distribution  of this file, with or without modification,
60       are permitted in any medium without royalty provided the copyright  no‐
61       tice and this notice are preserved.
62

SEE ALSO

64       The  full  documentation  for gnutls is maintained as a Texinfo manual.
65       If the /usr/share/doc/gnutls/ directory does not contain the HTML  form
66       visit
67
68       https://www.gnutls.org/manual/
69
70gnutls                               3.7.8           dane_query_to_raw_tlsa(3)
Impressum