AGENTS.md

1# Name Resolution
2 
3This directory contains the implementation of gRPC's name resolution framework.
4 
5## Overarching Purpose
6 
7The name resolution framework provides a pluggable mechanism for resolving a logical name into a list of network addresses. This is a key component of gRPC's load balancing and failover systems.
8 
9## Files and Subdirectories
10 
11- **`resolver.h` / `resolver.cc`**: Defines the core `Resolver` class, which is the main interface for name resolution.
12- **`resolver_factory.h`**: Defines the `ResolverFactory` class, which is used to create `Resolver` instances.
13- **`resolver_registry.h` / `resolver_registry.cc`**: Defines a registry for `ResolverFactory` instances.
14- **`dns/`**: An implementation of name resolution that uses DNS.
15- **`fake/`**: A fake implementation of name resolution for testing.
16- **`google_c2p/`**: An implementation of name resolution that is specific to Google's C2P infrastructure.
17- **`sockaddr/`**: An implementation of name resolution that uses a list of socket addresses.
18- **`xds/`**: An implementation of name resolution that uses XDS.
19 
20## Notes
21 
22- The name resolution framework is a key component of gRPC's networking infrastructure.
23- It provides a flexible and extensible way to add new name resolution mechanisms to gRPC.
24- The `Resolver` interface is designed to be simple and easy to implement, which makes it easy to add support for new name resolution mechanisms.
25