adig.1 3.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091
  1. .TH ADIG "1" "April 2011" "c-ares utilities"
  2. .SH NAME
  3. adig \- print information collected from Domain Name System (DNS) servers
  4. .SH SYNOPSIS
  5. .B adig
  6. [\fIOPTION\fR]... \fINAME\fR...
  7. .SH DESCRIPTION
  8. .PP
  9. .\" Add any additional description here
  10. .PP
  11. Send queries to DNS servers about \fINAME\fR and print received
  12. information, where \fINAME\fR is a valid DNS name (e.g. www.example.com,
  13. 1.2.3.10.in-addr.arpa).
  14. .PP
  15. This utility comes with the \fBc\-ares\fR asynchronous resolver library.
  16. .SH OPTIONS
  17. .TP
  18. \fB\-c\fR class
  19. Set the query class.
  20. Possible values for class are
  21. ANY, CHAOS, HS and IN (default).
  22. .TP
  23. \fB\-d\fR
  24. Print some extra debugging output.
  25. .TP
  26. \fB\-f\fR flag
  27. Add a behavior control flag.
  28. Possible values for flag are
  29. igntc - ignore to query in TCP to get truncated UDP answer,
  30. noaliases - don't honor the HOSTALIASES environment variable,
  31. norecurse - don't query upstream servers recursively,
  32. primary - use the first server,
  33. stayopen - don't close the communication sockets, and
  34. usevc - always use TCP.
  35. .TP
  36. \fB\-h\fR, \fB\-?\fR
  37. Display this help and exit.
  38. .TP
  39. \fB\-s\fR server
  40. Connect to specified DNS server, instead of the system's default one(s).
  41. Servers are tried in round-robin, if the previous one failed.
  42. .TP
  43. \fB\-t\fR type
  44. Query records of specified type.
  45. Possible values for type are
  46. A (default), AAAA, AFSDB, ANY, AXFR, CNAME, GPOS, HINFO, ISDN, KEY, LOC, MAILA,
  47. MAILB, MB, MD, MF, MG, MINFO, MR, MX, NAPTR, NS, NSAP, NSAP_PTR, NULL,
  48. PTR, PX, RP, RT, SIG, SOA, SRV, TXT, URI, WKS and X25.
  49. .TP
  50. \fB\-T\fR port
  51. Connect to the specified TCP port of DNS server.
  52. .TP
  53. \fB\-U\fR port
  54. Connect to the specified UDP port of DNS server.
  55. .TP
  56. \fB\-x\fR
  57. For an IPv4 \fB-t PTR a.b.c.d\fR lookup, query for
  58. .br
  59. \fBd.c.b.a.in-addr.arpa.\fR
  60. This more often gives correct names in the \fBANSWER\fR.
  61. .br
  62. For an IPv6 \fB-t PTR addr\fR lookup, query for \fBa.b.c....z.IP6.ARPA.\fR
  63. .TP
  64. \fB\-xx\fR
  65. As for \fB-x\fR and an IPv6 address, compact \fBa.b.c....z.IP6.ARPA.\fR into a RFC-2673 bit-string.
  66. This compacted \fBbit-string\fR form is not supported by many DNS-servers.
  67. .SH "REPORTING BUGS"
  68. Report bugs to the c-ares mailing list:
  69. .br
  70. \fBhttps://lists.haxx.se/listinfo/c-ares\fR
  71. .SH "SEE ALSO"
  72. .PP
  73. acountry(1), ahost(1).
  74. .SH COPYRIGHT
  75. This utility is based on code/ideas contained in sofware written by Greg Hudson (ares)
  76. carrying the following notice:
  77. .br
  78. Copyright 1998 by the Massachusetts Institute of Technology.
  79. .br
  80. Permission to use, copy, modify, and distribute this software and its
  81. documentation for any purpose and without fee is hereby granted,
  82. provided that the above copyright notice appear in all copies and that
  83. both that copyright notice and this permission notice appear in
  84. supporting documentation, and that the name of M.I.T. not be used in
  85. advertising or publicity pertaining to distribution of the software
  86. without specific, written prior permission. M.I.T. makes no
  87. representations about the suitability of this software for any
  88. purpose. It is provided "as is" without express or implied warranty.
  89. .br
  90. No further copyright claims are being made by the author(s) of this utility.