|
Packit |
aea12f |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
991b93 |
.TH "dane_query_to_raw_tlsa" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit |
aea12f |
.SH NAME
|
|
Packit |
aea12f |
dane_query_to_raw_tlsa \- API function
|
|
Packit |
aea12f |
.SH SYNOPSIS
|
|
Packit |
aea12f |
.B #include <gnutls/dane.h>
|
|
Packit |
aea12f |
.sp
|
|
Packit |
aea12f |
.BI "int dane_query_to_raw_tlsa(dane_query_t " q ", unsigned int * " data_entries ", char *** " dane_data ", int ** " dane_data_len ", int * " secure ", int * " bogus ");"
|
|
Packit |
aea12f |
.SH ARGUMENTS
|
|
Packit |
aea12f |
.IP "dane_query_t q" 12
|
|
Packit |
aea12f |
The query result structure
|
|
Packit |
aea12f |
.IP "unsigned int * data_entries" 12
|
|
Packit |
aea12f |
Pointer set to the number of entries in the query
|
|
Packit |
aea12f |
.IP "char *** dane_data" 12
|
|
Packit |
aea12f |
Pointer to contain an array of DNS rdata items, terminated with a NULL pointer;
|
|
Packit |
aea12f |
caller must guarantee that the referenced data remains
|
|
Packit |
aea12f |
valid until \fBdane_query_deinit()\fP is called.
|
|
Packit |
aea12f |
.IP "int ** dane_data_len" 12
|
|
Packit |
aea12f |
Pointer to contain the length n bytes of the dane_data items
|
|
Packit |
aea12f |
.IP "int * secure" 12
|
|
Packit |
aea12f |
Pointer set true if the result is validated securely, false if
|
|
Packit |
aea12f |
validation failed or the domain queried has no security info
|
|
Packit |
aea12f |
.IP "int * bogus" 12
|
|
Packit |
aea12f |
Pointer set true if the result was not secure due to a security failure
|
|
Packit |
aea12f |
.SH "DESCRIPTION"
|
|
Packit |
aea12f |
This function will provide the DANE data from the query
|
|
Packit |
aea12f |
response.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
The pointers dane_data and dane_data_len are allocated with \fBgnutls_malloc()\fP
|
|
Packit |
aea12f |
to contain the data from the query result structure (individual
|
|
Packit |
aea12f |
\fIdane_data\fP items simply point to the original data and are not allocated separately).
|
|
Packit |
aea12f |
The returned \fIdane_data\fP are only valid during the lifetime of \fIq\fP .
|
|
Packit |
aea12f |
.SH "RETURNS"
|
|
Packit |
aea12f |
On success, \fBDANE_E_SUCCESS\fP (0) is returned, otherwise a
|
|
Packit |
aea12f |
negative error value.
|
|
Packit |
aea12f |
.SH "REPORTING BUGS"
|
|
Packit |
aea12f |
Report bugs to <bugs@gnutls.org>.
|
|
Packit |
aea12f |
.br
|
|
Packit |
aea12f |
Home page: https://www.gnutls.org
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
.SH COPYRIGHT
|
|
Packit Service |
991b93 |
Copyright \(co 2001- Free Software Foundation, Inc., and others.
|
|
Packit |
aea12f |
.br
|
|
Packit |
aea12f |
Copying and distribution of this file, with or without modification,
|
|
Packit |
aea12f |
are permitted in any medium without royalty provided the copyright
|
|
Packit |
aea12f |
notice and this notice are preserved.
|
|
Packit |
aea12f |
.SH "SEE ALSO"
|
|
Packit |
aea12f |
The full documentation for
|
|
Packit |
aea12f |
.B gnutls
|
|
Packit |
aea12f |
is maintained as a Texinfo manual.
|
|
Packit |
aea12f |
If the /usr/share/doc/gnutls/
|
|
Packit |
aea12f |
directory does not contain the HTML form visit
|
|
Packit |
aea12f |
.B
|
|
Packit |
aea12f |
.IP https://www.gnutls.org/manual/
|
|
Packit |
aea12f |
.PP
|