GRPC Core  48.0.0
channel_arg_names.h
Go to the documentation of this file.
1 // Copyright 2023 gRPC authors.
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 
15 #ifndef GRPC_IMPL_CHANNEL_ARG_NAMES_H
16 #define GRPC_IMPL_CHANNEL_ARG_NAMES_H
17 
18 // IWYU pragma: private, include <grpc/grpc.h>
19 // IWYU pragma: friend "src/.*"
20 // IWYU pragma: friend "test/.*"
21 
27 #define GRPC_ARG_ENABLE_CENSUS "grpc.census"
28 
29 #define GRPC_ARG_ENABLE_LOAD_REPORTING "grpc.loadreporting"
30 
31 #define GRPC_ARG_SERVER_CALL_METRIC_RECORDING \
32  "grpc.server_call_metric_recording"
33 
36 #define GRPC_ARG_MINIMAL_STACK "grpc.minimal_stack"
37 
39 #define GRPC_ARG_MAX_CONCURRENT_STREAMS "grpc.max_concurrent_streams"
40 
43 #define GRPC_ARG_MAX_RECEIVE_MESSAGE_LENGTH "grpc.max_receive_message_length"
44 
46 #define GRPC_ARG_MAX_MESSAGE_LENGTH GRPC_ARG_MAX_RECEIVE_MESSAGE_LENGTH
47 
49 #define GRPC_ARG_MAX_SEND_MESSAGE_LENGTH "grpc.max_send_message_length"
50 
53 #define GRPC_ARG_MAX_CONNECTION_IDLE_MS "grpc.max_connection_idle_ms"
54 
58 #define GRPC_ARG_MAX_CONNECTION_AGE_MS "grpc.max_connection_age_ms"
59 
61 #define GRPC_ARG_MAX_CONNECTION_AGE_GRACE_MS "grpc.max_connection_age_grace_ms"
62 
65 #define GRPC_ARG_CLIENT_IDLE_TIMEOUT_MS "grpc.client_idle_timeout_ms"
66 
69 #define GRPC_ARG_ENABLE_PER_MESSAGE_COMPRESSION "grpc.per_message_compression"
70 
73 #define GRPC_ARG_ENABLE_PER_MESSAGE_DECOMPRESSION \
74  "grpc.per_message_decompression"
75 
77 #define GRPC_ARG_HTTP2_INITIAL_SEQUENCE_NUMBER \
78  "grpc.http2.initial_sequence_number"
79 
83 #define GRPC_ARG_HTTP2_STREAM_LOOKAHEAD_BYTES "grpc.http2.lookahead_bytes"
84 
86 #define GRPC_ARG_HTTP2_HPACK_TABLE_SIZE_DECODER \
87  "grpc.http2.hpack_table_size.decoder"
88 
90 #define GRPC_ARG_HTTP2_HPACK_TABLE_SIZE_ENCODER \
91  "grpc.http2.hpack_table_size.encoder"
92 
97 #define GRPC_ARG_HTTP2_MAX_FRAME_SIZE "grpc.http2.max_frame_size"
98 
100 #define GRPC_ARG_HTTP2_BDP_PROBE "grpc.http2.bdp_probe"
101 
110 #define GRPC_ARG_HTTP2_MIN_SENT_PING_INTERVAL_WITHOUT_DATA_MS \
111  "grpc.http2.min_time_between_pings_ms"
112 
115 #define GRPC_ARG_HTTP2_MIN_RECV_PING_INTERVAL_WITHOUT_DATA_MS \
116  "grpc.http2.min_ping_interval_without_data_ms"
117 
121 #define GRPC_ARG_SERVER_MAX_UNREQUESTED_TIME_IN_SERVER_SECONDS \
122  "grpc.server_max_unrequested_time_in_server"
123 
124 #define GRPC_ARG_HTTP2_SCHEME "grpc.http2_scheme"
125 
131 #define GRPC_ARG_HTTP2_MAX_PINGS_WITHOUT_DATA \
132  "grpc.http2.max_pings_without_data"
133 
137 #define GRPC_ARG_HTTP2_MAX_PING_STRIKES "grpc.http2.max_ping_strikes"
138 
141 #define GRPC_ARG_HTTP2_WRITE_BUFFER_SIZE "grpc.http2.write_buffer_size"
142 
144 #define GRPC_ARG_HTTP2_ENABLE_TRUE_BINARY "grpc.http2.true_binary"
145 
150 #define GRPC_ARG_EXPERIMENTAL_HTTP2_PREFERRED_CRYPTO_FRAME_SIZE \
151  "grpc.experimental.http2.enable_preferred_frame_size"
152 
155 #define GRPC_ARG_KEEPALIVE_TIME_MS "grpc.keepalive_time_ms"
156 
159 #define GRPC_ARG_KEEPALIVE_TIMEOUT_MS "grpc.keepalive_timeout_ms"
160 
162 #define GRPC_ARG_KEEPALIVE_PERMIT_WITHOUT_CALLS \
163  "grpc.keepalive_permit_without_calls"
164 
166 #define GRPC_ARG_DEFAULT_AUTHORITY "grpc.default_authority"
167 
169 #define GRPC_ARG_PRIMARY_USER_AGENT_STRING "grpc.primary_user_agent"
170 
172 #define GRPC_ARG_SECONDARY_USER_AGENT_STRING "grpc.secondary_user_agent"
173 
177 #define GRPC_ARG_MIN_RECONNECT_BACKOFF_MS "grpc.min_reconnect_backoff_ms"
178 
182 #define GRPC_ARG_MAX_RECONNECT_BACKOFF_MS "grpc.max_reconnect_backoff_ms"
183 
187 #define GRPC_ARG_INITIAL_RECONNECT_BACKOFF_MS \
188  "grpc.initial_reconnect_backoff_ms"
189 
191 #define GRPC_ARG_DNS_MIN_TIME_BETWEEN_RESOLUTIONS_MS \
192  "grpc.dns_min_time_between_resolutions_ms"
193 
195 #define GRPC_ARG_SERVER_HANDSHAKE_TIMEOUT_MS "grpc.server_handshake_timeout_ms"
196 
203 #define GRPC_SSL_TARGET_NAME_OVERRIDE_ARG "grpc.ssl_target_name_override"
204 
207 #define GRPC_SSL_SESSION_CACHE_ARG "grpc.ssl_session_cache"
208 
211 #define GRPC_ARG_TSI_MAX_FRAME_SIZE "grpc.tsi.max_frame_size"
212 
218 #define GRPC_ARG_MAX_METADATA_SIZE "grpc.max_metadata_size"
219 
223 #define GRPC_ARG_ABSOLUTE_MAX_METADATA_SIZE "grpc.absolute_max_metadata_size"
224 
225 #define GRPC_ARG_ALLOW_REUSEPORT "grpc.so_reuseport"
226 
229 #define GRPC_ARG_RESOURCE_QUOTA "grpc.resource_quota"
230 
232 #define GRPC_ARG_EXPAND_WILDCARD_ADDRS "grpc.expand_wildcard_addrs"
233 
236 #define GRPC_ARG_SERVICE_CONFIG "grpc.service_config"
237 
239 #define GRPC_ARG_SERVICE_CONFIG_DISABLE_RESOLUTION \
240  "grpc.service_config_disable_resolution"
241 
242 #define GRPC_ARG_LB_POLICY_NAME "grpc.lb_policy_name"
243 
246 #define GRPC_ARG_RING_HASH_LB_RING_SIZE_CAP "grpc.lb.ring_hash.ring_size_cap"
247 
248 #define GRPC_ARG_SOCKET_MUTATOR "grpc.socket_mutator"
249 
250 #define GRPC_ARG_SOCKET_FACTORY "grpc.socket_factory"
251 
255 #define GRPC_ARG_MAX_CHANNEL_TRACE_EVENT_MEMORY_PER_NODE \
256  "grpc.max_channel_trace_event_memory_per_node"
257 
260 #define GRPC_ARG_ENABLE_CHANNELZ "grpc.enable_channelz"
261 
264 #define GRPC_ARG_TCP_READ_CHUNK_SIZE "grpc.experimental.tcp_read_chunk_size"
265 
268 #define GRPC_TCP_DEFAULT_READ_SLICE_SIZE 8192
269 
271 #define GRPC_ARG_TCP_MIN_READ_CHUNK_SIZE \
272  "grpc.experimental.tcp_min_read_chunk_size"
273 #define GRPC_ARG_TCP_MAX_READ_CHUNK_SIZE \
274  "grpc.experimental.tcp_max_read_chunk_size"
275 /* TCP TX Zerocopy enable state: zero is disabled, non-zero is enabled. By
276  default, it is disabled. */
277 #define GRPC_ARG_TCP_TX_ZEROCOPY_ENABLED \
278  "grpc.experimental.tcp_tx_zerocopy_enabled"
279 /* TCP TX Zerocopy send threshold: only zerocopy if >= this many bytes sent. By
280  default, this is set to 16KB. */
281 #define GRPC_ARG_TCP_TX_ZEROCOPY_SEND_BYTES_THRESHOLD \
282  "grpc.experimental.tcp_tx_zerocopy_send_bytes_threshold"
283 /* TCP TX Zerocopy max simultaneous sends: limit for maximum number of pending
284  calls to tcp_write() using zerocopy. A tcp_write() is considered pending
285  until the kernel performs the zerocopy-done callback for all sendmsg() calls
286  issued by the tcp_write(). By default, this is set to 4. */
287 #define GRPC_ARG_TCP_TX_ZEROCOPY_MAX_SIMULT_SENDS \
288  "grpc.experimental.tcp_tx_zerocopy_max_simultaneous_sends"
289 /* Overrides the TCP socket receive buffer size, SO_RCVBUF.
290  Default value is -1(kReadBufferSizeUnset) indicating that the system will
291  decide the buffer size. Range varies from 0 to INT_MAX. */
292 #define GRPC_ARG_TCP_RECEIVE_BUFFER_SIZE "grpc.tcp_receive_buffer_size"
293 /* Timeout in milliseconds to use for calls to the grpclb load balancer.
294  If 0 or unset, the balancer calls will have no deadline. Defaults to 0 ms. */
295 #define GRPC_ARG_GRPCLB_CALL_TIMEOUT_MS "grpc.grpclb_call_timeout_ms"
296 /* Specifies the xDS bootstrap config as a JSON string.
297  FOR TESTING PURPOSES ONLY -- DO NOT USE IN PRODUCTION.
298  This option allows controlling the bootstrap configuration on a
299  per-channel basis, which is useful in tests. However, this results
300  in having a separate xDS client instance per channel rather than
301  using the global instance, which is not the intended way to use xDS.
302  Currently, this will (a) add unnecessary load on the xDS server and
303  (b) break use of CSDS, and there may be additional side effects in
304  the future. */
305 #define GRPC_ARG_TEST_ONLY_DO_NOT_USE_IN_PROD_XDS_BOOTSTRAP_CONFIG \
306  "grpc.TEST_ONLY_DO_NOT_USE_IN_PROD.xds_bootstrap_config"
307 /* Timeout in milliseconds to wait for the serverlist from the grpclb load
308  balancer before using fallback backend addresses from the resolver.
309  If 0, enter fallback mode immediately. Default value is 10000ms. */
310 #define GRPC_ARG_GRPCLB_FALLBACK_TIMEOUT_MS "grpc.grpclb_fallback_timeout_ms"
311 /* Experimental Arg. Channel args to be used for the control-plane channel
312  * created to the grpclb load balancers. This is a pointer arg whose value is a
313  * grpc_channel_args object. If unset, most channel args from the parent channel
314  * will be propagated to the grpclb channel. */
315 #define GRPC_ARG_EXPERIMENTAL_GRPCLB_CHANNEL_ARGS \
316  "grpc.experimental.grpclb_channel_args"
317 /* Timeout in milliseconds to wait for the child of a specific priority to
318  complete its initial connection attempt before the priority LB policy fails
319  over to the next priority. Default value is 10 seconds. */
320 #define GRPC_ARG_PRIORITY_FAILOVER_TIMEOUT_MS \
321  "grpc.priority_failover_timeout_ms"
322 
329 #define GRPC_ARG_OPTIMIZATION_TARGET "grpc.optimization_target"
330 
339 #define GRPC_ARG_ENABLE_RETRIES "grpc.enable_retries"
340 
348 #define GRPC_ARG_EXPERIMENTAL_ENABLE_HEDGING "grpc.experimental.enable_hedging"
349 
350 #define GRPC_ARG_PER_RPC_RETRY_BUFFER_SIZE "grpc.per_rpc_retry_buffer_size"
351 
353 #define GRPC_ARG_MOBILE_LOG_CONTEXT "grpc.mobile_log_context"
354 
356 #define GRPC_ARG_DISABLE_CLIENT_AUTHORITY_FILTER \
357  "grpc.disable_client_authority_filter"
358 
359 #define GRPC_ARG_ENABLE_HTTP_PROXY "grpc.enable_http_proxy"
360 
363 #define GRPC_ARG_HTTP_PROXY "grpc.http_proxy"
364 
368 #define GRPC_ARG_ADDRESS_HTTP_PROXY "grpc.address_http_proxy"
369 
372 #define GRPC_ARG_ADDRESS_HTTP_PROXY_ENABLED_ADDRESSES \
373  "grpc.address_http_proxy_enabled_addresses"
374 
376 #define GRPC_ARG_SURFACE_USER_AGENT "grpc.surface_user_agent"
377 
379 #define GRPC_ARG_INHIBIT_HEALTH_CHECKING "grpc.inhibit_health_checking"
380 
388 #define GRPC_ARG_DNS_ENABLE_SRV_QUERIES "grpc.dns_enable_srv_queries"
389 
395 #define GRPC_ARG_DNS_ARES_QUERY_TIMEOUT_MS "grpc.dns_ares_query_timeout"
396 
398 #define GRPC_ARG_USE_LOCAL_SUBCHANNEL_POOL "grpc.use_local_subchannel_pool"
399 
400 #define GRPC_ARG_CHANNEL_POOL_DOMAIN "grpc.channel_pooling_domain"
401 
402 #define GRPC_ARG_CHANNEL_ID "grpc.channel_id"
403 
405 #define GRPC_ARG_AUTHORIZATION_POLICY_PROVIDER \
406  "grpc.authorization_policy_provider"
407 
411 #define GRPC_ARG_SERVER_CONFIG_CHANGE_DRAIN_GRACE_TIME_MS \
412  "grpc.experimental.server_config_change_drain_grace_time_ms"
413 
415 #define GRPC_ARG_DSCP "grpc.dscp"
416 
418 #define GRPC_ARG_HAPPY_EYEBALLS_CONNECTION_ATTEMPT_DELAY_MS \
419  "grpc.happy_eyeballs_connection_attempt_delay_ms"
420 
423 #define GRPC_ARG_EVENT_ENGINE_USE_MEMORY_ALLOCATOR_FACTORY \
424  "grpc.event_engine_use_memory_allocator_factory"
425 
427 #define GRPC_ARG_MAX_ALLOWED_INCOMING_CONNECTIONS \
428  "grpc.max_allowed_incoming_connections"
429 
430 #define GRPC_ARG_EXPERIMENTAL_STATS_PLUGINS "grpc.experimental.stats_plugins"
431 
432 #define GRPC_ARG_SECURITY_FRAME_ALLOWED "grpc.security_frame_allowed"
433 
435 #endif /* GRPC_IMPL_CHANNEL_ARG_NAMES_H */