AGENTS.md

1# DNS Name Resolution
2 
3This directory contains an implementation of name resolution that uses DNS.
4 
5## Overarching Purpose
6 
7This directory provides a concrete implementation of the `Resolver` interface that can be used to resolve names using DNS.
8 
9## Subdirectories
10 
11- **`c_ares/`**: An implementation of DNS resolution that uses the c-ares library.
12- **`event_engine/`**: An implementation of DNS resolution that uses the EventEngine.
13- **`native/`**: An implementation of DNS resolution that uses the native DNS resolver of the operating system.
14 
15## Notes
16 
17- This is the default name resolution mechanism for gRPC.
18- It is well-tested and has been used in production for many years.
19- The choice of which DNS resolver to use can have a significant impact on performance, so it is important to choose the right one for your application.
20