Chiebot-Mirror
/
c-ares
mirror of https://github.com/c-ares/c-ares.git
8
0
Fork 0
Code Issues Projects Releases Wiki Activity
A C library for asynchronous DNS requests (grpc依赖)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
845 Commits
14 Branches
96 Tags
22 MiB
Tag: Branch: Tree: fc0f8a47e8
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'fc0f8a47e8'
${ noResults }
c-ares/docs/adig.1

180 lines
4.4 KiB
Raw Normal View History Unescape

provide SPDX identifiers and a REUSE CI job to verify All files have their licence and copyright information clearly identifiable. If not in the file header, they are set separately in .reuse/dep5. All used license texts are provided in LICENSES/
1 year ago
.\"
.\" Copyright (C) the Massachusetts Institute of Technology.
.\" Copyright (C) Daniel Stenberg
.\" SPDX-License-Identifier: MIT
.\"
adig: rework command line arguments to mimic dig from bind (#890) The c-ares dig utility outputs a similar format to the bind dig utility, we should also make it take arguments that mimic theirs for compatibility. This PR starts down that path supporting some of the major options. Fixes #885 Authored-By: Brad House (@bradh352)
2 months ago
.TH ADIG "1" "Sept 2024" "c-ares utilities"
Avoid buffer overflow in RC4 loop comparison (#336) The rc4 function iterates over a buffer of size buffer_len who's maximum value is INT_MAX with a counter of type short that is not guaranteed to have maximum size INT_MAX. In circumstances where short is narrower than int and where buffer_len is larger than the maximum value of a short, it may be possible to loop infinitely as counter will overflow and never be greater than or equal to buffer_len. The solution is to make the comparison be between types of equal width. This commit defines counter as an int. Fix By: Fionn Fitzmaurice (@fionn)
4 years ago
.SH NAME
adig \- print information collected from Domain Name System (DNS) servers
.SH SYNOPSIS
adig: rework command line arguments to mimic dig from bind (#890) The c-ares dig utility outputs a similar format to the bind dig utility, we should also make it take arguments that mimic theirs for compatibility. This PR starts down that path supporting some of the major options. Fixes #885 Authored-By: Brad House (@bradh352)
2 months ago
\fBadig\fP [\fI@server\fR] [\fI-c class\fR] [\fI-p port#\fR] [\fI-q name\fR]
[\fI-t type\fR] [\fI-x addr\fR] [\fIname\fR] [\fItype\fR] [\fIclass\fR]
[\fIqueryopt\fR...]
Avoid buffer overflow in RC4 loop comparison (#336) The rc4 function iterates over a buffer of size buffer_len who's maximum value is INT_MAX with a counter of type short that is not guaranteed to have maximum size INT_MAX. In circumstances where short is narrower than int and where buffer_len is larger than the maximum value of a short, it may be possible to loop infinitely as counter will overflow and never be greater than or equal to buffer_len. The solution is to make the comparison be between types of equal width. This commit defines counter as an int. Fix By: Fionn Fitzmaurice (@fionn)
4 years ago
.SH DESCRIPTION
.PP
adig: rework command line arguments to mimic dig from bind (#890) The c-ares dig utility outputs a similar format to the bind dig utility, we should also make it take arguments that mimic theirs for compatibility. This PR starts down that path supporting some of the major options. Fixes #885 Authored-By: Brad House (@bradh352)
2 months ago
Send queries to DNS servers about \fUname\fR and print received
information, where \fIname\fR is a valid DNS name (e.g. www.example.com,
Avoid buffer overflow in RC4 loop comparison (#336) The rc4 function iterates over a buffer of size buffer_len who's maximum value is INT_MAX with a counter of type short that is not guaranteed to have maximum size INT_MAX. In circumstances where short is narrower than int and where buffer_len is larger than the maximum value of a short, it may be possible to loop infinitely as counter will overflow and never be greater than or equal to buffer_len. The solution is to make the comparison be between types of equal width. This commit defines counter as an int. Fix By: Fionn Fitzmaurice (@fionn)
4 years ago
1.2.3.10.in-addr.arpa).
.PP
This utility comes with the \fBc\-ares\fR asynchronous resolver library.
adig: read arguments from adigrc (#856) This allows for default arguments to be provided through a user configuration file, useful for avoiding repetitive passing of flags on the command line when using adig frequently. The syntax within $XDG_CONFIG_HOME/adigrc resembles the one from dig's ~/.digrc, meaning any command line arguments can be provided, separated either by line breaks or whitespaces. --------- Authored-By: Georg Pfuetzenreuter <mail@georg-pfuetzenreuter.net>
3 months ago
.PP
It is possible to specify default arguments for \fBadig\fR via \fB${XDG_CONFIG_HOME}/adigrc\fR.
adig: rework command line arguments to mimic dig from bind (#890) The c-ares dig utility outputs a similar format to the bind dig utility, we should also make it take arguments that mimic theirs for compatibility. This PR starts down that path supporting some of the major options. Fixes #885 Authored-By: Brad House (@bradh352)
2 months ago
.SH ARGS
.TP
\fB@server\fR
Server ip address. May specify multiple in comma delimited format. May be
specified in URI format.
.TP
\fBname\fR
Name of the resource record that is to be looked up
.TP
\fBtype\fR
What type of query is required. e.g. - A, AAAA, MX, TXT, etc. If not
specified, A will be used.
.TP
\fBclass\fR
Sets the query class, defaults to IN. May also be HS or CH.
.SH FLAGS
Avoid buffer overflow in RC4 loop comparison (#336) The rc4 function iterates over a buffer of size buffer_len who's maximum value is INT_MAX with a counter of type short that is not guaranteed to have maximum size INT_MAX. In circumstances where short is narrower than int and where buffer_len is larger than the maximum value of a short, it may be possible to loop infinitely as counter will overflow and never be greater than or equal to buffer_len. The solution is to make the comparison be between types of equal width. This commit defines counter as an int. Fix By: Fionn Fitzmaurice (@fionn)
4 years ago
.TP
\fB\-c\fR class
adig: rework command line arguments to mimic dig from bind (#890) The c-ares dig utility outputs a similar format to the bind dig utility, we should also make it take arguments that mimic theirs for compatibility. This PR starts down that path supporting some of the major options. Fixes #885 Authored-By: Brad House (@bradh352)
2 months ago
Sets the query class, defaults to IN. May also be HS or CH.
.TP
\fB\-h\fR
Prints the help.
.TP
\fB\-p\fR port
Sends query to a port other than 53. Often recommended to set the port using
\fI@server\fR instead.
.TP
\fB\-q\fR name
Specifies the domain name to query. Useful to distinguish name from other
arguments
.TP
\fB\-r\fR
Skip adigrc processing
Avoid buffer overflow in RC4 loop comparison (#336) The rc4 function iterates over a buffer of size buffer_len who's maximum value is INT_MAX with a counter of type short that is not guaranteed to have maximum size INT_MAX. In circumstances where short is narrower than int and where buffer_len is larger than the maximum value of a short, it may be possible to loop infinitely as counter will overflow and never be greater than or equal to buffer_len. The solution is to make the comparison be between types of equal width. This commit defines counter as an int. Fix By: Fionn Fitzmaurice (@fionn)
4 years ago
.TP
adig manpage: missing -s
2 months ago
\fB\-s\fR
Server (alias for @server syntax), compatibility with old cmdline
.TP
Avoid buffer overflow in RC4 loop comparison (#336) The rc4 function iterates over a buffer of size buffer_len who's maximum value is INT_MAX with a counter of type short that is not guaranteed to have maximum size INT_MAX. In circumstances where short is narrower than int and where buffer_len is larger than the maximum value of a short, it may be possible to loop infinitely as counter will overflow and never be greater than or equal to buffer_len. The solution is to make the comparison be between types of equal width. This commit defines counter as an int. Fix By: Fionn Fitzmaurice (@fionn)
4 years ago
\fB\-t\fR type
adig: rework command line arguments to mimic dig from bind (#890) The c-ares dig utility outputs a similar format to the bind dig utility, we should also make it take arguments that mimic theirs for compatibility. This PR starts down that path supporting some of the major options. Fixes #885 Authored-By: Brad House (@bradh352)
2 months ago
Indicates resource record type to query. Useful to distinguish type from other
arguments
.TP
\fB\-x\fR addr
Simplified reverse lookups. Sets the type to PTR and forms a valid in-arpa
query string
.SH QUERY OPTIONS
.TP
\fB+[no]aaonly\fR
Sets the aa flag in the query. Default is off.
.TP
\fB+[no]aaflag\fR
Alias for +[no]aaonly
.TP
\fB+[no]additional\fR
Toggles printing the additional section. On by default.
.TP
\fB+[no]adflag\fR
Sets the ad (authentic data) bit in the query. Default is off.
.TP
\fB+[no]aliases\fR
Whether or not to honor the HOSTALIASES file. Default is on.
.TP
\fB+[no]all\fR
Toggles all of +[no]cmd, +[no]stats, +[no]question, +[no]answer,
+[no]authority, +[no]additional, +[no]comments
.TP
\fB+[no]answer\fR
Toggles printing the answer. On by default.
.TP
\fB+[no]authority\fR
Toggles printing the authority. On by default.
.TP
\fB+bufsize=\fR#
UDP EDNS 0 packet size allowed. Defaults to 1232.
.TP
\fB+[no]cdflag\fR
Sets the CD (checking disabled) bit in the query. Default is off.
.TP
\fB+[no]class\fR
Display the class when printing the record. On by default.
.TP
\fB+[no]cmd\fR
Toggles printing the command requested. On by default.
.TP
\fB+[no]comments\fR
Toggles printing the comments. On by default
.TP
\fB+[no]defname\fR
Alias for +[no]search
.TP
\fB+domain=somename\fR
Sets the search list to a single domain.
.TP
\fB+[no]dns0x20\fR
Whether or not to use DNS 0x20 case randomization when sending queries.
Default is off.
.TP
\fB+[no]edns\fR[=#]
Enable or disable EDNS. Only allows a value of 0 if specified. Default is to
enable EDNS.
.TP
\fB+[no]ignore\fR
Ignore truncation on UDP, by default retried on TCP.
.TP
\fB+[no]keepopen\fR
Whether or not the server connection should be persistent. Default is off.
.TP
\fB+ndots\fR=#
Sets the number of dots that must appear before being considered absolute.
Defaults to 1.
.TP
\fB+[no]primary\fR
Whether or not to only use a single server if more than one server is available.
Defaults to using all servers.
.TP
\fB+[no]qr\fR
Toggles printing the request query. Off by default.
.TP
\fB+[no]question\fR
Toggles printing the question. On by default.
.TP
\fB+[no]recurse\fR
Toggles the RD (Recursion Desired) bit. On by default.
.TP
\fB+retry\fR=#
Same as +tries but does not include the initial attempt.
.TP
\fB+[no]search\fR
To use or not use the search list. Search list is not used by default.
.TP
\fB+[no]stats\fR
Toggles printing the statistics. On by default.
.TP
\fB+[no]tcp\fR
Whether to use TCP when querying name servers. Default is UDP.
.TP
\fB+tries\fR=#
Number of query tries. Defaults to 3.
tools: refine help (#481) fix invalid help options and documentation typos Fix By: @lifenjoiner
2 years ago
.TP
adig: rework command line arguments to mimic dig from bind (#890) The c-ares dig utility outputs a similar format to the bind dig utility, we should also make it take arguments that mimic theirs for compatibility. This PR starts down that path supporting some of the major options. Fixes #885 Authored-By: Brad House (@bradh352)
2 months ago
\fB+[no]ttlid\fR
Display the TTL when printing the record. On by default.
Avoid buffer overflow in RC4 loop comparison (#336) The rc4 function iterates over a buffer of size buffer_len who's maximum value is INT_MAX with a counter of type short that is not guaranteed to have maximum size INT_MAX. In circumstances where short is narrower than int and where buffer_len is larger than the maximum value of a short, it may be possible to loop infinitely as counter will overflow and never be greater than or equal to buffer_len. The solution is to make the comparison be between types of equal width. This commit defines counter as an int. Fix By: Fionn Fitzmaurice (@fionn)
4 years ago
.TP
adig: rework command line arguments to mimic dig from bind (#890) The c-ares dig utility outputs a similar format to the bind dig utility, we should also make it take arguments that mimic theirs for compatibility. This PR starts down that path supporting some of the major options. Fixes #885 Authored-By: Brad House (@bradh352)
2 months ago
\fB+[no]vc\fR
Alias for +[no]tcp
[adig] Update man-page for the '-x' option (#357) Fix By: Gisle Vanem (@gvanem)
4 years ago
adig: read arguments from adigrc (#856) This allows for default arguments to be provided through a user configuration file, useful for avoiding repetitive passing of flags on the command line when using adig frequently. The syntax within $XDG_CONFIG_HOME/adigrc resembles the one from dig's ~/.digrc, meaning any command line arguments can be provided, separated either by line breaks or whitespaces. --------- Authored-By: Georg Pfuetzenreuter <mail@georg-pfuetzenreuter.net>
3 months ago
.SH FILES
${XDG_CONFIG_HOME}/adigrc
Avoid buffer overflow in RC4 loop comparison (#336) The rc4 function iterates over a buffer of size buffer_len who's maximum value is INT_MAX with a counter of type short that is not guaranteed to have maximum size INT_MAX. In circumstances where short is narrower than int and where buffer_len is larger than the maximum value of a short, it may be possible to loop infinitely as counter will overflow and never be greater than or equal to buffer_len. The solution is to make the comparison be between types of equal width. This commit defines counter as an int. Fix By: Fionn Fitzmaurice (@fionn)
4 years ago
.SH "REPORTING BUGS"
adig: rework command line arguments to mimic dig from bind (#890) The c-ares dig utility outputs a similar format to the bind dig utility, we should also make it take arguments that mimic theirs for compatibility. This PR starts down that path supporting some of the major options. Fixes #885 Authored-By: Brad House (@bradh352)
2 months ago
Report bugs to the c-ares github issues tracker
Change the mailman links (#358) Links when wrapping become misleading. Insert newline to prevent wrapping. Fix By: Gisle Vanem (@gvanem)
4 years ago
.br
adig: rework command line arguments to mimic dig from bind (#890) The c-ares dig utility outputs a similar format to the bind dig utility, we should also make it take arguments that mimic theirs for compatibility. This PR starts down that path supporting some of the major options. Fixes #885 Authored-By: Brad House (@bradh352)
2 months ago
\fBhttps://github.com/c-ares/c-ares/issues\fR
Avoid buffer overflow in RC4 loop comparison (#336) The rc4 function iterates over a buffer of size buffer_len who's maximum value is INT_MAX with a counter of type short that is not guaranteed to have maximum size INT_MAX. In circumstances where short is narrower than int and where buffer_len is larger than the maximum value of a short, it may be possible to loop infinitely as counter will overflow and never be greater than or equal to buffer_len. The solution is to make the comparison be between types of equal width. This commit defines counter as an int. Fix By: Fionn Fitzmaurice (@fionn)
4 years ago
.SH "SEE ALSO"
.PP
Remove acountry completely from code, including manpage Since acountry cannot be restored due to nerd.dk being decommissioned, we should completely remove the manpage and source. This also will resolve issue #718. Fixes Issue: #718 Fix By: Brad House (@bradh352)
9 months ago
ahost(1).