DnsClient 1.6.0
Prefix ReservedSee the version list below for details.
dotnet add package DnsClient --version 1.6.0
NuGet\Install-Package DnsClient -Version 1.6.0
<PackageReference Include="DnsClient" Version="1.6.0" />
paket add DnsClient --version 1.6.0
#r "nuget: DnsClient, 1.6.0"
// Install DnsClient as a Cake Addin #addin nuget:?package=DnsClient&version=1.6.0 // Install DnsClient as a Cake Tool #tool nuget:?package=DnsClient&version=1.6.0
DnsClient.NET
DnsClient.NET is a simple yet very powerful and high performance open source library for the .NET Framework to do DNS lookups.
Usage
See the DnsClient site for more details and documentation.
The following example instantiates a new LookupClient
to query some IP address.
var lookup = new LookupClient();
var result = await lookup.QueryAsync("google.com", QueryType.A);
var record = result.Answers.ARecords().FirstOrDefault();
var ip = record?.Address;
Features
General
- Sync & Async API
- UDP and TCP lookup, configurable if TCP should be used as fallback in case the UDP result is truncated (default=true).
- Configurable EDNS support to change the default UDP buffer size and request security relevant records
- Caching
- Query result cache based on provided TTL
- Minimum TTL setting to overrule the result's TTL and always cache the responses for at least that time. (Even very low value, like a few milliseconds, do make a huge difference if used in high traffic low latency scenarios)
- Maximum TTL to limit cache duration
- Cache can be disabled
- Nameserver auto discovery. If no servers are explicitly configured, DnsClient will try its best to resolve them based on your local system configuration. This includes DNS servers configured via network interfaces or even via Windows specific NRPT policies.
- Multiple DNS endpoints can be configured. DnsClient will use them in random or sequential order (configurable), with re-tries.
- Configurable retry of queries
- Optional audit trail of each response and exception
- Configurable error handling. Throwing DNS errors, like
NotExistentDomain
is turned off by default - Optional Trace/Logging
Supported resource records
- A, AAAA, NS, CNAME, SOA, MB, MG, MR, WKS, HINFO, MINFO, MX, RP, TXT, AFSDB, URI, CAA, NULL, SSHFP, TLSA, RRSIG, NSEC, NSEC3, NSEC3PARAM, DNSKEY, DS
- PTR for reverse lookups
- SRV for service discovery.
LookupClient
has some extensions to help with that. - AXFR zone transfer (as per spec, LookupClient has to be set to TCP mode only for this type. Also, the result depends on if the DNS server trusts your current connection)
Build from Source
To build and contribute to this project, you must have the latest .NET 5 SDK installed. Just clone the repository and open the solution in Visual Studio 2019.
Examples
- See MiniDig's readme for what this example command line tool can do.
- More documentation and examples
- The Samples repository (there might be more in the future).
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 is compatible. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp1.0 was computed. netcoreapp1.1 was computed. netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard1.3 is compatible. netstandard1.4 was computed. netstandard1.5 was computed. netstandard1.6 was computed. netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net45 is compatible. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 is compatible. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen30 was computed. tizen40 was computed. tizen60 was computed. |
Universal Windows Platform | uap was computed. uap10.0 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.5
- System.Buffers (>= 4.5.1)
-
.NETFramework 4.7.1
- Microsoft.Win32.Registry (>= 5.0.0)
- System.Buffers (>= 4.5.1)
-
.NETStandard 1.3
- Microsoft.Win32.Primitives (>= 4.3.0)
- Microsoft.Win32.Registry (>= 5.0.0)
- NETStandard.Library (>= 1.6.1)
- System.Buffers (>= 4.5.1)
- System.Diagnostics.TraceSource (>= 4.3.0)
- System.Globalization.Extensions (>= 4.3.0)
- System.Net.NameResolution (>= 4.3.0)
- System.Net.NetworkInformation (>= 4.3.0)
-
.NETStandard 2.0
- Microsoft.Win32.Registry (>= 5.0.0)
- System.Buffers (>= 4.5.1)
-
.NETStandard 2.1
- Microsoft.Win32.Registry (>= 5.0.0)
-
net5.0
- Microsoft.Win32.Registry (>= 5.0.0)
NuGet packages (142)
Showing the top 5 NuGet packages that depend on DnsClient:
Package | Downloads |
---|---|
MongoDB.Driver.Core
Core Component of the Official MongoDB .NET Driver. |
|
MongoDB.Driver
Official .NET driver for MongoDB. |
|
Microsoft.Extensions.Configuration.AzureAppConfiguration
Microsoft.Extensions.Configuration.AzureAppConfiguration is a configuration provider for the .NET Core framework that allows developers to use Microsoft Azure App Configuration service as a configuration source in their applications. |
|
CouchbaseNetClient
The Official Couchbase .NET SDK. |
|
MongoDB.Driver.Core.signed
(Unofficial) Signed Core Component of the MongoDB .NET Driver. The containing assembly was generated by signing the officially published MongoDB.Driver.Core.dll. |
GitHub repositories (54)
Showing the top 5 popular GitHub repositories that depend on DnsClient:
Repository | Stars |
---|---|
BeyondDimension/SteamTools
🛠「Watt Toolkit」是一个开源跨平台的多功能 Steam 工具箱。
|
|
bitwarden/server
Bitwarden infrastructure/backend (API, database, Docker, etc).
|
|
duplicati/duplicati
Store securely encrypted backups in the cloud!
|
|
BornToBeRoot/NETworkManager
A powerful tool for managing networks and troubleshoot network problems!
|
|
ldqk/Masuit.Tools
全龄段友好的C#万能工具库,码数吐司库,包含一些常用的操作类,大都是静态类,加密解密,反射操作,权重随机筛选算法,分布式短id,表达式树,linq扩展,文件压缩,多线程下载,硬件信息,字符串扩展方法,日期时间扩展操作,中国农历,大文件拷贝,图像裁剪,验证码,断点续传,集合扩展、Excel导出等常用封装。诸多功能集一身,代码量不到2MB!
|
Version | Downloads | Last updated |
---|---|---|
1.8.0 | 497,538 | 7/1/2024 |
1.8.0-beta-20240317.9 | 5,753 | 3/17/2024 |
1.7.0 | 11,826,937 | 10/23/2022 |
1.6.1 | 61,720,434 | 6/10/2022 |
1.6.0 | 10,479,502 | 1/30/2022 |
1.5.0 | 4,427,537 | 6/20/2021 |
1.5.0-beta-20210612.7 | 1,485 | 6/12/2021 |
1.5.0-beta-20210522.7 | 672 | 5/22/2021 |
1.4.0 | 39,913,432 | 2/14/2021 |
1.4.0-beta-20200912.4 | 17,639 | 9/12/2020 |
1.4.0-beta-20200801.7 | 71,170 | 8/1/2020 |
1.3.2 | 5,276,748 | 5/13/2020 |
1.3.2-beta-20200512.2 | 527 | 5/12/2020 |
1.3.1 | 35,753,280 | 3/31/2020 |
1.3.0 | 359,869 | 3/17/2020 |
1.3.0-beta-20200316.3 | 787 | 3/16/2020 |
1.3.0-beta-20200314.3 | 659 | 3/14/2020 |
1.3.0-beta-20200311.4 | 1,243 | 3/11/2020 |
1.2.0 | 38,885,464 | 8/15/2018 |
1.1.1 | 368,496 | 6/13/2018 |
1.1.0 | 20,198 | 6/4/2018 |
1.0.7 | 18,432,042 | 5/1/2017 |
1.0.6 | 18,375 | 4/5/2017 |
1.0.5 | 14,664 | 3/3/2017 |
1.0.4 | 3,586 | 2/23/2017 |
1.0.3 | 21,300 | 1/21/2017 |
1.0.2 | 3,545 | 1/16/2017 |
1.0.2-beta-1080 | 3,173 | 1/10/2017 |
1.0.1 | 50,989 | 12/31/2016 |
1.0.1-beta-1033 | 3,123 | 12/31/2016 |
1.0.1-beta-1030 | 3,228 | 12/31/2016 |
1.0.0 | 6,263 | 12/29/2016 |
1.0.0-beta-1017 | 3,486 | 12/7/2016 |
1.0.0-beta-1014 | 3,420 | 11/27/2016 |
1.0.0-beta-1011 | 3,354 | 11/24/2016 |
1.0.0-beta-1005 | 3,321 | 11/22/2016 |