man/firedns_getname6.3

   1 .\" (C) 2002 Ian Gulliver
   2 .TH firedns_getname6 3 2002-03-31
   3 .SH NAME
   4 firedns_getname6 \- Create a query to resolve an IPv6 address to a hostname
   5 .SH SYNOPSIS
   6 .B #include <firedns.h>
   7 .br
   8 .B -lfiredns
   9 .LP
  10 .BI "int firedns_getname6(const struct in6_addr *" "ip" ")"
  11 .SH DESCRIPTION
  12 firedns_getname6() creates and sends a request to resolve
  13 the IPv6 address
  14 .I ip
  15 to a hostname.  It returns a file descriptor that 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)