firedns_dnsbl_lookup(3)

NAME
firedns_dnsbl_lookup - Create a query to look up an IP in a DNS-based blacklist

SYNOPSIS
#include <firedns.h>
-lfiredns

int firedns_dnsbl_lookup(const struct in_addr *ip, const char * const name)

DESCRIPTION
firedns_dnsbl_lookup() creates and sends a request to resolve the TXT record of the entry of ip in the DNS-based blacklist name. It returns a file descriptor that should be select(2)'ed upon (read set). When the file descriptor shows ready for reading call firedns_getresult(3) to retrieve the results. The result will be a char * with the message from the listing server, or NULL if the IP address is not listed.

RETURN VALUE
Returns an integer file descriptor that can be used the same as any other file descriptor. Returns -1 on error.

AUTHOR
Ian Gulliver <ian@penguinhosting.net>

SEE ALSO
libfiredns(3), firedns_getresult(3), select(2)