AGENTS.md

1# Address Utilities
2 
3This directory contains utility functions for working with network addresses.
4 
5## Overarching Purpose
6 
7This directory provides a set of functions for parsing, formatting, and manipulating network addresses. It is used throughout the gRPC core to handle network addresses in a consistent way.
8 
9## Files
10 
11- **`parse_address.h` / `parse_address.cc`**: Defines functions for parsing string representations of network addresses into `grpc_resolved_address` structures.
12- **`sockaddr_utils.h` / `sockaddr_utils.cc`**: Defines functions for working with `sockaddr` structures, including converting them to and from string representations, and comparing them for equality.
13 
14## Notes
15 
16- These utilities are essential for gRPC's networking code.
17- They provide a platform-independent way to work with network addresses.
18- The functions in this directory are carefully designed to be efficient and to avoid common pitfalls when working with network addresses.
19