man/firedns_getip6list.3

   1 .\" (C) 2002 Ian Gulliver
   2 .TH firedns_getip6list 3 2004-02-12
   3 .SH NAME
   4 firedns_getip6list \- Create a query to resolve a hostname to a list of IPv6 addresses
   5 .SH SYNOPSIS
   6 .B #include <firedns.h>
   7 .br
   8 .B -lfiredns
   9 .LP
  10 .BI "int firedns_getip6list(const char * const " "name" ")"
  11 .SH DESCRIPTION
  12 firedns_getip6list() creates and sends a request to resolve
  13 .I name
  14 to a list of IPv6 address.  It returns a file descriptor that
  15 should be
  16 .IR select (2)'ed
  17 upon (read set).  When the file descriptor shows ready
  18 for reading, call
  19 .IR firedns_getresult (3)
  20 to retrieve the results.
  21 .SH RETURN VALUE
  22 Returns an integer file descriptor that can be used the
  23 same as any other file descriptor.  Returns
  24 .I -1
  25 on error.
  26 .SH AUTHOR
  27 Ian Gulliver <ian@penguinhosting.net>
  28 .SH SEE ALSO
  29 .BR libfiredns (3),
  30 .BR firedns_getresult (3),
  31 .BR select (2)