# Copyright 2022 gRPC authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# File format:
#
# Each config var gets a name, and a type (one of string, int, bool).
#
# A default value is provided. Defaults prefixed by '$' are read as expressions,
# otherwise they're assumed literals.
# A description field must be present.
#
# Optionally, a force-load-on-access: true flag can be added to force checking
# the environment variables every time the value is queried, to match legacy
# behavior for some environment variables.
#
# Optionally, fuzz: true can be added to enable fuzzers to explore variations
# in this config var with their regular fuzzing work - or fuzz: FunctionName 
# can be used to specify that the config space be explored, but FunctionName should be called to pre-format/validate the value for fuzzing.
# Such functions should be listed in fuzz_config_vars_helpers.h.

- name: experiments
  type: comma_separated_string
  description:
    A comma separated list of currently active experiments. Experiments may be
    prefixed with a '-' to disable them.
  default:
  fuzz_type: uint64
  fuzz: ValidateExperimentsStringForFuzzing
- name: client_channel_backup_poll_interval_ms
  type: int
  default: 5000
  description:
    Declares the interval in ms between two backup polls on client channels.
    These polls are run in the timer thread so that gRPC can process
    connection failures while there is no active polling thread.
    They help reconnect disconnected client channels (mostly due to
    idleness), so that the next RPC on this channel won't fail. Set to 0 to
    turn off the backup polls.
- name: dns_resolver
  default:
  type: string
  description:
    Declares which DNS resolver to use. The default is ares if gRPC is built
    with c-ares support. Otherwise, the value of this environment variable is
    ignored.
  fuzz: true
- name: trace
  type: comma_separated_string
  default:
  description:
    A comma separated list of tracers that provide additional insight into
    how gRPC C core is processing requests via debug logs.
  fuzz: true
- name: verbosity
  type: string
  prelude: |
    #ifndef GPR_DEFAULT_LOG_VERBOSITY_STRING
    #define GPR_DEFAULT_LOG_VERBOSITY_STRING "ERROR"
    #endif  // !GPR_DEFAULT_LOG_VERBOSITY_STRING
  default: $GPR_DEFAULT_LOG_VERBOSITY_STRING
  description:
    Default gRPC logging verbosity
  fuzz: true
- name: stacktrace_minloglevel
  type: string
  default:
  description:
    Messages logged at the same or higher level than this will print stacktrace
  fuzz: true
- name: enable_fork_support
  type: bool
  description: Enable fork support
  prelude: |
    #ifdef GRPC_ENABLE_FORK_SUPPORT
    #define GRPC_ENABLE_FORK_SUPPORT_DEFAULT true
    #else
    #define GRPC_ENABLE_FORK_SUPPORT_DEFAULT false
    #endif  // GRPC_ENABLE_FORK_SUPPORT
  default: $GRPC_ENABLE_FORK_SUPPORT_DEFAULT
  fuzz: true
- name: poll_strategy
  type: string
  description:
    Declares which polling engines to try when starting gRPC.
    This is a comma-separated list of engines, which are tried in priority
    order first -> last.
  default: all
- name: abort_on_leaks
  type: bool
  default: false
  description:
    A debugging aid to cause a call to abort() when gRPC objects are leaked
    past grpc_shutdown()
- name: system_ssl_roots_dir
  type: string
  default:
  description: Custom directory to SSL Roots
  force-load-on-access: true
- name: default_ssl_roots_file_path
  type: string
  default:
  description: Path to the default SSL roots file.
  force-load-on-access: true
- name: not_use_system_ssl_roots
  type: bool
  default: false
  description: Disable loading system root certificates.
- name: ssl_cipher_suites
  type: string
  description: A colon separated list of cipher suites to use with OpenSSL
  default: "TLS_AES_128_GCM_SHA256:\
    TLS_AES_256_GCM_SHA384:\
    TLS_CHACHA20_POLY1305_SHA256:\
    ECDHE-ECDSA-AES128-GCM-SHA256:\
    ECDHE-ECDSA-AES256-GCM-SHA384:\
    ECDHE-RSA-AES128-GCM-SHA256:\
    ECDHE-RSA-AES256-GCM-SHA384"
- name: absl_logging
  type: bool
  default: false
  description:
    Use absl logging from within gpr_log.