man/firedns_getmx.3

   1 .\" (C) 2002 Ian Gulliver
   2 .TH firedns_getmx 3 2002-03-31
   3 .SH NAME
   4 firedns_getmx \- Create a query to resolve a hostname's MX record
   5 .SH SYNOPSIS
   6 .B #include <firedns.h>
   7 .br
   8 .B -lfiredns
   9 .LP
  10 .BI "int firedns_getmx(const char * const " "name" ")"
  11 .SH DESCRIPTION
  12 firedns_getmx() creates and sends a request to resolve
  13 the MX record of
  14 .IR name .
  15 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)