AGENTS.md

1# gRPC Server
2 
3This directory contains the core implementation of the gRPC server.
4 
5## Overarching Purpose
6 
7The gRPC server is responsible for listening for incoming connections, handling requests, and sending responses. It is the main entry point for all server-side gRPC applications.
8 
9## Files
10 
11- **`server.h` / `server.cc`**: Defines the `Server` class, which is the main class for the gRPC server.
12- **`server_interface.h`**: Defines the `ServerInterface` class, which is an interface that can be used to interact with the server.
13- **`add_port.cc`**: Contains the implementation of the `grpc_server_add_http2_port` function, which is used to add a listening port to the server.
14- **`server_call_tracer_filter.h` / `server_call_tracer_filter.cc`**: Defines a filter that can be used to trace server-side calls.
15- **`server_config_selector.h`**: Defines the `ServerConfigSelector` class, which is used to select the server configuration for a given request.
16- **`server_config_selector_filter.h` / `server_config_selector_filter.cc`**: Defines a filter that uses the `ServerConfigSelector` to select the server configuration.
17- **`xds_channel_stack_modifier.h` / `xds_channel_stack_modifier.cc`**: Defines a class that can be used to modify the channel stack for XDS-enabled servers.
18- **`xds_server_config_fetcher.cc`**: Fetches server configuration from an XDS server.
19 
20## Major Classes
21 
22- **`grpc_core::Server`**: The main class for the gRPC server.
23- **`grpc_core::ServerInterface`**: An interface that can be used to interact with the server.
24- **`grpc_core::ServerConfigSelector`**: A class that is used to select the server configuration for a given request.
25 
26## Notes
27 
28- The gRPC server is a complex piece of software with many different components.
29- The `Server` class is the main entry point for all server-side gRPC applications.
30- The `ServerBuilder` class can be used to create and configure a `Server` instance.
31- The server can be configured with a variety of options, including the number of threads, the maximum number of concurrent requests, and the security credentials to use.
32