NAME

       getdns_convert, getdns_convert_dns_name_to_fqdn, getdns_convert_fqdn_to_dns_name -- convert dname between
       presentation- and wire-format

LIBRARY

       DNS Resolver library (libgetdns, -lgetdns)

SYNOPSIS

       #include <getdns.h>

       getdns_return_t
       getdns_convert_dns_name_to_fqdn (const getdns_bindata *dns_name_wire_fmt,
          char **fqdn_as_string)

       getdns_return_t
       getdns_convert_fqdn_to_dns_name (char *fqdn_as_string,
          const getdns_bindata **dns_name_wire_fmt)

DESCRIPTION

       Names in DNS fields are stored in a fashion very different from the normal presentation  format  normally
       used  in applications. The DNS format is described in the first paragraph in Section 3.1 of RFC 1035; the
       presentation format here is a null-terminated string with interior dots. These helper functions only work
       with  names in the DNS format that are not compressed. They are useful for converting domain names in the
       replies_tree to and from the FQDN presentation format.

       getdns_convert_dns_name_to_fqdn() converts a domain name in DNS format to the  presentation  format.  For
       example,  the  hex  sequence  03  77  77  77 07 65 78 61 6d 70 6c 65 03 63 6f 6d 00 would be converted to
       "www.example.com".  getdns_convert_fqdn_to_dns_name() does the reverse:  it  converts  a  null-terminated
       string in FQDN format to bytes in DNS format.

       dns_name_wire_fmt The non-compressed DNS wire format name (per RFC 1035) in a bindata structure that will
          be converted to/from an fqdn.  In  getdns_convert_fqdn_to_dns_name  storage  is  allocated  using  the
          system allocator (malloc) and must be freed by the caller.

       fqdn_as_string  a null terminated string to be converted to/from non-compressed DNS wire format name (per
          RFC 1035).  In  getdns_convert_dns_name_to_fqdn  storage  is  allocated  using  the  system  allocator
          (malloc) and must be freed by the caller.

RETURN VALUES

       Upon successful completion the function returns GETDNS_RETURN_GOOD

EXAMPLES

       TBD

SEE ALSO

       libgetdns(3)