GRPC Core  49.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 
129 #define GRPC_ARG_HTTP2_MAX_PINGS_WITHOUT_DATA \
130  "grpc.http2.max_pings_without_data"
131 
135 #define GRPC_ARG_HTTP2_MAX_PING_STRIKES "grpc.http2.max_ping_strikes"
136 
139 #define GRPC_ARG_HTTP2_WRITE_BUFFER_SIZE "grpc.http2.write_buffer_size"
140 
142 #define GRPC_ARG_HTTP2_ENABLE_TRUE_BINARY "grpc.http2.true_binary"
143 
148 #define GRPC_ARG_EXPERIMENTAL_HTTP2_PREFERRED_CRYPTO_FRAME_SIZE \
149  "grpc.experimental.http2.enable_preferred_frame_size"
150 
153 #define GRPC_ARG_KEEPALIVE_TIME_MS "grpc.keepalive_time_ms"
154 
157 #define GRPC_ARG_KEEPALIVE_TIMEOUT_MS "grpc.keepalive_timeout_ms"
158 
160 #define GRPC_ARG_KEEPALIVE_PERMIT_WITHOUT_CALLS \
161  "grpc.keepalive_permit_without_calls"
162 
164 #define GRPC_ARG_DEFAULT_AUTHORITY "grpc.default_authority"
165 
167 #define GRPC_ARG_PRIMARY_USER_AGENT_STRING "grpc.primary_user_agent"
168 
170 #define GRPC_ARG_SECONDARY_USER_AGENT_STRING "grpc.secondary_user_agent"
171 
175 #define GRPC_ARG_MIN_RECONNECT_BACKOFF_MS "grpc.min_reconnect_backoff_ms"
176 
180 #define GRPC_ARG_MAX_RECONNECT_BACKOFF_MS "grpc.max_reconnect_backoff_ms"
181 
185 #define GRPC_ARG_INITIAL_RECONNECT_BACKOFF_MS \
186  "grpc.initial_reconnect_backoff_ms"
187 
189 #define GRPC_ARG_DNS_MIN_TIME_BETWEEN_RESOLUTIONS_MS \
190  "grpc.dns_min_time_between_resolutions_ms"
191 
193 #define GRPC_ARG_SERVER_HANDSHAKE_TIMEOUT_MS "grpc.server_handshake_timeout_ms"
194 
201 #define GRPC_SSL_TARGET_NAME_OVERRIDE_ARG "grpc.ssl_target_name_override"
202 
205 #define GRPC_SSL_SESSION_CACHE_ARG "grpc.ssl_session_cache"
206 
209 #define GRPC_ARG_TSI_MAX_FRAME_SIZE "grpc.tsi.max_frame_size"
210 
216 #define GRPC_ARG_MAX_METADATA_SIZE "grpc.max_metadata_size"
217 
221 #define GRPC_ARG_ABSOLUTE_MAX_METADATA_SIZE "grpc.absolute_max_metadata_size"
222 
223 #define GRPC_ARG_ALLOW_REUSEPORT "grpc.so_reuseport"
224 
227 #define GRPC_ARG_RESOURCE_QUOTA "grpc.resource_quota"
228 
230 #define GRPC_ARG_EXPAND_WILDCARD_ADDRS "grpc.expand_wildcard_addrs"
231 
234 #define GRPC_ARG_SERVICE_CONFIG "grpc.service_config"
235 
237 #define GRPC_ARG_SERVICE_CONFIG_DISABLE_RESOLUTION \
238  "grpc.service_config_disable_resolution"
239 
240 #define GRPC_ARG_LB_POLICY_NAME "grpc.lb_policy_name"
241 
244 #define GRPC_ARG_RING_HASH_LB_RING_SIZE_CAP "grpc.lb.ring_hash.ring_size_cap"
245 
246 #define GRPC_ARG_SOCKET_MUTATOR "grpc.socket_mutator"
247 
248 #define GRPC_ARG_SOCKET_FACTORY "grpc.socket_factory"
249 
253 #define GRPC_ARG_MAX_CHANNEL_TRACE_EVENT_MEMORY_PER_NODE \
254  "grpc.max_channel_trace_event_memory_per_node"
255 
258 #define GRPC_ARG_ENABLE_CHANNELZ "grpc.enable_channelz"
259 
262 #define GRPC_ARG_TCP_READ_CHUNK_SIZE "grpc.experimental.tcp_read_chunk_size"
263 
266 #define GRPC_TCP_DEFAULT_READ_SLICE_SIZE 8192
267 
269 #define GRPC_ARG_TCP_MIN_READ_CHUNK_SIZE \
270  "grpc.experimental.tcp_min_read_chunk_size"
271 #define GRPC_ARG_TCP_MAX_READ_CHUNK_SIZE \
272  "grpc.experimental.tcp_max_read_chunk_size"
273 /* TCP TX Zerocopy enable state: zero is disabled, non-zero is enabled. By
274  default, it is disabled. */
275 #define GRPC_ARG_TCP_TX_ZEROCOPY_ENABLED \
276  "grpc.experimental.tcp_tx_zerocopy_enabled"
277 /* TCP TX Zerocopy send threshold: only zerocopy if >= this many bytes sent. By
278  default, this is set to 16KB. */
279 #define GRPC_ARG_TCP_TX_ZEROCOPY_SEND_BYTES_THRESHOLD \
280  "grpc.experimental.tcp_tx_zerocopy_send_bytes_threshold"
281 /* TCP TX Zerocopy max simultaneous sends: limit for maximum number of pending
282  calls to tcp_write() using zerocopy. A tcp_write() is considered pending
283  until the kernel performs the zerocopy-done callback for all sendmsg() calls
284  issued by the tcp_write(). By default, this is set to 4. */
285 #define GRPC_ARG_TCP_TX_ZEROCOPY_MAX_SIMULT_SENDS \
286  "grpc.experimental.tcp_tx_zerocopy_max_simultaneous_sends"
287 /* Overrides the TCP socket receive buffer size, SO_RCVBUF.
288  Default value is -1(kReadBufferSizeUnset) indicating that the system will
289  decide the buffer size. Range varies from 0 to INT_MAX. */
290 #define GRPC_ARG_TCP_RECEIVE_BUFFER_SIZE "grpc.tcp_receive_buffer_size"
291 /* Timeout in milliseconds to use for calls to the grpclb load balancer.
292  If 0 or unset, the balancer calls will have no deadline. Defaults to 0 ms. */
293 #define GRPC_ARG_GRPCLB_CALL_TIMEOUT_MS "grpc.grpclb_call_timeout_ms"
294 /* Specifies the xDS bootstrap config as a JSON string.
295  FOR TESTING PURPOSES ONLY -- DO NOT USE IN PRODUCTION.
296  This option allows controlling the bootstrap configuration on a
297  per-channel basis, which is useful in tests. However, this results
298  in having a separate xDS client instance per channel rather than
299  using the global instance, which is not the intended way to use xDS.
300  Currently, this will (a) add unnecessary load on the xDS server and
301  (b) break use of CSDS, and there may be additional side effects in
302  the future. */
303 #define GRPC_ARG_TEST_ONLY_DO_NOT_USE_IN_PROD_XDS_BOOTSTRAP_CONFIG \
304  "grpc.TEST_ONLY_DO_NOT_USE_IN_PROD.xds_bootstrap_config"
305 /* Timeout in milliseconds to wait for the serverlist from the grpclb load
306  balancer before using fallback backend addresses from the resolver.
307  If 0, enter fallback mode immediately. Default value is 10000ms. */
308 #define GRPC_ARG_GRPCLB_FALLBACK_TIMEOUT_MS "grpc.grpclb_fallback_timeout_ms"
309 /* Experimental Arg. Channel args to be used for the control-plane channel
310  * created to the grpclb load balancers. This is a pointer arg whose value is a
311  * grpc_channel_args object. If unset, most channel args from the parent channel
312  * will be propagated to the grpclb channel. */
313 #define GRPC_ARG_EXPERIMENTAL_GRPCLB_CHANNEL_ARGS \
314  "grpc.experimental.grpclb_channel_args"
315 /* Timeout in milliseconds to wait for the child of a specific priority to
316  complete its initial connection attempt before the priority LB policy fails
317  over to the next priority. Default value is 10 seconds. */
318 #define GRPC_ARG_PRIORITY_FAILOVER_TIMEOUT_MS \
319  "grpc.priority_failover_timeout_ms"
320 
327 #define GRPC_ARG_OPTIMIZATION_TARGET "grpc.optimization_target"
328 
337 #define GRPC_ARG_ENABLE_RETRIES "grpc.enable_retries"
338 
346 #define GRPC_ARG_EXPERIMENTAL_ENABLE_HEDGING "grpc.experimental.enable_hedging"
347 
348 #define GRPC_ARG_PER_RPC_RETRY_BUFFER_SIZE "grpc.per_rpc_retry_buffer_size"
349 
351 #define GRPC_ARG_MOBILE_LOG_CONTEXT "grpc.mobile_log_context"
352 
354 #define GRPC_ARG_DISABLE_CLIENT_AUTHORITY_FILTER \
355  "grpc.disable_client_authority_filter"
356 
357 #define GRPC_ARG_ENABLE_HTTP_PROXY "grpc.enable_http_proxy"
358 
361 #define GRPC_ARG_HTTP_PROXY "grpc.http_proxy"
362 
366 #define GRPC_ARG_ADDRESS_HTTP_PROXY "grpc.address_http_proxy"
367 
370 #define GRPC_ARG_ADDRESS_HTTP_PROXY_ENABLED_ADDRESSES \
371  "grpc.address_http_proxy_enabled_addresses"
372 
374 #define GRPC_ARG_SURFACE_USER_AGENT "grpc.surface_user_agent"
375 
377 #define GRPC_ARG_INHIBIT_HEALTH_CHECKING "grpc.inhibit_health_checking"
378 
386 #define GRPC_ARG_DNS_ENABLE_SRV_QUERIES "grpc.dns_enable_srv_queries"
387 
393 #define GRPC_ARG_DNS_ARES_QUERY_TIMEOUT_MS "grpc.dns_ares_query_timeout"
394 
396 #define GRPC_ARG_USE_LOCAL_SUBCHANNEL_POOL "grpc.use_local_subchannel_pool"
397 
398 #define GRPC_ARG_CHANNEL_POOL_DOMAIN "grpc.channel_pooling_domain"
399 
400 #define GRPC_ARG_CHANNEL_ID "grpc.channel_id"
401 
403 #define GRPC_ARG_AUTHORIZATION_POLICY_PROVIDER \
404  "grpc.authorization_policy_provider"
405 
409 #define GRPC_ARG_SERVER_CONFIG_CHANGE_DRAIN_GRACE_TIME_MS \
410  "grpc.experimental.server_config_change_drain_grace_time_ms"
411 
413 #define GRPC_ARG_DSCP "grpc.dscp"
414 
416 #define GRPC_ARG_HAPPY_EYEBALLS_CONNECTION_ATTEMPT_DELAY_MS \
417  "grpc.happy_eyeballs_connection_attempt_delay_ms"
418 
421 #define GRPC_ARG_EVENT_ENGINE_USE_MEMORY_ALLOCATOR_FACTORY \
422  "grpc.event_engine_use_memory_allocator_factory"
423 
425 #define GRPC_ARG_MAX_ALLOWED_INCOMING_CONNECTIONS \
426  "grpc.max_allowed_incoming_connections"
427 
428 #define GRPC_ARG_EXPERIMENTAL_STATS_PLUGINS "grpc.experimental.stats_plugins"
429 
430 #define GRPC_ARG_SECURITY_FRAME_ALLOWED "grpc.security_frame_allowed"
431 
433 #endif /* GRPC_IMPL_CHANNEL_ARG_NAMES_H */