man/fdnsnamep.1

   1 .\" (C) 2004 Ian Gulliver
   2 .TH fdnsnamep 1 2004-02-13
   3 .SH NAME
   4 fdnsnamep \- resolve an IPv4 or IPv6 address to a hostname with paranoid checking
   5 .SH SYNOPSIS
   6 .BI "fdnsname " "<IP address>"
   7 .SH DESCRIPTION
   8 fdnsname will attempt to look up a single hostname for
   9 .IR "IP address"
  10 (which is an IPv4 address in dotted-quad format or an IPv6 address in
  11 colon-seperated format).  If one is found, the program checks to make sure that the
  12 hostname has a corresponding A or AAAA record pointing back to the supplied IP.  If so,
  13 the hostname is printed to standard output and the program exits
  14 with return code 0.  If the paranoid check fails, nothing is printed and the
  15 program exits with return code 3.  If no hostname is found, nothing is printed and the program exits
  16 with return code 1.
  17 .SH AUTHOR
  18 Ian Gulliver <ian@penguinhosting.net>
  19 .SH SEE ALSO
  20 .BR libfiredns (3)