diff --git a/.gitignore b/.gitignore index 46329936bef..f676c43dc88 100644 --- a/.gitignore +++ b/.gitignore @@ -52,7 +52,7 @@ config.cache config.status config.nice -configs/records.config.default +configs/records.yaml.default configs/storage.config.default doc/_build diff --git a/ci/jenkins/ats_conf.pl b/ci/jenkins/ats_conf.pl index 2d5599b405e..7abd1d24f1b 100755 --- a/ci/jenkins/ats_conf.pl +++ b/ci/jenkins/ats_conf.pl @@ -33,7 +33,7 @@ $recedit->set(conf => "proxy.config.http.server_ports", val => "80 80:ipv6 443:ssl 443:ipv6:ssl"); # Threads -$recedit->set(conf => "proxy.config.exec_thread.autoconfig", val => "0"); +$recedit->set(conf => "proxy.config.exec_thread.autoconfig.enabled", val => "0"); $recedit->set(conf => "proxy.config.exec_thread.limit", val => "8"); $recedit->set(conf => "proxy.config.cache.threads_per_disk", val => "8"); $recedit->set(conf => "proxy.config.accept_threads", val => "0"); @@ -42,7 +42,7 @@ # TLS $recedit->set(conf => "proxy.config.ssl.hsts_max_age", val => "17280000"); #$recedit->set(conf => "proxy.config.ssl.max_record_size", val => "-1"); -$recedit->set(conf => "proxy.config.ssl.session_cache", val => "2"); +$recedit->set(conf => "proxy.config.ssl.session_cache.value", val => "2"); $recedit->set(conf => "proxy.config.ssl.ocsp.enabled", val => "1"); $recedit->set(conf => "proxy.config.http2.stream_priority_enabled", val => "1"); $recedit->set(conf => "proxy.config.ssl.max_record_size", val => "-1"); diff --git a/ci/jenkins/remap.config b/ci/jenkins/remap.config index 961b69bb81a..9360f51df29 100644 --- a/ci/jenkins/remap.config +++ b/ci/jenkins/remap.config @@ -28,13 +28,13 @@ reverse_map http://192.168.3.17:6969 https://ci.trafficserver.apache.org # Read-the-docs #map http://docs.trafficserver.apache.org \ -# http://trafficserver.readthedocs.org/en/latest/reference/configuration/records.config.en.html +# http://trafficserver.readthedocs.org/en/latest/reference/configuration/records.yaml.en.html redirect http://docs.trafficserver.apache.org https://docs.trafficserver.apache.org map https://docs.trafficserver.apache.org/__RTD http://192.168.3.17/RTD map https://docs.trafficserver.apache.org/records.config \ - https://trafficserver.readthedocs.org/en/latest/reference/configuration/records.config.en.html \ + https://trafficserver.readthedocs.org/en/latest/reference/configuration/records.yaml.en.html \ @plugin=conf_remap.so @pparam=records.config.pristine map https://docs.trafficserver.apache.org https://trafficserver.readthedocs.org \ diff --git a/configs/Makefile.am b/configs/Makefile.am index 95499b5e2f4..e3f302db6aa 100644 --- a/configs/Makefile.am +++ b/configs/Makefile.am @@ -18,12 +18,12 @@ SUBDIRS = body_factory EXTRA_DIST = \ - records.config.default.in \ + records.yaml.default.in \ storage.config.default.in sysconfdir = $(pkgsysconfdir) nodist_sysconf_DATA = \ - records.config.default \ + records.yaml.default \ storage.config.default dist_sysconf_DATA = \ diff --git a/configs/records.config.default.in b/configs/records.config.default.in deleted file mode 100644 index dc22bf75308..00000000000 --- a/configs/records.config.default.in +++ /dev/null @@ -1,180 +0,0 @@ -############################################################################## -# *NOTE*: All options covered in this file should be documented in the docs: -# -# https://docs.trafficserver.apache.org/records.config -############################################################################## - -############################################################################## -# Thread configurations. Docs: -# https://docs.trafficserver.apache.org/records.config#thread-variables -############################################################################## -CONFIG proxy.config.exec_thread.autoconfig INT 1 -CONFIG proxy.config.exec_thread.autoconfig.scale FLOAT 1.0 -CONFIG proxy.config.exec_thread.limit INT 2 -CONFIG proxy.config.accept_threads INT 1 -CONFIG proxy.config.task_threads INT 2 -CONFIG proxy.config.cache.threads_per_disk INT 8 -CONFIG proxy.config.exec_thread.affinity INT 1 - -############################################################################## -# Specify server addresses and ports to bind for HTTP and HTTPS. Docs: -# https://docs.trafficserver.apache.org/records.config#proxy.config.http.server_ports -############################################################################## -CONFIG proxy.config.http.server_ports STRING 8080 8080:ipv6 - -############################################################################## -# Via: headers. Docs: -# https://docs.trafficserver.apache.org/records.config#proxy-config-http-insert-response-via-str -############################################################################## -CONFIG proxy.config.http.insert_request_via_str INT 1 -CONFIG proxy.config.http.insert_response_via_str INT 0 - -############################################################################## -# Parent proxy configuration, in addition to these settings also see parent.config. Docs: -# https://docs.trafficserver.apache.org/records.config#parent-proxy-configuration -# https://docs.trafficserver.apache.org/en/latest/admin-guide/files/parent.config.en.html -############################################################################## -CONFIG proxy.config.http.parent_proxy.retry_time INT 300 -CONFIG proxy.config.http.forward.proxy_auth_to_parent INT 0 -CONFIG proxy.config.http.uncacheable_requests_bypass_parent INT 1 - -############################################################################## -# HTTP connection timeouts (secs). Docs: -# https://docs.trafficserver.apache.org/records.config#http-connection-timeouts -############################################################################## -CONFIG proxy.config.http.keep_alive_no_activity_timeout_in INT 120 -CONFIG proxy.config.http.keep_alive_no_activity_timeout_out INT 120 -CONFIG proxy.config.http.transaction_no_activity_timeout_in INT 30 -CONFIG proxy.config.http.transaction_no_activity_timeout_out INT 30 -CONFIG proxy.config.http.transaction_active_timeout_in INT 900 -CONFIG proxy.config.http.transaction_active_timeout_out INT 0 -CONFIG proxy.config.http.accept_no_activity_timeout INT 120 -CONFIG proxy.config.net.default_inactivity_timeout INT 86400 - -############################################################################## -# Origin server connect attempts. Docs: -# https://docs.trafficserver.apache.org/records.config#origin-server-connect-attempts -############################################################################## -CONFIG proxy.config.http.connect_attempts_max_retries INT 3 -CONFIG proxy.config.http.connect_attempts_max_retries_dead_server INT 1 -CONFIG proxy.config.http.connect_attempts_rr_retries INT 3 -CONFIG proxy.config.http.connect_attempts_timeout INT 30 -CONFIG proxy.config.http.down_server.cache_time INT 60 - -############################################################################## -# Negative response caching, for redirects and errors. Docs: -# https://docs.trafficserver.apache.org/records.config#negative-response-caching -############################################################################## -CONFIG proxy.config.http.negative_caching_enabled INT 0 -CONFIG proxy.config.http.negative_caching_lifetime INT 1800 - -############################################################################## -# Proxy users variables. Docs: -# https://docs.trafficserver.apache.org/records.config#proxy-user-variables -############################################################################## -CONFIG proxy.config.http.insert_client_ip INT 1 -CONFIG proxy.config.http.insert_squid_x_forwarded_for INT 1 - -############################################################################## -# Security. Docs: -# https://docs.trafficserver.apache.org/records.config#security -############################################################################## -CONFIG proxy.config.http.push_method_enabled INT 0 - -############################################################################## -# Enable / disable HTTP caching. Useful for testing, but also as an -# overridable (per remap) config -############################################################################## -CONFIG proxy.config.http.cache.http INT 1 - -############################################################################## -# Cache control. Docs: -# https://docs.trafficserver.apache.org/records.config#cache-control -# https://docs.trafficserver.apache.org/en/latest/admin-guide/files/cache.config.en.html -############################################################################## -CONFIG proxy.config.http.cache.ignore_client_cc_max_age INT 1 -CONFIG proxy.config.http.normalize_ae INT 1 -CONFIG proxy.config.http.cache.cache_responses_to_cookies INT 1 -CONFIG proxy.config.http.cache.cache_urls_that_look_dynamic INT 1 - # https://docs.trafficserver.apache.org/records.config#proxy-config-http-cache-when-to-revalidate -CONFIG proxy.config.http.cache.when_to_revalidate INT 0 - # https://docs.trafficserver.apache.org/records.config#proxy-config-http-cache-required-headers -CONFIG proxy.config.http.cache.required_headers INT 2 - -############################################################################## -# Heuristic cache expiration. Docs: -# https://docs.trafficserver.apache.org/records.config#heuristic-expiration -############################################################################## -CONFIG proxy.config.http.cache.heuristic_min_lifetime INT 3600 -CONFIG proxy.config.http.cache.heuristic_max_lifetime INT 86400 -CONFIG proxy.config.http.cache.heuristic_lm_factor FLOAT 0.10 - -############################################################################## -# Network. Docs: -# https://docs.trafficserver.apache.org/records.config#network -############################################################################## -CONFIG proxy.config.net.connections_throttle INT 30000 -CONFIG proxy.config.net.max_connections_in INT 30000 -CONFIG proxy.config.net.max_requests_in INT 0 - -############################################################################## -# RAM and disk cache configurations. Docs: -# https://docs.trafficserver.apache.org/records.config#ram-cache -# https://docs.trafficserver.apache.org/en/latest/admin-guide/files/storage.config.en.html -############################################################################## -CONFIG proxy.config.cache.ram_cache.size INT -1 -CONFIG proxy.config.cache.ram_cache_cutoff INT 4194304 - # https://docs.trafficserver.apache.org/records.config#proxy-config-cache-limits-http-max-alts -CONFIG proxy.config.cache.limits.http.max_alts INT 5 - # https://docs.trafficserver.apache.org/records.config#proxy-config-cache-log-alternate-eviction -CONFIG proxy.config.cache.log.alternate.eviction INT 0 - # https://docs.trafficserver.apache.org/records.config#proxy-config-cache-max-doc-size -CONFIG proxy.config.cache.max_doc_size INT 0 -CONFIG proxy.config.cache.min_average_object_size INT 8000 - -############################################################################## -# Logging Config. Docs: -# https://docs.trafficserver.apache.org/records.config#logging-configuration -# https://docs.trafficserver.apache.org/en/latest/admin-guide/files/logging.yaml.en.html -############################################################################## -CONFIG proxy.config.log.logging_enabled INT 3 -CONFIG proxy.config.log.max_space_mb_for_logs INT 25000 -CONFIG proxy.config.log.max_space_mb_headroom INT 1000 -CONFIG proxy.config.log.rolling_enabled INT 1 -CONFIG proxy.config.log.rolling_interval_sec INT 86400 -CONFIG proxy.config.log.rolling_size_mb INT 10 -CONFIG proxy.config.log.auto_delete_rolled_files INT 1 -CONFIG proxy.config.log.periodic_tasks_interval INT 5 - -############################################################################## -# These settings control remapping, and if the proxy allows (open) forward proxy or not. Docs: -# https://docs.trafficserver.apache.org/records.config#url-remap-rules -# https://docs.trafficserver.apache.org/en/latest/admin-guide/files/remap.config.en.html -############################################################################## -CONFIG proxy.config.url_remap.remap_required INT 1 - # https://docs.trafficserver.apache.org/records.config#proxy-config-url-remap-pristine-host-hdr -CONFIG proxy.config.url_remap.pristine_host_hdr INT 0 - # https://docs.trafficserver.apache.org/records.config#reverse-proxy -CONFIG proxy.config.reverse_proxy.enabled INT 1 - -############################################################################## -# SSL Termination. Docs: -# https://docs.trafficserver.apache.org/records.config#client-related-configuration -# https://docs.trafficserver.apache.org/en/latest/admin-guide/files/ssl_multicert.config.en.html -############################################################################## -CONFIG proxy.config.ssl.client.verify.server.policy STRING PERMISSIVE -CONFIG proxy.config.ssl.client.verify.server.properties STRING ALL -CONFIG proxy.config.ssl.client.CA.cert.filename STRING NULL - -############################################################################## -# Debugging. Docs: -# https://docs.trafficserver.apache.org/records.config#diagnostic-logging-configuration -# https://docs.trafficserver.apache.org/records.config#proxy-config-res-track-memory -# https://docs.trafficserver.apache.org/records.config#proxy-config-dump-mem-info-frequency -# https://docs.trafficserver.apache.org/records.config#proxy-config-http-slow-log-threshold -############################################################################## -CONFIG proxy.config.diags.debug.enabled INT 0 -CONFIG proxy.config.diags.debug.tags STRING http|dns -CONFIG proxy.config.res_track_memory INT 0 -CONFIG proxy.config.dump_mem_info_frequency INT 0 -CONFIG proxy.config.http.slow.log.threshold INT 0 diff --git a/configs/records.yaml.default.in b/configs/records.yaml.default.in new file mode 100644 index 00000000000..72711d876fa --- /dev/null +++ b/configs/records.yaml.default.in @@ -0,0 +1,218 @@ +############################################################################## +# *NOTE*: All options covered in this file should be documented in the docs: +# +# https://docs.trafficserver.apache.org/records.yaml +############################################################################## + +ts: + accept_threads: 1 + cache: + limits: + http: + +# https://docs.trafficserver.apache.org/records.yaml#proxy-config-cache-limits-http-max-alts + max_alts: 5 + log: + alternate: + +# https://docs.trafficserver.apache.org/records.yaml#proxy-config-cache-log-alternate-eviction + eviction: 0 + +# https://docs.trafficserver.apache.org/records.yaml#proxy-config-cache-max-doc-size + max_doc_size: 0 + min_average_object_size: 8000 + +############################################################################## +# RAM and disk cache configurations. Docs: +# https://docs.trafficserver.apache.org/records.yaml#ram-cache +# https://docs.trafficserver.apache.org/en/latest/admin-guide/files/storage.config.en.html +############################################################################## + ram_cache: + size: -1 + ram_cache_cutoff: 4194304 + threads_per_disk: 8 +############################################################################## +# Debugging. Docs: +# https://docs.trafficserver.apache.org/records.yaml#diagnostic-logging-configuration +############################################################################## + diags: + debug: + enabled: 0 + tags: http|dns + +# https://docs.trafficserver.apache.org/records.yaml#proxy-config-dump-mem-info-frequency + dump_mem_info_frequency: 0 + +############################################################################## +# Thread configurations. Docs: +# https://docs.trafficserver.apache.org/records.yaml#thread-variables +############################################################################## + exec_thread: + affinity: 1 + autoconfig: + enabled: 1 + scale: 1.13 + limit: 2 + http: + accept_no_activity_timeout: 120 + cache: + cache_responses_to_cookies: 1 + cache_urls_that_look_dynamic: 1 + +############################################################################## +# Heuristic cache expiration. Docs: +# https://docs.trafficserver.apache.org/records.yaml#heuristic-expiration +############################################################################## + heuristic_lm_factor: 0.1 + heuristic_max_lifetime: 86400 + heuristic_min_lifetime: 3600 + +############################################################################## +# Enable / disable HTTP caching. Useful for testing, but also as an +# overridable (per remap) config +############################################################################## + http: 1 + +############################################################################## +# Cache control. Docs: +# https://docs.trafficserver.apache.org/records.yaml#cache-control +# https://docs.trafficserver.apache.org/en/latest/admin-guide/files/cache.config.en.html +############################################################################## + ignore_client_cc_max_age: 1 + +# https://docs.trafficserver.apache.org/records.yaml#proxy-config-http-cache-required-headers + required_headers: 2 + +# https://docs.trafficserver.apache.org/records.yaml#proxy-config-http-cache-when-to-revalidate + when_to_revalidate: 0 + +############################################################################## +# Origin server connect attempts. Docs: +# https://docs.trafficserver.apache.org/records.yaml#origin-server-connect-attempts +############################################################################## + connect_attempts_max_retries: 3 + connect_attempts_max_retries_dead_server: 1 + connect_attempts_rr_retries: 3 + connect_attempts_timeout: 30 + down_server: + cache_time: 60 + forward: + proxy_auth_to_parent: 0 + +############################################################################## +# Proxy users variables. Docs: +# https://docs.trafficserver.apache.org/records.yaml#proxy-user-variables +############################################################################## + insert_client_ip: 1 + +############################################################################## +# Via: headers. Docs: +# https://docs.trafficserver.apache.org/records.yaml#proxy-config-http-insert-response-via-str +############################################################################## + insert_request_via_str: 1 + insert_response_via_str: 0 + insert_squid_x_forwarded_for: 1 + keep_alive_no_activity_timeout_in: 120 + keep_alive_no_activity_timeout_out: 120 + +############################################################################## +# Negative response caching, for redirects and errors. Docs: +# https://docs.trafficserver.apache.org/records.yaml#negative-response-caching +############################################################################## + negative_caching_enabled: 0 + negative_caching_lifetime: 1800 + normalize_ae: 1 + +############################################################################## +# Parent proxy configuration, in addition to these settings also see parent.config. Docs: +# https://docs.trafficserver.apache.org/records.yaml#parent-proxy-configuration +# https://docs.trafficserver.apache.org/en/latest/admin-guide/files/parent.config.en.html +############################################################################## + parent_proxy: + retry_time: 300 + +############################################################################## +# Security. Docs: +# https://docs.trafficserver.apache.org/records.yaml#security +############################################################################## + push_method_enabled: 0 + +############################################################################## +# Specify server addresses and ports to bind for HTTP and HTTPS. Docs: +# https://docs.trafficserver.apache.org/records.yaml#proxy.config.http.server_ports +############################################################################## + server_ports: 8080 8080:ipv6 + +# https://docs.trafficserver.apache.org/records.yaml#proxy-config-http-slow-log-threshold + slow: + log: + threshold: 0 + +############################################################################## +# HTTP connection timeouts (secs). Docs: +# https://docs.trafficserver.apache.org/records.yaml#http-connection-timeouts +############################################################################## + transaction_active_timeout_in: 900 + transaction_active_timeout_out: 0 + transaction_no_activity_timeout_in: 30 + transaction_no_activity_timeout_out: 30 + uncacheable_requests_bypass_parent: 1 + +############################################################################## +# Logging Config. Docs: +# https://docs.trafficserver.apache.org/records.yaml#logging-configuration +# https://docs.trafficserver.apache.org/en/latest/admin-guide/files/logging.yaml.en.html +############################################################################## + log: + auto_delete_rolled_files: 1 + logging_enabled: 3 + max_space_mb_for_logs: 25000 + max_space_mb_headroom: 1000 + periodic_tasks_interval: 5 + rolling_enabled: 1 + rolling_interval_sec: 86400 + rolling_size_mb: 10 + +############################################################################## +# Network. Docs: +# https://docs.trafficserver.apache.org/records.yaml#network +############################################################################## + net: + connections_throttle: 30000 + default_inactivity_timeout: 86400 + max_connections_in: 30000 + max_requests_in: 0 + +# https://docs.trafficserver.apache.org/records.yaml#proxy-config-res-track-memory + res_track_memory: 0 + +# https://docs.trafficserver.apache.org/records.yaml#reverse-proxy + reverse_proxy: + enabled: 1 + ssl: + client: + CA: + cert: + filename: null + +############################################################################## +# SSL Termination. Docs: +# https://docs.trafficserver.apache.org/records.yaml#client-related-configuration +# https://docs.trafficserver.apache.org/en/latest/admin-guide/files/ssl_multicert.config.en.html +############################################################################## + verify: + server: + policy: PERMISSIVE + properties: ALL + task_threads: 2 + +############################################################################## +# These settings control remapping, and if the proxy allows (open) forward proxy or not. Docs: +# https://docs.trafficserver.apache.org/records.yaml#url-remap-rules +# https://docs.trafficserver.apache.org/en/latest/admin-guide/files/remap.config.en.html +############################################################################## + url_remap: + +# https://docs.trafficserver.apache.org/records.yaml#proxy-config-url-remap-pristine-host-hdr + pristine_host_hdr: 0 + remap_required: 1 diff --git a/configure.ac b/configure.ac index cdca9a37f61..d6409aa6a8d 100644 --- a/configure.ac +++ b/configure.ac @@ -2346,7 +2346,7 @@ AC_CONFIG_FILES([ configs/Makefile configs/body_factory/Makefile configs/body_factory/default/Makefile - configs/records.config.default + configs/records.yaml.default configs/storage.config.default doc/Makefile doc/ext/local-config.py diff --git a/contrib/set_trafficserver.sh b/contrib/set_trafficserver.sh index 837d7ce524b..d6486d11e12 100644 --- a/contrib/set_trafficserver.sh +++ b/contrib/set_trafficserver.sh @@ -37,7 +37,7 @@ function recordsConfig() { startServer traffic_ctl config set proxy.config.reverse_proxy.enabled 1 - traffic_ctl config set proxy.config.exec_thread.autoconfig 1 + traffic_ctl config set proxy.config.exec_thread.autoconfig.enabled 1 # Good default on a dedicated box or SMP VM. #traffic_ctl config set proxy.config.exec_thread.autoconfig.scale 3.000000 diff --git a/doc/.tx/config b/doc/.tx/config index c7baab4394a..d3e330292a0 100644 --- a/doc/.tx/config +++ b/doc/.tx/config @@ -98,8 +98,8 @@ source_file = _build/locale/pot/admin-guide/files/plugin.config.en.pot source_lang = en [apache-traffic-server-6x.admin-guide--files--records_config_en] -file_filter = locale//LC_MESSAGES/admin-guide/files/records.config.en.po -source_file = _build/locale/pot/admin-guide/files/records.config.en.pot +file_filter = locale//LC_MESSAGES/admin-guide/files/records.yaml.en.po +source_file = _build/locale/pot/admin-guide/files/records.yaml.en.pot source_lang = en [apache-traffic-server-6x.admin-guide--files--remap_config_en] diff --git a/doc/Pipfile b/doc/Pipfile index ba2b3f17f37..bb0a358d793 100644 --- a/doc/Pipfile +++ b/doc/Pipfile @@ -35,6 +35,8 @@ sphinxcontrib-plantuml = "*" # i18n sphinx-intl = "*" +pyyaml = "*" + # For parsing Doxygen XML output, to add links from an API description # to the source code for that object lxml = "*" diff --git a/doc/admin-guide/configuration/cache-basics.en.rst b/doc/admin-guide/configuration/cache-basics.en.rst index 273005b9b8d..5e9fe515273 100644 --- a/doc/admin-guide/configuration/cache-basics.en.rst +++ b/doc/admin-guide/configuration/cache-basics.en.rst @@ -171,7 +171,7 @@ To specify an absolute freshness limit: #. Edit the variables :ts:cv:`proxy.config.http.cache.heuristic_min_lifetime` and :ts:cv:`proxy.config.http.cache.heuristic_max_lifetime` in - :file:`records.config`. + :file:`records.yaml`. #. Run the :option:`traffic_ctl config reload` command to apply the configuration changes. @@ -190,7 +190,7 @@ explicit expiration information). To configure Traffic Server to cache objects with specific headers: #. Change the value for :ts:cv:`proxy.config.http.cache.required_headers` - in :file:`records.config`. + in :file:`records.yaml`. #. Run the :option:`traffic_ctl config reload` command to apply the configuration changes. @@ -276,7 +276,7 @@ can set specific revalidation rules in :file:`cache.config`. To configure revalidation options #. Edit the variable :ts:cv:`proxy.config.http.cache.when_to_revalidate` - in :file:`records.config`. + in :file:`records.yaml`. #. Run the :option:`traffic_ctl config reload` command to apply the configuration changes. @@ -298,7 +298,7 @@ must configure Traffic Server to accept ``PUSH`` requests. #. Edit :file:`ip_allow.yaml` to allow ``PUSH`` from the appropriate addresses. #. Update :ts:cv:`proxy.config.http.push_method_enabled` in - :file:`records.config`:: + :file:`records.yaml`:: CONFIG proxy.config.http.push_method_enabled INT 1 @@ -348,7 +348,7 @@ if it is indeed cacheable. To set cache pinning rules: -#. Enable :ts:cv:`proxy.config.cache.permit.pinning` in :file:`records.config`:: +#. Enable :ts:cv:`proxy.config.cache.permit.pinning` in :file:`records.yaml`:: CONFIG proxy.config.cache.permit.pinning INT 1 @@ -411,7 +411,7 @@ You can configure Traffic Server to honor both of these client directives with the following: #. Edit :ts:cv:`proxy.config.http.cache.ignore_client_no_cache` in - :file:`records.config`. :: + :file:`records.yaml`. :: CONFIG proxy.config.http.cache.ignore_client_no_cache INT 0 @@ -454,7 +454,7 @@ in most cases. To configure Traffic Server to ignore server ``no-cache`` headers: #. Edit :ts:cv:`proxy.config.http.cache.ignore_server_no_cache` in - :file:`records.config`. :: + :file:`records.yaml`. :: CONFIG proxy.config.http.cache.ignore_server_no_cache INT 1 @@ -480,7 +480,7 @@ To configure Traffic Server to ignore server ``WWW-Authenticate`` headers: #. Edit :ts:cv:`proxy.config.http.cache.ignore_authentication` in - :file:`records.config`. :: + :file:`records.yaml`. :: CONFIG proxy.config.http.cache.ignore_authentication INT 1 @@ -517,7 +517,7 @@ detailed below. To disable HTTP object caching manually: -#. Set :ts:cv:`proxy.config.http.cache.http` to ``0`` in :file:`records.config`. :: +#. Set :ts:cv:`proxy.config.http.cache.http` to ``0`` in :file:`records.yaml`. :: CONFIG proxy.config.http.cache.http INT 0 @@ -537,7 +537,7 @@ To configure Traffic Server's cache behaviour in regard to dynamic content: #. Edit :ts:cv:`proxy.config.http.cache.cache_urls_that_look_dynamic` in - :file:`records.config`. To disable caching, set the variable to ``0``, + :file:`records.yaml`. To disable caching, set the variable to ``0``, and to explicitly permit caching use ``1``. :: CONFIG proxy.config.http.cache.cache_urls_that_look_dynamic INT 0 @@ -572,7 +572,7 @@ You can reconfigure Traffic Server to: To configure how Traffic Server caches cookied content: #. Edit :ts:cv:`proxy.config.http.cache.cache_responses_to_cookies` in - :file:`records.config`. + :file:`records.yaml`. #. Run the command :option:`traffic_ctl config reload` to apply the configuration changes. @@ -622,7 +622,7 @@ object (the default is 3). To alter the limit on the number of alternates: -#. Edit :ts:cv:`proxy.config.cache.limits.http.max_alts` in :file:`records.config`. :: +#. Edit :ts:cv:`proxy.config.cache.limits.http.max_alts` in :file:`records.yaml`. :: CONFIG proxy.config.cache.limits.http.max_alts INT 5 @@ -712,7 +712,7 @@ content being unique to different client requests, ATS will not enable read-while-writer functionality until it has determined that it will be able to cache the object. -The following settings must be made in :file:`records.config` to enable +The following settings must be made in :file:`records.yaml` to enable read-while-writer functionality in ATS:: CONFIG proxy.config.cache.enable_read_while_writer INT 1 diff --git a/doc/admin-guide/configuration/redirecting-http-requests.en.rst b/doc/admin-guide/configuration/redirecting-http-requests.en.rst index defb77c44da..75d28981aa3 100644 --- a/doc/admin-guide/configuration/redirecting-http-requests.en.rst +++ b/doc/admin-guide/configuration/redirecting-http-requests.en.rst @@ -269,7 +269,7 @@ Enabling HTTP Reverse Proxy To enable HTTP reverse proxy: -#. Edit :ts:cv:`proxy.config.reverse_proxy.enabled` in :file:`records.config`. :: +#. Edit :ts:cv:`proxy.config.reverse_proxy.enabled` in :file:`records.yaml`. :: CONFIG proxy.config.reverse_proxy.enabled INT 1 @@ -279,7 +279,7 @@ Setting Optional HTTP Reverse Proxy Options ------------------------------------------- Traffic Server provides several reverse proxy configuration options in -:file:`records.config` that enable you to: +:file:`records.yaml` that enable you to: - Configure Traffic Server to retain the client host header information in a request during translation. diff --git a/doc/admin-guide/configuration/transparent-forward-proxying.en.rst b/doc/admin-guide/configuration/transparent-forward-proxying.en.rst index d573c282274..a352b5fc0e5 100644 --- a/doc/admin-guide/configuration/transparent-forward-proxying.en.rst +++ b/doc/admin-guide/configuration/transparent-forward-proxying.en.rst @@ -66,13 +66,13 @@ and straightforward. 1. Permit Traffic Server to process requests for hosts not explicitly configured in the remap rules, by modifying :ts:cv:`proxy.config.url_remap.remap_required` - in :file:`records.config`:: + in :file:`records.yaml`:: CONFIG proxy.config.url_remap.remap_required INT 0 2. *Optional*: If Traffic Server will be operating strictly as a forward proxy, you will want to disable reverse proxy support by modifying - :ts:cv:`proxy.config.reverse_proxy.enabled` in :file:`records.config`:: + :ts:cv:`proxy.config.reverse_proxy.enabled` in :file:`records.yaml`:: CONFIG proxy.config.reverse_proxy.enabled INT 0 diff --git a/doc/admin-guide/configuration/transparent-proxy/bridge.en.rst b/doc/admin-guide/configuration/transparent-proxy/bridge.en.rst index 12bbd1c2dd9..75ae9edb0c0 100644 --- a/doc/admin-guide/configuration/transparent-proxy/bridge.en.rst +++ b/doc/admin-guide/configuration/transparent-proxy/bridge.en.rst @@ -123,7 +123,7 @@ The marking used is arbitrary but it must be consistent between 1..253. To configure Traffic Server set the following values in -:file:`records.config` +:file:`records.yaml` - :ts:cv:`proxy.config.http.server_ports` *value from* ``--on-port`` (see below) diff --git a/doc/admin-guide/configuration/transparent-proxy/router-inline.en.rst b/doc/admin-guide/configuration/transparent-proxy/router-inline.en.rst index 9f033e683e4..7a499abe46b 100644 --- a/doc/admin-guide/configuration/transparent-proxy/router-inline.en.rst +++ b/doc/admin-guide/configuration/transparent-proxy/router-inline.en.rst @@ -71,7 +71,7 @@ The marking used is arbitrary but it must be consistent between 1..253. To configure Traffic Server set the following values in -:file:`records.config` +:file:`records.yaml` ``proxy.config.http.server_ports`` ``STRING`` diff --git a/doc/admin-guide/configuration/transparent-proxy/wccp-configuration.en.rst b/doc/admin-guide/configuration/transparent-proxy/wccp-configuration.en.rst index 8611c08f66a..42c4dc7f94a 100644 --- a/doc/admin-guide/configuration/transparent-proxy/wccp-configuration.en.rst +++ b/doc/admin-guide/configuration/transparent-proxy/wccp-configuration.en.rst @@ -70,7 +70,7 @@ roughly the same way as the standard transparency use. Finally Traffic Server itself must be configured for transparency and use of WCCP. The former is again very similar to the standard use, while WCCP configuration is specific to WCCP and uses a separate configuration -file, referred to by the :file:`records.config` file. +file, referred to by the :file:`records.yaml` file. The primary concern for configuration in which of three basic topologies are to be used. diff --git a/doc/admin-guide/configuring-traffic-server.en.rst b/doc/admin-guide/configuring-traffic-server.en.rst index 298a9107561..2da1895f93a 100644 --- a/doc/admin-guide/configuring-traffic-server.en.rst +++ b/doc/admin-guide/configuring-traffic-server.en.rst @@ -60,13 +60,13 @@ Configure Traffic Server Using Configuration Files You can change Traffic Server configuration options by manually editing specific -variables in :file:`records.config`. +variables in :file:`records.yaml`. Traffic Server must reread the configuration files for any changes to take effect. This is done with :option:`traffic_ctl config reload`. Some configuration changes require a full restart of Traffic Server. -The following is a sample portion of :file:`records.config`: +The following is a sample portion of :file:`records.yaml`: .. figure:: ../static/images/admin/records.jpg :align: center @@ -74,7 +74,7 @@ The following is a sample portion of :file:`records.config`: Sample records.config file -In addition to :file:`records.config`, +In addition to :file:`records.yaml`, Traffic Server provides other configuration files that are used to configure specific features. You can manually edit all configuration files as described in :ref:`admin-configuration-files`. diff --git a/doc/admin-guide/files/index.en.rst b/doc/admin-guide/files/index.en.rst index 4bf2aca3aaf..f6bff4434e5 100644 --- a/doc/admin-guide/files/index.en.rst +++ b/doc/admin-guide/files/index.en.rst @@ -31,7 +31,7 @@ Configuration Files logging.yaml.en parent.config.en plugin.config.en - records.config.en + records.yaml.en remap.config.en splitdns.config.en ssl_multicert.config.en @@ -63,7 +63,7 @@ Configuration Files Control runtime loadable plugins available to |TS|, as well as their configurations. -:doc:`records.config.en` +:doc:`records.yaml.en` Contains many configuration variables affecting |TS| operation. :doc:`remap.config.en` diff --git a/doc/admin-guide/files/logging.yaml.en.rst b/doc/admin-guide/files/logging.yaml.en.rst index 0f9cee03550..5c77515d09f 100644 --- a/doc/admin-guide/files/logging.yaml.en.rst +++ b/doc/admin-guide/files/logging.yaml.en.rst @@ -293,7 +293,7 @@ filters array of The optional list of filter objects which may only contain one accept filter. ====================== =========== ================================================= -Enabling log rolling may be done globally in :file:`records.config`, or on a +Enabling log rolling may be done globally in :file:`records.yaml`, or on a per-log basis by passing appropriate values for the ``rolling_enabled`` key. The latter method may also be used to effect different rolling settings for individual logs. The numeric values that may be passed are the same as used by diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.yaml.en.rst similarity index 99% rename from doc/admin-guide/files/records.config.en.rst rename to doc/admin-guide/files/records.yaml.en.rst index 5f4080f75f8..7331a1b2a4f 100644 --- a/doc/admin-guide/files/records.config.en.rst +++ b/doc/admin-guide/files/records.yaml.en.rst @@ -17,16 +17,16 @@ .. include:: ../../common.defs -.. configfile:: records.config +.. configfile:: records.yaml -records.config -************** +records.yaml +************ -The :file:`records.config` file (by default, located in +The :file:`records.yaml` file (by default, located in ``/usr/local/etc/trafficserver/``) is a list of configurable variables used by -the |TS| software. Many of the variables in :file:`records.config` are set +the |TS| software. Many of the variables in :file:`records.yaml` are set automatically when you set configuration options with :option:`traffic_ctl config set`. After you -modify :file:`records.config`, run the command :option:`traffic_ctl config reload` +modify :file:`records.yaml`, run the command :option:`traffic_ctl config reload` to apply the changes. Note: The configuration directory, containing the ``SYSCONFDIR`` value specified at build time @@ -138,16 +138,16 @@ prefix. :: Environment Overrides ===================== -Every :file:`records.config` configuration variable can be overridden +Every :file:`records.yaml` configuration variable can be overridden by a corresponding environment variable. This can be useful in -situations where you need a static :file:`records.config` but still +situations where you need a static :file:`records.yaml` but still want to tweak one or two settings. The override variable is formed -by converting the :file:`records.config` variable name to upper +by converting the :file:`records.yaml` variable name to upper case, and replacing any dot separators with an underscore. Overriding a variable from the environment is permanent and will not be affected by future configuration changes made in -:file:`records.config` or applied with :program:`traffic_ctl`. +:file:`records.yaml` or applied with :program:`traffic_ctl`. For example, we could override the `proxy.config.product_company`_ variable like this:: @@ -161,7 +161,7 @@ Configuration Variables ======================= The following list describes the configuration variables available in -the :file:`records.config` file. +the :file:`records.yaml` file. System Variables ---------------- @@ -825,7 +825,7 @@ mptcp :reloadable: :overridable: - Set the server and version string in the ``Via`` request header to the origin server which is inserted when the value of :ts:cv:`proxy.config.http.insert_request_via_str` is not ``0``. Note that the actual default value is defined with ``"ApacheTrafficServer/" PACKAGE_VERSION`` in a C++ source code, and you must write such as ``ApacheTrafficServer/6.0.0`` if you really set a value with the version in :file:`records.config` file. If you want to hide the version, you can set this value to ``ApacheTrafficServer``. + Set the server and version string in the ``Via`` request header to the origin server which is inserted when the value of :ts:cv:`proxy.config.http.insert_request_via_str` is not ``0``. Note that the actual default value is defined with ``"ApacheTrafficServer/" PACKAGE_VERSION`` in a C++ source code, and you must write such as ``ApacheTrafficServer/6.0.0`` if you really set a value with the version in :file:`records.yaml` file. If you want to hide the version, you can set this value to ``ApacheTrafficServer``. .. ts:cv:: CONFIG proxy.config.http.insert_response_via_str INT 0 :reloadable: @@ -851,7 +851,7 @@ mptcp :reloadable: :overridable: - Set the server and version string in the ``Via`` response header to the client which is inserted when the value of :ts:cv:`proxy.config.http.insert_response_via_str` is not ``0``. Note that the actual default value is defined with ``"ApacheTrafficServer/" PACKAGE_VERSION`` in a C++ source code, and you must write such as ``ApacheTrafficServer/6.0.0`` if you really set a value with the version in :file:`records.config` file. If you want to hide the version, you can set this value to ``ApacheTrafficServer``. + Set the server and version string in the ``Via`` response header to the client which is inserted when the value of :ts:cv:`proxy.config.http.insert_response_via_str` is not ``0``. Note that the actual default value is defined with ``"ApacheTrafficServer/" PACKAGE_VERSION`` in a C++ source code, and you must write such as ``ApacheTrafficServer/6.0.0`` if you really set a value with the version in :file:`records.yaml` file. If you want to hide the version, you can set this value to ``ApacheTrafficServer``. .. ts:cv:: CONFIG proxy.config.http.send_100_continue_response INT 0 :reloadable: @@ -891,7 +891,7 @@ mptcp requested, see above). Note that the actual default value is defined with ``"ATS/" PACKAGE_VERSION`` in the C++ source, and you must write such as ``ATS/6.0.0`` if you really set a value with the version in - :file:`records.config`. If you want to hide the version, you can set this + :file:`records.yaml`. If you want to hide the version, you can set this value to ``ATS``. .. ts:cv:: CONFIG proxy.config.http.insert_age_in_response INT 1 @@ -1993,7 +1993,7 @@ Security global ``proxy.config.http.host_sni_policy`` is set to a value of 1 or 2. It is only performed for connections to hosts specifying ``verify_client`` and/or ``ip_allow`` policies in :file:`sni.yaml`. That is, the SNI and hostname mismatch check is only performed if a relevant security policy for the SNI is set in :file:`sni.yaml`. The - ``proxy.config.http.host_sni_policy`` :file:`records.config` value is used as the default value if either of these + ``proxy.config.http.host_sni_policy`` :file:`records.yaml` value is used as the default value if either of these policies is set in the corresponding :file:`sni.yaml` file entry and the :file:`sni.yaml` entry does not override this value via a :ref:`host_sni_policy` attribute. @@ -2632,7 +2632,7 @@ DNS === .. ts:cv:: CONFIG proxy.config.dns.search_default_domains INT 0 - :Reloadable: + :reloadable: |TS| can attempt to resolve unqualified hostnames by expanding to the local domain. For example if a client makes a request to an unqualified host (e.g. @@ -4682,7 +4682,7 @@ SOCKS Processor See :ref:`admin-performance-timeouts` for more discussion on |TS| timeouts. -.. ts:cv:: CONFIG proxy.config.socks.default_servers STRING +.. ts:cv:: CONFIG proxy.config.socks.default_servers STRING "" Default list of SOCKS servers and their ports. @@ -4851,13 +4851,13 @@ Sockets Set socket option TCP_NOTSENT_LOWAT to specified value for a connection -.. ts:cv:: CONFIG proxy.config.net.poll_timeout INT 10 (or 30 on Solaris) +.. ts:cv:: CONFIG proxy.config.net.poll_timeout INT 10 Same as the command line option ``--poll_timeout``, or ``-t``, which specifies the timeout used for the polling mechanism used. This timeout is always in milliseconds (ms). This is the timeout to ``epoll_wait()`` on Linux platforms, and to ``kevent()`` on BSD type OSs. The default value is - ``10`` on all platforms. + ``10`` on all platforms or 30 on Solaris. Changing this configuration can reduce CPU usage on an idle system, since periodic tasks gets processed at these intervals. On busy servers, this diff --git a/doc/admin-guide/files/remap.config.en.rst b/doc/admin-guide/files/remap.config.en.rst index aba51f79f48..cae4ca64cbf 100644 --- a/doc/admin-guide/files/remap.config.en.rst +++ b/doc/admin-guide/files/remap.config.en.rst @@ -269,7 +269,7 @@ Client Request Translated Request ``http://www.x.com/Widgets`` ``http://server.hoster.com/x/Widgets`` ================================ ===================================== -  + ================================ ======================================= ============================= Client Request Origin Server Header Translated Request @@ -280,7 +280,7 @@ Client Request Origin Server Header Transla When acting as a reverse proxy for multiple servers, Traffic Server is unable to route to URLs from older browsers that do not send the ``Host:`` header. As a solution, set the variable :ts:cv:`proxy.config.header.parse.no_host_url_redirect` -in the :file:`records.config` file to the URL to which Traffic Server will redirect +in the :file:`records.yaml` file to the URL to which Traffic Server will redirect requests without host headers. Redirect Mapping Rules diff --git a/doc/admin-guide/files/sni.yaml.en.rst b/doc/admin-guide/files/sni.yaml.en.rst index f5a58683f8c..7ed07c1d6fe 100644 --- a/doc/admin-guide/files/sni.yaml.en.rst +++ b/doc/admin-guide/files/sni.yaml.en.rst @@ -96,7 +96,7 @@ host_sni_policy Inbound One of the values :code:`DISABLED`, :code:`P If not specified, the value of :ts:cv:`proxy.config.http.host_sni_policy` is used. This controls how policy impacting mismatches between host header and SNI values are dealt with. For details about hos this configuration behaves, see the corresponding - :ts:cv:`proxy.config.http.host_sni_policy` :file:`records.config` documentation. + :ts:cv:`proxy.config.http.host_sni_policy` :file:`records.yaml` documentation. Note that this particular configuration will be inspected at the time the HTTP Host header field is processed. Further, this policy check will be keyed off of the Host header diff --git a/doc/admin-guide/layer-4-routing.en.rst b/doc/admin-guide/layer-4-routing.en.rst index 463d94762ae..746e9ba2068 100644 --- a/doc/admin-guide/layer-4-routing.en.rst +++ b/doc/admin-guide/layer-4-routing.en.rst @@ -111,7 +111,7 @@ The :file:`sni.yaml` contents would be - tunnel_route: app-server-56:4443 fqdn: service-2.example.com -In addition to this, in the :file:`records.config` file, edit ``connect_ports`` like so: +In addition to this, in the :file:`records.yaml` file, edit ``connect_ports`` like so: - :ts:cv:`proxy.config.http.connect_ports`: ``443 4443`` to allow |TS| to connect to the destination port diff --git a/doc/admin-guide/logging/destinations.en.rst b/doc/admin-guide/logging/destinations.en.rst index 03b6f75fb91..41d1015675c 100644 --- a/doc/admin-guide/logging/destinations.en.rst +++ b/doc/admin-guide/logging/destinations.en.rst @@ -46,7 +46,7 @@ Log Directory Configuration All local logging output is stored within a single base directory. Individual log file configurations may optionally append subdirectories to this base path. This location is adjusted with -:ts:cv:`proxy.config.log.logfile_dir` in :file:`records.config`. +:ts:cv:`proxy.config.log.logfile_dir` in :file:`records.yaml`. This configuration may specify either an absolute path on the host (if it begins with ``/``) or a path relative to the |TS| installation directory (any diff --git a/doc/admin-guide/logging/formatting.en.rst b/doc/admin-guide/logging/formatting.en.rst index 4e65bc01283..d87fa62659d 100644 --- a/doc/admin-guide/logging/formatting.en.rst +++ b/doc/admin-guide/logging/formatting.en.rst @@ -856,7 +856,7 @@ Line Length The maximum line size for a log entry can be configured via the following parameters, the details of which are documented in the linked -:file:`records.config` descriptions: +:file:`records.yaml` descriptions: - :ts:cv:`proxy.config.log.max_line_size` - :ts:cv:`proxy.config.log.ascii_buffer_size` diff --git a/doc/admin-guide/logging/rotation.en.rst b/doc/admin-guide/logging/rotation.en.rst index e0b93c2cd1d..1271e588865 100644 --- a/doc/admin-guide/logging/rotation.en.rst +++ b/doc/admin-guide/logging/rotation.en.rst @@ -146,7 +146,7 @@ example, if the rolling interval is six hours and the offset hour is ``0`` To set log file rolling options and/or configure |TS| to roll log files when they reach a certain size, adjust the following settings in -:file:`records.config`: +:file:`records.yaml`: #. Enable log rolling with :ts:cv:`proxy.config.log.rolling_enabled`. :: @@ -177,7 +177,7 @@ they reach a certain size, adjust the following settings in You can fine-tune log file rolling settings for individual log files in the ``log.*`` specification in :file:`logging.yaml`. The custom log file uses the rolling settings provided in the relevant ``log`` function call, which override -the default settings you specify in Traffic Manager or :file:`records.config` +the default settings you specify in Traffic Manager or :file:`records.yaml` described above. .. _admin-logging-retention: @@ -237,7 +237,7 @@ Setting Log File Management Options To set log management options, follow the steps below: -#. In the :file:`records.config` file, edit the following variables +#. In the :file:`records.yaml` file, edit the following variables - :ts:cv:`proxy.config.log.max_space_mb_for_logs` - :ts:cv:`proxy.config.log.max_space_mb_headroom` diff --git a/doc/admin-guide/logging/understanding.en.rst b/doc/admin-guide/logging/understanding.en.rst index cf84e1e487d..36b6bef5ef3 100644 --- a/doc/admin-guide/logging/understanding.en.rst +++ b/doc/admin-guide/logging/understanding.en.rst @@ -40,7 +40,7 @@ Enabling Logs By default, |TS| creates both error and event log files and records system information in system log files. You can disable event logging and/or error logging by setting the configuration variable -:ts:cv:`proxy.config.log.logging_enabled` in :file:`records.config` +:ts:cv:`proxy.config.log.logging_enabled` in :file:`records.yaml` to one of the following values: ===== ========================================================================= diff --git a/doc/admin-guide/monitoring/error-messages.en.rst b/doc/admin-guide/monitoring/error-messages.en.rst index 6aa414fb7b2..0912a1a80eb 100644 --- a/doc/admin-guide/monitoring/error-messages.en.rst +++ b/doc/admin-guide/monitoring/error-messages.en.rst @@ -30,7 +30,7 @@ Fatal Process Messages ====================== ``Accept port is not between 1 and 65535. Please check configuration`` - The port specified in :file:`records.config` that accepts + The port specified in :file:`records.yaml` that accepts incoming HTTP requests is not valid. ``Self loop is detected in parent proxy configuration`` diff --git a/doc/admin-guide/performance/index.en.rst b/doc/admin-guide/performance/index.en.rst index b425a2b2961..512476a70f2 100644 --- a/doc/admin-guide/performance/index.en.rst +++ b/doc/admin-guide/performance/index.en.rst @@ -108,7 +108,7 @@ startup. Your |TS| systems will need at least enough memory to satisfy basic operating system requirements, as well as capacity for the cache directory, and any memory cache you wish to use. The default settings allocate roughly 10 megabytes of RAM cache for every gigabyte of disk cache storage, though this -setting can be adjusted manually in :file:`records.config` using the setting +setting can be adjusted manually in :file:`records.yaml` using the setting :ts:cv:`proxy.config.cache.ram_cache.size`. |TS| will, under the default configuration, adjust this automatically if your system does not have enough physical memory to accommodate the aforementioned target. @@ -173,7 +173,7 @@ Traffic Server Tuning |TS| itself, of course, has many options you may want to consider adjusting to achieve optimal performance in your environment. Many of these settings are -recorded in :file:`records.config` and may be adjusted with the +recorded in :file:`records.yaml` and may be adjusted with the :option:`traffic_ctl config set` command line utility while the server is operating. CPU and Thread Optimization @@ -183,7 +183,7 @@ Thread Scaling ~~~~~~~~~~~~~~ By default, |TS| creates one thread per CPU core on the host system. This may -be adjusted with the following settings in :file:`records.config`: +be adjusted with the following settings in :file:`records.yaml`: * :ts:cv:`proxy.config.exec_thread.autoconfig` * :ts:cv:`proxy.config.exec_thread.autoconfig.scale` @@ -196,7 +196,7 @@ On multi-socket servers, such as Intel architectures with NUMA, you can adjust the thread affinity configuration to take advantage of cache pipelines and faster memory access, as well as preventing possibly costly thread migrations across sockets. This is adjusted with :ts:cv:`proxy.config.exec_thread.affinity` -in :file:`records.config`. :: +in :file:`records.yaml`. :: CONFIG proxy.config.exec_thread.affinity INT 1 @@ -224,7 +224,7 @@ instance, if you are not using any hierarchical caching then the parent proxy timeouts will be irrelevant. While all of the timeouts described below may be set globally for your |TS| -instance using :file:`records.config`, many of them are also overridable on a +instance using :file:`records.yaml`, many of them are also overridable on a per-transaction basis by plugins (including :ref:`admin-plugins-conf-remap`). This allows the possibility for adjusting timeout value for individual subsets of your cache. diff --git a/doc/admin-guide/plugins/authproxy.en.rst b/doc/admin-guide/plugins/authproxy.en.rst index c788c632734..ef27ea26f1f 100644 --- a/doc/admin-guide/plugins/authproxy.en.rst +++ b/doc/admin-guide/plugins/authproxy.en.rst @@ -33,7 +33,7 @@ lookup state if a document is found in the cache. This will have the effect of serving the document without consulting the ``AuthProxy`` plugin. you can disable this behavior by setting :ts:cv:`proxy.config.http.doc_in_cache_skip_dns` to ``0`` in -:file:`records.config`. +:file:`records.yaml`. Note that the authorization request will need to match a remap rule (which, as a standalone remap rule, does not need to call the diff --git a/doc/admin-guide/plugins/conf_remap.en.rst b/doc/admin-guide/plugins/conf_remap.en.rst index 1cd19da96ed..d31749d05d9 100644 --- a/doc/admin-guide/plugins/conf_remap.en.rst +++ b/doc/admin-guide/plugins/conf_remap.en.rst @@ -29,7 +29,7 @@ Purpose ======= |TS| provides a plethora of configuration options, but specifying the values of -those options in :file:`records.config` is global. All requests, regardless of +those options in :file:`records.yaml` is global. All requests, regardless of the cache object or its origin, will be evaluated within the same collection of settings. Sometimes you may want |TS| to behave differently for portions of your cache. @@ -91,7 +91,7 @@ Instead of specifying the directives and their values in :file:`remap.config` as you do with the in-line method, you place all the affected directives in a separate text file. The location and name is entirely up to you, but we'll use `/etc/trafficserver/cdn_conf_remap.config` here. The contents of this file -should mirror how configuration directives are written in :file:`records.config`:: +should mirror how configuration directives are written in :file:`records.yaml`:: CONFIG proxy.config.url_remap.pristine_host_hdr INT 1 diff --git a/doc/admin-guide/plugins/header_rewrite.en.rst b/doc/admin-guide/plugins/header_rewrite.en.rst index c251cb6e0ef..f7c21ae1bf1 100644 --- a/doc/admin-guide/plugins/header_rewrite.en.rst +++ b/doc/admin-guide/plugins/header_rewrite.en.rst @@ -683,7 +683,7 @@ set-config Allows you to override the value of a |TS| configuration variable for the current connection. The variables specified by ```` must be overridable. For details on available |TS| configuration variables, consult the -documentation for :file:`records.config`. You can read more about overridable +documentation for :file:`records.yaml`. You can read more about overridable configuration variables in the developer's documentation for :ref:`ts-overridable-config`. diff --git a/doc/admin-guide/plugins/tcpinfo.en.rst b/doc/admin-guide/plugins/tcpinfo.en.rst index 09f87d0abdf..79a9efba38c 100644 --- a/doc/admin-guide/plugins/tcpinfo.en.rst +++ b/doc/admin-guide/plugins/tcpinfo.en.rst @@ -121,7 +121,7 @@ The following options may be specified in :file:`plugin.config`: This logfile option allows you to set logfile rolling behaviour of the output log file without making any changes to the global logging configurations. This option overrides the - :ts:cv:`proxy.config.output.logfile.rolling_enabled` setting in :file:`records.config` + :ts:cv:`proxy.config.output.logfile.rolling_enabled` setting in :file:`records.yaml` for the ``tcpinfo`` plugin. The setting may range from ``0`` to ``3``. ``0`` disables logfile rolling. ``1`` is the ``default`` and enables logfile rolling at specific intervals set by ``--rolling-interval-sec`` discussed diff --git a/doc/admin-guide/plugins/url_sig.en.rst b/doc/admin-guide/plugins/url_sig.en.rst index 5324bbe27c2..37a6a611793 100644 --- a/doc/admin-guide/plugins/url_sig.en.rst +++ b/doc/admin-guide/plugins/url_sig.en.rst @@ -301,7 +301,7 @@ Edge Cache Debugging To include debugging output for this plugin in your |TS| logs, adjust the values for :ts:cv:`proxy.config.diags.debug.enabled` and -:ts:cv:`proxy.config.diags.debug.tags` in your :file:`records.config` as so:: +:ts:cv:`proxy.config.diags.debug.tags` in your :file:`records.yaml` as so:: CONFIG proxy.config.diags.debug.enabled INT 1 CONFIG proxy.config.diags.debug.tags STRING url_sig diff --git a/doc/admin-guide/security/index.en.rst b/doc/admin-guide/security/index.en.rst index 97ddb6c92c6..1c71ddbaf5b 100644 --- a/doc/admin-guide/security/index.en.rst +++ b/doc/admin-guide/security/index.en.rst @@ -106,10 +106,10 @@ Client/|TS| connections, you must do the following: and exchange encryption keys. #. Set the port number used for SSL communication using - :ts:cv:`proxy.config.http.server_ports` in :file:`records.config`. + :ts:cv:`proxy.config.http.server_ports` in :file:`records.yaml`. #. Set the appropriate base path for your SSL certificates and private keys - in :file:`records.config`. :: + in :file:`records.yaml`. :: CONFIG proxy.config.ssl.server.cert.path STRING /opt/ts/etc/ssl/certs/ CONFIG proxy.config.ssl.server.private_key.path STRING /opt/ts/etc/ssl/keys/ @@ -122,7 +122,7 @@ Client/|TS| connections, you must do the following: dest_ip=* ssl_cert_name=default.pem #. *Optional*: Configure the use of client certificates using the variable - :ts:cv:`proxy.config.ssl.client.certification_level` in :file:`records.config`. + :ts:cv:`proxy.config.ssl.client.certification_level` in :file:`records.yaml`. If you configure |TS| to require client certificates, then Traffic Server verifies the client certificate during the SSL handshake that authenticates the client. If you configure |TS| to not require @@ -146,7 +146,7 @@ Client/|TS| connections, you must do the following: #. *Optional*: Configure the use of Certification Authorities (CAs). CAs add security by verifying the identity of the person requesting a certificate. The list of acceptable CA signers is configured with - :ts:cv:`proxy.config.ssl.CA.cert.path` in :file:`records.config`. :: + :ts:cv:`proxy.config.ssl.CA.cert.path` in :file:`records.yaml`. :: CONFIG proxy.config.ssl.CA.cert.path STRING /opt/CA/certs/private-ca.pem @@ -207,7 +207,7 @@ and origin server connections, you must do the following: Certificate Authority recognized by your origin server. If you are using a client certificate, you must add its location to - :file:`records.config` in the setting :ts:cv:`proxy.config.ssl.client.cert.path` + :file:`records.yaml` in the setting :ts:cv:`proxy.config.ssl.client.cert.path` and :ts:cv:`proxy.config.ssl.client.cert.filename`. :: CONFIG proxy.config.ssl.client.cert.path STRING /opt/ts/etc/ssl/certs/ @@ -223,12 +223,12 @@ and origin server connections, you must do the following: #. Enable or disable, per your security policy, server SSL certificate verification using :ts:cv:`proxy.config.ssl.client.verify.server.policy` in - :file:`records.config`. :: + :file:`records.yaml`. :: CONFIG proxy.config.ssl.client.verify.server.policy STRING ENFORCED #. Add the collection of authorized Certificate Authorities to the Traffic - Server configuration in :file:`records.config` using the settings + Server configuration in :file:`records.yaml` using the settings :ts:cv:`proxy.config.ssl.client.CA.cert.path` and :ts:cv:`proxy.config.ssl.client.CA.cert.filename`. :: @@ -310,7 +310,7 @@ Support for OCSP Stapling can be tested using the -status option of the OpenSSL Details of the OCSP Stapling TLS extension can be found in :rfc:`6961`. To configure |TS| to use OCSP Stapling, edit the following variables -in :file:`records.config` file: +in :file:`records.yaml` file: * :ts:cv:`proxy.config.ssl.ocsp.enabled` * :ts:cv:`proxy.config.ssl.ocsp.cache_timeout` @@ -338,7 +338,7 @@ To configure Split DNS: These rules are located in :file:`splitdns.config`. #. Enable the *Split DNS* option by adjusting :ts:cv:`proxy.config.dns.splitDNS.enabled` - in :file:`records.config`. :: + in :file:`records.yaml`. :: CONFIG proxy.config.dns.splitDNS.enabled INT 1 diff --git a/doc/admin-guide/security/mtls.en.rst b/doc/admin-guide/security/mtls.en.rst index 6dd4bff2f51..6a850459730 100644 --- a/doc/admin-guide/security/mtls.en.rst +++ b/doc/admin-guide/security/mtls.en.rst @@ -35,13 +35,13 @@ Otherwise it will fail. Case 1: Require certificates from all User Agents -------------------------------------------------- In this case, you must set the :ts:cv:`proxy.config.ssl.client.certification_level` setting -in :file:`records.config` to 2 to require a client certificate from all user agents. +in :file:`records.yaml` to 2 to require a client certificate from all user agents. Setting this to 0 means that no client certificate is requested. Setting this to 0 means that a client certificate is requested but the handshake proceeds even if one is not provided. There may be problems with some clients and the 1 setting, so staying with values 0 or 2 may be best. If the certificate_level is set to 2, you must also set :ts:cv:`proxy.config.ssl.CA.cert.path` and :ts:cv:`proxy.config.ssl.CA.cert.filename` -in :file:`records.config` to point to a file that contains the certificates of the CA's that +in :file:`records.yaml` to point to a file that contains the certificates of the CA's that would have signed the user agent provided certificates that |TS| receives. Case 2: Apply different certificate requirements depending on the domain requested by the User Agent @@ -54,7 +54,7 @@ cases. This is the FQDN value in the :file:`sni.yaml` file. To control client "verify_client" keyword which can take on the following values: NONE, MODERATE, or STRICT. In the case were |TS| should require certificates from all domains except the health check domain, hc.example.com, -you should set :ts:cv:`proxy.config.ssl.client.certification_level` to 2 in :file:`records.config` and have the +you should set :ts:cv:`proxy.config.ssl.client.certification_level` to 2 in :file:`records.yaml` and have the following in :file:`sni.yaml`. :: sni: @@ -63,7 +63,7 @@ following in :file:`sni.yaml`. :: Similarly, if you only wanted to require client certificates for super.sensitive.example.com, you would set :ts:cv:`proxy.config.ssl.client.certification_level` to 0 in -:file:`records.config` and have the following in :file:`sni.yaml` :: +:file:`records.yaml` and have the following in :file:`sni.yaml` :: sni: - fqdn: super.sensitive.example.com @@ -91,7 +91,7 @@ You can use the verify_client_ca_certs keyword to specialize the CA bundle name For example you expect all client certs to be signed by the roots in client_CA_bundle.pem except for special.example.com where the client certs should be signed by roots in partners_bundle.pem. Then you would set :ts:cv:`proxy.config.ssl.CA.cert.filename` to client_CA_bundle.pem in -:file:`records.config` and you would set the following in :file:`sni.yaml` :: +:file:`records.yaml` and you would set the following in :file:`sni.yaml` :: sni: - fqdn: special.example.com @@ -142,7 +142,7 @@ Case 3: Provide different certificates to origins depending on origin name and r ------------------------------------------------------------------------------------------ In this case you use the conf_remap.so plugin on a remap rule to override the cient_cert definition only for URLs that match that remap rule. You could create the following lines in your :file:`remap.config` to override -the value of :ts:cv:`proxy.config.ssl.client.cert.filename` in :file:`records.config` for specific types of +the value of :ts:cv:`proxy.config.ssl.client.cert.filename` in :file:`records.yaml` for specific types of traffic. In the example below any client traffic with a path that starts with /case1 will use the customer-case1.pem certificate. Any client traffic directed to the hostname bank.example.com and a path that starts with /pci will use the pci.pem certificate. :: diff --git a/doc/appendices/command-line/traffic_crashlog.en.rst b/doc/appendices/command-line/traffic_crashlog.en.rst index 9be4b672827..8f3257d44a0 100644 --- a/doc/appendices/command-line/traffic_crashlog.en.rst +++ b/doc/appendices/command-line/traffic_crashlog.en.rst @@ -84,5 +84,5 @@ carefully before posting it in a public forum. See also ======== -:manpage:`records.config(5)`, +:manpage:`records.yaml(5)`, :manpage:`traffic_server(8)` diff --git a/doc/appendices/command-line/traffic_ctl.en.rst b/doc/appendices/command-line/traffic_ctl.en.rst index c21fbc98393..e3c1493e840 100644 --- a/doc/appendices/command-line/traffic_ctl.en.rst +++ b/doc/appendices/command-line/traffic_ctl.en.rst @@ -171,7 +171,7 @@ Display the current value of a configuration record. .. option:: --records If this flag is provided, :option:`traffic_ctl config get` will emit results in - :file:`records.config` format. + :file:`records.yaml` format. .. program:: traffic_ctl config .. option:: match [--records] REGEX [REGEX...] @@ -199,7 +199,7 @@ Display the current value of a configuration record. :ref:`admin_config_set_records` - Set the named configuration record to the specified value. Refer to the :file:`records.config` + Set the named configuration record to the specified value. Refer to the :file:`records.yaml` documentation for a list of the configuration variables you can specify. Note that this is not a synchronous operation. @@ -601,7 +601,7 @@ when creating the ATS Process, otherwise the `runroot.yaml` will not be set. See also ======== -:manpage:`records.config(5)`, +:manpage:`records.yaml(5)`, :manpage:`storage.config(5)`, :ref:`admin-jsonrpc-configuration`, :ref:`jsonrpc-protocol` diff --git a/doc/appendices/faq.en.rst b/doc/appendices/faq.en.rst index ea248734fbc..4a4e48a1518 100644 --- a/doc/appendices/faq.en.rst +++ b/doc/appendices/faq.en.rst @@ -106,7 +106,7 @@ proxy mode. If you want to run in reverse proxy only mode (wherein Traffic Server does not serve requests that fail to match a map rule), then you must set the configuration variable :ts:cv:`proxy.config.url_remap.remap_required` -to ``1`` in :file:`records.config`. +to ``1`` in :file:`records.yaml`. How do I enable forward proxy mode ---------------------------------- @@ -407,7 +407,7 @@ generated, verify the following: - Make sure you're looking in the correct directory. By default, Traffic Server creates log files in the ``logs`` directory. This can be modified - by changing :ts:cv:`proxy.config.log.logfile_dir` in :file:`records.config`. + by changing :ts:cv:`proxy.config.log.logfile_dir` in :file:`records.yaml`. - Check that the log directory has read/write permissions for the Traffic Server user account. If the log directory does not have the correct @@ -415,9 +415,9 @@ generated, verify the following: open or create log files. - Check that logging is enabled by checking the value of the - :ts:cv:`proxy.config.log.logging_enabled` variable in :file:`records.config`. + :ts:cv:`proxy.config.log.logging_enabled` variable in :file:`records.yaml`. -- Check that a log format is enabled. In :file:`records.config`, select +- Check that a log format is enabled. In :file:`records.yaml`, select the standard or custom format by editing variables in the Logging Config section. @@ -449,7 +449,7 @@ Service Overload If necessary, you can adjust the maximum number of connections supported by Traffic Server by editing :ts:cv:`proxy.config.net.connections_throttle` in -:file:`records.config`. +:file:`records.yaml`. .. note:: @@ -495,7 +495,7 @@ By default, Traffic Server will timeout after 30 seconds when contacting origin servers. If you cannot avoid such timeouts by otherwise addressing the performance on your origin servers, you may adjust the origin connection timeout in Traffic Server by changing :ts:cv:`proxy.config.http.connect_attempts_timeout` -in :file:`records.config` to a larger value. +in :file:`records.yaml` to a larger value. Log entries for some transactions are skipped --------------------------------------------- diff --git a/doc/developer-guide/api/functions/TSAPI.en.rst b/doc/developer-guide/api/functions/TSAPI.en.rst index e8c06fd4cc5..799ae810856 100644 --- a/doc/developer-guide/api/functions/TSAPI.en.rst +++ b/doc/developer-guide/api/functions/TSAPI.en.rst @@ -127,7 +127,7 @@ When Traffic Server is first started, it consults the plugin.config file to determine the names of all shared plugin libraries that need to be loaded. The plugin.config file also defines arguments that are to be passed to each plugin's initialization function, -:func:`TSPluginInit`. The :file:`records.config` file defines the path to +:func:`TSPluginInit`. The :file:`records.yaml` file defines the path to each plugin shared library. The sample :file:`plugin.config` file below contains a comment line, a blank @@ -167,7 +167,7 @@ Files ===== :file:`plugin.config`, -:file:`records.config` +:file:`records.yaml` See Also ======== diff --git a/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst b/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst index c3772122ab9..324ca889590 100644 --- a/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst +++ b/doc/developer-guide/api/functions/TSHttpOverridableConfig.en.rst @@ -42,7 +42,7 @@ Synopsis Description =========== -Some of the values that are set in :file:`records.config` can be changed for a +Some of the values that are set in :file:`records.yaml` can be changed for a specific transaction. It is important to note that these functions change the configuration values stored for the transaction, which is not quite the same as changing the actual operating values of the transaction. The critical effect is diff --git a/doc/developer-guide/api/functions/TSMgmtSourceGet.en.rst b/doc/developer-guide/api/functions/TSMgmtSourceGet.en.rst index 6839b5044c7..c941744b8cf 100644 --- a/doc/developer-guide/api/functions/TSMgmtSourceGet.en.rst +++ b/doc/developer-guide/api/functions/TSMgmtSourceGet.en.rst @@ -60,7 +60,7 @@ Types .. macro:: TS_MGMT_SOURCE_EXPLICIT - The value has been set in :file:`records.config`. Note this value is returned even if the + The value has been set in :file:`records.yaml`. Note this value is returned even if the variable was explicitly set to the default value. .. macro:: TS_MGMT_SOURCE_ENV diff --git a/doc/developer-guide/api/functions/TSRecords.en.rst b/doc/developer-guide/api/functions/TSRecords.en.rst index b52cb39d4b1..b227831b6ce 100644 --- a/doc/developer-guide/api/functions/TSRecords.en.rst +++ b/doc/developer-guide/api/functions/TSRecords.en.rst @@ -46,7 +46,7 @@ Description :func:`TSMgmtStringCreate` registers :arg:`name` as a configuration name and sets its various properties. If :arg:`check_type` is :member:`TS_RECORDCHECK_STR` then :arg:`check_reg` must be point to a valid regular expression to use to check the string value. -If a plugin uses a value from :file:`records.config` that is not built in to |TS| it must use this function or the value will be inaccessible and a warning for that name will be generated. +If a plugin uses a value from :file:`records.yaml` that is not built in to |TS| it must use this function or the value will be inaccessible and a warning for that name will be generated. Return Values ============= diff --git a/doc/developer-guide/api/functions/TSSslServerContextCreate.en.rst b/doc/developer-guide/api/functions/TSSslServerContextCreate.en.rst index 097044c33af..37715c42ce3 100644 --- a/doc/developer-guide/api/functions/TSSslServerContextCreate.en.rst +++ b/doc/developer-guide/api/functions/TSSslServerContextCreate.en.rst @@ -37,7 +37,7 @@ Description =========== :func:`TSSslServerContextCreate` creates a new TLS server context. The context -is configured using the TLS settings specified in :file:`records.config`. The user can pass certificate object(:type:`TSSslX509` :arg:`cert` +is configured using the TLS settings specified in :file:`records.yaml`. The user can pass certificate object(:type:`TSSslX509` :arg:`cert` and certname (:code:`const char*` :arg:`certname`) optionally. This function sets the certificate status callback and initializes OCSP stapling data if :arg:`cert` and :arg:`certname` is provided and ocsp is enabled globally. :func:`TSSslServerContextCreate` returns ``nullptr`` on failure. diff --git a/doc/developer-guide/cache-architecture/architecture.en.rst b/doc/developer-guide/cache-architecture/architecture.en.rst index 7e9bb4a6f70..533991ff416 100644 --- a/doc/developer-guide/cache-architecture/architecture.en.rst +++ b/doc/developer-guide/cache-architecture/architecture.en.rst @@ -598,7 +598,7 @@ a single unit of the multiplier. .. _target-fragment-size: -The target fragment size can set with the :file:`records.config` value +The target fragment size can set with the :file:`records.yaml` value :ts:cv:`proxy.config.cache.target_fragment_size`. This value should be chosen so that it is a multiple of a @@ -715,11 +715,11 @@ as appropriate in the sections on the relevant operations. The set of things which can affect cacheability are: * Built in constraints. -* Settings in :file:`records.config`. +* Settings in :file:`records.yaml`. * Settings in :file:`cache.config`. * Plugin operations. -The initial internal checks, along with their :file:`records.config` +The initial internal checks, along with their :file:`records.yaml` overrides[#cacheability-overrides]_, are done in ``HttpTransact::is_request_cache_lookupable``. The checks that are done are: @@ -746,7 +746,7 @@ The checks that are done are: Range Request Cache valid only if :ts:cv:`proxy.config.http.cache.range.lookup` in - :file:`records.config` is non-zero. This does not mean the range request + :file:`records.yaml` is non-zero. This does not mean the range request can be cached, only that it might be satisfiable from the cache. In addition, :ts:cv:`proxy.config.http.cache.range.write` can be set to try to force a write on a range request. This @@ -814,7 +814,7 @@ information. This will always contain the HTTP headers for all serving an object from cache in one transaction while it is being written in another. Several settings are needed for it to be used. See :ref:`admin-configuration-reducing-origin-requests`. It must - specifically enabled in :file:`records.config` and if not, a cache read will + specifically enabled in :file:`records.yaml` and if not, a cache read will fail if the object is currently be written or updated. At this point an alternate for the object is selected. This is done by comparing @@ -841,7 +841,7 @@ After these checks the object age is calculated by ``HttpTransactHeaders::calcul and then any configured fuzzing is applied. The limits to this age based on available data is calculated by ``HttpTransact::calculate_document_freshness_limit``. -How this age is used is determined by the :file:`records.config` setting for +How this age is used is determined by the :file:`records.yaml` setting for :ts:cv:`proxy.config.http.cache.when_to_revalidate`. If this is ``0`` then the built calculations are used which compare the freshness limits with document age, modified by any of the client supplied cache control values (``max-age``, @@ -1090,7 +1090,7 @@ appropriate evacuation bucket. .. [#cache-mult-value] - The comment in earlier versions of the :file:`records.config` documentation + The comment in earlier versions of the :file:`records.yaml` documentation which indicated that this value must be a power of two were, unfortunately, mistaken and have been corrected. diff --git a/doc/developer-guide/config-vars.en.rst b/doc/developer-guide/config-vars.en.rst index b693396bc7e..890eeb064c1 100644 --- a/doc/developer-guide/config-vars.en.rst +++ b/doc/developer-guide/config-vars.en.rst @@ -61,7 +61,7 @@ Configuration Variable Implementation ************************************* -Adding a new configuration variable in :file:`records.config` requires a number +Adding a new configuration variable in :file:`records.yaml` requires a number of steps which are mostly documented here. Before adding a new configuration variable, please discuss it on the mailing @@ -182,7 +182,7 @@ dynamic if possible. Documentation and Defaults -------------------------- -A configuration variable should be documented in :file:`records.config`. There +A configuration variable should be documented in :file:`records.yaml`. There are many examples in the file already that can be used for guidance. The general format is to use the tag :: @@ -218,9 +218,9 @@ can use the form :: This will display the name as a link to the full definition. In general, a new configuration variable should not be present in the default -:file:`records.config`. If it is added, such defaults should be added to the +:file:`records.yaml`. If it is added, such defaults should be added to the file ``proxy/config/records.config.default.in``. This is used to generate the -default :file:`records.config`. Just add the variable to the file in an +default :file:`records.yaml`. Just add the variable to the file in an appropriate place with a proper default as this will now override whatever default you put in the code for new installs. @@ -229,7 +229,7 @@ Handling Updates The simplest mechanism for handling updates is the ``REC_EstablishStaticConfigXXX`` family of functions. This mechanism will cause the value in the indicated -instance to be updated in place when an update to :file:`records.config` occurs. +instance to be updated in place when an update to :file:`records.yaml` occurs. This is done asynchronously using atomic operations. Use of these variables must keep that in mind. diff --git a/doc/developer-guide/debugging/debug-builds.en.rst b/doc/developer-guide/debugging/debug-builds.en.rst index 099312bf7e9..ccffa778be7 100644 --- a/doc/developer-guide/debugging/debug-builds.en.rst +++ b/doc/developer-guide/debugging/debug-builds.en.rst @@ -25,7 +25,7 @@ Debug Builds A debugger can set breakpoints in a plugin. Use a Traffic Server debug build and compile the plugin with the ``-g`` option. A debugger can also be used to analyze a core dump. To generate core, set the size limit of -the core files in the :file:`records.config` file to -1 as follows: +the core files in the :file:`records.yaml` file to -1 as follows: :: diff --git a/doc/developer-guide/debugging/debug-tags.en.rst b/doc/developer-guide/debugging/debug-tags.en.rst index d15d4c33a23..342f6087ac0 100644 --- a/doc/developer-guide/debugging/debug-tags.en.rst +++ b/doc/developer-guide/debugging/debug-tags.en.rst @@ -61,7 +61,7 @@ below: traffic_server -T"my-plugin" -Sets the following variables in :file:`records.config` (in the Traffic Server +Sets the following variables in :file:`records.yaml` (in the Traffic Server ``config`` directory): :: diff --git a/doc/developer-guide/debugging/memory-leaks.en.rst b/doc/developer-guide/debugging/memory-leaks.en.rst index 23d451626ba..2d7563071f8 100644 --- a/doc/developer-guide/debugging/memory-leaks.en.rst +++ b/doc/developer-guide/debugging/memory-leaks.en.rst @@ -24,7 +24,7 @@ Memory Leaks Memory leaks in a plugin can be detected using e.g. an MRTG graph related to memory - you can use memory dump information. Enable -``mem dump`` in :file:`records.config` as follows: +``mem dump`` in :file:`records.yaml` as follows: :: diff --git a/doc/developer-guide/design-documents/reloading-plugins.en.rst b/doc/developer-guide/design-documents/reloading-plugins.en.rst index 14e7aec95ae..6e6712b520f 100644 --- a/doc/developer-guide/design-documents/reloading-plugins.en.rst +++ b/doc/developer-guide/design-documents/reloading-plugins.en.rst @@ -30,7 +30,7 @@ configuration reload, i.e.:: traffic_ctl config reload -This feature is enabled by default. It can be turned off by setting the configuration variable :ts:cv:`proxy.config.plugin.dynamic_reload_mode` to ``0`` in :file:`records.config`. When the feature is turned off, once ATS is started one will be able load only one version of a plugin, and re-loading the same plugin would do nothing. +This feature is enabled by default. It can be turned off by setting the configuration variable :ts:cv:`proxy.config.plugin.dynamic_reload_mode` to ``0`` in :file:`records.yaml`. When the feature is turned off, once ATS is started one will be able load only one version of a plugin, and re-loading the same plugin would do nothing. Although plugin reloading should be transparent to plugin developers, the following are some design considerations and implementation details for this feature. diff --git a/doc/developer-guide/documentation/ts-markup.en.rst b/doc/developer-guide/documentation/ts-markup.en.rst index d0188ece3a3..45f09fa4240 100644 --- a/doc/developer-guide/documentation/ts-markup.en.rst +++ b/doc/developer-guide/documentation/ts-markup.en.rst @@ -55,7 +55,7 @@ argument (the default value). :: :ts:cv: -This corresponds exactly to the line in :file:`records.config`. +This corresponds exactly to the line in :file:`records.yaml`. Definition ~~~~~~~~~~ diff --git a/doc/developer-guide/host-resolution-proposal.en.rst b/doc/developer-guide/host-resolution-proposal.en.rst index a1a5272d85e..c0948859db6 100644 --- a/doc/developer-guide/host-resolution-proposal.en.rst +++ b/doc/developer-guide/host-resolution-proposal.en.rst @@ -115,7 +115,7 @@ Configuration To configuration the resolution, each resolver would be assigned a tag. It is not, however, sufficient to simply provide the list of resolver tags because some resolvers require additional configuration. Unfortunately this will likely -require a separate configuration file outside of :file:`records.config`, although we would be able to remove +require a separate configuration file outside of :file:`records.yaml`, although we would be able to remove :file:`splitdns.config`. In this case we would need chain start / end markers around a list of resolver tags. Each tag would the be able to take additional resolver configuration data. For instance, for a SplitDNS resolver the nameservers. diff --git a/doc/developer-guide/plugins/getting-started/a-simple-plugin.en.rst b/doc/developer-guide/plugins/getting-started/a-simple-plugin.en.rst index 04f6a32a18d..2b53d5c5170 100644 --- a/doc/developer-guide/plugins/getting-started/a-simple-plugin.en.rst +++ b/doc/developer-guide/plugins/getting-started/a-simple-plugin.en.rst @@ -32,7 +32,7 @@ simple Traffic Server plugin. You'll follow the steps below: 3. Add an entry to :file:`plugin.config`. -4. Add the path to your plugin shared library into :file:`records.config`. +4. Add the path to your plugin shared library into :file:`records.yaml`. 5. Restart Traffic Server. @@ -82,7 +82,7 @@ Specify the Plugin's Location All plugins must be located in the directory specified by the configuration variable ``proxy.config.plugin.plugin_dir``, which is -located in the :file:`records.config` file. The directory can be specified +located in the :file:`records.yaml` file. The directory can be specified as an absolute or relative path. If a relative path is used, then the starting directory will be the @@ -115,6 +115,6 @@ plugin. In the example above, Traffic Server notes are directed to the console by specifying ``E`` for :ts:cv:`proxy.config.diags.output.note` in - :file:`records.config`. The second note shows Traffic Server attempting to + :file:`records.yaml`. The second note shows Traffic Server attempting to load the ``hello_world`` plugin. The third line of Traffic Server output is from your plugin. diff --git a/doc/developer-guide/plugins/getting-started/index.en.rst b/doc/developer-guide/plugins/getting-started/index.en.rst index f300673e0cc..33d92314068 100644 --- a/doc/developer-guide/plugins/getting-started/index.en.rst +++ b/doc/developer-guide/plugins/getting-started/index.en.rst @@ -162,7 +162,7 @@ When Traffic Server is first started, it consults the ``plugin.config`` file to determine the names of all shared plugin libraries that need to be loaded. The ``plugin.config`` file also defines arguments that are to be passed to each plugin's initialization function, ``TSPluginInit``. -The :file:`records.config` file defines the path to each plugin shared +The :file:`records.yaml` file defines the path to each plugin shared library, as described in :ref:`specify-the-plugins-location`. .. note:: The path for each of these files is **\ ``/config/``, where ** is where you installed Traffic Server. diff --git a/doc/developer-guide/plugins/plugin-management/settings-and-statistics.en.rst b/doc/developer-guide/plugins/plugin-management/settings-and-statistics.en.rst index 1cd4bcf1bec..7c1256c8d37 100644 --- a/doc/developer-guide/plugins/plugin-management/settings-and-statistics.en.rst +++ b/doc/developer-guide/plugins/plugin-management/settings-and-statistics.en.rst @@ -24,21 +24,21 @@ Settings and Statistics Your plugin might need to know information about Traffic Server's current configuration and performance. The functions described in this -section read this information from the Traffic Server :file:`records.config` +section read this information from the Traffic Server :file:`records.yaml` file. Configuration settings are stored in ``CONFIG`` variables and statistics are stored in ``PROCESS`` variables. .. caution:: - Not all ``CONFIG`` and ``PROCESS`` variables in :file:`records.config` are + Not all ``CONFIG`` and ``PROCESS`` variables in :file:`records.yaml` are relevant to Traffic Server's configuration and statistics. Therefore, - retrieve only the :file:`records.config` variables that are documented in + retrieve only the :file:`records.yaml` variables that are documented in the :ref:`admin-guide`. To retrieve a variable, you need to know its type (``int``, ``counter``, -``float``, or ``string``). Plugins store the :file:`records.config` values +``float``, or ``string``). Plugins store the :file:`records.yaml` values as an ``TSMgmtInt``, ``TSMgmtCounter``, ``TSMgmtFloat``, or -``TSMgmtString``. You can look up :file:`records.config` variable types in +``TSMgmtString``. You can look up :file:`records.yaml` variable types in the :ref:`admin-guide`. Depending on the result type, you'll use ``TSMgmtIntGet``, diff --git a/doc/ext/traffic-server.py b/doc/ext/traffic-server.py index 71edfb6df2e..ffe50087fe1 100644 --- a/doc/ext/traffic-server.py +++ b/doc/ext/traffic-server.py @@ -37,6 +37,7 @@ import os import subprocess import re +import yaml # 2/3 compat logic try: @@ -49,6 +50,17 @@ def is_string_type(s): return isinstance(s, str) +def get_code(data): + + def float_representer(dumper, value): + return dumper.represent_scalar(u'tag:yaml.org,2002:float', str(value), style="'") + + # We want to show that the !!float should be set! + yaml.add_representer(float, float_representer) + + return yaml.dump(data) + + class TSConfVar(std.Target): """ Description of a traffic server configuration variable. @@ -67,12 +79,76 @@ class TSConfVar(std.Target): 'deprecated': rst.directives.flag, 'overridable': rst.directives.flag, 'units': rst.directives.unchanged, + 'legacy': rst.directives.flag, } required_arguments = 3 optional_arguments = 1 # default is optional, special case if omitted final_argument_whitespace = True has_content = True + def __generate_code(self, cv_name, cv_default, cv_type): + def add_object(config, var, value, type=None): + def get_value(type, value): + + def have_multipliers(value, mps): + for m in mps: + if value.endswith(m): + return True + + return False + + if value is None or value == 'nullptr' or value == 'NULL': + return None + + # We want to make the type right when inserting the element into the dict. + if type == 'FLOAT': + return float(value) + elif type == 'INT': + # We need to make it YAML compliant as this will be an int, so if contains + # any special character like hex or a multiplier, then we make a string. ATS will + # parse it as string anyway. + if value.startswith('0x') or have_multipliers(value, ['K', 'M', 'G', 'T']): + return str(value) + else: + return int(value) + elif type == 'STRING': + return str(value) + + return None + + obj = {} + key = '' + index = var.find('.') + if index < 0: # last part + config[var] = get_value(type, value) + else: + key = var[:index] + if key not in config: + config[key] = {} + + add_object(config[key], var[index + 1:], value, type=type) + + name = cv_name + if name.startswith("proxy.config."): + name = name[len("proxy.config."):] + elif name.startswith("local.config."): + name = name[len("local.config."):] + + ts = {} + config = {} + + # Build the object + add_object(config, name, cv_default, cv_type) + ts['ts'] = config + code = get_code(ts) + literal = nodes.literal_block(code, code) + literal['linenos'] = True + literal['force'] = True + literal['language'] = 'yaml' + literal['caption'] = 'records.yaml' + + return literal + def make_field(self, tag, value): field = nodes.field() field.append(nodes.field_name(text=tag)) @@ -140,6 +216,15 @@ def run(self): if ('deprecated' in self.options): fl.append(self.make_field('Deprecated', 'Yes')) + # add yaml rep if record is not legacy. + code_block = None + code_block_title = None + if 'legacy' not in self.options: + code_block = self.__generate_code(cv_name, cv_default, cv_type) + code_block_title = sphinx.addnodes.compact_paragraph(text="yaml-rep:") + self.add_name(code_block_title) + self.add_name(code_block) + # Get any contained content nn = nodes.compound() self.state.nested_parse(self.content, self.content_offset, nn) @@ -156,8 +241,10 @@ def run(self): indexnode['entries'].append( ('single', _('%s') % cv_name, nodes.make_id(cv_name), '') ) - - return [indexnode, node, fl, nn] + if code_block is None: + return [indexnode, node, fl, nn] + else: + return [indexnode, node, fl, code_block_title, code_block, nn] class TSConfVarRef(XRefRole): diff --git a/doc/getting-started/index.en.rst b/doc/getting-started/index.en.rst index fbd4ca7a3f7..070d142fc59 100644 --- a/doc/getting-started/index.en.rst +++ b/doc/getting-started/index.en.rst @@ -242,7 +242,7 @@ networks, as long as |TS| is able to reach the origin host. Enable Reverse Proxying ~~~~~~~~~~~~~~~~~~~~~~~ -Within the :file:`records.config` configuration file, ensure that the following +Within the :file:`records.yaml` configuration file, ensure that the following settings have been configured as shown below:: CONFIG proxy.config.http.cache.http INT 1 @@ -374,7 +374,7 @@ Final Configurations Once completed, the following configuration files for |AW| contain the following entries: -:file:`records.config`:: +:file:`records.yaml`:: CONFIG proxy.config.http.cache.http INT 1 CONFIG proxy.config.reverse_proxy.enabled INT 1 @@ -416,7 +416,7 @@ Enable Forward Proxying Contrary to a reverse proxy, where you have a defined list of origin servers for which you wish to proxy (and optionally cache), a forward proxy is used to proxy (and optionally cache) for arbitrary remote hosts. As such, the following -settings in :file:`records.config` are the base configuration for a minimal +settings in :file:`records.yaml` are the base configuration for a minimal forward proxy:: CONFIG proxy.config.url_remap.remap_required INT 0 diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/cache-basics.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/cache-basics.en.po index e0ca0c4a184..92817ae091f 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/cache-basics.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/cache-basics.en.po @@ -330,7 +330,7 @@ msgid "" "and :ts:cv:`proxy.config.http.cache.heuristic_max_lifetime` in :file:" "`records.config`." msgstr "" -":file:`records.config` 内の :ts:cv:`proxy.config.http.cache." +":file:`records.yaml` 内の :ts:cv:`proxy.config.http.cache." "heuristic_min_lifetime` 変数と :ts:cv:`proxy.config.http.cache." "heuristic_max_lifetime` 変数を編集してください。" @@ -368,7 +368,7 @@ msgid "" "Change the value for :ts:cv:`proxy.config.http.cache.required_headers` in :" "file:`records.config`." msgstr "" -":file:`records.config` 内の :ts:cv:`proxy.config.http.cache." +":file:`records.yaml` 内の :ts:cv:`proxy.config.http.cache." "required_headers` の値を変更してください。" #: ../../../admin-guide/configuration/cache-basics.en.rst:198 @@ -583,7 +583,7 @@ msgid "" "Edit the variable :ts:cv:`proxy.config.http.cache.when_to_revalidate` in :" "file:`records.config`." msgstr "" -":file:`records.config` の :ts:cv:`proxy.config.http.cache." +":file:`records.yaml` の :ts:cv:`proxy.config.http.cache." "when_to_revalidate` を編集してください。" #: ../../../admin-guide/configuration/cache-basics.en.rst:286 @@ -625,7 +625,7 @@ msgid "" "Update :ts:cv:`proxy.config.http.push_method_enabled` in :file:`records." "config`::" msgstr "" -":file:`records.config` の :ts:cv:`proxy.config.http.push_method_enabled` を" +":file:`records.yaml` の :ts:cv:`proxy.config.http.push_method_enabled` を" "更新してください ::" #: ../../../admin-guide/configuration/cache-basics.en.rst:305 @@ -716,7 +716,7 @@ msgid "" "Enable :ts:cv:`proxy.config.cache.permit.pinning` in :file:`records." "config`::" msgstr "" -":file:`records.config` の :ts:cv:`proxy.config.cache.permit.pinning` を有効" +":file:`records.yaml` の :ts:cv:`proxy.config.cache.permit.pinning` を有効" "にしてください。" #: ../../../admin-guide/configuration/cache-basics.en.rst:355 @@ -834,7 +834,7 @@ msgid "" "Edit :ts:cv:`proxy.config.http.cache.ignore_client_no_cache` in :file:" "`records.config`. ::" msgstr "" -":file:`records.config` の :ts:cv:`proxy.config.http.cache." +":file:`records.yaml` の :ts:cv:`proxy.config.http.cache." "ignore_client_no_cache` を編集してください。" #: ../../../admin-guide/configuration/cache-basics.en.rst:416 @@ -915,7 +915,7 @@ msgid "" "Edit :ts:cv:`proxy.config.http.cache.ignore_server_no_cache` in :file:" "`records.config`. ::" msgstr "" -":file:`records.config` の :ts:cv:`proxy.config.http.cache." +":file:`records.yaml` の :ts:cv:`proxy.config.http.cache." "ignore_server_no_cache ` を編集してください。" #: ../../../admin-guide/configuration/cache-basics.en.rst:460 @@ -963,7 +963,7 @@ msgid "" "Edit :ts:cv:`proxy.config.http.cache.ignore_authentication` in :file:" "`records.config`. ::" msgstr "" -":file:`records.config` の :ts:cv:`proxy.config.http.cache." +":file:`records.yaml` の :ts:cv:`proxy.config.http.cache." "ignore_authentication ` を編集してください。" #: ../../../admin-guide/configuration/cache-basics.en.rst:486 @@ -1038,7 +1038,7 @@ msgid "" "Set :ts:cv:`proxy.config.http.cache.http` to ``0`` in :file:`records." "config`. ::" msgstr "" -":file:`records.config` の :ts:cv:`proxy.config.http.enabled` を ``0`` に設定" +":file:`records.yaml` の :ts:cv:`proxy.config.http.enabled` を ``0`` に設定" "してください ::" #: ../../../admin-guide/configuration/cache-basics.en.rst:523 @@ -1072,7 +1072,7 @@ msgid "" "`records.config`. To disable caching, set the variable to ``0``, and to " "explicitly permit caching use ``1``. ::" msgstr "" -":file:`records.config` の :ts:cv:`proxy.config.http.cache." +":file:`records.yaml` の :ts:cv:`proxy.config.http.cache." "cache_urls_that_look_dynamic` を編集してください。キャッシュを無効にするに" "は ``0`` に設定し、明示的にキャッシュを許可するには ``1`` に設定してくださ" "い。 ::" @@ -1118,7 +1118,7 @@ msgid "" "Edit :ts:cv:`proxy.config.http.cache.cache_responses_to_cookies` in :file:" "`records.config`." msgstr "" -":file:`records.config` の :ts:cv:`proxy.config.http.cache." +":file:`records.yaml` の :ts:cv:`proxy.config.http.cache." "cache_responses_to_cookies` を編集してください。" #: ../../../admin-guide/configuration/cache-basics.en.rst:571 @@ -1183,8 +1183,8 @@ msgid "To configure how Traffic Server caches alternates:" msgstr "Traffic Server が代替をキャッシュするように設定するには :" #: ../../../admin-guide/configuration/cache-basics.en.rst:605 -msgid "Edit the following variables in :file:`records.config`:" -msgstr ":file:`records.config` の次の変数を編集してください :" +msgid "Edit the following variables in :file:`records.yaml`:" +msgstr ":file:`records.yaml` の次の変数を編集してください :" #: ../../../admin-guide/configuration/cache-basics.en.rst:616 msgid "" @@ -1229,7 +1229,7 @@ msgid "" "Edit :ts:cv:`proxy.config.cache.limits.http.max_alts` in :file:`records." "config`. ::" msgstr "" -":file:`records.config` の :ts:cv:`proxy.config.cache.limits.http.max_alts` " +":file:`records.yaml` の :ts:cv:`proxy.config.cache.limits.http.max_alts` " "を編集してください ::" #: ../../../admin-guide/configuration/cache-basics.en.rst:645 @@ -1257,7 +1257,7 @@ msgid "" "Set :ts:cv:`proxy.config.http.congestion_control.enabled` to ``1`` in :file:" "`records.config`. ::" msgstr "" -":file:`records.config` の :ts:cv:`proxy.config.http.congestion_control." +":file:`records.yaml` の :ts:cv:`proxy.config.http.congestion_control." "enabled` を ``1`` にセットしてください ::" #: ../../../admin-guide/configuration/cache-basics.en.rst:659 @@ -1504,10 +1504,10 @@ msgstr "" #: ../../../admin-guide/configuration/cache-basics.en.rst:758 msgid "" -"The following settings must be made in :file:`records.config` to enable " +"The following settings must be made in :file:`records.yaml` to enable " "read-while-writer functionality in ATS::" msgstr "" -"ATS で read-while-writer 機能を有効にするには :file:`records.config` で以下" +"ATS で read-while-writer 機能を有効にするには :file:`records.yaml` で以下" "の設定を行う必要があります ::" #: ../../../admin-guide/configuration/cache-basics.en.rst:766 @@ -1592,10 +1592,10 @@ msgstr "" #: ../../../admin-guide/configuration/cache-basics.en.rst:809 msgid "" "Traffic Server can be set to attempt to revalidate an object before it " -"becomes stale in cache. :file:`records.config` contains the settings::" +"becomes stale in cache. :file:`records.yaml` contains the settings::" msgstr "" "Traffic Server はキャッシュが新鮮でなくなる前に、オブジェクトの再確認を試み" -"るように設定することもできす。:file:`records.config` に次の設定があります ::" +"るように設定することもできす。:file:`records.yaml` に次の設定があります ::" #: ../../../admin-guide/configuration/cache-basics.en.rst:816 msgid "" diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/redirecting-http-requests.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/redirecting-http-requests.en.po index 68f4d998437..a81cf471e04 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/redirecting-http-requests.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/redirecting-http-requests.en.po @@ -193,7 +193,7 @@ msgid "" "Edit :ts:cv:`proxy.config.reverse_proxy.enabled` in :file:`records." "config`. ::" msgstr "" -":file:`records.config` にある :ts:cv:`proxy.config.reverse_proxy.enabled` を" +":file:`records.yaml` にある :ts:cv:`proxy.config.reverse_proxy.enabled` を" "編集してください ::" #: ../../admin-guide/configuration/redirecting-http-requests.en.rst:324 @@ -542,7 +542,7 @@ msgid "" "Traffic Server provides several reverse proxy configuration options in :" "file:`records.config` that enable you to:" msgstr "" -"Traffic Server は :file:`records.config` でいくつかのリバースプロキシー設定" +"Traffic Server は :file:`records.yaml` でいくつかのリバースプロキシー設定" "オプションを提供し次のことを可能にします。" #: ../../admin-guide/configuration/redirecting-http-requests.en.rst:243 diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/transparent-forward-proxying.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/transparent-forward-proxying.en.po index 13f8b27e02b..cd6c594f770 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/transparent-forward-proxying.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/transparent-forward-proxying.en.po @@ -102,14 +102,14 @@ msgstr "" msgid "" "Permit Traffic Server to process requests for hosts not explicitly " "configured in the remap rules, by modifying :ts:cv:`proxy.config.url_remap." -"remap_required` in :file:`records.config`::" +"remap_required` in :file:`records.yaml`::" msgstr "" #: ../../admin-guide/configuration/transparent-forward-proxying.en.rst:73 msgid "" "*Optional*: If Traffic Server will be operating strictly as a forward " "proxy, you will want to disable reverse proxy support by modifying :ts:cv:" -"`proxy.config.reverse_proxy.enabled` in :file:`records.config`::" +"`proxy.config.reverse_proxy.enabled` in :file:`records.yaml`::" msgstr "" #: ../../admin-guide/configuration/transparent-forward-proxying.en.rst:79 diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/transparent-proxy/bridge.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/transparent-proxy/bridge.en.po index 052c1f6a4ab..8170bd9e402 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/transparent-proxy/bridge.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/transparent-proxy/bridge.en.po @@ -201,7 +201,7 @@ msgid "" "To configure Traffic Server set the following values in :file:`records." "config`" msgstr "" -"Traffic Server を設定するために次の値を :file:`records.config` に設定してく" +"Traffic Server を設定するために次の値を :file:`records.yaml` に設定してく" "ださい。" #: ../../../admin-guide/configuration/transparent-proxy/bridge.en.rst:128 diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/transparent-proxy/wccp-configuration.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/transparent-proxy/wccp-configuration.en.po index c53843de076..c7c101e2901 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/transparent-proxy/wccp-configuration.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/configuration/transparent-proxy/wccp-configuration.en.po @@ -110,7 +110,7 @@ msgid "" "Finally Traffic Server itself must be configured for transparency and use " "of WCCP. The former is again very similar to the standard use, while WCCP " "configuration is specific to WCCP and uses a separate configuration file, " -"referred to by the :file:`records.config` file." +"referred to by the :file:`records.yaml` file." msgstr "" #: ../../../admin-guide/configuration/transparent-proxy/wccp-configuration.en.rst:75 diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/configuring-traffic-server.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/configuring-traffic-server.en.po index 9e2d2441980..a80d66116ef 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/configuring-traffic-server.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/configuring-traffic-server.en.po @@ -94,7 +94,7 @@ msgstr "設定ファイルを使用して Traffic Server を設定する" #: ../../../admin-guide/configuring-traffic-server.en.rst:61 msgid "" "You can change Traffic Server configuration options by manually editing " -"specific variables in :file:`records.config`." +"specific variables in :file:`records.yaml`." msgstr "" #: ../../../admin-guide/configuring-traffic-server.en.rst:65 @@ -108,8 +108,8 @@ msgstr "" "かの設定では Traffic Server の完全な再起動が必要となります。" #: ../../../admin-guide/configuring-traffic-server.en.rst:69 -msgid "The following is a sample portion of :file:`records.config`:" -msgstr "以下は :file:`records.config` ファイルの部分的なサンプルです" +msgid "The following is a sample portion of :file:`records.yaml`:" +msgstr "以下は :file:`records.yaml` ファイルの部分的なサンプルです" #: ../../../admin-guide/configuring-traffic-server.en.rst:75 msgid "Sample records.config file" @@ -117,7 +117,7 @@ msgstr "records.config ファイルのサンプル" #: ../../../admin-guide/configuring-traffic-server.en.rst:77 msgid "" -"In addition to :file:`records.config`, Traffic Server provides other " +"In addition to :file:`records.yaml`, Traffic Server provides other " "configuration files that are used to configure specific features. You can " "manually edit all configuration files as described in :ref:`admin-" "configuration-files`." diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/files/records.config.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/files/records.config.en.po index 73d6ef9f433..ccc16771219 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/files/records.config.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/files/records.config.en.po @@ -27,129 +27,129 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.2.0\n" -#: ../../../admin-guide/files/records.config.en.rst:23 +#: ../../../admin-guide/files/records.yaml.en.rst:23 msgid "records.config" msgstr "records.config" -#: ../../../admin-guide/files/records.config.en.rst:25 +#: ../../../admin-guide/files/records.yaml.en.rst:25 msgid "" -"The :file:`records.config` file (by default, located in ``/usr/local/etc/" +"The :file:`records.yaml` file (by default, located in ``/usr/local/etc/" "trafficserver/``) is a list of configurable variables used by the |TS| " -"software. Many of the variables in :file:`records.config` are set " +"software. Many of the variables in :file:`records.yaml` are set " "automatically when you set configuration options in Traffic Line. After you " -"modify :file:`records.config`, run the command :option:`traffic_ctl config " +"modify :file:`records.yaml`, run the command :option:`traffic_ctl config " "reload` to apply the changes." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:34 +#: ../../../admin-guide/files/records.yaml.en.rst:34 msgid "Format" msgstr "フォーマット" -#: ../../../admin-guide/files/records.config.en.rst:36 +#: ../../../admin-guide/files/records.yaml.en.rst:36 msgid "Each variable has the following format::" msgstr "それぞれの変数は次のフォーマットとなっています" -#: ../../../admin-guide/files/records.config.en.rst:41 -#: ../../../admin-guide/files/records.config.en.rst:48 +#: ../../../admin-guide/files/records.yaml.en.rst:41 +#: ../../../admin-guide/files/records.yaml.en.rst:48 #, fuzzy msgid "Scope" msgstr "compress" -#: ../../../admin-guide/files/records.config.en.rst:48 -#: ../../../admin-guide/files/records.config.en.rst:60 -#: ../../../admin-guide/files/records.config.en.rst:81 -#: ../../../admin-guide/files/records.config.en.rst:276 -#: ../../../admin-guide/files/records.config.en.rst:835 -#: ../../../admin-guide/files/records.config.en.rst:850 -#: ../../../admin-guide/files/records.config.en.rst:879 -#: ../../../admin-guide/files/records.config.en.rst:899 -#: ../../../admin-guide/files/records.config.en.rst:936 -#: ../../../admin-guide/files/records.config.en.rst:972 -#: ../../../admin-guide/files/records.config.en.rst:1007 -#: ../../../admin-guide/files/records.config.en.rst:1056 -#: ../../../admin-guide/files/records.config.en.rst:1497 -#: ../../../admin-guide/files/records.config.en.rst:1628 -#: ../../../admin-guide/files/records.config.en.rst:1740 -#: ../../../admin-guide/files/records.config.en.rst:1776 -#: ../../../admin-guide/files/records.config.en.rst:1797 -#: ../../../admin-guide/files/records.config.en.rst:1992 -#: ../../../admin-guide/files/records.config.en.rst:2134 -#: ../../../admin-guide/files/records.config.en.rst:2157 -#: ../../../admin-guide/files/records.config.en.rst:2188 -#: ../../../admin-guide/files/records.config.en.rst:2200 -#: ../../../admin-guide/files/records.config.en.rst:2216 -#: ../../../admin-guide/files/records.config.en.rst:2224 -#: ../../../admin-guide/files/records.config.en.rst:2251 -#: ../../../admin-guide/files/records.config.en.rst:2435 -#: ../../../admin-guide/files/records.config.en.rst:2580 -#: ../../../admin-guide/files/records.config.en.rst:2677 -#: ../../../admin-guide/files/records.config.en.rst:2722 -#: ../../../admin-guide/files/records.config.en.rst:2763 -#: ../../../admin-guide/files/records.config.en.rst:2809 -#: ../../../admin-guide/files/records.config.en.rst:2903 -#: ../../../admin-guide/files/records.config.en.rst:2922 -#: ../../../admin-guide/files/records.config.en.rst:3015 -#: ../../../admin-guide/files/records.config.en.rst:3056 -#: ../../../admin-guide/files/records.config.en.rst:3168 -#: ../../../admin-guide/files/records.config.en.rst:3199 -#: ../../../admin-guide/files/records.config.en.rst:3620 +#: ../../../admin-guide/files/records.yaml.en.rst:48 +#: ../../../admin-guide/files/records.yaml.en.rst:60 +#: ../../../admin-guide/files/records.yaml.en.rst:81 +#: ../../../admin-guide/files/records.yaml.en.rst:276 +#: ../../../admin-guide/files/records.yaml.en.rst:835 +#: ../../../admin-guide/files/records.yaml.en.rst:850 +#: ../../../admin-guide/files/records.yaml.en.rst:879 +#: ../../../admin-guide/files/records.yaml.en.rst:899 +#: ../../../admin-guide/files/records.yaml.en.rst:936 +#: ../../../admin-guide/files/records.yaml.en.rst:972 +#: ../../../admin-guide/files/records.yaml.en.rst:1007 +#: ../../../admin-guide/files/records.yaml.en.rst:1056 +#: ../../../admin-guide/files/records.yaml.en.rst:1497 +#: ../../../admin-guide/files/records.yaml.en.rst:1628 +#: ../../../admin-guide/files/records.yaml.en.rst:1740 +#: ../../../admin-guide/files/records.yaml.en.rst:1776 +#: ../../../admin-guide/files/records.yaml.en.rst:1797 +#: ../../../admin-guide/files/records.yaml.en.rst:1992 +#: ../../../admin-guide/files/records.yaml.en.rst:2134 +#: ../../../admin-guide/files/records.yaml.en.rst:2157 +#: ../../../admin-guide/files/records.yaml.en.rst:2188 +#: ../../../admin-guide/files/records.yaml.en.rst:2200 +#: ../../../admin-guide/files/records.yaml.en.rst:2216 +#: ../../../admin-guide/files/records.yaml.en.rst:2224 +#: ../../../admin-guide/files/records.yaml.en.rst:2251 +#: ../../../admin-guide/files/records.yaml.en.rst:2435 +#: ../../../admin-guide/files/records.yaml.en.rst:2580 +#: ../../../admin-guide/files/records.yaml.en.rst:2677 +#: ../../../admin-guide/files/records.yaml.en.rst:2722 +#: ../../../admin-guide/files/records.yaml.en.rst:2763 +#: ../../../admin-guide/files/records.yaml.en.rst:2809 +#: ../../../admin-guide/files/records.yaml.en.rst:2903 +#: ../../../admin-guide/files/records.yaml.en.rst:2922 +#: ../../../admin-guide/files/records.yaml.en.rst:3015 +#: ../../../admin-guide/files/records.yaml.en.rst:3056 +#: ../../../admin-guide/files/records.yaml.en.rst:3168 +#: ../../../admin-guide/files/records.yaml.en.rst:3199 +#: ../../../admin-guide/files/records.yaml.en.rst:3620 msgid "Description" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:50 +#: ../../../admin-guide/files/records.yaml.en.rst:50 msgid "``CONFIG``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:55 +#: ../../../admin-guide/files/records.yaml.en.rst:55 msgid "Data Type" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:57 +#: ../../../admin-guide/files/records.yaml.en.rst:57 msgid "A variable's type is defined by the ``DATATYPE`` and must be one of:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:60 +#: ../../../admin-guide/files/records.yaml.en.rst:60 msgid "Type" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:62 +#: ../../../admin-guide/files/records.yaml.en.rst:62 msgid "``FLOAT``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:62 +#: ../../../admin-guide/files/records.yaml.en.rst:62 msgid "" "Floating point, expressed as a decimal number without units or exponents." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:64 +#: ../../../admin-guide/files/records.yaml.en.rst:64 msgid "``INT``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:64 +#: ../../../admin-guide/files/records.yaml.en.rst:64 msgid "" "Integers, expressed with or without unit prefixes (as described below)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:66 +#: ../../../admin-guide/files/records.yaml.en.rst:66 msgid "``STRING``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:66 +#: ../../../admin-guide/files/records.yaml.en.rst:66 msgid "String of characters up to the first newline. No quoting necessary." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:70 +#: ../../../admin-guide/files/records.yaml.en.rst:70 #, fuzzy msgid "Values" msgstr "値" -#: ../../../admin-guide/files/records.config.en.rst:72 +#: ../../../admin-guide/files/records.yaml.en.rst:72 msgid "" "The *variable_value* must conform to the variable's type. For ``STRING``, " "this is simply any character data until the first newline." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:75 +#: ../../../admin-guide/files/records.yaml.en.rst:75 #, fuzzy msgid "" "For integer (``INT``) variables, values are expressed as any normal " @@ -162,78 +162,78 @@ msgstr "" "す。例えば *32K* のように。``INT`` 型の設定では次のプレフィックスがサポート" "されています。" -#: ../../../admin-guide/files/records.config.en.rst:81 +#: ../../../admin-guide/files/records.yaml.en.rst:81 msgid "Prefix" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:81 +#: ../../../admin-guide/files/records.yaml.en.rst:81 msgid "Equivalent in Bytes" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:83 +#: ../../../admin-guide/files/records.yaml.en.rst:83 msgid "``K``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:83 +#: ../../../admin-guide/files/records.yaml.en.rst:83 msgid "Kilobytes" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:83 +#: ../../../admin-guide/files/records.yaml.en.rst:83 msgid "1,024 bytes" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:84 +#: ../../../admin-guide/files/records.yaml.en.rst:84 msgid "``M``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:84 +#: ../../../admin-guide/files/records.yaml.en.rst:84 msgid "Megabytes" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:84 +#: ../../../admin-guide/files/records.yaml.en.rst:84 msgid "1,048,576 bytes (1024\\ :sup:`2`)" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:85 +#: ../../../admin-guide/files/records.yaml.en.rst:85 msgid "``G``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:85 +#: ../../../admin-guide/files/records.yaml.en.rst:85 msgid "Gigabytes" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:85 +#: ../../../admin-guide/files/records.yaml.en.rst:85 msgid "1,073,741,824 bytes (1024\\ :sup:`3`)" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:86 +#: ../../../admin-guide/files/records.yaml.en.rst:86 msgid "``T``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:86 +#: ../../../admin-guide/files/records.yaml.en.rst:86 msgid "Terabytes" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:86 +#: ../../../admin-guide/files/records.yaml.en.rst:86 msgid "1,099,511,627,776 bytes (1024\\ :sup:`4`)" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:95 +#: ../../../admin-guide/files/records.yaml.en.rst:95 msgid "" "Floating point variables (``FLOAT``) must be expressed as a regular decimal " "number. Unit prefixes are not supported, nor are alternate notations " "(scientific, exponent, etc.)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:100 +#: ../../../admin-guide/files/records.yaml.en.rst:100 msgid "Additional Attributes" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:103 +#: ../../../admin-guide/files/records.yaml.en.rst:103 msgid "Deprecated" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:105 +#: ../../../admin-guide/files/records.yaml.en.rst:105 #, fuzzy msgid "" "A variable marked as *Deprecated* is still functional but should be avoided " @@ -243,37 +243,37 @@ msgstr "" "(floating point) のいずれかです。``Deprecated`` と記された変数はまだ機能しま" "すが、将来のリリースで予告なく削除されるかもしれないので避けるべきです。" -#: ../../../admin-guide/files/records.config.en.rst:109 +#: ../../../admin-guide/files/records.yaml.en.rst:109 msgid "Reloadable" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:111 +#: ../../../admin-guide/files/records.yaml.en.rst:111 #, fuzzy msgid "A variable marked as *Reloadable* can be updated via the command::" msgstr "``Reloadable`` と記された変数は次のコマンドで更新可能です。" -#: ../../../admin-guide/files/records.config.en.rst:115 +#: ../../../admin-guide/files/records.yaml.en.rst:115 msgid "" "This updates configuration parameters without restarting |TS| or " "interrupting the processing of requests." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:119 +#: ../../../admin-guide/files/records.yaml.en.rst:119 msgid "Overridable" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:121 +#: ../../../admin-guide/files/records.yaml.en.rst:121 msgid "" "A variable marked as *Overridable* can be changed on a per-remap basis " "using plugins (like the :ref:`admin-plugins-conf-remap`), affecting " "operations within the current transaction only." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:126 +#: ../../../admin-guide/files/records.yaml.en.rst:126 msgid "Examples" msgstr "例" -#: ../../../admin-guide/files/records.config.en.rst:128 +#: ../../../admin-guide/files/records.yaml.en.rst:128 msgid "" "In the following example, the variable `proxy.config.proxy_name`_ is a " "``STRING`` datatype with the value ``my_server``. This means that the name " @@ -283,12 +283,12 @@ msgstr "" "``STRING`` データ型の変数です。これは Traffic Server プロキシーの名前が " "``my_server`` であることを意味しています。::" -#: ../../../admin-guide/files/records.config.en.rst:134 +#: ../../../admin-guide/files/records.yaml.en.rst:134 msgid "If the server name should be ``that_server`` the line would be ::" msgstr "" "もしサーバー名が ``that_server`` であるべきなら行は次のようになります ::" -#: ../../../admin-guide/files/records.config.en.rst:138 +#: ../../../admin-guide/files/records.yaml.en.rst:138 msgid "" "In the following example, the variable ``proxy.config.arm.enabled`` is a " "yes/no flag. A value of ``0`` (zero) disables the option; a value of ``1`` " @@ -297,7 +297,7 @@ msgstr "" "次の例で、``proxy.config.arm.enabled`` 変数は yes/no フラグです。値 ``0`` " "(ゼロ) はオプションを無効化し、値 ``1`` はオプションを有効化します。 ::" -#: ../../../admin-guide/files/records.config.en.rst:149 +#: ../../../admin-guide/files/records.yaml.en.rst:149 msgid "" "The last examples configures a 64GB RAM cache, using a human readable " "prefix. ::" @@ -305,91 +305,91 @@ msgstr "" "最後の例は、人間が読みやすいプレフィックスを使用して RAM キャッシュを 64GB " "に設定します。" -#: ../../../admin-guide/files/records.config.en.rst:155 +#: ../../../admin-guide/files/records.yaml.en.rst:155 msgid "Environment Overrides" msgstr "環境の再定義" -#: ../../../admin-guide/files/records.config.en.rst:157 +#: ../../../admin-guide/files/records.yaml.en.rst:157 msgid "" -"Every :file:`records.config` configuration variable can be overridden by a " +"Every :file:`records.yaml` configuration variable can be overridden by a " "corresponding environment variable. This can be useful in situations where " -"you need a static :file:`records.config` but still want to tweak one or two " +"you need a static :file:`records.yaml` but still want to tweak one or two " "settings. The override variable is formed by converting the :file:`records." "config` variable name to upper case, and replacing any dot separators with " "an underscore." msgstr "" -":file:`records.config` の各設定変数は対応する環境変数で再定義できます。これ" -"は静的な :file:`records.config` が必要であるが 1、2 個の設定だけ調整したいと" -"いう状況で便利です。再定義変数は :file:`records.config` の変数名を大文字に" +":file:`records.yaml` の各設定変数は対応する環境変数で再定義できます。これ" +"は静的な :file:`records.yaml` が必要であるが 1、2 個の設定だけ調整したいと" +"いう状況で便利です。再定義変数は :file:`records.yaml` の変数名を大文字に" "し、ドットをアンダースコアに置換えたものになっています。" -#: ../../../admin-guide/files/records.config.en.rst:164 +#: ../../../admin-guide/files/records.yaml.en.rst:164 msgid "" "Overriding a variable from the environment is permanent and will not be " -"affected by future configuration changes made in :file:`records.config` or " +"affected by future configuration changes made in :file:`records.yaml` or " "applied with :program:`traffic_ctl`." msgstr "" -"環境からの変数の再定義は恒久的であり、:file:`records.config` の変更や :" +"環境からの変数の再定義は恒久的であり、:file:`records.yaml` の変更や :" "program:`traffic_ctl ` での適用による将来的な設定変更の影響を受けません。" -#: ../../../admin-guide/files/records.config.en.rst:168 +#: ../../../admin-guide/files/records.yaml.en.rst:168 msgid "" "For example, we could override the `proxy.config.product_company`_ variable " "like this::" msgstr "" "例えば、`proxy.config.product_company`_ 変数はこのように再定義できるでしょう" -#: ../../../admin-guide/files/records.config.en.rst:177 +#: ../../../admin-guide/files/records.yaml.en.rst:177 msgid "Configuration Variables" msgstr "設定変数" -#: ../../../admin-guide/files/records.config.en.rst:179 +#: ../../../admin-guide/files/records.yaml.en.rst:179 msgid "" "The following list describes the configuration variables available in the :" "file:`records.config` file." msgstr "" -"次の一覧では :file:`records.config` ファイル内で利用可能な設定変数について説" +"次の一覧では :file:`records.yaml` ファイル内で利用可能な設定変数について説" "明します。" -#: ../../../admin-guide/files/records.config.en.rst:183 +#: ../../../admin-guide/files/records.yaml.en.rst:183 msgid "System Variables" msgstr "システム変数" -#: ../../../admin-guide/files/records.config.en.rst:187 +#: ../../../admin-guide/files/records.yaml.en.rst:187 msgid "The name of the organization developing Traffic Server." msgstr "Traffic Server を開発している組織の名称。" -#: ../../../admin-guide/files/records.config.en.rst:191 +#: ../../../admin-guide/files/records.yaml.en.rst:191 msgid "The name of the vendor providing Traffic Server." msgstr "Traffic Server を提供しているベンダーの名称。" -#: ../../../admin-guide/files/records.config.en.rst:195 +#: ../../../admin-guide/files/records.yaml.en.rst:195 msgid "The name of the product." msgstr "プロダクトの名称。" -#: ../../../admin-guide/files/records.config.en.rst:200 +#: ../../../admin-guide/files/records.yaml.en.rst:200 msgid "The name of the Traffic Server node." msgstr "Traffic Server ノードの名称。" -#: ../../../admin-guide/files/records.config.en.rst:204 +#: ../../../admin-guide/files/records.yaml.en.rst:204 msgid "The location of the Traffic Server ``bin`` directory." msgstr "Traffic Server の ``bin`` ディレクトリの位置。" -#: ../../../admin-guide/files/records.config.en.rst:208 +#: ../../../admin-guide/files/records.yaml.en.rst:208 msgid "" "The name of the executable that runs the :program:`traffic_server` process." msgstr ":program:`traffic_server` プロセスを実行する実行ファイルの名称。" -#: ../../../admin-guide/files/records.config.en.rst:212 +#: ../../../admin-guide/files/records.yaml.en.rst:212 msgid "The command-line options for starting Traffic Server." msgstr "Traffic Server をスタートする際のコマンドラインオプション。" -#: ../../../admin-guide/files/records.config.en.rst:216 +#: ../../../admin-guide/files/records.yaml.en.rst:216 msgid "" "The name of the executable that runs the :program:`traffic_manager` process." msgstr ":program:`traffic_manager` プロセスを実行する実行ファイルの名称。" -#: ../../../admin-guide/files/records.config.en.rst:220 +#: ../../../admin-guide/files/records.yaml.en.rst:220 msgid "" "The script executed before the :program:`traffic_manager` process spawns " "the :program:`traffic_server` process." @@ -397,7 +397,7 @@ msgstr "" ":program:`traffic_manager` プロセスが :program:`traffic_server` プロセスを立" "ち上げる前に実行するスクリプト。" -#: ../../../admin-guide/files/records.config.en.rst:225 +#: ../../../admin-guide/files/records.yaml.en.rst:225 msgid "" "The directory that contains Traffic Server configuration files. This is a " "read-only configuration option that contains the ``SYSCONFDIR`` value " @@ -410,7 +410,7 @@ msgstr "" "読み取り専用の設定オプションです。``$TS_ROOT`` 環境変数はインストールした場" "所のプレフィックスを実行時に切り替えるために使うことができます。" -#: ../../../admin-guide/files/records.config.en.rst:233 +#: ../../../admin-guide/files/records.yaml.en.rst:233 #, fuzzy msgid "" "The facility used to record system log files. Refer to :ref:`admin-" @@ -420,25 +420,25 @@ msgstr "" "システムログファイルを記録する機能です。 :ref:`understanding-traffic-server-" "log-files` を参照してください。" -#: ../../../admin-guide/files/records.config.en.rst:239 +#: ../../../admin-guide/files/records.yaml.en.rst:239 msgid "" "The signal sent to :program:`traffic_cop`'s managed processes to stop them." msgstr "" ":program:`traffic_cop` の管理しているプロセスを停止するために送信されるシグ" "ナルです。" -#: ../../../admin-guide/files/records.config.en.rst:241 +#: ../../../admin-guide/files/records.yaml.en.rst:241 msgid "A value of ``0`` means no signal will be sent." msgstr "値 ``0`` はシグナルが送信されないことを意味します。" -#: ../../../admin-guide/files/records.config.en.rst:245 +#: ../../../admin-guide/files/records.yaml.en.rst:245 msgid "" "The minimum amount of free memory space allowed before Traffic Server stops " "the :program:`traffic_server` and :program:`traffic_manager` processes to " "prevent the system from hanging." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:251 +#: ../../../admin-guide/files/records.yaml.en.rst:251 msgid "" "The minimum amount of free swap space allowed before Traffic Server stops " "the :program:`traffic_server` and :program:`traffic_manager` processes to " @@ -450,7 +450,7 @@ msgstr "" "小空き容量です。この設定変数は Linux 2.2 でスワップが有効化されている場合の" "み適用されます。`" -#: ../../../admin-guide/files/records.config.en.rst:258 +#: ../../../admin-guide/files/records.yaml.en.rst:258 msgid "" "The minimum amount of additional duration allowed before Traffic Server " "detects that the :program:`traffic_server` is not responsive and attempts a " @@ -460,7 +460,7 @@ msgid "" "and does not apply to the run time heartbeat checking." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:267 +#: ../../../admin-guide/files/records.yaml.en.rst:267 msgid "" "The name and location of the file that contains warnings, status messages, " "and error messages produced by the Traffic Server processes. If no path is " @@ -470,187 +470,187 @@ msgstr "" "メッセージを含むファイルの名前と場所。パスが指定されていない場合、Traffic " "Server はロギングディレクトリにファイルを作成します。" -#: ../../../admin-guide/files/records.config.en.rst:273 +#: ../../../admin-guide/files/records.yaml.en.rst:273 msgid "" "Specifies how the output log is rolled. You can specify the following " "values:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:276 -#: ../../../admin-guide/files/records.config.en.rst:338 -#: ../../../admin-guide/files/records.config.en.rst:501 -#: ../../../admin-guide/files/records.config.en.rst:668 -#: ../../../admin-guide/files/records.config.en.rst:669 -#: ../../../admin-guide/files/records.config.en.rst:670 -#: ../../../admin-guide/files/records.config.en.rst:671 -#: ../../../admin-guide/files/records.config.en.rst:786 -#: ../../../admin-guide/files/records.config.en.rst:811 -#: ../../../admin-guide/files/records.config.en.rst:835 -#: ../../../admin-guide/files/records.config.en.rst:850 -#: ../../../admin-guide/files/records.config.en.rst:879 -#: ../../../admin-guide/files/records.config.en.rst:899 -#: ../../../admin-guide/files/records.config.en.rst:936 -#: ../../../admin-guide/files/records.config.en.rst:972 -#: ../../../admin-guide/files/records.config.en.rst:1007 -#: ../../../admin-guide/files/records.config.en.rst:1056 -#: ../../../admin-guide/files/records.config.en.rst:1628 -#: ../../../admin-guide/files/records.config.en.rst:1740 -#: ../../../admin-guide/files/records.config.en.rst:1776 -#: ../../../admin-guide/files/records.config.en.rst:1797 -#: ../../../admin-guide/files/records.config.en.rst:1992 -#: ../../../admin-guide/files/records.config.en.rst:2134 -#: ../../../admin-guide/files/records.config.en.rst:2157 -#: ../../../admin-guide/files/records.config.en.rst:2188 -#: ../../../admin-guide/files/records.config.en.rst:2200 -#: ../../../admin-guide/files/records.config.en.rst:2251 -#: ../../../admin-guide/files/records.config.en.rst:2355 -#: ../../../admin-guide/files/records.config.en.rst:2511 -#: ../../../admin-guide/files/records.config.en.rst:2580 -#: ../../../admin-guide/files/records.config.en.rst:2627 -#: ../../../admin-guide/files/records.config.en.rst:2677 -#: ../../../admin-guide/files/records.config.en.rst:2722 -#: ../../../admin-guide/files/records.config.en.rst:2763 -#: ../../../admin-guide/files/records.config.en.rst:2809 -#: ../../../admin-guide/files/records.config.en.rst:2903 -#: ../../../admin-guide/files/records.config.en.rst:2922 -#: ../../../admin-guide/files/records.config.en.rst:3015 -#: ../../../admin-guide/files/records.config.en.rst:3056 -#: ../../../admin-guide/files/records.config.en.rst:3168 -#: ../../../admin-guide/files/records.config.en.rst:3199 -#: ../../../admin-guide/files/records.config.en.rst:3620 +#: ../../../admin-guide/files/records.yaml.en.rst:276 +#: ../../../admin-guide/files/records.yaml.en.rst:338 +#: ../../../admin-guide/files/records.yaml.en.rst:501 +#: ../../../admin-guide/files/records.yaml.en.rst:668 +#: ../../../admin-guide/files/records.yaml.en.rst:669 +#: ../../../admin-guide/files/records.yaml.en.rst:670 +#: ../../../admin-guide/files/records.yaml.en.rst:671 +#: ../../../admin-guide/files/records.yaml.en.rst:786 +#: ../../../admin-guide/files/records.yaml.en.rst:811 +#: ../../../admin-guide/files/records.yaml.en.rst:835 +#: ../../../admin-guide/files/records.yaml.en.rst:850 +#: ../../../admin-guide/files/records.yaml.en.rst:879 +#: ../../../admin-guide/files/records.yaml.en.rst:899 +#: ../../../admin-guide/files/records.yaml.en.rst:936 +#: ../../../admin-guide/files/records.yaml.en.rst:972 +#: ../../../admin-guide/files/records.yaml.en.rst:1007 +#: ../../../admin-guide/files/records.yaml.en.rst:1056 +#: ../../../admin-guide/files/records.yaml.en.rst:1628 +#: ../../../admin-guide/files/records.yaml.en.rst:1740 +#: ../../../admin-guide/files/records.yaml.en.rst:1776 +#: ../../../admin-guide/files/records.yaml.en.rst:1797 +#: ../../../admin-guide/files/records.yaml.en.rst:1992 +#: ../../../admin-guide/files/records.yaml.en.rst:2134 +#: ../../../admin-guide/files/records.yaml.en.rst:2157 +#: ../../../admin-guide/files/records.yaml.en.rst:2188 +#: ../../../admin-guide/files/records.yaml.en.rst:2200 +#: ../../../admin-guide/files/records.yaml.en.rst:2251 +#: ../../../admin-guide/files/records.yaml.en.rst:2355 +#: ../../../admin-guide/files/records.yaml.en.rst:2511 +#: ../../../admin-guide/files/records.yaml.en.rst:2580 +#: ../../../admin-guide/files/records.yaml.en.rst:2627 +#: ../../../admin-guide/files/records.yaml.en.rst:2677 +#: ../../../admin-guide/files/records.yaml.en.rst:2722 +#: ../../../admin-guide/files/records.yaml.en.rst:2763 +#: ../../../admin-guide/files/records.yaml.en.rst:2809 +#: ../../../admin-guide/files/records.yaml.en.rst:2903 +#: ../../../admin-guide/files/records.yaml.en.rst:2922 +#: ../../../admin-guide/files/records.yaml.en.rst:3015 +#: ../../../admin-guide/files/records.yaml.en.rst:3056 +#: ../../../admin-guide/files/records.yaml.en.rst:3168 +#: ../../../admin-guide/files/records.yaml.en.rst:3199 +#: ../../../admin-guide/files/records.yaml.en.rst:3620 msgid "Value" msgstr "値" -#: ../../../admin-guide/files/records.config.en.rst:278 -#: ../../../admin-guide/files/records.config.en.rst:340 -#: ../../../admin-guide/files/records.config.en.rst:788 -#: ../../../admin-guide/files/records.config.en.rst:813 -#: ../../../admin-guide/files/records.config.en.rst:837 -#: ../../../admin-guide/files/records.config.en.rst:852 -#: ../../../admin-guide/files/records.config.en.rst:881 -#: ../../../admin-guide/files/records.config.en.rst:901 -#: ../../../admin-guide/files/records.config.en.rst:938 -#: ../../../admin-guide/files/records.config.en.rst:1058 -#: ../../../admin-guide/files/records.config.en.rst:1630 -#: ../../../admin-guide/files/records.config.en.rst:1742 -#: ../../../admin-guide/files/records.config.en.rst:1778 -#: ../../../admin-guide/files/records.config.en.rst:1799 -#: ../../../admin-guide/files/records.config.en.rst:1994 -#: ../../../admin-guide/files/records.config.en.rst:2136 -#: ../../../admin-guide/files/records.config.en.rst:2190 -#: ../../../admin-guide/files/records.config.en.rst:2202 -#: ../../../admin-guide/files/records.config.en.rst:2253 -#: ../../../admin-guide/files/records.config.en.rst:2357 -#: ../../../admin-guide/files/records.config.en.rst:2513 -#: ../../../admin-guide/files/records.config.en.rst:2629 -#: ../../../admin-guide/files/records.config.en.rst:2679 -#: ../../../admin-guide/files/records.config.en.rst:2811 -#: ../../../admin-guide/files/records.config.en.rst:2905 -#: ../../../admin-guide/files/records.config.en.rst:2924 -#: ../../../admin-guide/files/records.config.en.rst:3017 -#: ../../../admin-guide/files/records.config.en.rst:3058 -#: ../../../admin-guide/files/records.config.en.rst:3170 -#: ../../../admin-guide/files/records.config.en.rst:3201 -#: ../../../admin-guide/files/records.config.en.rst:3622 +#: ../../../admin-guide/files/records.yaml.en.rst:278 +#: ../../../admin-guide/files/records.yaml.en.rst:340 +#: ../../../admin-guide/files/records.yaml.en.rst:788 +#: ../../../admin-guide/files/records.yaml.en.rst:813 +#: ../../../admin-guide/files/records.yaml.en.rst:837 +#: ../../../admin-guide/files/records.yaml.en.rst:852 +#: ../../../admin-guide/files/records.yaml.en.rst:881 +#: ../../../admin-guide/files/records.yaml.en.rst:901 +#: ../../../admin-guide/files/records.yaml.en.rst:938 +#: ../../../admin-guide/files/records.yaml.en.rst:1058 +#: ../../../admin-guide/files/records.yaml.en.rst:1630 +#: ../../../admin-guide/files/records.yaml.en.rst:1742 +#: ../../../admin-guide/files/records.yaml.en.rst:1778 +#: ../../../admin-guide/files/records.yaml.en.rst:1799 +#: ../../../admin-guide/files/records.yaml.en.rst:1994 +#: ../../../admin-guide/files/records.yaml.en.rst:2136 +#: ../../../admin-guide/files/records.yaml.en.rst:2190 +#: ../../../admin-guide/files/records.yaml.en.rst:2202 +#: ../../../admin-guide/files/records.yaml.en.rst:2253 +#: ../../../admin-guide/files/records.yaml.en.rst:2357 +#: ../../../admin-guide/files/records.yaml.en.rst:2513 +#: ../../../admin-guide/files/records.yaml.en.rst:2629 +#: ../../../admin-guide/files/records.yaml.en.rst:2679 +#: ../../../admin-guide/files/records.yaml.en.rst:2811 +#: ../../../admin-guide/files/records.yaml.en.rst:2905 +#: ../../../admin-guide/files/records.yaml.en.rst:2924 +#: ../../../admin-guide/files/records.yaml.en.rst:3017 +#: ../../../admin-guide/files/records.yaml.en.rst:3058 +#: ../../../admin-guide/files/records.yaml.en.rst:3170 +#: ../../../admin-guide/files/records.yaml.en.rst:3201 +#: ../../../admin-guide/files/records.yaml.en.rst:3622 msgid "``0``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:278 +#: ../../../admin-guide/files/records.yaml.en.rst:278 msgid "Disables output log rolling." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:279 -#: ../../../admin-guide/files/records.config.en.rst:341 -#: ../../../admin-guide/files/records.config.en.rst:503 -#: ../../../admin-guide/files/records.config.en.rst:789 -#: ../../../admin-guide/files/records.config.en.rst:814 -#: ../../../admin-guide/files/records.config.en.rst:839 -#: ../../../admin-guide/files/records.config.en.rst:853 -#: ../../../admin-guide/files/records.config.en.rst:882 -#: ../../../admin-guide/files/records.config.en.rst:902 -#: ../../../admin-guide/files/records.config.en.rst:939 -#: ../../../admin-guide/files/records.config.en.rst:1059 -#: ../../../admin-guide/files/records.config.en.rst:1631 -#: ../../../admin-guide/files/records.config.en.rst:1743 -#: ../../../admin-guide/files/records.config.en.rst:1779 -#: ../../../admin-guide/files/records.config.en.rst:1800 -#: ../../../admin-guide/files/records.config.en.rst:1995 -#: ../../../admin-guide/files/records.config.en.rst:2137 -#: ../../../admin-guide/files/records.config.en.rst:2159 -#: ../../../admin-guide/files/records.config.en.rst:2191 -#: ../../../admin-guide/files/records.config.en.rst:2203 -#: ../../../admin-guide/files/records.config.en.rst:2254 -#: ../../../admin-guide/files/records.config.en.rst:2358 -#: ../../../admin-guide/files/records.config.en.rst:2514 -#: ../../../admin-guide/files/records.config.en.rst:2630 -#: ../../../admin-guide/files/records.config.en.rst:2680 -#: ../../../admin-guide/files/records.config.en.rst:2724 -#: ../../../admin-guide/files/records.config.en.rst:2812 -#: ../../../admin-guide/files/records.config.en.rst:2908 -#: ../../../admin-guide/files/records.config.en.rst:3018 -#: ../../../admin-guide/files/records.config.en.rst:3059 -#: ../../../admin-guide/files/records.config.en.rst:3171 -#: ../../../admin-guide/files/records.config.en.rst:3202 -#: ../../../admin-guide/files/records.config.en.rst:3625 +#: ../../../admin-guide/files/records.yaml.en.rst:279 +#: ../../../admin-guide/files/records.yaml.en.rst:341 +#: ../../../admin-guide/files/records.yaml.en.rst:503 +#: ../../../admin-guide/files/records.yaml.en.rst:789 +#: ../../../admin-guide/files/records.yaml.en.rst:814 +#: ../../../admin-guide/files/records.yaml.en.rst:839 +#: ../../../admin-guide/files/records.yaml.en.rst:853 +#: ../../../admin-guide/files/records.yaml.en.rst:882 +#: ../../../admin-guide/files/records.yaml.en.rst:902 +#: ../../../admin-guide/files/records.yaml.en.rst:939 +#: ../../../admin-guide/files/records.yaml.en.rst:1059 +#: ../../../admin-guide/files/records.yaml.en.rst:1631 +#: ../../../admin-guide/files/records.yaml.en.rst:1743 +#: ../../../admin-guide/files/records.yaml.en.rst:1779 +#: ../../../admin-guide/files/records.yaml.en.rst:1800 +#: ../../../admin-guide/files/records.yaml.en.rst:1995 +#: ../../../admin-guide/files/records.yaml.en.rst:2137 +#: ../../../admin-guide/files/records.yaml.en.rst:2159 +#: ../../../admin-guide/files/records.yaml.en.rst:2191 +#: ../../../admin-guide/files/records.yaml.en.rst:2203 +#: ../../../admin-guide/files/records.yaml.en.rst:2254 +#: ../../../admin-guide/files/records.yaml.en.rst:2358 +#: ../../../admin-guide/files/records.yaml.en.rst:2514 +#: ../../../admin-guide/files/records.yaml.en.rst:2630 +#: ../../../admin-guide/files/records.yaml.en.rst:2680 +#: ../../../admin-guide/files/records.yaml.en.rst:2724 +#: ../../../admin-guide/files/records.yaml.en.rst:2812 +#: ../../../admin-guide/files/records.yaml.en.rst:2908 +#: ../../../admin-guide/files/records.yaml.en.rst:3018 +#: ../../../admin-guide/files/records.yaml.en.rst:3059 +#: ../../../admin-guide/files/records.yaml.en.rst:3171 +#: ../../../admin-guide/files/records.yaml.en.rst:3202 +#: ../../../admin-guide/files/records.yaml.en.rst:3625 msgid "``1``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:279 +#: ../../../admin-guide/files/records.yaml.en.rst:279 msgid "" "Enables output log rolling at specific intervals (specified with the :ts:cv:" "`proxy.config.output.logfile.rolling_interval_sec` variable). The clock " "starts ticking on |TS| boot." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:282 -#: ../../../admin-guide/files/records.config.en.rst:342 -#: ../../../admin-guide/files/records.config.en.rst:504 -#: ../../../admin-guide/files/records.config.en.rst:790 -#: ../../../admin-guide/files/records.config.en.rst:815 -#: ../../../admin-guide/files/records.config.en.rst:855 -#: ../../../admin-guide/files/records.config.en.rst:903 -#: ../../../admin-guide/files/records.config.en.rst:940 -#: ../../../admin-guide/files/records.config.en.rst:1063 -#: ../../../admin-guide/files/records.config.en.rst:1632 -#: ../../../admin-guide/files/records.config.en.rst:1744 -#: ../../../admin-guide/files/records.config.en.rst:1780 -#: ../../../admin-guide/files/records.config.en.rst:1802 -#: ../../../admin-guide/files/records.config.en.rst:1996 -#: ../../../admin-guide/files/records.config.en.rst:2138 -#: ../../../admin-guide/files/records.config.en.rst:2160 -#: ../../../admin-guide/files/records.config.en.rst:2192 -#: ../../../admin-guide/files/records.config.en.rst:2204 -#: ../../../admin-guide/files/records.config.en.rst:2255 -#: ../../../admin-guide/files/records.config.en.rst:2359 -#: ../../../admin-guide/files/records.config.en.rst:2515 -#: ../../../admin-guide/files/records.config.en.rst:2631 -#: ../../../admin-guide/files/records.config.en.rst:2683 -#: ../../../admin-guide/files/records.config.en.rst:2725 -#: ../../../admin-guide/files/records.config.en.rst:2815 -#: ../../../admin-guide/files/records.config.en.rst:2912 -#: ../../../admin-guide/files/records.config.en.rst:3019 -#: ../../../admin-guide/files/records.config.en.rst:3203 -#: ../../../admin-guide/files/records.config.en.rst:3628 +#: ../../../admin-guide/files/records.yaml.en.rst:282 +#: ../../../admin-guide/files/records.yaml.en.rst:342 +#: ../../../admin-guide/files/records.yaml.en.rst:504 +#: ../../../admin-guide/files/records.yaml.en.rst:790 +#: ../../../admin-guide/files/records.yaml.en.rst:815 +#: ../../../admin-guide/files/records.yaml.en.rst:855 +#: ../../../admin-guide/files/records.yaml.en.rst:903 +#: ../../../admin-guide/files/records.yaml.en.rst:940 +#: ../../../admin-guide/files/records.yaml.en.rst:1063 +#: ../../../admin-guide/files/records.yaml.en.rst:1632 +#: ../../../admin-guide/files/records.yaml.en.rst:1744 +#: ../../../admin-guide/files/records.yaml.en.rst:1780 +#: ../../../admin-guide/files/records.yaml.en.rst:1802 +#: ../../../admin-guide/files/records.yaml.en.rst:1996 +#: ../../../admin-guide/files/records.yaml.en.rst:2138 +#: ../../../admin-guide/files/records.yaml.en.rst:2160 +#: ../../../admin-guide/files/records.yaml.en.rst:2192 +#: ../../../admin-guide/files/records.yaml.en.rst:2204 +#: ../../../admin-guide/files/records.yaml.en.rst:2255 +#: ../../../admin-guide/files/records.yaml.en.rst:2359 +#: ../../../admin-guide/files/records.yaml.en.rst:2515 +#: ../../../admin-guide/files/records.yaml.en.rst:2631 +#: ../../../admin-guide/files/records.yaml.en.rst:2683 +#: ../../../admin-guide/files/records.yaml.en.rst:2725 +#: ../../../admin-guide/files/records.yaml.en.rst:2815 +#: ../../../admin-guide/files/records.yaml.en.rst:2912 +#: ../../../admin-guide/files/records.yaml.en.rst:3019 +#: ../../../admin-guide/files/records.yaml.en.rst:3203 +#: ../../../admin-guide/files/records.yaml.en.rst:3628 msgid "``2``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:282 +#: ../../../admin-guide/files/records.yaml.en.rst:282 msgid "" "Enables output log rolling when the output log reaches a specific size " "(specified with :ts:cv:`proxy.config.output.logfile.rolling_size_mb`)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:290 +#: ../../../admin-guide/files/records.yaml.en.rst:290 msgid "" "Specifies how often the output log is rolled, in seconds. The timer starts " "on Traffic Server bootup." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:296 +#: ../../../admin-guide/files/records.yaml.en.rst:296 msgid "Specifies at what size to roll the output log at." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:300 +#: ../../../admin-guide/files/records.yaml.en.rst:300 msgid "" "The directory in which Traffic Server stores configuration snapshots on the " "local system. Unless you specify an absolute path, this directory is " @@ -660,12 +660,12 @@ msgstr "" "クトリ。絶対パスを指定しない限り、このディレクトリは Traffic Server の " "``SYSCONFDIR`` ディレクトリに置かれます。" -#: ../../../admin-guide/files/records.config.en.rst:306 +#: ../../../admin-guide/files/records.yaml.en.rst:306 #, fuzzy msgid "Thread Variables" msgstr "システム変数" -#: ../../../admin-guide/files/records.config.en.rst:310 +#: ../../../admin-guide/files/records.yaml.en.rst:310 #, fuzzy msgid "" "When enabled (the default, ``1``), |TS| scales threads according to the " @@ -674,7 +674,7 @@ msgstr "" "有効化すると (デフォルトは ``1``) 、Traffic Server は CPU のコア数をもとにス" "レッドをスケールします。以下の設定オプションを見てください。" -#: ../../../admin-guide/files/records.config.en.rst:315 +#: ../../../admin-guide/files/records.yaml.en.rst:315 #, fuzzy msgid "" "Factor by which |TS| scales the number of threads. The multiplier is " @@ -684,19 +684,19 @@ msgstr "" "Traffic Server がスレッド数をスケールする際の係数。乗数は通常利用可能な CPU " "のコア数です。デフォルトではスケーリング係数は ``1.5`` です。" -#: ../../../admin-guide/files/records.config.en.rst:321 +#: ../../../admin-guide/files/records.yaml.en.rst:321 msgid "" "The number of threads |TS| will create if `proxy.config.exec_thread." "autoconfig` is set to ``0``, otherwise this option is ignored." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:326 +#: ../../../admin-guide/files/records.yaml.en.rst:326 msgid "" "The number of accept threads. If disabled (``0``), then accepts will be " "done in each of the worker threads." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:331 +#: ../../../admin-guide/files/records.yaml.en.rst:331 #, fuzzy msgid "" "Default thread stack size, in bytes, for all threads (default is 1 MB)." @@ -704,75 +704,75 @@ msgstr "" "全スレッドに適用される、スレッドスタックサイズの新しいデフォルト値です。元々" "のデフォルトは 1 MB に設定されています。" -#: ../../../admin-guide/files/records.config.en.rst:335 +#: ../../../admin-guide/files/records.yaml.en.rst:335 msgid "Bind threads to specific processing units." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:338 -#: ../../../admin-guide/files/records.config.en.rst:501 -#: ../../../admin-guide/files/records.config.en.rst:786 -#: ../../../admin-guide/files/records.config.en.rst:811 -#: ../../../admin-guide/files/records.config.en.rst:2511 -#: ../../../admin-guide/files/records.config.en.rst:2627 +#: ../../../admin-guide/files/records.yaml.en.rst:338 +#: ../../../admin-guide/files/records.yaml.en.rst:501 +#: ../../../admin-guide/files/records.yaml.en.rst:786 +#: ../../../admin-guide/files/records.yaml.en.rst:811 +#: ../../../admin-guide/files/records.yaml.en.rst:2511 +#: ../../../admin-guide/files/records.yaml.en.rst:2627 msgid "Effect" msgstr "効果" -#: ../../../admin-guide/files/records.config.en.rst:340 +#: ../../../admin-guide/files/records.yaml.en.rst:340 #, fuzzy msgid "Assign threads to machine." msgstr "マシーンにスレッドを割り当てます" -#: ../../../admin-guide/files/records.config.en.rst:341 +#: ../../../admin-guide/files/records.yaml.en.rst:341 #, fuzzy msgid "Assign threads to NUMA nodes [default]." msgstr "マシーンにスレッドを割り当てます" -#: ../../../admin-guide/files/records.config.en.rst:342 +#: ../../../admin-guide/files/records.yaml.en.rst:342 #, fuzzy msgid "Assign threads to sockets." msgstr "スレッドをソケットに割り当てます" -#: ../../../admin-guide/files/records.config.en.rst:343 -#: ../../../admin-guide/files/records.config.en.rst:505 -#: ../../../admin-guide/files/records.config.en.rst:791 -#: ../../../admin-guide/files/records.config.en.rst:816 -#: ../../../admin-guide/files/records.config.en.rst:905 -#: ../../../admin-guide/files/records.config.en.rst:942 -#: ../../../admin-guide/files/records.config.en.rst:1745 -#: ../../../admin-guide/files/records.config.en.rst:1781 -#: ../../../admin-guide/files/records.config.en.rst:1997 -#: ../../../admin-guide/files/records.config.en.rst:2141 -#: ../../../admin-guide/files/records.config.en.rst:2161 -#: ../../../admin-guide/files/records.config.en.rst:2205 -#: ../../../admin-guide/files/records.config.en.rst:2361 -#: ../../../admin-guide/files/records.config.en.rst:2516 -#: ../../../admin-guide/files/records.config.en.rst:2633 -#: ../../../admin-guide/files/records.config.en.rst:2685 -#: ../../../admin-guide/files/records.config.en.rst:2726 -#: ../../../admin-guide/files/records.config.en.rst:3633 +#: ../../../admin-guide/files/records.yaml.en.rst:343 +#: ../../../admin-guide/files/records.yaml.en.rst:505 +#: ../../../admin-guide/files/records.yaml.en.rst:791 +#: ../../../admin-guide/files/records.yaml.en.rst:816 +#: ../../../admin-guide/files/records.yaml.en.rst:905 +#: ../../../admin-guide/files/records.yaml.en.rst:942 +#: ../../../admin-guide/files/records.yaml.en.rst:1745 +#: ../../../admin-guide/files/records.yaml.en.rst:1781 +#: ../../../admin-guide/files/records.yaml.en.rst:1997 +#: ../../../admin-guide/files/records.yaml.en.rst:2141 +#: ../../../admin-guide/files/records.yaml.en.rst:2161 +#: ../../../admin-guide/files/records.yaml.en.rst:2205 +#: ../../../admin-guide/files/records.yaml.en.rst:2361 +#: ../../../admin-guide/files/records.yaml.en.rst:2516 +#: ../../../admin-guide/files/records.yaml.en.rst:2633 +#: ../../../admin-guide/files/records.yaml.en.rst:2685 +#: ../../../admin-guide/files/records.yaml.en.rst:2726 +#: ../../../admin-guide/files/records.yaml.en.rst:3633 msgid "``3``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:343 +#: ../../../admin-guide/files/records.yaml.en.rst:343 #, fuzzy msgid "Assign threads to cores." msgstr "コアにスレッドを割り当てます" -#: ../../../admin-guide/files/records.config.en.rst:344 -#: ../../../admin-guide/files/records.config.en.rst:1746 -#: ../../../admin-guide/files/records.config.en.rst:1782 -#: ../../../admin-guide/files/records.config.en.rst:2145 -#: ../../../admin-guide/files/records.config.en.rst:2635 -#: ../../../admin-guide/files/records.config.en.rst:2687 +#: ../../../admin-guide/files/records.yaml.en.rst:344 +#: ../../../admin-guide/files/records.yaml.en.rst:1746 +#: ../../../admin-guide/files/records.yaml.en.rst:1782 +#: ../../../admin-guide/files/records.yaml.en.rst:2145 +#: ../../../admin-guide/files/records.yaml.en.rst:2635 +#: ../../../admin-guide/files/records.yaml.en.rst:2687 msgid "``4``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:344 +#: ../../../admin-guide/files/records.yaml.en.rst:344 #, fuzzy msgid "Assign threads to processing units." msgstr "プロセッシングユニットにスレッドを割り当てます" -#: ../../../admin-guide/files/records.config.en.rst:349 +#: ../../../admin-guide/files/records.yaml.en.rst:349 msgid "" "This option only has an affect when Traffic Server has been compiled with " "``--enable-hwloc``." @@ -780,13 +780,13 @@ msgstr "" "このオプションは Traffic Server が ``--enable-hwloc`` 付きでコンパイルされて" "いる場合のみ効果があります。" -#: ../../../admin-guide/files/records.config.en.rst:353 +#: ../../../admin-guide/files/records.yaml.en.rst:353 msgid "" "Set the maximum number of file handles for the traffic_server process as a " "percentage of the the fs.file-max proc value in Linux. The default is 90%." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:357 +#: ../../../admin-guide/files/records.yaml.en.rst:357 msgid "" "This option directs :program:`traffic_server` to spawn a crash log helper " "at startup. The value should be the path to an executable program. If the " @@ -796,24 +796,24 @@ msgid "" "implement the :option:`traffic_crashlog --wait` behavior." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:365 +#: ../../../admin-guide/files/records.yaml.en.rst:365 msgid "" "This setting not reloadable because the helper must be spawned before :" "program:`traffic_server` drops privilege. If this variable is set to " "``NULL``, no helper will be spawned." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:378 +#: ../../../admin-guide/files/records.yaml.en.rst:378 msgid "" "This setting specifies the number of active client connections for use by :" "option:`traffic_ctl server restart --drain`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:382 +#: ../../../admin-guide/files/records.yaml.en.rst:382 msgid "Network" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:386 +#: ../../../admin-guide/files/records.yaml.en.rst:386 #, python-format msgid "" "The total number of client and origin server connections that the server " @@ -825,7 +825,7 @@ msgid "" "work load." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:397 +#: ../../../admin-guide/files/records.yaml.en.rst:397 msgid "" "The connection inactivity timeout (in seconds) to apply when Traffic Server " "detects that no inactivity timeout has been applied by the HTTP state " @@ -833,50 +833,50 @@ msgid "" "default_inactivity_timeout_applied` metric is incremented." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:403 -#: ../../../admin-guide/files/records.config.en.rst:1204 -#: ../../../admin-guide/files/records.config.en.rst:1228 -#: ../../../admin-guide/files/records.config.en.rst:1238 -#: ../../../admin-guide/files/records.config.en.rst:1247 -#: ../../../admin-guide/files/records.config.en.rst:1255 -#: ../../../admin-guide/files/records.config.en.rst:1263 -#: ../../../admin-guide/files/records.config.en.rst:1271 -#: ../../../admin-guide/files/records.config.en.rst:1282 -#: ../../../admin-guide/files/records.config.en.rst:1293 -#: ../../../admin-guide/files/records.config.en.rst:1300 -#: ../../../admin-guide/files/records.config.en.rst:1308 -#: ../../../admin-guide/files/records.config.en.rst:1415 -#: ../../../admin-guide/files/records.config.en.rst:1424 -#: ../../../admin-guide/files/records.config.en.rst:2320 -#: ../../../admin-guide/files/records.config.en.rst:2373 -#: ../../../admin-guide/files/records.config.en.rst:3032 -#: ../../../admin-guide/files/records.config.en.rst:3098 -#: ../../../admin-guide/files/records.config.en.rst:3179 -#: ../../../admin-guide/files/records.config.en.rst:3185 -#: ../../../admin-guide/files/records.config.en.rst:3238 -#: ../../../admin-guide/files/records.config.en.rst:3379 -#: ../../../admin-guide/files/records.config.en.rst:3385 -#: ../../../admin-guide/files/records.config.en.rst:3401 -#: ../../../admin-guide/files/records.config.en.rst:3575 +#: ../../../admin-guide/files/records.yaml.en.rst:403 +#: ../../../admin-guide/files/records.yaml.en.rst:1204 +#: ../../../admin-guide/files/records.yaml.en.rst:1228 +#: ../../../admin-guide/files/records.yaml.en.rst:1238 +#: ../../../admin-guide/files/records.yaml.en.rst:1247 +#: ../../../admin-guide/files/records.yaml.en.rst:1255 +#: ../../../admin-guide/files/records.yaml.en.rst:1263 +#: ../../../admin-guide/files/records.yaml.en.rst:1271 +#: ../../../admin-guide/files/records.yaml.en.rst:1282 +#: ../../../admin-guide/files/records.yaml.en.rst:1293 +#: ../../../admin-guide/files/records.yaml.en.rst:1300 +#: ../../../admin-guide/files/records.yaml.en.rst:1308 +#: ../../../admin-guide/files/records.yaml.en.rst:1415 +#: ../../../admin-guide/files/records.yaml.en.rst:1424 +#: ../../../admin-guide/files/records.yaml.en.rst:2320 +#: ../../../admin-guide/files/records.yaml.en.rst:2373 +#: ../../../admin-guide/files/records.yaml.en.rst:3032 +#: ../../../admin-guide/files/records.yaml.en.rst:3098 +#: ../../../admin-guide/files/records.yaml.en.rst:3179 +#: ../../../admin-guide/files/records.yaml.en.rst:3185 +#: ../../../admin-guide/files/records.yaml.en.rst:3238 +#: ../../../admin-guide/files/records.yaml.en.rst:3379 +#: ../../../admin-guide/files/records.yaml.en.rst:3385 +#: ../../../admin-guide/files/records.yaml.en.rst:3401 +#: ../../../admin-guide/files/records.yaml.en.rst:3575 msgid "" "See :ref:`admin-performance-timeouts` for more discussion on |TS| timeouts." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:407 +#: ../../../admin-guide/files/records.yaml.en.rst:407 msgid "" "How frequent (in seconds) to check for inactive connections. If you deal " "with a lot of concurrent connections, increasing this setting can reduce " "pressure on the system." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:413 +#: ../../../admin-guide/files/records.yaml.en.rst:413 msgid "" "Controls the global default IP addresses to which to bind proxy server " "ports. The value is a space separated list of IP addresses, one per " "supported IP address family (currently IPv4 and IPv6)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:417 +#: ../../../admin-guide/files/records.yaml.en.rst:417 msgid "" "Unless explicitly specified in :ts:cv:`proxy.config.http.server_ports`, the " "server port will be bound to one of these addresses, selected by IP address " @@ -885,36 +885,36 @@ msgid "" "should be bound to the same address." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:425 +#: ../../../admin-guide/files/records.yaml.en.rst:425 msgid "" "This is ignored for inbound transparent server ports because they must be " "able to accept connections on arbitrary IP addresses." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst +#: ../../../admin-guide/files/records.yaml.en.rst msgid "Example" msgstr "例" -#: ../../../admin-guide/files/records.config.en.rst:430 +#: ../../../admin-guide/files/records.yaml.en.rst:430 msgid "" "Set the global default for IPv4 to ``192.168.101.18`` and leave the global " "default for IPv6 as any address::" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:437 +#: ../../../admin-guide/files/records.yaml.en.rst:437 msgid "" "Set the global default for IPv4 to ``191.68.101.18`` and the global default " "for IPv6 to ``fc07:192:168:101::17``::" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:444 +#: ../../../admin-guide/files/records.yaml.en.rst:444 msgid "" "This controls the global default for the local IP address for outbound " "connections to origin servers. The value is a list of space separated IP " "addresses, one per supported IP address family (currently IPv4 and IPv6)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:448 +#: ../../../admin-guide/files/records.yaml.en.rst:448 msgid "" "Unless explicitly specified in :ts:cv:`proxy.config.http.server_ports`, one " "of these addresses, selected by IP address family, will be used as the " @@ -922,87 +922,87 @@ msgid "" "all of the server ports should use the same outbound IP addresses." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:455 +#: ../../../admin-guide/files/records.yaml.en.rst:455 msgid "" "This is ignored for outbound transparent ports as the local outbound " "address will be the same as the client local address." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:459 +#: ../../../admin-guide/files/records.yaml.en.rst:459 msgid "" "Set the default local outbound IP address for IPv4 connections to " "``192.168.101.18``.::" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:465 +#: ../../../admin-guide/files/records.yaml.en.rst:465 msgid "" "Set the default local outbound IP address to ``192.168.101.17`` for IPv4 " "and ``fc07:192:168:101::17`` for IPv6.::" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:471 +#: ../../../admin-guide/files/records.yaml.en.rst:471 msgid "" "How often, in milli-seconds, to schedule IO event processing. This is " "unlikely to be necessary to tune, and we discourage setting it to a value " "smaller than 10ms (on Linux)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:477 +#: ../../../admin-guide/files/records.yaml.en.rst:477 msgid "" "How often, in milli-seconds, to schedule accept() processing. This is " "unlikely to be necessary to tune, and we discourage setting it to a value " "smaller than 10ms (on Linux)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:484 +#: ../../../admin-guide/files/records.yaml.en.rst:484 msgid "" "How long to wait until we retry various events that would otherwise block " "the network processing threads (e.g. locks). We discourage setting this to " "a value smaller than 10ms (on Linux)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:491 +#: ../../../admin-guide/files/records.yaml.en.rst:491 msgid "" "When we trigger a throttling scenario, this how long our accept() are " "delayed." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:539 +#: ../../../admin-guide/files/records.yaml.en.rst:539 msgid "" -"This particular :file:`records.config` configuration can be controlled per " +"This particular :file:`records.yaml` configuration can be controlled per " "transaction or per remap rule. As such, it augments the :file:`cache." "config` directives, since you can turn on the local caching feature without " "complex regular expression matching." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:544 +#: ../../../admin-guide/files/records.yaml.en.rst:544 msgid "" -"This implies that turning this on in your global :file:`records.config` is " +"This implies that turning this on in your global :file:`records.yaml` is " "almost never what you want; instead, you want to use this either via e.g. " "``conf_remap.so`` overrides for a certain remap rule, or through a custom " "plugin using the appropriate APIs." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:550 +#: ../../../admin-guide/files/records.yaml.en.rst:550 msgid "Local Manager" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:554 +#: ../../../admin-guide/files/records.yaml.en.rst:554 msgid "The synthetic healthcheck port." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:558 +#: ../../../admin-guide/files/records.yaml.en.rst:558 msgid "The maximum number of copies of rolled configuration files to keep." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:562 +#: ../../../admin-guide/files/records.yaml.en.rst:562 msgid "" "Designates the non-privileged account to run the :program:`traffic_server` " "process as, which also has the effect of setting ownership of configuration " "and log files." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:566 +#: ../../../admin-guide/files/records.yaml.en.rst:566 msgid "" "As of version 2.1.1 if the user_id is prefixed with pound character (``#``) " "the remainder of the string is considered to be a `numeric user identifier " @@ -1010,7 +1010,7 @@ msgid "" "``#-1`` |TS| will not change the user during startup." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:573 +#: ../../../admin-guide/files/records.yaml.en.rst:573 msgid "" "Attempting to set this option to ``root`` or ``#0`` is now forbidden, as a " "measure to increase security. Doing so will cause a fatal failure upon " @@ -1018,15 +1018,15 @@ msgid "" "this restriction:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:578 +#: ../../../admin-guide/files/records.yaml.en.rst:578 msgid "Specify ``-DBIG_SECURITY_HOLE`` in ``CXXFLAGS`` during compilation." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:580 +#: ../../../admin-guide/files/records.yaml.en.rst:580 msgid "Set the ``user_id=#-1`` and start trafficserver as root." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:584 +#: ../../../admin-guide/files/records.yaml.en.rst:584 msgid "" "This setting specifies whether the management API should be restricted to " "root processes. If this is set to ``0``, then on platforms that support " @@ -1036,25 +1036,25 @@ msgid "" "root processes." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:591 +#: ../../../admin-guide/files/records.yaml.en.rst:591 msgid "" "This setting is not reloadable, since it is must be applied when program:" "`traffic_manager` initializes." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:597 +#: ../../../admin-guide/files/records.yaml.en.rst:597 msgid "" -"This setting prevents |TS| from rewriting the :file:`records.config` " +"This setting prevents |TS| from rewriting the :file:`records.yaml` " "configuration file. Dynamic configuration changes can still be made using :" "program:`traffic_ctl config set`, but these changes will not be persisted " "on service restarts or when :option:`traffic_ctl config reload` is run." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:603 +#: ../../../admin-guide/files/records.yaml.en.rst:603 msgid "Process Manager" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:607 +#: ../../../admin-guide/files/records.yaml.en.rst:607 #, fuzzy msgid "" "The port used for internal communication between :program:`traffic_manager` " @@ -1063,54 +1063,54 @@ msgstr "" ":program:`traffic_manager` プロセスが :program:`traffic_server` プロセスを立" "ち上げる前に実行するスクリプト。" -#: ../../../admin-guide/files/records.config.en.rst:611 +#: ../../../admin-guide/files/records.yaml.en.rst:611 msgid "Alarm Configuration" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:616 +#: ../../../admin-guide/files/records.yaml.en.rst:616 msgid "The address to which the alarm script should send email." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:621 +#: ../../../admin-guide/files/records.yaml.en.rst:621 msgid "" "Name of the script file that can execute certain actions when an alarm is " "signaled. The script is invoked with up to 4 arguments:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:624 +#: ../../../admin-guide/files/records.yaml.en.rst:624 msgid "The alarm message." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:625 +#: ../../../admin-guide/files/records.yaml.en.rst:625 msgid "The value of :ts:cv:`proxy.config.product_name`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:626 +#: ../../../admin-guide/files/records.yaml.en.rst:626 msgid "The value of :ts:cv:`proxy.config.admin.user_id`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:632 +#: ../../../admin-guide/files/records.yaml.en.rst:632 msgid "" "The absolute path to the directory containing the alarm script. If this is " "not set, the script will be located relative to :ts:cv:`proxy.config." "bin_path`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:639 +#: ../../../admin-guide/files/records.yaml.en.rst:639 msgid "" "The number of seconds that Traffic Server allows the alarm script to run " "before aborting it." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:643 +#: ../../../admin-guide/files/records.yaml.en.rst:643 msgid "HTTP Engine" msgstr "HTTP エンジン" -#: ../../../admin-guide/files/records.config.en.rst:647 +#: ../../../admin-guide/files/records.yaml.en.rst:647 msgid "Ports used for proxying HTTP traffic." msgstr "HTTP トラフィックをプロキシーするために使用されるポート。" -#: ../../../admin-guide/files/records.config.en.rst:649 +#: ../../../admin-guide/files/records.yaml.en.rst:649 #, fuzzy msgid "" "This is a list, separated by space or comma, of :index:`port descriptors`. " @@ -1132,185 +1132,185 @@ msgstr "" "起きるかもしれません。値のないオプションは冪等です。後述する ``ip-out`` 以外" "の値のあるオプションは最後 ( もっとも右 ) に記述された値を使用します。" -#: ../../../admin-guide/files/records.config.en.rst:658 +#: ../../../admin-guide/files/records.yaml.en.rst:658 #, fuzzy msgid "Quick reference chart:" msgstr "早見表" -#: ../../../admin-guide/files/records.config.en.rst:661 -#: ../../../admin-guide/files/records.config.en.rst:2216 -#: ../../../admin-guide/files/records.config.en.rst:2224 +#: ../../../admin-guide/files/records.yaml.en.rst:661 +#: ../../../admin-guide/files/records.yaml.en.rst:2216 +#: ../../../admin-guide/files/records.yaml.en.rst:2224 msgid "Name" msgstr "名前" -#: ../../../admin-guide/files/records.config.en.rst:661 +#: ../../../admin-guide/files/records.yaml.en.rst:661 msgid "Note" msgstr "注釈" -#: ../../../admin-guide/files/records.config.en.rst:661 +#: ../../../admin-guide/files/records.yaml.en.rst:661 msgid "Definition" msgstr "定義" -#: ../../../admin-guide/files/records.config.en.rst:663 -#: ../../../admin-guide/files/records.config.en.rst:680 +#: ../../../admin-guide/files/records.yaml.en.rst:663 +#: ../../../admin-guide/files/records.yaml.en.rst:680 msgid "*number*" msgstr "*number*" -#: ../../../admin-guide/files/records.config.en.rst:663 +#: ../../../admin-guide/files/records.yaml.en.rst:663 #, fuzzy msgid "Required" msgstr "**必須**" -#: ../../../admin-guide/files/records.config.en.rst:663 +#: ../../../admin-guide/files/records.yaml.en.rst:663 msgid "The local port." msgstr "ローカルポート" -#: ../../../admin-guide/files/records.config.en.rst:664 -#: ../../../admin-guide/files/records.config.en.rst:685 +#: ../../../admin-guide/files/records.yaml.en.rst:664 +#: ../../../admin-guide/files/records.yaml.en.rst:685 msgid "blind" msgstr "blind" -#: ../../../admin-guide/files/records.config.en.rst:664 +#: ../../../admin-guide/files/records.yaml.en.rst:664 msgid "Blind (``CONNECT``) port." msgstr "Blind (``CONNECT``) ポート。" -#: ../../../admin-guide/files/records.config.en.rst:665 -#: ../../../admin-guide/files/records.config.en.rst:688 +#: ../../../admin-guide/files/records.yaml.en.rst:665 +#: ../../../admin-guide/files/records.yaml.en.rst:688 msgid "compress" msgstr "compress" -#: ../../../admin-guide/files/records.config.en.rst:665 -#: ../../../admin-guide/files/records.config.en.rst:1506 +#: ../../../admin-guide/files/records.yaml.en.rst:665 +#: ../../../admin-guide/files/records.yaml.en.rst:1506 #, fuzzy msgid "Not Implemented" msgstr "圧縮。実装されていません。" -#: ../../../admin-guide/files/records.config.en.rst:665 +#: ../../../admin-guide/files/records.yaml.en.rst:665 #, fuzzy msgid "Compressed." msgstr "compress" -#: ../../../admin-guide/files/records.config.en.rst:666 -#: ../../../admin-guide/files/records.config.en.rst:691 +#: ../../../admin-guide/files/records.yaml.en.rst:666 +#: ../../../admin-guide/files/records.yaml.en.rst:691 msgid "ipv4" msgstr "ipv4" -#: ../../../admin-guide/files/records.config.en.rst:666 +#: ../../../admin-guide/files/records.yaml.en.rst:666 #, fuzzy msgid "Default" msgstr "**デフォルト**" -#: ../../../admin-guide/files/records.config.en.rst:666 +#: ../../../admin-guide/files/records.yaml.en.rst:666 msgid "Bind to IPv4 address family." msgstr "IPv4 アドレスファミリーにバインド。" -#: ../../../admin-guide/files/records.config.en.rst:667 -#: ../../../admin-guide/files/records.config.en.rst:694 +#: ../../../admin-guide/files/records.yaml.en.rst:667 +#: ../../../admin-guide/files/records.yaml.en.rst:694 msgid "ipv6" msgstr "ipv6" -#: ../../../admin-guide/files/records.config.en.rst:667 +#: ../../../admin-guide/files/records.yaml.en.rst:667 msgid "Bind to IPv6 address family." msgstr "IPv6 アドレスファミリーにバインド。" -#: ../../../admin-guide/files/records.config.en.rst:668 -#: ../../../admin-guide/files/records.config.en.rst:728 +#: ../../../admin-guide/files/records.yaml.en.rst:668 +#: ../../../admin-guide/files/records.yaml.en.rst:728 msgid "ip-in" msgstr "ip-in" -#: ../../../admin-guide/files/records.config.en.rst:668 +#: ../../../admin-guide/files/records.yaml.en.rst:668 msgid "Local inbound IP address." msgstr "ローカルインバウンド IP アドレス。" -#: ../../../admin-guide/files/records.config.en.rst:669 -#: ../../../admin-guide/files/records.config.en.rst:735 +#: ../../../admin-guide/files/records.yaml.en.rst:669 +#: ../../../admin-guide/files/records.yaml.en.rst:735 msgid "ip-out" msgstr "ip-out" -#: ../../../admin-guide/files/records.config.en.rst:669 +#: ../../../admin-guide/files/records.yaml.en.rst:669 msgid "Local outbound IP address." msgstr "ローカルアウトバウンド IP アドレス。" -#: ../../../admin-guide/files/records.config.en.rst:670 -#: ../../../admin-guide/files/records.config.en.rst:740 +#: ../../../admin-guide/files/records.yaml.en.rst:670 +#: ../../../admin-guide/files/records.yaml.en.rst:740 msgid "ip-resolve" msgstr "ip-resolve" -#: ../../../admin-guide/files/records.config.en.rst:670 +#: ../../../admin-guide/files/records.yaml.en.rst:670 msgid "IP address resolution style." msgstr "IP アドレス解決スタイル。" -#: ../../../admin-guide/files/records.config.en.rst:671 -#: ../../../admin-guide/files/records.config.en.rst:705 +#: ../../../admin-guide/files/records.yaml.en.rst:671 +#: ../../../admin-guide/files/records.yaml.en.rst:705 msgid "proto" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:671 +#: ../../../admin-guide/files/records.yaml.en.rst:671 msgid "List of supported session protocols." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:672 -#: ../../../admin-guide/files/records.config.en.rst:699 -#: ../../../admin-guide/files/records.config.en.rst:2797 +#: ../../../admin-guide/files/records.yaml.en.rst:672 +#: ../../../admin-guide/files/records.yaml.en.rst:699 +#: ../../../admin-guide/files/records.yaml.en.rst:2797 msgid "ssl" msgstr "ssl" -#: ../../../admin-guide/files/records.config.en.rst:672 +#: ../../../admin-guide/files/records.yaml.en.rst:672 msgid "SSL terminated." msgstr "SSL 終端" -#: ../../../admin-guide/files/records.config.en.rst:673 -#: ../../../admin-guide/files/records.config.en.rst:710 +#: ../../../admin-guide/files/records.yaml.en.rst:673 +#: ../../../admin-guide/files/records.yaml.en.rst:710 msgid "tr-full" msgstr "tr-full" -#: ../../../admin-guide/files/records.config.en.rst:673 +#: ../../../admin-guide/files/records.yaml.en.rst:673 msgid "Fully transparent (inbound and outbound)" msgstr "完全な透過。 ( インバウンドとアウトバウンド )" -#: ../../../admin-guide/files/records.config.en.rst:674 -#: ../../../admin-guide/files/records.config.en.rst:715 +#: ../../../admin-guide/files/records.yaml.en.rst:674 +#: ../../../admin-guide/files/records.yaml.en.rst:715 msgid "tr-in" msgstr "tr-in" -#: ../../../admin-guide/files/records.config.en.rst:674 +#: ../../../admin-guide/files/records.yaml.en.rst:674 msgid "Inbound transparent." msgstr "インバウンド透過。" -#: ../../../admin-guide/files/records.config.en.rst:675 -#: ../../../admin-guide/files/records.config.en.rst:720 +#: ../../../admin-guide/files/records.yaml.en.rst:675 +#: ../../../admin-guide/files/records.yaml.en.rst:720 msgid "tr-out" msgstr "tr-out" -#: ../../../admin-guide/files/records.config.en.rst:675 +#: ../../../admin-guide/files/records.yaml.en.rst:675 msgid "Outbound transparent." msgstr "アウトバウンド透過。" -#: ../../../admin-guide/files/records.config.en.rst:676 -#: ../../../admin-guide/files/records.config.en.rst:723 +#: ../../../admin-guide/files/records.yaml.en.rst:676 +#: ../../../admin-guide/files/records.yaml.en.rst:723 msgid "tr-pass" msgstr "tr-pass" -#: ../../../admin-guide/files/records.config.en.rst:676 +#: ../../../admin-guide/files/records.yaml.en.rst:676 msgid "Pass through enabled." msgstr "パススルー有効化。" -#: ../../../admin-guide/files/records.config.en.rst:680 +#: ../../../admin-guide/files/records.yaml.en.rst:680 msgid "" "Local IP port to bind. This is the port to which ATS clients will connect." msgstr "" "バインドするローカル IP ポート。これは ATS クライアントが接続するポートで" "す。" -#: ../../../admin-guide/files/records.config.en.rst:683 +#: ../../../admin-guide/files/records.yaml.en.rst:683 msgid "Accept only the ``CONNECT`` method on this port." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:685 +#: ../../../admin-guide/files/records.yaml.en.rst:685 msgid "Not compatible with: ``tr-in``, ``ssl``." msgstr "非互換 : ``tr-in``、 ``ssl``." -#: ../../../admin-guide/files/records.config.en.rst:688 +#: ../../../admin-guide/files/records.yaml.en.rst:688 msgid "" "Compress the connection. Retained only by inertia, should be considered " "\"not implemented\"." @@ -1318,7 +1318,7 @@ msgstr "" "コネクションの圧縮。惰性により残されています。これは \"実装されていない\" と" "考えられるべきです。" -#: ../../../admin-guide/files/records.config.en.rst:691 +#: ../../../admin-guide/files/records.yaml.en.rst:691 msgid "" "Use IPv4. This is the default and is included primarily for completeness. " "This forced if the ``ip-in`` option is used with an IPv4 address." @@ -1327,7 +1327,7 @@ msgstr "" "います。 ``ip-in`` オプションが IPv4 アドレスで使用されている場合、これは強" "制されます。" -#: ../../../admin-guide/files/records.config.en.rst:694 +#: ../../../admin-guide/files/records.yaml.en.rst:694 msgid "" "Use IPv6. This is forced if the ``ip-in`` option is used with an IPv6 " "address." @@ -1335,7 +1335,7 @@ msgstr "" "IPv6 の使用。これは ``ip-in`` オプションが IPv6 アドレスで使用されている場" "合、強制されます。" -#: ../../../admin-guide/files/records.config.en.rst:697 +#: ../../../admin-guide/files/records.yaml.en.rst:697 msgid "" "Require SSL termination for inbound connections. SSL :ref:`must be " "configured ` for this option to provide a functional " @@ -1345,11 +1345,11 @@ msgstr "" "使って機能するサーバーポートを提供するには SSL が :ref:`設定されていなければ" "なりません ` 。" -#: ../../../admin-guide/files/records.config.en.rst:699 +#: ../../../admin-guide/files/records.yaml.en.rst:699 msgid "Not compatible with: ``blind``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:702 +#: ../../../admin-guide/files/records.yaml.en.rst:702 msgid "" "Specify the :ref:`session level protocols ` supported. " "These should be separated by semi-colons. For TLS proxy ports the default " @@ -1357,7 +1357,7 @@ msgid "" "HTTP only." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:708 +#: ../../../admin-guide/files/records.yaml.en.rst:708 msgid "" "Fully transparent. This is a convenience option and is identical to " "specifying both ``tr-in`` and ``tr-out``." @@ -1365,12 +1365,12 @@ msgstr "" "完全な透過。これは便利なオプションであり ``tr-in`` と ``tr-out`` の両方を記" "述することと同じです。" -#: ../../../admin-guide/files/records.config.en.rst:710 +#: ../../../admin-guide/files/records.yaml.en.rst:710 msgid "" "Not compatible with: Any option not compatible with ``tr-in`` or ``tr-out``." msgstr "非互換 : ``tr-in`` もしくは ``tr-out`` と非互換なオプション全て。" -#: ../../../admin-guide/files/records.config.en.rst:713 +#: ../../../admin-guide/files/records.yaml.en.rst:713 msgid "" "Inbound transparent. The proxy port will accept connections to any IP " "address on the port. To have IPv6 inbound transparent you must use this and " @@ -1378,22 +1378,22 @@ msgid "" "incoming_ip_to_bind` for this port." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:715 +#: ../../../admin-guide/files/records.yaml.en.rst:715 msgid "Not compatible with: ``ip-in``, ``blind``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:718 +#: ../../../admin-guide/files/records.yaml.en.rst:718 msgid "" "Outbound transparent. If ATS connects to an origin server for a transaction " "on this port, it will use the client's address as its local address. This " "overrides :ts:cv:`proxy.local.outgoing_ip_to_bind` for this port." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:720 +#: ../../../admin-guide/files/records.yaml.en.rst:720 msgid "Not compatible with: ``ip-out``, ``ip-resolve``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:723 +#: ../../../admin-guide/files/records.yaml.en.rst:723 msgid "" "Transparent pass through. This option is useful only for inbound " "transparent proxy ports. If the parsing of the expected HTTP header fails, " @@ -1409,7 +1409,7 @@ msgstr "" "ンと同様に :ts:cv:`proxy.config.http.use_client_target_addr` を事実上有効化" "します。" -#: ../../../admin-guide/files/records.config.en.rst:726 +#: ../../../admin-guide/files/records.yaml.en.rst:726 msgid "" "Set the local IP address for the port. This is the address to which clients " "will connect. This forces the IP address family for the port. The ``ipv4`` " @@ -1419,11 +1419,11 @@ msgid "" "local.incoming_ip_to_bind` is used." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:728 +#: ../../../admin-guide/files/records.yaml.en.rst:728 msgid "Not compatible with: ``tr-in``." msgstr "非互換 : ``tr-in``" -#: ../../../admin-guide/files/records.config.en.rst:731 +#: ../../../admin-guide/files/records.yaml.en.rst:731 msgid "" "Set the local IP address for outbound connections. This is the address used " "by ATS locally when it connects to an origin server for transactions on " @@ -1435,7 +1435,7 @@ msgstr "" "されるアドレスです。これが設定されなかった場合、 :ts:cv:`proxy.local." "outgoing_ip_to_bind` が使用されます。" -#: ../../../admin-guide/files/records.config.en.rst:733 +#: ../../../admin-guide/files/records.yaml.en.rst:733 msgid "" "This option can used multiple times, once for each IP address family. The " "address used is selected by the IP address family of the origin server " @@ -1445,11 +1445,11 @@ msgstr "" "ます。使用されるアドレスはオリジンサーバーアドレスの IP アドレスファミリーか" "ら選択されます。" -#: ../../../admin-guide/files/records.config.en.rst:735 +#: ../../../admin-guide/files/records.yaml.en.rst:735 msgid "Not compatible with: ``tr-out``." msgstr "非互換 : ``tr-out``" -#: ../../../admin-guide/files/records.config.en.rst:738 +#: ../../../admin-guide/files/records.yaml.en.rst:738 msgid "" "Set the :ts:cv:`host resolution style ` for " "transactions on this proxy port." @@ -1457,17 +1457,17 @@ msgstr "" "このプロキシーポートのトランザクション用の :ts:cv:`ホスト解決方法 ` の設定。" -#: ../../../admin-guide/files/records.config.en.rst:740 +#: ../../../admin-guide/files/records.yaml.en.rst:740 msgid "" "Not compatible with: ``tr-out`` - this option requires a value of ``client;" "none`` which is forced and should not be explicitly specified." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:744 +#: ../../../admin-guide/files/records.yaml.en.rst:744 msgid "Listen on port 80 on any address for IPv4 and IPv6.::" msgstr "IPv4 と IPv6 のどのアドレスでもポート 80 でリッスンします。" -#: ../../../admin-guide/files/records.config.en.rst:750 +#: ../../../admin-guide/files/records.yaml.en.rst:750 msgid "" "Listen transparently on any IPv4 address on port 8080, and transparently on " "port 8080 on local address ``fc01:10:10:1::1`` (which implies ``ipv6``).::" @@ -1476,7 +1476,7 @@ msgstr "" "``fc01:10:10:1::1`` ( これは ``IPv6`` を意味します。) のポート 8080 を透過的" "にリッスンします。" -#: ../../../admin-guide/files/records.config.en.rst:758 +#: ../../../admin-guide/files/records.yaml.en.rst:758 msgid "" "Listen on port 8080 for IPv6, fully transparent. Set up an SSL port on 443. " "These ports will use the IP address from :ts:cv:`proxy.local." @@ -1490,20 +1490,20 @@ msgstr "" "でリッスンして、オリジンサーバーへはローカルアドレス ``10.10.10.1`` を IPv4 " "で ``fc01:10:10:1::1`` を IPv6 で使用して接続します。" -#: ../../../admin-guide/files/records.config.en.rst:764 +#: ../../../admin-guide/files/records.yaml.en.rst:764 msgid "" "Listen on port 9090 for TLS enabled HTTP/2 or HTTP connections, accept no " "other session protocols.::" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:770 +#: ../../../admin-guide/files/records.yaml.en.rst:770 msgid "" "The range of origin server ports that can be used for tunneling via " "``CONNECT``." msgstr "" "``CONNECT`` によるトンネリングに使用可能なオリジンサーバーポートの幅。" -#: ../../../admin-guide/files/records.config.en.rst:772 +#: ../../../admin-guide/files/records.yaml.en.rst:772 #, fuzzy msgid "" "|TS| allows tunnels only to the specified ports. Supports both wildcards " @@ -1512,7 +1512,7 @@ msgstr "" "Traffic Server は指定されたポートへしかトンネルを許可しません。ワイルドカー" "ド ('\\*') とレンジ (\"0-123\") の両方をサポートします。" -#: ../../../admin-guide/files/records.config.en.rst:777 +#: ../../../admin-guide/files/records.yaml.en.rst:777 #, fuzzy msgid "" "These are the ports on the *origin server*, not |TS| :ts:cv:`proxy ports " @@ -1521,35 +1521,35 @@ msgstr "" "これらは *オリジンサーバー* のポートであり、 Traffic Server :ts:cv:`プロキ" "シーポート ` ではありません。" -#: ../../../admin-guide/files/records.config.en.rst:783 +#: ../../../admin-guide/files/records.yaml.en.rst:783 msgid "" "Set how the ``Via`` field is handled on a request to the origin server." msgstr "" "オリジンサーバーへのリクエストで ``Via`` フィールドがどのように処理されるか" "の設定。" -#: ../../../admin-guide/files/records.config.en.rst:788 +#: ../../../admin-guide/files/records.yaml.en.rst:788 #, fuzzy msgid "Do not modify or set this Via header." msgstr "via ヘッダーを変更または設定しない" -#: ../../../admin-guide/files/records.config.en.rst:789 +#: ../../../admin-guide/files/records.yaml.en.rst:789 #, fuzzy msgid "Update the Via, with normal verbosity." msgstr "通常の冗長さで via ヘッダーを更新" -#: ../../../admin-guide/files/records.config.en.rst:790 +#: ../../../admin-guide/files/records.yaml.en.rst:790 #, fuzzy msgid "Update the Via, with higher verbosity." msgstr "より高い冗長さで via ヘッダーを更新" -#: ../../../admin-guide/files/records.config.en.rst:791 +#: ../../../admin-guide/files/records.yaml.en.rst:791 #, fuzzy msgid "Update the Via, with highest verbosity." msgstr "もっとも高い冗長さで via ヘッダーを更新" -#: ../../../admin-guide/files/records.config.en.rst:796 -#: ../../../admin-guide/files/records.config.en.rst:821 +#: ../../../admin-guide/files/records.yaml.en.rst:796 +#: ../../../admin-guide/files/records.yaml.en.rst:821 msgid "" "The ``Via`` header string can be decoded with the `Via Decoder Ring `_." @@ -1557,91 +1557,91 @@ msgstr "" "``Via`` ヘッダーは `Via Decoder Ring `_ でデコードできます。" -#: ../../../admin-guide/files/records.config.en.rst:802 +#: ../../../admin-guide/files/records.yaml.en.rst:802 msgid "" "Set the server and version string in the ``Via`` request header to the " "origin server which is inserted when the value of :ts:cv:`proxy.config.http." "insert_request_via_str` is not ``0``. Note that the actual default value " "is defined with ``\"ApacheTrafficServer/\" PACKAGE_VERSION`` in a C++ " "source code, and you must write such as ``ApacheTrafficServer/6.0.0`` if " -"you really set a value with the version in :file:`records.config` file. If " +"you really set a value with the version in :file:`records.yaml` file. If " "you want to hide the version, you can set this value to " "``ApacheTrafficServer``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:808 +#: ../../../admin-guide/files/records.yaml.en.rst:808 msgid "Set how the ``Via`` field is handled on the response to the client." msgstr "" "クライアントへのレスポンスで ``Via`` フィールドがどのように処理されるかの設" "定。" -#: ../../../admin-guide/files/records.config.en.rst:813 +#: ../../../admin-guide/files/records.yaml.en.rst:813 #, fuzzy msgid "Do not modify or set this via header." msgstr "via ヘッダーを変更または設定しない" -#: ../../../admin-guide/files/records.config.en.rst:814 +#: ../../../admin-guide/files/records.yaml.en.rst:814 #, fuzzy msgid "Update the via, with normal verbosity." msgstr "通常の冗長さで via ヘッダーを更新" -#: ../../../admin-guide/files/records.config.en.rst:815 +#: ../../../admin-guide/files/records.yaml.en.rst:815 #, fuzzy msgid "Update the via, with higher verbosity." msgstr "より高い冗長さで via ヘッダーを更新" -#: ../../../admin-guide/files/records.config.en.rst:816 +#: ../../../admin-guide/files/records.yaml.en.rst:816 #, fuzzy msgid "Update the via, with highest verbosity." msgstr "もっとも高い冗長さで via ヘッダーを更新" -#: ../../../admin-guide/files/records.config.en.rst:827 +#: ../../../admin-guide/files/records.yaml.en.rst:827 msgid "" "Set the server and version string in the ``Via`` response header to the " "client which is inserted when the value of :ts:cv:`proxy.config.http." "insert_response_via_str` is not ``0``. Note that the actual default value " "is defined with ``\"ApacheTrafficServer/\" PACKAGE_VERSION`` in a C++ " "source code, and you must write such as ``ApacheTrafficServer/6.0.0`` if " -"you really set a value with the version in :file:`records.config` file. If " +"you really set a value with the version in :file:`records.yaml` file. If " "you want to hide the version, you can set this value to " "``ApacheTrafficServer``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:832 -#: ../../../admin-guide/files/records.config.en.rst:847 +#: ../../../admin-guide/files/records.yaml.en.rst:832 +#: ../../../admin-guide/files/records.yaml.en.rst:847 msgid "You can specify one of the following:" msgstr "次のうち 1 つを指定できます。" -#: ../../../admin-guide/files/records.config.en.rst:837 +#: ../../../admin-guide/files/records.yaml.en.rst:837 msgid "" "|TS| will buffer the request until the post body has been received and then " "send the request to the origin server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:839 +#: ../../../admin-guide/files/records.yaml.en.rst:839 msgid "" "Immediately return a ``100 Continue`` from |TS| without waiting for the " "post body." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:852 +#: ../../../admin-guide/files/records.yaml.en.rst:852 #, fuzzy msgid "No ``Server`` header is added to the response." msgstr "``0`` : Server ヘッダーはレスポンスに追加されません。" -#: ../../../admin-guide/files/records.config.en.rst:853 +#: ../../../admin-guide/files/records.yaml.en.rst:853 msgid "" "The ``Server`` header is added according to :ts:cv:`proxy.config.http." "response_server_str`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:855 +#: ../../../admin-guide/files/records.yaml.en.rst:855 msgid "" "The ``Server`` header is added only if the response from origin does not " "have one already." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:863 +#: ../../../admin-guide/files/records.yaml.en.rst:863 msgid "" "The ``Server`` string that |TS| will insert in a response header (if " "requested, see above). Note that the actual default value is defined with ``" @@ -1650,22 +1650,22 @@ msgid "" "config`. If you want to hide the version, you can set this value to ``ATS``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:874 +#: ../../../admin-guide/files/records.yaml.en.rst:874 msgid "" "This option specifies whether |TS| should insert an ``Age`` header in the " "response. The value is the cache's estimate of the amount of time since the " "response was generated or revalidated by the origin server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:881 +#: ../../../admin-guide/files/records.yaml.en.rst:881 msgid "No ``Age`` header is added." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:882 +#: ../../../admin-guide/files/records.yaml.en.rst:882 msgid "``Age`` header is added." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:888 +#: ../../../admin-guide/files/records.yaml.en.rst:888 msgid "" "Enables (``1``) or disables (``0``) ``.com`` domain expansion. This " "configures the Traffic Server to resolve unqualified hostnames by " @@ -1674,49 +1674,49 @@ msgid "" "then Traffic Server redirects the request to ``www.host.com``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:896 +#: ../../../admin-guide/files/records.yaml.en.rst:896 msgid "Specifies whether |TS| can generate a chunked response:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:901 +#: ../../../admin-guide/files/records.yaml.en.rst:901 msgid "Never respond with chunked encoding." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:902 +#: ../../../admin-guide/files/records.yaml.en.rst:902 msgid "Always respond with chunked encoding." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:903 +#: ../../../admin-guide/files/records.yaml.en.rst:903 msgid "" "Generate a chunked response if the origin server has previously returned " "HTTP/1.1." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:905 +#: ../../../admin-guide/files/records.yaml.en.rst:905 msgid "" "Generate a chunked response if the client request is HTTP/1.1 and the " "origin server has previously returned HTTP/1.1." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:911 +#: ../../../admin-guide/files/records.yaml.en.rst:911 msgid "" "If HTTP/1.1 is used, then |TS| can use keep-alive connections with " "pipelining to origin servers." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:914 +#: ../../../admin-guide/files/records.yaml.en.rst:914 msgid "" "If HTTP/1.0 is used, then |TS| can use keep-alive connections without " "pipelining to origin servers." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:917 +#: ../../../admin-guide/files/records.yaml.en.rst:917 msgid "" "If HTTP/0.9 is used, then |TS| does not use keep-alive connections to " "origin servers." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:923 +#: ../../../admin-guide/files/records.yaml.en.rst:923 msgid "" "If chunked transfer encoding is enabled with :ts:cv:`proxy.config.http." "chunking_enabled`, and the conditions specified by that option's setting " @@ -1724,40 +1724,40 @@ msgid "" "chunks, in bytes, to use when sending content to an HTTP/1.1 client." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:932 +#: ../../../admin-guide/files/records.yaml.en.rst:932 msgid "" "Specifies when and how |TS| uses HTTP/1.1 to communicate with the origin " "server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:938 +#: ../../../admin-guide/files/records.yaml.en.rst:938 msgid "Never use HTTP/1.1." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:939 +#: ../../../admin-guide/files/records.yaml.en.rst:939 msgid "Always use HTTP/1.1." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:940 +#: ../../../admin-guide/files/records.yaml.en.rst:940 msgid "" "Use HTTP/1.1 with origin connections only if the server has previously " "eturned HTTP/1.1." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:942 +#: ../../../admin-guide/files/records.yaml.en.rst:942 msgid "" "If the client request is HTTP/1.1 and the origin server has previously " "returned HTTP/1.1, then use HTTP/1.1 for origin server connections." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:948 +#: ../../../admin-guide/files/records.yaml.en.rst:948 msgid "" "If :ts:cv:`proxy.config.http.use_client_target_addr` is set to ``1``, then " "options ``2`` and ``3`` for this configuration variable cause the proxy to " "use the client HTTP version for upstream requests." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:961 +#: ../../../admin-guide/files/records.yaml.en.rst:961 msgid "" "If enabled (``1``) anytime a request contains a ``Authorization``, ``Proxy-" "Authorization``, or ``Www-Authenticate`` header the connection will be " @@ -1765,58 +1765,58 @@ msgid "" "(``0``) the connection will be available for reuse." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:968 +#: ../../../admin-guide/files/records.yaml.en.rst:968 msgid "" "Enable and set the ability to re-use server connections across client " "connections. The valid values are:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:974 -#: ../../../admin-guide/files/records.config.en.rst:2440 +#: ../../../admin-guide/files/records.yaml.en.rst:974 +#: ../../../admin-guide/files/records.yaml.en.rst:2440 msgid "``none``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:974 +#: ../../../admin-guide/files/records.yaml.en.rst:974 msgid "" "Do not match and do not re-use server sessions. If using this in :ref:`ts-" "overridable-config` (like the :ref:`admin-plugins-conf-remap`), use the " "integer ``0`` instead." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:977 +#: ../../../admin-guide/files/records.yaml.en.rst:977 msgid "``both``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:977 +#: ../../../admin-guide/files/records.yaml.en.rst:977 msgid "" "Re-use server sessions, if *both* the IP address and fully qualified domain " "name match. If using this in :ref:`ts-overridable-config` (like the :ref:" "`admin-plugins-conf-remap`), use the integer ``1`` instead." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:980 +#: ../../../admin-guide/files/records.yaml.en.rst:980 msgid "``ip``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:980 +#: ../../../admin-guide/files/records.yaml.en.rst:980 msgid "" "Re-use server sessions, checking only that the IP address and port of the " "origin server matches. If using this in :ref:`ts-overridable-config` (like " "the :ref:`admin-plugins-conf-remap`), use the integer ``2`` instead." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:984 +#: ../../../admin-guide/files/records.yaml.en.rst:984 msgid "``host``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:984 +#: ../../../admin-guide/files/records.yaml.en.rst:984 msgid "" "Re-use server sessions, checking only that the fully qualified domain name " "matches. If using this in :ref:`ts-overridable-config` (like the :ref:" "`admin-plugins-conf-remap`), use the integer ``3`` instead." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:989 +#: ../../../admin-guide/files/records.yaml.en.rst:989 msgid "" "It is strongly recommended to use either ``none`` or ``both`` for this " "value unless you have a specific need for the other settings. The most " @@ -1826,40 +1826,40 @@ msgid "" "connection so use with caution." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:998 +#: ../../../admin-guide/files/records.yaml.en.rst:998 msgid "" "Server sessions to different ports never match even if the FQDN and IP " "address match." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1003 +#: ../../../admin-guide/files/records.yaml.en.rst:1003 msgid "" "Control the scope of server session re-use if it is enabled by :ts:cv:" "`proxy.config.http.server_session_sharing.match`. Valid values are:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1009 +#: ../../../admin-guide/files/records.yaml.en.rst:1009 msgid "``global``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1009 +#: ../../../admin-guide/files/records.yaml.en.rst:1009 msgid "Re-use sessions from a global pool of all server sessions." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1010 +#: ../../../admin-guide/files/records.yaml.en.rst:1010 msgid "``thread``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1010 +#: ../../../admin-guide/files/records.yaml.en.rst:1010 msgid "Re-use sessions from a per-thread pool." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1016 +#: ../../../admin-guide/files/records.yaml.en.rst:1016 msgid "" "Control the re-use of an server session by a user agent (client) session." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1018 +#: ../../../admin-guide/files/records.yaml.en.rst:1018 msgid "" "If a user agent performs more than one HTTP transaction on its connection " "to Traffic Server a server session must be obtained for the second (and " @@ -1867,7 +1867,7 @@ msgid "" "server session is selected." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1022 +#: ../../../admin-guide/files/records.yaml.en.rst:1022 msgid "" "If this setting is ``0`` then after the first transaction the server " "session for that transaction is released to the server pool (if any). When " @@ -1876,7 +1876,7 @@ msgid "" "pool." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1026 +#: ../../../admin-guide/files/records.yaml.en.rst:1026 msgid "" "If this setting is not ``0`` then the current server session for the user " "agent session is \"sticky\". It will be preferred to any other server " @@ -1888,52 +1888,52 @@ msgid "" "will be released to the pool and a different session selected or created." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1036 +#: ../../../admin-guide/files/records.yaml.en.rst:1036 msgid "" "Enables (``1``) or disables (``0``) :program:`traffic_cop` heartbeat " "logging." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1040 +#: ../../../admin-guide/files/records.yaml.en.rst:1040 msgid "" "For fully transparent ports use the same origin server address as the " "client." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1042 +#: ../../../admin-guide/files/records.yaml.en.rst:1042 msgid "" "This option causes |TS| to avoid where possible doing DNS lookups in " "forward transparent proxy mode. The option is only effective if the " "following three conditions are true:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1046 +#: ../../../admin-guide/files/records.yaml.en.rst:1046 msgid "|TS| is in forward proxy mode." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1047 +#: ../../../admin-guide/files/records.yaml.en.rst:1047 msgid "The proxy port is inbound transparent." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1048 +#: ../../../admin-guide/files/records.yaml.en.rst:1048 msgid "The target URL has not been modified by either remapping or a plugin." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1050 +#: ../../../admin-guide/files/records.yaml.en.rst:1050 msgid "" "If any of these conditions are not true, then normal DNS processing is done " "for the connection." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1053 +#: ../../../admin-guide/files/records.yaml.en.rst:1053 msgid "There are three valid values." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1058 +#: ../../../admin-guide/files/records.yaml.en.rst:1058 msgid "Disables the feature." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1059 +#: ../../../admin-guide/files/records.yaml.en.rst:1059 msgid "" "Enables the feature with address verification. The proxy does the regular " "DNS processing. If the client-specified origin address is not in the set of " @@ -1941,7 +1941,7 @@ msgid "" "address, but the result is not cached." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1063 +#: ../../../admin-guide/files/records.yaml.en.rst:1063 msgid "" "Enables the feature with no address verification. No DNS processing is " "performed. The result is cached (if allowed otherwise). This option is " @@ -1950,14 +1950,14 @@ msgid "" "details." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1070 +#: ../../../admin-guide/files/records.yaml.en.rst:1070 msgid "" "If all of these conditions are met, then the origin server IP address is " "retrieved from the original client connection, rather than through HostDB " "or DNS lookup. In effect, client DNS resolution is used instead of |TS| DNS." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1074 +#: ../../../admin-guide/files/records.yaml.en.rst:1074 msgid "" "This can be used to be a little more efficient (looking up the target once " "by the client rather than by both the client and |TS|) but the primary use " @@ -1965,7 +1965,7 @@ msgid "" "cases are:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1079 +#: ../../../admin-guide/files/records.yaml.en.rst:1079 msgid "" "Embedded IP addresses in a protocol with DNS load sharing. In this case, " "even though |TS| and the client both make the same request to the same DNS " @@ -1975,7 +1975,7 @@ msgid "" "the address as a security measure." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1086 +#: ../../../admin-guide/files/records.yaml.en.rst:1086 msgid "" "The client has access to local DNS zone information which is not available " "to |TS|. There are corporate nets with local DNS information for internal " @@ -1985,7 +1985,7 @@ msgid "" "In such as case the client supplied target address must be used." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1094 +#: ../../../admin-guide/files/records.yaml.en.rst:1094 msgid "" "This solution must be considered interim. In the longer term, it should be " "possible to arrange for much finer grained control of DNS lookup so that " @@ -1996,30 +1996,30 @@ msgid "" "it for specific domains." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1105 +#: ../../../admin-guide/files/records.yaml.en.rst:1105 msgid "Enables (``1``) or disables (``0``) incoming keep-alive connections." msgstr "" "入ってくる接続の keep-alive を有効化 (``1``) または無効化 (``0``) します。" -#: ../../../admin-guide/files/records.config.en.rst:1110 +#: ../../../admin-guide/files/records.yaml.en.rst:1110 msgid "Enables (``1``) or disables (``0``) outgoing keep-alive connections." msgstr "" "出て行く接続の keep-alive を有効化 (``1``) または無効化 (``0``) します。" -#: ../../../admin-guide/files/records.config.en.rst:1114 +#: ../../../admin-guide/files/records.yaml.en.rst:1114 msgid "" "Enabling keep-alive does not automatically enable purging of keep-alive " "requests when nearing the connection limit, that is controlled by :ts:cv:" "`proxy.config.http.server_max_connections`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1121 +#: ../../../admin-guide/files/records.yaml.en.rst:1121 msgid "" "Controls whether new POST requests re-use keep-alive sessions (``1``) or " "create new connections per request (``0``)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1126 +#: ../../../admin-guide/files/records.yaml.en.rst:1126 msgid "" "Enables (``1``) or disables (``0``) additional handling of ``Accept-" "encoding`` header on incoming requests based on the ``User-Agent`` header, " @@ -2027,121 +2027,121 @@ msgid "" "encodings they are able to accept." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1133 +#: ../../../admin-guide/files/records.yaml.en.rst:1133 msgid "" "Allows you to return a 405 Method Not Supported with Posts also containing " "an Expect: 100-continue." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1136 +#: ../../../admin-guide/files/records.yaml.en.rst:1136 msgid "" "When a Post w/ Expect: 100-continue is blocked the stat proxy.process.http." "disallowed_post_100_continue will be incremented." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1141 +#: ../../../admin-guide/files/records.yaml.en.rst:1141 msgid "" "Configures the default buffer size, in bytes, to allocate for incoming " "request bodies which lack a ``Content-length`` header." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1148 +#: ../../../admin-guide/files/records.yaml.en.rst:1148 msgid "" "Controls the maximum size, in bytes, of an HTTP header in requests. Headers " "in a request which exceed this size will cause the entire request to be " "treated as invalid and rejected by the proxy." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1154 +#: ../../../admin-guide/files/records.yaml.en.rst:1154 msgid "" "Controls the maximum size, in bytes, of headers in HTTP responses from the " "proxy. Any responses with a header exceeding this limit will be treated as " "invalid and a client error will be returned instead." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1161 +#: ../../../admin-guide/files/records.yaml.en.rst:1161 msgid "" "An arbitrary string value that, if set, will be used to replace any request " "``User-Agent`` header." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1166 +#: ../../../admin-guide/files/records.yaml.en.rst:1166 msgid "" "Enables (``1``) or disables (``0``) Traffic Server to return a 400 Bad " "Request if client's request URI includes character which is not RFC 3986 " "compliant" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1170 +#: ../../../admin-guide/files/records.yaml.en.rst:1170 msgid "Parent Proxy Configuration" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1175 +#: ../../../admin-guide/files/records.yaml.en.rst:1175 msgid "" "Enables (``1``) or disables (``0``) the parent caching option. Refer to :" "ref:`admin-hierarchical-caching`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1180 +#: ../../../admin-guide/files/records.yaml.en.rst:1180 msgid "" "The amount of time allowed between connection retries to a parent cache " "that is unavailable." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1185 +#: ../../../admin-guide/files/records.yaml.en.rst:1185 msgid "" "The number of times the connection to the parent cache can fail before " "Traffic Server considers the parent unavailable." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1191 +#: ../../../admin-guide/files/records.yaml.en.rst:1191 msgid "" "The total number of connection attempts allowed to a parent cache before " "Traffic Server bypasses the parent or fails the request (depending on the " "``go_direct`` option in the :file:`parent.config` file)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1197 +#: ../../../admin-guide/files/records.yaml.en.rst:1197 msgid "" "The total number of connection attempts allowed per parent, if multiple " "parents are used." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1202 +#: ../../../admin-guide/files/records.yaml.en.rst:1202 msgid "The timeout value (in seconds) for parent cache connection attempts." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1210 +#: ../../../admin-guide/files/records.yaml.en.rst:1210 msgid "" "Configures Traffic Server to send proxy authentication headers on to the " "parent cache." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1215 +#: ../../../admin-guide/files/records.yaml.en.rst:1215 msgid "" "Don't try to resolve DNS, forward all DNS requests to the parent. This is " "off (``0``) by default." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1218 +#: ../../../admin-guide/files/records.yaml.en.rst:1218 msgid "HTTP Connection Timeouts" msgstr "HTTP 接続タイムアウト" -#: ../../../admin-guide/files/records.config.en.rst:1224 +#: ../../../admin-guide/files/records.yaml.en.rst:1224 msgid "" "Specifies how long Traffic Server keeps connections to clients open for a " "subsequent request after a transaction ends. A value of ``0`` will disable " "the no activity timeout." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1234 +#: ../../../admin-guide/files/records.yaml.en.rst:1234 msgid "" "Specifies how long Traffic Server keeps connections to origin servers open " "for a subsequent transfer of data after a transaction ends. A value of " "``0`` will disable the no activity timeout." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1244 +#: ../../../admin-guide/files/records.yaml.en.rst:1244 msgid "" "Specifies how long Traffic Server keeps connections to clients open if a " "transaction stalls." @@ -2149,7 +2149,7 @@ msgstr "" "トランザクションがストールした場合に Traffic Server がクライアントとの接続を" "どれだけ長く維持するかを指定します。" -#: ../../../admin-guide/files/records.config.en.rst:1253 +#: ../../../admin-guide/files/records.yaml.en.rst:1253 msgid "" "Specifies how long Traffic Server keeps connections to origin servers open " "if the transaction stalls." @@ -2157,7 +2157,7 @@ msgstr "" "トランザクションがストールした場合に Traffic Server がオリジンサーバーとの接" "続をどれだけ長く維持するかを指定します。" -#: ../../../admin-guide/files/records.config.en.rst:1261 +#: ../../../admin-guide/files/records.yaml.en.rst:1261 #, fuzzy msgid "" "Specifies how long Traffic Server keeps connections open if a websocket " @@ -2166,12 +2166,12 @@ msgstr "" "トランザクションがストールした場合に Traffic Server がクライアントとの接続を" "どれだけ長く維持するかを指定します。" -#: ../../../admin-guide/files/records.config.en.rst:1269 +#: ../../../admin-guide/files/records.yaml.en.rst:1269 msgid "" "The maximum amount of time Traffic Server keeps websocket connections open." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1277 +#: ../../../admin-guide/files/records.yaml.en.rst:1277 msgid "" "The maximum amount of time Traffic Server can remain connected to a client. " "If the transfer to the client is not complete before this timeout expires, " @@ -2181,11 +2181,11 @@ msgstr "" "の転送がこのタイムアウトまでに完了しない場合、Traffic Server は接続を閉じま" "す。" -#: ../../../admin-guide/files/records.config.en.rst:1280 +#: ../../../admin-guide/files/records.yaml.en.rst:1280 msgid "The value of ``0`` specifies that there is no timeout." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1288 +#: ../../../admin-guide/files/records.yaml.en.rst:1288 msgid "" "The maximum amount of time Traffic Server waits for fulfillment of a " "connection request to an origin server. If Traffic Server does not complete " @@ -2196,17 +2196,17 @@ msgstr "" "時間です。Traffic Server がオリジンサーバーへの転送をタイムアウトまでに完了" "しない場合、Traffic Server は接続要求を終了します。" -#: ../../../admin-guide/files/records.config.en.rst:1291 +#: ../../../admin-guide/files/records.yaml.en.rst:1291 msgid "The default value of ``0`` specifies that there is no timeout." msgstr "デフォルト値 ``0`` はタイムアウト無しを指定しています。" -#: ../../../admin-guide/files/records.config.en.rst:1298 +#: ../../../admin-guide/files/records.yaml.en.rst:1298 msgid "" "The timeout interval in seconds before Traffic Server closes a connection " "that has no activity." msgstr "Traffic Server が活動のない接続をクローズするまでの秒数です。" -#: ../../../admin-guide/files/records.config.en.rst:1306 +#: ../../../admin-guide/files/records.yaml.en.rst:1306 msgid "" "Specifies how long Traffic Server continues a background fill before giving " "up and dropping the origin server connection." @@ -2214,7 +2214,7 @@ msgstr "" "オリジンサーバーとの接続を放棄する前に Traffic Server が background fill を" "継続する時間を指定します。" -#: ../../../admin-guide/files/records.config.en.rst:1314 +#: ../../../admin-guide/files/records.yaml.en.rst:1314 msgid "" "The proportion of total document size already transferred when a client " "aborts at which the proxy continues fetching the document from the origin " @@ -2224,11 +2224,11 @@ msgstr "" "らその取得を継続するクライアントが中断した時点ですでに転送済みのドキュメント" "の総サイズに対する割合 (**background fill**) 。" -#: ../../../admin-guide/files/records.config.en.rst:1318 +#: ../../../admin-guide/files/records.yaml.en.rst:1318 msgid "HTTP Redirection" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1324 +#: ../../../admin-guide/files/records.yaml.en.rst:1324 msgid "" "This setting indicates whether Trafficserver does a redirect follow " "location on receiving a 3XX Redirect response from the Origin server. The " @@ -2236,14 +2236,14 @@ msgid "" "the final response from the redirected-to location." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1332 +#: ../../../admin-guide/files/records.yaml.en.rst:1332 msgid "" "This setting determines the maximum number of times Trafficserver does a " "redirect follow location on receiving a 3XX Redirect response for a given " "client request." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1337 +#: ../../../admin-guide/files/records.yaml.en.rst:1337 msgid "" "This setting enables Trafficserver to not include the port in the Host " "header in the redirect follow request for default/standard ports (e.g. 80 " @@ -2251,7 +2251,7 @@ msgid "" "Host header if it's non-default." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1344 +#: ../../../admin-guide/files/records.yaml.en.rst:1344 msgid "" "This setting enables Trafficserver to allow using original request cache " "key (for example, set using a TS API) during a 3xx redirect follow. The " @@ -2259,11 +2259,11 @@ msgid "" "3xx response as the cache key." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1348 +#: ../../../admin-guide/files/records.yaml.en.rst:1348 msgid "Origin Server Connect Attempts" msgstr "オリジンサーバーへの接続の試行" -#: ../../../admin-guide/files/records.config.en.rst:1354 +#: ../../../admin-guide/files/records.yaml.en.rst:1354 msgid "" "The maximum number of connection retries Traffic Server can make when the " "origin server is not responding. Each retry attempt lasts for `proxy.config." @@ -2273,7 +2273,7 @@ msgid "" "limit the number of retry attempts to the known dead origin." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1363 +#: ../../../admin-guide/files/records.yaml.en.rst:1363 msgid "" "Maximum number of connection retries Traffic Server can make while an " "origin is marked dead. Typically this value is smaller than `proxy.config." @@ -2283,7 +2283,7 @@ msgid "" "setting." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1370 +#: ../../../admin-guide/files/records.yaml.en.rst:1370 msgid "" "Limits the number of socket connections across all origin servers to the " "value specified. To disable, set to zero (``0``)." @@ -2291,7 +2291,7 @@ msgstr "" "全オリジンサーバーにおけるソケットの接続数を指定した値に制限します。無効化す" "るには、ゼロ (``0``) を設定してください。" -#: ../../../admin-guide/files/records.config.en.rst:1373 +#: ../../../admin-guide/files/records.yaml.en.rst:1373 #, fuzzy msgid "" "This value is used in determining when and if to prune active origin " @@ -2304,7 +2304,7 @@ msgstr "" "connections_throttle` の接続数まで消費され、有効な接続から入ってくるリクエス" "トを次々とタイムアウトさせます。<" -#: ../../../admin-guide/files/records.config.en.rst:1382 +#: ../../../admin-guide/files/records.yaml.en.rst:1382 msgid "" "Limits the number of socket connections per origin server to the value " "specified. To enable, set to one (``1``)." @@ -2312,7 +2312,7 @@ msgstr "" "オリジンサーバー毎のソケットの接続数を指定した値に制限します。有効化するに" "は、イチ (``1``) を設定してください。" -#: ../../../admin-guide/files/records.config.en.rst:1388 +#: ../../../admin-guide/files/records.yaml.en.rst:1388 msgid "" "Limits the number of requests to be queued when the :ts:cv:`proxy.config." "http.origin_max_connections` is reached. When disabled (``-1``) requests " @@ -2323,7 +2323,7 @@ msgid "" "immediately fail." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1396 +#: ../../../admin-guide/files/records.yaml.en.rst:1396 msgid "" "As connection to an origin server are opened, keep at least 'n' number of " "connections open to that origin, even if the connection isn't used for a " @@ -2337,7 +2337,7 @@ msgstr "" "準備に必要となる時間を不要とします。有効化するには、イチ (``1``) を設定して" "ください。" -#: ../../../admin-guide/files/records.config.en.rst:1405 +#: ../../../admin-guide/files/records.yaml.en.rst:1405 msgid "" "The maximum number of failed connection attempts allowed before a round-" "robin entry is marked as 'down' if a server has round-robin DNS entries." @@ -2345,7 +2345,7 @@ msgstr "" "サーバーがラウンドロビンの DNS エントリーを持っている場合に、一つのラウンド" "ロビンエントリーが '落ちてる' とマークされるまでに許される接続失敗の最大数。" -#: ../../../admin-guide/files/records.config.en.rst:1412 +#: ../../../admin-guide/files/records.yaml.en.rst:1412 #, fuzzy msgid "" "The timeout value (in seconds) for time to first byte for an origin server " @@ -2354,7 +2354,7 @@ msgstr "" "クライアントのリクエストが ``POST`` か ``PUT`` リクエストのときのオリジン" "サーバーへの接続のタイムアウト値 ( 秒 ) 。" -#: ../../../admin-guide/files/records.config.en.rst:1421 +#: ../../../admin-guide/files/records.yaml.en.rst:1421 msgid "" "The timeout value (in seconds) for an origin server connection when the " "client request is a ``POST`` or ``PUT`` request." @@ -2362,7 +2362,7 @@ msgstr "" "クライアントのリクエストが ``POST`` か ``PUT`` リクエストのときのオリジン" "サーバーへの接続のタイムアウト値 ( 秒 ) 。" -#: ../../../admin-guide/files/records.config.en.rst:1430 +#: ../../../admin-guide/files/records.yaml.en.rst:1430 msgid "" "Specifies how long (in seconds) Traffic Server remembers that an origin " "server was unreachable." @@ -2370,7 +2370,7 @@ msgstr "" "オリジンサーバーが到達不可能であったと Traffic Server が覚えている長さ " "( 秒 ) を指定します。" -#: ../../../admin-guide/files/records.config.en.rst:1436 +#: ../../../admin-guide/files/records.yaml.en.rst:1436 msgid "" "The number of seconds before Traffic Server marks an origin server as " "unavailable after a client abandons a request because the origin server was " @@ -2380,7 +2380,7 @@ msgstr "" "クエストを断念した後で、Traffic Server がオリジンサーバーを到達不能とマーク" "するまでの秒数。" -#: ../../../admin-guide/files/records.config.en.rst:1443 +#: ../../../admin-guide/files/records.yaml.en.rst:1443 msgid "" "When enabled (1), Traffic Server bypasses the parent proxy for a request " "that is not cacheable." @@ -2388,11 +2388,11 @@ msgstr "" "有効化 (1) すると、Traffic Server はキャッシュできないリクエストで親プロキ" "シーをバイパスします。" -#: ../../../admin-guide/files/records.config.en.rst:1446 +#: ../../../admin-guide/files/records.yaml.en.rst:1446 msgid "Congestion Control" msgstr "輻輳制御" -#: ../../../admin-guide/files/records.config.en.rst:1450 +#: ../../../admin-guide/files/records.yaml.en.rst:1450 msgid "" "Enables (``1``) or disables (``0``) the Congestion Control option, which " "configures Traffic Server to stop forwarding HTTP requests to origin " @@ -2406,7 +2406,7 @@ msgstr "" "ントにメッセージを送信します。:ref:`using-congestion-control` を参照してくだ" "さい。" -#: ../../../admin-guide/files/records.config.en.rst:1457 +#: ../../../admin-guide/files/records.yaml.en.rst:1457 msgid "" "Transaction buffering / flow control is enabled if this is set to a non-" "zero value. Otherwise no flow control is done." @@ -2414,7 +2414,7 @@ msgstr "" "非ゼロ値を設定するとトランザクションのバッファリング / フロー制御が有効化さ" "れます。そうでない場合はフロー制御は行われません。" -#: ../../../admin-guide/files/records.config.en.rst:1463 +#: ../../../admin-guide/files/records.yaml.en.rst:1463 msgid "" "The high water mark for transaction buffer control. External source I/O is " "halted when the total buffer space in use by the transaction exceeds this " @@ -2423,7 +2423,7 @@ msgstr "" "トランザクションのバッファー制御用の high water マークです。使用中の総バッ" "ファー領域がこの値に達すると外部ソース I/O が停止されます。" -#: ../../../admin-guide/files/records.config.en.rst:1470 +#: ../../../admin-guide/files/records.yaml.en.rst:1470 msgid "" "The low water mark for transaction buffer control. External source I/O is " "resumed when the total buffer space in use by the transaction is no more " @@ -2432,17 +2432,17 @@ msgstr "" "トランザクションのバッファー制御用の low water マークです。使用中の総バッ" "ファー領域がこの値より少なくなると外部ソース I/O が再開されます。" -#: ../../../admin-guide/files/records.config.en.rst:1476 +#: ../../../admin-guide/files/records.yaml.en.rst:1476 msgid "" "When enabled >= (``0``), Traffic Server will enforce a maximum number of " "simultaneous websocket connections." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1481 +#: ../../../admin-guide/files/records.yaml.en.rst:1481 msgid "Negative Response Caching" msgstr "ネガティブレスポンスキャッシュ" -#: ../../../admin-guide/files/records.config.en.rst:1487 +#: ../../../admin-guide/files/records.yaml.en.rst:1487 #, fuzzy msgid "" "When enabled (``1``), |TS| caches negative responses (such as ``404 Not " @@ -2457,108 +2457,108 @@ msgstr "" "Traffic Server はレスポンスが ``Cache-Control`` ヘッダーをもって場合にのみ" "キャッシュを行います。" -#: ../../../admin-guide/files/records.config.en.rst:1491 +#: ../../../admin-guide/files/records.yaml.en.rst:1491 msgid "" "When disabled (``0``), |TS| will only cache the response if the response " "has ``Cache-Control`` headers." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1494 +#: ../../../admin-guide/files/records.yaml.en.rst:1494 #, fuzzy msgid "The following negative responses are cached by Traffic Server:" msgstr "次のネガティブレスポンスは Traffic Server にキャッシュされます。" -#: ../../../admin-guide/files/records.config.en.rst:1497 +#: ../../../admin-guide/files/records.yaml.en.rst:1497 msgid "HTTP Response Code" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1499 +#: ../../../admin-guide/files/records.yaml.en.rst:1499 msgid "``204``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1499 +#: ../../../admin-guide/files/records.yaml.en.rst:1499 msgid "No Content" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1500 +#: ../../../admin-guide/files/records.yaml.en.rst:1500 msgid "``305``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1500 +#: ../../../admin-guide/files/records.yaml.en.rst:1500 #, fuzzy msgid "Use Proxy" msgstr "リバースプロキシー" -#: ../../../admin-guide/files/records.config.en.rst:1501 +#: ../../../admin-guide/files/records.yaml.en.rst:1501 msgid "``400``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1501 +#: ../../../admin-guide/files/records.yaml.en.rst:1501 msgid "Bad Request" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1502 +#: ../../../admin-guide/files/records.yaml.en.rst:1502 msgid "``403``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1502 +#: ../../../admin-guide/files/records.yaml.en.rst:1502 msgid "Forbidden" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1503 +#: ../../../admin-guide/files/records.yaml.en.rst:1503 msgid "``404``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1503 +#: ../../../admin-guide/files/records.yaml.en.rst:1503 msgid "Not Found" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1504 +#: ../../../admin-guide/files/records.yaml.en.rst:1504 msgid "``405``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1504 +#: ../../../admin-guide/files/records.yaml.en.rst:1504 msgid "Method Not Allowed" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1505 +#: ../../../admin-guide/files/records.yaml.en.rst:1505 msgid "``500``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1505 +#: ../../../admin-guide/files/records.yaml.en.rst:1505 msgid "Internal Server Error" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1506 +#: ../../../admin-guide/files/records.yaml.en.rst:1506 msgid "``501``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1507 +#: ../../../admin-guide/files/records.yaml.en.rst:1507 msgid "``502``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1507 +#: ../../../admin-guide/files/records.yaml.en.rst:1507 msgid "Bad Gateway" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1508 +#: ../../../admin-guide/files/records.yaml.en.rst:1508 msgid "``503``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1508 +#: ../../../admin-guide/files/records.yaml.en.rst:1508 #, fuzzy msgid "Service Unavailable" msgstr "システム変数" -#: ../../../admin-guide/files/records.config.en.rst:1509 +#: ../../../admin-guide/files/records.yaml.en.rst:1509 msgid "``504``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1509 +#: ../../../admin-guide/files/records.yaml.en.rst:1509 msgid "Gateway Timeout" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1512 +#: ../../../admin-guide/files/records.yaml.en.rst:1512 msgid "" "The cache lifetime for objects cached from this setting is controlled via :" "ts:cv:`proxy.config.http.negative_caching_lifetime`." @@ -2566,120 +2566,120 @@ msgstr "" "この設定によりキャッシュされたオブジェクトのキャッシュライフタイムは :ts:cv:" "`proxy.config.http.negative_caching_lifetime` により制御されます。" -#: ../../../admin-guide/files/records.config.en.rst:1518 +#: ../../../admin-guide/files/records.yaml.en.rst:1518 msgid "" "How long (in seconds) Traffic Server keeps the negative responses valid in " "cache. This value only affects negative responses that do NOT have explicit " "``Expires:`` or ``Cache-Control:`` lifetimes set by the server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1523 +#: ../../../admin-guide/files/records.yaml.en.rst:1523 msgid "" "Enables (``1``) or disables (``0``) forcing revalidation of cached " "documents when |TS| receives a negative (``5xx`` only) response from the " "origin server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1528 +#: ../../../admin-guide/files/records.yaml.en.rst:1528 msgid "" "How long, in seconds, to consider a stale cached document valid if during " "the revalidation attempt |TS| receives a negative (``5xx`` only) response " "from the origin server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1533 +#: ../../../admin-guide/files/records.yaml.en.rst:1533 msgid "Proxy User Variables" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1539 +#: ../../../admin-guide/files/records.yaml.en.rst:1539 msgid "" "When enabled (``1``), Traffic Server removes the ``From`` header to protect " "the privacy of your users." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1544 +#: ../../../admin-guide/files/records.yaml.en.rst:1544 msgid "" "When enabled (``1``), Traffic Server removes the ``Referrer`` header to " "protect the privacy of your site and users." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1550 +#: ../../../admin-guide/files/records.yaml.en.rst:1550 msgid "" "When enabled (``1``), Traffic Server removes the ``User-agent`` header to " "protect the privacy of your site and users." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1556 +#: ../../../admin-guide/files/records.yaml.en.rst:1556 msgid "" "When enabled (``1``), Traffic Server removes the ``Cookie`` header to " "protect the privacy of your site and users." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1562 +#: ../../../admin-guide/files/records.yaml.en.rst:1562 msgid "" "When enabled (``1``), Traffic Server removes ``Client-IP`` headers for more " "privacy." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1568 +#: ../../../admin-guide/files/records.yaml.en.rst:1568 msgid "" "When enabled (``1``), Traffic Server inserts ``Client-IP`` headers to " "retain the client IP address." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1573 +#: ../../../admin-guide/files/records.yaml.en.rst:1573 msgid "" "Comma separated list of headers Traffic Server should remove from outgoing " "requests." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1579 +#: ../../../admin-guide/files/records.yaml.en.rst:1579 msgid "" "When enabled (``1``), Traffic Server adds the client IP address to the ``X-" "Forwarded-For`` header." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1585 +#: ../../../admin-guide/files/records.yaml.en.rst:1585 msgid "" "Enable (``1``) to normalize all ``Accept-Encoding:`` headers to one of the " "following:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1587 +#: ../../../admin-guide/files/records.yaml.en.rst:1587 msgid "" "``Accept-Encoding: gzip`` (if the header has ``gzip`` or ``x-gzip`` with " "any ``q``) **OR**" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1588 +#: ../../../admin-guide/files/records.yaml.en.rst:1588 msgid "*blank* (for any header that does not include ``gzip``)" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1590 +#: ../../../admin-guide/files/records.yaml.en.rst:1590 msgid "" "This is useful for minimizing cached alternates of documents (e.g. ``gzip, " "deflate`` vs. ``deflate, gzip``). Enabling this option is recommended if " "your origin servers use no encodings other than ``gzip``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1594 +#: ../../../admin-guide/files/records.yaml.en.rst:1594 msgid "Security" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1599 +#: ../../../admin-guide/files/records.yaml.en.rst:1599 msgid "" "Enables (``1``) or disables (``0``) the HTTP ``PUSH`` option, which allows " "you to deliver content directly to the cache without a user request." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1604 +#: ../../../admin-guide/files/records.yaml.en.rst:1604 msgid "" "If you enable this option, then you must also specify a filtering rule in " "the ip_allow.config file to allow only certain machines to push content " "into the cache." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1611 +#: ../../../admin-guide/files/records.yaml.en.rst:1611 msgid "" "This feature is disabled by default with a value of (``0``), any positive " "value will limit the size of post bodies. If a request is received with a " @@ -2687,11 +2687,11 @@ msgid "" "Request Entity Too Large and logged accordingly." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1617 +#: ../../../admin-guide/files/records.yaml.en.rst:1617 msgid "Cache Control" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1622 +#: ../../../admin-guide/files/records.yaml.en.rst:1622 msgid "" "Specifies when to enable the ability to read a cached object while another " "connection is completing the write to cache for that same object. The goal " @@ -2699,33 +2699,33 @@ msgid "" "upon a cache miss. The possible values of this config are:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1630 +#: ../../../admin-guide/files/records.yaml.en.rst:1630 msgid "Never read while writing." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1631 +#: ../../../admin-guide/files/records.yaml.en.rst:1631 msgid "Always read while writing." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1632 +#: ../../../admin-guide/files/records.yaml.en.rst:1632 msgid "" "Always read while writing, but allow non-cached ``Range`` requests through " "to the origin server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1636 +#: ../../../admin-guide/files/records.yaml.en.rst:1636 msgid "" "The ``2`` option is useful to avoid delaying requests which can not easily " "be satisfied by the partially written response." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1639 +#: ../../../admin-guide/files/records.yaml.en.rst:1639 msgid "" "Several other configuration values need to be set for this to be usable. " "See :ref:`admin-configuration-reducing-origin-requests`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1645 +#: ../../../admin-guide/files/records.yaml.en.rst:1645 msgid "" "Specifies how many retries trafficserver attempts to trigger " "read_while_writer on failing to obtain the write VC mutex or until the " @@ -2734,7 +2734,7 @@ msgid "" "read_while_writer_retry.delay`" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1653 +#: ../../../admin-guide/files/records.yaml.en.rst:1653 msgid "" "Specifies the delay in msec, trafficserver waits to reattempt " "read_while_writer on failing to obtain the write VC mutex or until the " @@ -2743,19 +2743,19 @@ msgid "" "the configured duration from the third reattempt onwards." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1662 +#: ../../../admin-guide/files/records.yaml.en.rst:1662 msgid "" "Forces the use of a specific hardware sector size, e.g. 4096, for all disks." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1664 +#: ../../../admin-guide/files/records.yaml.en.rst:1664 msgid "" "SSDs and \"advanced format" drives claim a sector size of 512; however, it " "is safe to force a higher size than the hardware supports natively as we " "count atomicity in 512 byte increments." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1667 +#: ../../../admin-guide/files/records.yaml.en.rst:1667 msgid "" "4096-sized drives formatted for Windows will have partitions aligned on 63 " "512-byte sector boundaries, so they will be unaligned. There are " @@ -2764,32 +2764,32 @@ msgid "" "others might require reformatting or repartitioning." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1672 +#: ../../../admin-guide/files/records.yaml.en.rst:1672 msgid "" "To be safe in Linux, you could just use the entire drive: ``/dev/sdb`` " "instead of ``/dev/sdb1`` and Traffic Server will do the right thing. " "Misaligned partitions on Linux are auto-detected." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1675 +#: ../../../admin-guide/files/records.yaml.en.rst:1675 msgid "" "For example: If ``/sys/block/sda/sda1/alignment_offset`` is non-zero, ATS " "will offset reads/writes to that disk by that alignment. If Linux knows " "about any existing partition misalignments, ATS will compensate." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1678 +#: ../../../admin-guide/files/records.yaml.en.rst:1678 msgid "" "Partitions formatted to support hardware sector size of more than 512 (e.g. " "4096) will result in all objects stored in the cache to be integral " "multiples of 4096 bytes, which will result in some waste for small files." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1686 +#: ../../../admin-guide/files/records.yaml.en.rst:1686 msgid "Enables (``1``) or disables (``0``) caching of HTTP requests." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1692 +#: ../../../admin-guide/files/records.yaml.en.rst:1692 msgid "" "If set to a value other than ``-1``, the value if this configuration option " "is combined with the cache key at cache lookup time. Changing this value " @@ -2799,7 +2799,7 @@ msgid "" "specific :file:`remap.config` rule." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1704 +#: ../../../admin-guide/files/records.yaml.en.rst:1704 msgid "" "Enables (``1``) or disables (``0``) caching objects that have an empty " "response body. This is particularly useful for caching 301 or 302 responses " @@ -2807,64 +2807,64 @@ msgid "" "origin response also has a ``Content-Length`` header." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1711 +#: ../../../admin-guide/files/records.yaml.en.rst:1711 msgid "" "Do not perform origin server DNS resolution if a fresh copy of the " "requested document is available in the cache. This setting has no effect if " "HTTP caching is disabled or if there are IP based ACLs configured." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1719 +#: ../../../admin-guide/files/records.yaml.en.rst:1719 msgid "" "When enabled (``1``), Traffic Server ignores client requests to bypass the " "cache." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1725 +#: ../../../admin-guide/files/records.yaml.en.rst:1725 msgid "" "When enabled (``1``), Traffic Server issues a conditional request to the " "origin server if an incoming request has a ``No-Cache`` header." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1731 +#: ../../../admin-guide/files/records.yaml.en.rst:1731 msgid "" "When enabled (``1``), Traffic Server ignores origin server requests to " "bypass the cache." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1737 +#: ../../../admin-guide/files/records.yaml.en.rst:1737 msgid "Specifies how cookies are cached:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1742 +#: ../../../admin-guide/files/records.yaml.en.rst:1742 msgid "Do not cache any responses to cookies." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1743 +#: ../../../admin-guide/files/records.yaml.en.rst:1743 msgid "Cache for any content-type." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1744 +#: ../../../admin-guide/files/records.yaml.en.rst:1744 msgid "Cache only for image types." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1745 +#: ../../../admin-guide/files/records.yaml.en.rst:1745 msgid "Cache for all but text content-types." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1746 +#: ../../../admin-guide/files/records.yaml.en.rst:1746 msgid "" "Cache for all but text content-types; except origin server response without " "``Set-Cookie`` or with ``Cache-Control: public``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1753 +#: ../../../admin-guide/files/records.yaml.en.rst:1753 msgid "" "When enabled (``1``), Traffic Server ignores ``WWW-Authentication`` headers " "in responses ``WWW-Authentication`` headers are removed and not cached." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1760 +#: ../../../admin-guide/files/records.yaml.en.rst:1760 msgid "" "Enables (``1``) or disables (``0``) caching of URLs that look dynamic, i." "e.: URLs that end in ``.asp`` or contain a question mark (``?``), a " @@ -2872,77 +2872,77 @@ msgid "" "`HttpTransact::url_looks_dynamic `_" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1767 +#: ../../../admin-guide/files/records.yaml.en.rst:1767 msgid "" "Enables (``1``) or disables (``0``) caching of alternate versions of HTTP " "objects that do not contain the ``Vary`` header." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1773 +#: ../../../admin-guide/files/records.yaml.en.rst:1773 msgid "Specifies when to revalidate content:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1778 +#: ../../../admin-guide/files/records.yaml.en.rst:1778 msgid "Use cache directives or heuristic (the default value)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1779 +#: ../../../admin-guide/files/records.yaml.en.rst:1779 msgid "Stale if heuristic." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1780 +#: ../../../admin-guide/files/records.yaml.en.rst:1780 msgid "Always stale (always revalidate)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1781 +#: ../../../admin-guide/files/records.yaml.en.rst:1781 msgid "Never stale." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1782 +#: ../../../admin-guide/files/records.yaml.en.rst:1782 msgid "" "Use cache directives or heuristic (0) unless the request has an ``If-" "Modified-Since`` header." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1786 +#: ../../../admin-guide/files/records.yaml.en.rst:1786 msgid "" "If the request contains the ``If-Modified-Since`` header, then |TS| always " "revalidates the cached content and uses the client's ``If-Modified-Since`` " "header for the proxy request." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1794 +#: ../../../admin-guide/files/records.yaml.en.rst:1794 msgid "" "The type of headers required in a request for the request to be cacheable." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1799 +#: ../../../admin-guide/files/records.yaml.en.rst:1799 msgid "No headers required to make document cacheable." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1800 +#: ../../../admin-guide/files/records.yaml.en.rst:1800 msgid "" "Either the ``Last-Modified`` header, or an explicit lifetime header " "(``Expires`` or ``Cache-Control: max-age``) is required." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1802 +#: ../../../admin-guide/files/records.yaml.en.rst:1802 msgid "" "Explicit lifetime is required, from either ``Expires`` or ``Cache-Control: " "max-age``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1810 +#: ../../../admin-guide/files/records.yaml.en.rst:1810 msgid "" "The maximum age allowed for a stale response before it cannot be cached." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1815 +#: ../../../admin-guide/files/records.yaml.en.rst:1815 msgid "" "When enabled (``1``), Traffic Server looks up range requests in the cache." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1820 +#: ../../../admin-guide/files/records.yaml.en.rst:1820 msgid "" "When enabled (``1``), Traffic Server will attempt to write (lock) the URL " "to cache. This is rarely useful (at the moment), since it'll only be able " @@ -2951,7 +2951,7 @@ msgid "" "response, you can turn this on to allow it to be cached." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1829 +#: ../../../admin-guide/files/records.yaml.en.rst:1829 msgid "" "When enabled with a value of ``1``, Traffic Server serves documents from " "cache with a ``Content-Type:`` header even if it does not match the " @@ -2960,7 +2960,7 @@ msgid "" "(which is the recommended and safe use)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1836 +#: ../../../admin-guide/files/records.yaml.en.rst:1836 msgid "" "This option should only be enabled with ``1`` if you're having problems " "with caching *and* you origin server doesn't set the ``Vary`` header. " @@ -2969,7 +2969,7 @@ msgid "" "configuration with a ``1``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1845 +#: ../../../admin-guide/files/records.yaml.en.rst:1845 msgid "" "When enabled with a value of ``1``, Traffic Server serves documents from " "cache with a ``Content-Language:`` header even if it does not match the " @@ -2978,7 +2978,7 @@ msgid "" "response (which is the recommended and safe use)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1852 +#: ../../../admin-guide/files/records.yaml.en.rst:1852 msgid "" "This option should only be enabled with ``1`` if you're having problems " "with caching *and* you origin server doesn't set the ``Vary`` header. " @@ -2987,7 +2987,7 @@ msgid "" "enable this configuration with a ``1``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1861 +#: ../../../admin-guide/files/records.yaml.en.rst:1861 msgid "" "When enabled with a value of ``1``, Traffic Server serves documents from " "cache with a ``Content-Encoding:`` header even if it does not match the " @@ -2996,7 +2996,7 @@ msgid "" "response (which is the recommended and safe use)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1868 +#: ../../../admin-guide/files/records.yaml.en.rst:1868 msgid "" "This option should only be enabled with ``1`` if you're having problems " "with caching *and* you origin server doesn't set the ``Vary`` header. " @@ -3005,7 +3005,7 @@ msgid "" "enable this configuration with a ``1``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1877 +#: ../../../admin-guide/files/records.yaml.en.rst:1877 msgid "" "When enabled with a value of ``1``, Traffic Server serves documents from " "cache with a ``Content-Type:`` header even if it does not match the " @@ -3014,7 +3014,7 @@ msgid "" "response (which is the recommended and safe use)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1884 +#: ../../../admin-guide/files/records.yaml.en.rst:1884 msgid "" "This option should only be enabled with ``1`` if you're having problems " "with caching *and* you origin server doesn't set the ``Vary`` header. " @@ -3023,39 +3023,39 @@ msgid "" "enable this configuration with a ``1``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1894 +#: ../../../admin-guide/files/records.yaml.en.rst:1894 msgid "" "When enabled (``1``), Traffic Server ignores any ``Cache-Control: max-age`` " "headers from the client. This technically violates the HTTP RFC, but avoids " "a problem where a client can forcefully invalidate a cached object." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1900 +#: ../../../admin-guide/files/records.yaml.en.rst:1900 msgid "" "Specifies the maximum object size that will be cached. ``0`` is unlimited." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1904 +#: ../../../admin-guide/files/records.yaml.en.rst:1904 msgid "" "Specifies the lower boundary of average object sizes in the cache and is " "used in determining the number of :term:`directory buckets ` to allocate for the in-memory cache directory." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1911 +#: ../../../admin-guide/files/records.yaml.en.rst:1911 msgid "" "When enabled (``1``), Traffic Server will keep certain HTTP objects in the " "cache for a certain time as specified in cache.config." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1915 +#: ../../../admin-guide/files/records.yaml.en.rst:1915 msgid "" "The size of the region (as a percentage of the total content storage in a :" "term:`cache stripe`) in front of the :term:`write cursor` that constitutes " "a recent access hit for evacutating the accessed object." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1918 +#: ../../../admin-guide/files/records.yaml.en.rst:1918 msgid "" "When an object is accessed it can be marked for evacuation, that is to be " "copied over the write cursor and thereby preserved from being overwritten. " @@ -3065,34 +3065,34 @@ msgid "" "and that percentage is set by this variable." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1923 +#: ../../../admin-guide/files/records.yaml.en.rst:1923 msgid "By default, the feature is off (set to 0)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1928 +#: ../../../admin-guide/files/records.yaml.en.rst:1928 msgid "Limit the size of objects that are hit evacuated." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1930 +#: ../../../admin-guide/files/records.yaml.en.rst:1930 msgid "" "Objects larger than the limit are not hit evacuated. A value of 0 disables " "the limit." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1934 +#: ../../../admin-guide/files/records.yaml.en.rst:1934 msgid "" "The maximum number of alternates that are allowed for any given URL. " "Disable by setting to 0." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1939 +#: ../../../admin-guide/files/records.yaml.en.rst:1939 msgid "" "Sets the target size of a contiguous fragment of a file in the disk cache. " "When setting this, consider that larger numbers could waste memory on slow " "connections, but smaller numbers could increase (waste) seeks." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1945 +#: ../../../admin-guide/files/records.yaml.en.rst:1945 msgid "" "Configures the size, in bytes, of an alternate that will be considered " "small enough to trigger a rewrite of the resident alt fragment within a " @@ -3100,25 +3100,25 @@ msgid "" "developer documentation for :cpp:class:`CacheVC`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1951 +#: ../../../admin-guide/files/records.yaml.en.rst:1951 msgid "RAM Cache" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1955 +#: ../../../admin-guide/files/records.yaml.en.rst:1955 msgid "" "By default the RAM cache size is automatically determined, based on disk " "cache size; approximately 10 MB of RAM cache per GB of disk cache. " "Alternatively, it can be set to a fixed value such as **20GB** (21474836480)" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1962 +#: ../../../admin-guide/files/records.yaml.en.rst:1962 msgid "" "Objects greater than this size will not be kept in the RAM cache. This " "should be set high enough to keep objects accessed frequently in memory in " "order to improve performance. **4MB** (4194304)" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1969 +#: ../../../admin-guide/files/records.yaml.en.rst:1969 msgid "" "Two distinct RAM caches are supported, the default (0) being the **CLFUS** " "(*Clocked Least Frequently Used by Size*). As an alternative, a simpler " @@ -3126,7 +3126,7 @@ msgid "" "configuration to 1." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1976 +#: ../../../admin-guide/files/records.yaml.en.rst:1976 msgid "" "Enabling this option will filter inserts into the RAM cache to ensure that " "they have been seen at least once. For the **LRU**, this provides scan " @@ -3136,7 +3136,7 @@ msgid "" "cache." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1984 +#: ../../../admin-guide/files/records.yaml.en.rst:1984 msgid "" "The **CLFUS** RAM cache also supports an optional in-memory compression. " "This is not to be confused with ``Content-Encoding: gzip`` compression. The " @@ -3144,58 +3144,58 @@ msgid "" "not visible to the User-Agent (client)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1989 +#: ../../../admin-guide/files/records.yaml.en.rst:1989 msgid "Possible values are:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1994 +#: ../../../admin-guide/files/records.yaml.en.rst:1994 #, fuzzy msgid "No compression" msgstr "compress" -#: ../../../admin-guide/files/records.config.en.rst:1995 +#: ../../../admin-guide/files/records.yaml.en.rst:1995 msgid "Fastlz (extremely fast, relatively low compression)" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1996 +#: ../../../admin-guide/files/records.yaml.en.rst:1996 msgid "Libz (moderate speed, reasonable compression)" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:1997 +#: ../../../admin-guide/files/records.yaml.en.rst:1997 msgid "Liblzma (very slow, high compression)" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2000 +#: ../../../admin-guide/files/records.yaml.en.rst:2000 msgid "" "Compression runs on task threads. To use more cores for RAM cache " "compression, increase :ts:cv:`proxy.config.task_threads`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2006 +#: ../../../admin-guide/files/records.yaml.en.rst:2006 msgid "Heuristic Expiration" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2012 +#: ../../../admin-guide/files/records.yaml.en.rst:2012 msgid "" "The minimum amount of time, in seconds, an HTTP object without an " "expiration date can remain fresh in the cache before is considered to be " "stale." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2019 +#: ../../../admin-guide/files/records.yaml.en.rst:2019 msgid "" "The maximum amount of time, in seconds, an HTTP object without an " "expiration date can remain fresh in the cache before is considered to be " "stale." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2026 +#: ../../../admin-guide/files/records.yaml.en.rst:2026 msgid "" "The aging factor for freshness computations. |TS| stores an object for this " "percentage of the time that elapsed since it last changed." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2033 +#: ../../../admin-guide/files/records.yaml.en.rst:2033 msgid "" "Establishes a guaranteed minimum lifetime boundary for freshness " "heuristics. When heuristics are used, and the :ts:cv:`proxy.config.http." @@ -3203,7 +3203,7 @@ msgid "" "calculated will never be lower than the value in this variable." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2042 +#: ../../../admin-guide/files/records.yaml.en.rst:2042 msgid "" "Establishes a guaranteed maximum lifetime boundary for freshness " "heuristics. When heuristics are used, and the :ts:cv:`proxy.config.http." @@ -3211,19 +3211,19 @@ msgid "" "calculated will never be higher than the value in this variable." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2052 +#: ../../../admin-guide/files/records.yaml.en.rst:2052 msgid "" "How often |TS| checks for an early refresh, during the period before the " "document stale time. The interval specified must be in seconds." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2061 +#: ../../../admin-guide/files/records.yaml.en.rst:2061 msgid "" "The probability that a refresh is made on a document during the fuzz time " "specified in :ts:cv:`proxy.config.http.cache.fuzz.time`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2069 +#: ../../../admin-guide/files/records.yaml.en.rst:2069 msgid "" "Handles requests with a TTL less than :ts:cv:`proxy.config.http.cache.fuzz." "time`. It allows for different times to evaluate the probability of " @@ -3237,7 +3237,7 @@ msgid "" "with small TTLs." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2081 +#: ../../../admin-guide/files/records.yaml.en.rst:2081 msgid "" "These fuzzing options are marked as deprecated as of v6.2.0, and will be " "removed for v7.0.0. Instead, we recommend looking at the new :ts:cv:`proxy-" @@ -3245,49 +3245,49 @@ msgid "" "around thundering heard avoidance (see :ref:`cache-basics` for details)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2088 +#: ../../../admin-guide/files/records.yaml.en.rst:2088 msgid "Dynamic Content & Content Negotiation" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2093 +#: ../../../admin-guide/files/records.yaml.en.rst:2093 msgid "The header on which Traffic Server varies for text documents." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2095 +#: ../../../admin-guide/files/records.yaml.en.rst:2095 msgid "" "For example: if you specify ``User-agent``, then Traffic Server caches all " "the different user-agent versions of documents it encounters." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2101 +#: ../../../admin-guide/files/records.yaml.en.rst:2101 msgid "The header on which Traffic Server varies for images." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2106 +#: ../../../admin-guide/files/records.yaml.en.rst:2106 msgid "" "The header on which Traffic Server varies for anything other than text and " "images." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2111 +#: ../../../admin-guide/files/records.yaml.en.rst:2111 msgid "" "The number of milliseconds a cacheable request will wait before requesting " "the object from cache if an equivalent request is in flight." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2116 +#: ../../../admin-guide/files/records.yaml.en.rst:2116 msgid "" "The number of times to attempt fetching an object from cache if there was " "an equivalent request in flight." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2122 +#: ../../../admin-guide/files/records.yaml.en.rst:2122 msgid "" "The number of times to attempt a cache open write upon failure to get a " "write lock." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2128 +#: ../../../admin-guide/files/records.yaml.en.rst:2128 msgid "" "This setting indicates the action taken on failing to obtain the cache open " "write lock on either a cache miss or a cache hit stale. This typically " @@ -3297,58 +3297,58 @@ msgid "" "setting." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2136 +#: ../../../admin-guide/files/records.yaml.en.rst:2136 msgid "Default. Disable cache and go to origin server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2137 +#: ../../../admin-guide/files/records.yaml.en.rst:2137 msgid "Return a ``502`` error on a cache miss." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2138 +#: ../../../admin-guide/files/records.yaml.en.rst:2138 msgid "" "Serve stale if object's age is under :ts:cv:`proxy.config.http.cache." "max_stale_age`. Otherwise, go to origin server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2141 +#: ../../../admin-guide/files/records.yaml.en.rst:2141 msgid "" "Return a ``502`` error on a cache miss or serve stale on a cache revalidate " "if object's age is under :ts:cv:`proxy.config.http.cache.max_stale_age`. " "Otherwise, go to origin server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2145 +#: ../../../admin-guide/files/records.yaml.en.rst:2145 msgid "Return a ``502`` error on either a cache miss or on a revalidation." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2149 +#: ../../../admin-guide/files/records.yaml.en.rst:2149 msgid "Customizable User Response Pages" msgstr "カスタマイズ可能なユーザーレスポンスページ" -#: ../../../admin-guide/files/records.config.en.rst:2153 +#: ../../../admin-guide/files/records.yaml.en.rst:2153 msgid "" "Specifies whether customizable response pages are language specific or not:" msgstr "カスタマイズ可能なレスポンスページが言語別どうかを指定します。" -#: ../../../admin-guide/files/records.config.en.rst:2159 +#: ../../../admin-guide/files/records.yaml.en.rst:2159 #, fuzzy msgid "Enable customizable user response pages in the default directory only." msgstr "" "``1`` = カスタマイズ可能なユーザーレスポンスページをデフォルトディレクトリで" "有効化します。" -#: ../../../admin-guide/files/records.config.en.rst:2160 +#: ../../../admin-guide/files/records.yaml.en.rst:2160 #, fuzzy msgid "Enable language-targeted user response pages." msgstr "``2`` = 言語別ユーザーレスポンスページを有効化します。" -#: ../../../admin-guide/files/records.config.en.rst:2161 +#: ../../../admin-guide/files/records.yaml.en.rst:2161 #, fuzzy msgid "Enable host-targeted user response pages." msgstr "``2`` = 言語別ユーザーレスポンスページを有効化します。" -#: ../../../admin-guide/files/records.config.en.rst:2166 +#: ../../../admin-guide/files/records.yaml.en.rst:2166 msgid "" "Enables (``1``) or disables (``0``) logging for customizable response " "pages. When enabled, Traffic Server records a message in the error log each " @@ -3358,7 +3358,7 @@ msgstr "" "(``0``) します。有効化すると、Traffic Server はカスタマイズ可能なレスポンス" "ページの使用もしくは変更のたびにメッセージをエラーログに記録します。" -#: ../../../admin-guide/files/records.config.en.rst:2171 +#: ../../../admin-guide/files/records.yaml.en.rst:2171 msgid "" "The customizable response page default directory. If this is a relative " "path, Traffic Server resolves it relative to the ``PREFIX`` directory." @@ -3366,123 +3366,123 @@ msgstr "" "カスタマイズ可能なレスポンスページのデフォルトディレクトリ。相対パスの場合、" "Traffic Server は ``PREFIX`` ディレクトリからの相対で解決します。" -#: ../../../admin-guide/files/records.config.en.rst:2179 +#: ../../../admin-guide/files/records.yaml.en.rst:2179 msgid "" "A prefix for the file name to use to find an error template file. If set " "(not the empty string) this value and an underscore are predended to the " "file name to find in the template sets directory. See :ref:`body-factory`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2185 +#: ../../../admin-guide/files/records.yaml.en.rst:2185 msgid "Specifies when Traffic Server suppresses generated response pages:" msgstr "" "Traffic Server が生成されたレスポンスページを使用するのを抑制させるときに指" "定します。" -#: ../../../admin-guide/files/records.config.en.rst:2190 +#: ../../../admin-guide/files/records.yaml.en.rst:2190 #, fuzzy msgid "Never suppress generated response pages." msgstr "``0`` = 生成されたレスポンスページの使用を抑制しません" -#: ../../../admin-guide/files/records.config.en.rst:2191 +#: ../../../admin-guide/files/records.yaml.en.rst:2191 #, fuzzy msgid "Always suppress generated response pages." msgstr "``1`` = 生成されたレスポンスページの使用を常に抑制します" -#: ../../../admin-guide/files/records.config.en.rst:2192 +#: ../../../admin-guide/files/records.yaml.en.rst:2192 #, fuzzy msgid "Suppress response pages only for intercepted traffic." msgstr "``2`` = 遮断された通信のレスポンスページのみを抑制します" -#: ../../../admin-guide/files/records.config.en.rst:2197 +#: ../../../admin-guide/files/records.yaml.en.rst:2197 msgid "" "Specifies which http UI endpoints to allow within :file:`remap.config`:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2202 +#: ../../../admin-guide/files/records.yaml.en.rst:2202 msgid "Disable all http UI endpoints." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2203 +#: ../../../admin-guide/files/records.yaml.en.rst:2203 msgid "Enable only cache endpoints." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2204 +#: ../../../admin-guide/files/records.yaml.en.rst:2204 msgid "Enable only stats endpoints." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2205 +#: ../../../admin-guide/files/records.yaml.en.rst:2205 msgid "Enable all http UI endpoints." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2208 +#: ../../../admin-guide/files/records.yaml.en.rst:2208 msgid "" "To enable any endpoint there needs to be an entry in :file:`remap.config` " "which specifically enables it. Such a line would look like: ::" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2213 +#: ../../../admin-guide/files/records.yaml.en.rst:2213 msgid "The following are the cache endpoints:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2218 +#: ../../../admin-guide/files/records.yaml.en.rst:2218 msgid "``cache``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2218 +#: ../../../admin-guide/files/records.yaml.en.rst:2218 msgid "UI to interact with the cache." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2221 +#: ../../../admin-guide/files/records.yaml.en.rst:2221 msgid "The following are the stats endpoints:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2226 +#: ../../../admin-guide/files/records.yaml.en.rst:2226 msgid "``cache-internal``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2226 +#: ../../../admin-guide/files/records.yaml.en.rst:2226 msgid "Statistics about cache evacuation and volumes." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2227 +#: ../../../admin-guide/files/records.yaml.en.rst:2227 msgid "``hostdb``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2227 +#: ../../../admin-guide/files/records.yaml.en.rst:2227 msgid "Lookups against the hostdb." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2228 +#: ../../../admin-guide/files/records.yaml.en.rst:2228 msgid "``http``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2228 +#: ../../../admin-guide/files/records.yaml.en.rst:2228 msgid "" "HTTPSM details, this endpoint is also gated by :ts:cv:`proxy.config.http." "enable_http_info`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2230 +#: ../../../admin-guide/files/records.yaml.en.rst:2230 msgid "``net``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2230 +#: ../../../admin-guide/files/records.yaml.en.rst:2230 msgid "Lookup and listing of open connections." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2235 +#: ../../../admin-guide/files/records.yaml.en.rst:2235 msgid "" "Enables (``1``) or disables (``0``) access to an endpoint within :ts:cv:" "`proxy.config.http_ui_enabled` which shows details about inflight " "transactions (HttpSM)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2240 +#: ../../../admin-guide/files/records.yaml.en.rst:2240 msgid "DNS" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2245 +#: ../../../admin-guide/files/records.yaml.en.rst:2245 msgid "" "|TS| can attempt to resolve unqualified hostnames by expanding to the local " "domain. For example if a client makes a request to an unqualified host (e." @@ -3490,19 +3490,19 @@ msgid "" "expand the hostname to ``host_x.y.com``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2253 +#: ../../../admin-guide/files/records.yaml.en.rst:2253 msgid "Disable local domain expansion." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2254 +#: ../../../admin-guide/files/records.yaml.en.rst:2254 msgid "Enable local domain expansion." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2255 +#: ../../../admin-guide/files/records.yaml.en.rst:2255 msgid "Enable local domain expansion, but do not split local domain name." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2261 +#: ../../../admin-guide/files/records.yaml.en.rst:2261 msgid "" "Enables (``1``) or disables (``0``) DNS server selection. When enabled, " "Traffic Server refers to the :file:`splitdns.config` file for the selection " @@ -3510,7 +3510,7 @@ msgid "" "dns>`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2266 +#: ../../../admin-guide/files/records.yaml.en.rst:2266 msgid "" "Specifies a list of hostname extensions that are automatically added to the " "hostname after a failed lookup. For example: if you want Traffic Server to " @@ -3518,7 +3518,7 @@ msgid "" "variable (Traffic Server automatically adds the dot (.))." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2278 +#: ../../../admin-guide/files/records.yaml.en.rst:2278 msgid "" "Allows to specify which ``resolv.conf`` file to use for finding resolvers. " "While the format of this file must be the same as the standard ``resolv." @@ -3527,19 +3527,19 @@ msgid "" "of the operating system uses DNS." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2285 +#: ../../../admin-guide/files/records.yaml.en.rst:2285 msgid "Enables (``1``) or disables (``0``) DNS server round-robin." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2290 +#: ../../../admin-guide/files/records.yaml.en.rst:2290 msgid "The DNS servers." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2295 +#: ../../../admin-guide/files/records.yaml.en.rst:2295 msgid "Indicates whether to use SRV records for origin server lookup." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2299 +#: ../../../admin-guide/files/records.yaml.en.rst:2299 msgid "" "Create and dedicate a thread entirely for DNS processing. This is probably " "most useful on system which do a significant number of DNS lookups, " @@ -3548,7 +3548,7 @@ msgid "" "of all DNS lookups)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2307 +#: ../../../admin-guide/files/records.yaml.en.rst:2307 msgid "" "When enabled (1) provides additional resilience against DNS forgery (for " "instance in DNS Injection attacks), particularly in forward or transparent " @@ -3556,43 +3556,43 @@ msgid "" "the response properly." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2312 +#: ../../../admin-guide/files/records.yaml.en.rst:2312 msgid "HostDB" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2318 +#: ../../../admin-guide/files/records.yaml.en.rst:2318 msgid "Time to wait for a DNS response in seconds." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2326 +#: ../../../admin-guide/files/records.yaml.en.rst:2326 msgid "" "The number of seconds for which to use a stale NS record while initiating a " "background fetch for the new data." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2329 +#: ../../../admin-guide/files/records.yaml.en.rst:2329 msgid "If not set then stale records are not served." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2334 +#: ../../../admin-guide/files/records.yaml.en.rst:2334 msgid "" "The maximum amount of space (in bytes) allocated to ``hostdb``. Setting " "this value to ``-1`` will disable size limit enforcement." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2339 +#: ../../../admin-guide/files/records.yaml.en.rst:2339 msgid "" "The maximum number of entries that can be stored in hostdb. A value of " "``-1`` disables item count limit enforcement." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2344 +#: ../../../admin-guide/files/records.yaml.en.rst:2344 msgid "" "For values above ``200000``, you must increase :ts:cv:`proxy.config.hostdb." "storage_size` by at least 44 bytes per entry." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2349 +#: ../../../admin-guide/files/records.yaml.en.rst:2349 msgid "" "A host entry will eventually time out and be discarded. This variable " "controls how that time is calculated. A DNS request will return a TTL value " @@ -3600,43 +3600,43 @@ msgid "" "This variable determines which value will be used." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2355 +#: ../../../admin-guide/files/records.yaml.en.rst:2355 msgid "TTL" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2357 +#: ../../../admin-guide/files/records.yaml.en.rst:2357 msgid "The TTL from the DNS response." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2358 +#: ../../../admin-guide/files/records.yaml.en.rst:2358 msgid "The internal timeout value." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2359 +#: ../../../admin-guide/files/records.yaml.en.rst:2359 msgid "" "The smaller of the DNS and internal TTL values. The internal timeout value " "becomes a maximum TTL." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2361 +#: ../../../admin-guide/files/records.yaml.en.rst:2361 msgid "" "The larger of the DNS and internal TTL values. The internal timeout value " "become a minimum TTL." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2369 +#: ../../../admin-guide/files/records.yaml.en.rst:2369 msgid "Internal time to live value for host DB entries, **in minutes**." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2371 +#: ../../../admin-guide/files/records.yaml.en.rst:2371 msgid "See :ts:cv:`proxy.config.hostdb.ttl_mode` for when this value is used." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2378 +#: ../../../admin-guide/files/records.yaml.en.rst:2378 msgid "Set host resolution to use strict round robin." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2380 +#: ../../../admin-guide/files/records.yaml.en.rst:2380 msgid "" "When this and :ts:cv:`proxy.config.hostdb.timed_round_robin` are both " "disabled (set to ``0``), |TS| always uses the same origin server for the " @@ -3645,11 +3645,11 @@ msgid "" "precedence over :ts:cv:`proxy.config.hostdb.timed_round_robin`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2389 +#: ../../../admin-guide/files/records.yaml.en.rst:2389 msgid "Set host resolution to use timed round robin." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2391 +#: ../../../admin-guide/files/records.yaml.en.rst:2391 msgid "" "When this and :ts:cv:`proxy.config.hostdb.strict_round_robin` are both " "disabled (set to ``0``), |TS| always uses the same origin server for the " @@ -3658,11 +3658,11 @@ msgid "" "passed since the first time the current address was used." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2399 +#: ../../../admin-guide/files/records.yaml.en.rst:2399 msgid "Set the file path for an external host file." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2401 +#: ../../../admin-guide/files/records.yaml.en.rst:2401 msgid "" "If this is set (non-empty) then the file is presumed to be a hosts file in " "the standard `host file format `)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2614 +#: ../../../admin-guide/files/records.yaml.en.rst:2614 msgid "``log_header`` STRING NULL" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2614 +#: ../../../admin-guide/files/records.yaml.en.rst:2614 msgid "" "The file header text (ex. :ref:`squid log `)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2616 +#: ../../../admin-guide/files/records.yaml.en.rst:2616 msgid "" "The format can be either ``squid`` (:ref:`admin-logging-format-squid`), " "``common`` (:ref:`admin-logging-format-common`), ``extended`` (:ref:`admin-" @@ -4011,170 +4011,170 @@ msgid "" "extended2`)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2624 +#: ../../../admin-guide/files/records.yaml.en.rst:2624 msgid "Set the log collation mode." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2629 +#: ../../../admin-guide/files/records.yaml.en.rst:2629 msgid "Log collation is disabled." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2630 +#: ../../../admin-guide/files/records.yaml.en.rst:2630 msgid "This host is a log collation server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2631 +#: ../../../admin-guide/files/records.yaml.en.rst:2631 msgid "" "This host is a collation client and sends entries using standard formats to " "the collation server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2633 +#: ../../../admin-guide/files/records.yaml.en.rst:2633 msgid "" "This host is a collation client and sends entries using the traditional " "custom formats to the collation server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2635 +#: ../../../admin-guide/files/records.yaml.en.rst:2635 msgid "" "This host is a collation client and sends entries that use both the " "standard and traditional custom formats to the collation server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2639 +#: ../../../admin-guide/files/records.yaml.en.rst:2639 msgid "" "For information on sending XML-based custom formats to the collation " "server, refer to :ref:`admin-monitoring-logging-formats` and :file:" "`logging.config`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2644 +#: ../../../admin-guide/files/records.yaml.en.rst:2644 msgid "" "Although Traffic Server supports traditional custom logging, you should use " "the more versatile XML-based custom formats." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2649 +#: ../../../admin-guide/files/records.yaml.en.rst:2649 msgid "The hostname of the log collation server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2654 +#: ../../../admin-guide/files/records.yaml.en.rst:2654 msgid "" "The port used for communication between the collation server and client." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2659 +#: ../../../admin-guide/files/records.yaml.en.rst:2659 msgid "" "The password used to validate logging data and prevent the exchange of " "unauthorized information when a collation server is being used." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2664 +#: ../../../admin-guide/files/records.yaml.en.rst:2664 msgid "" "When enabled (``1``), configures Traffic Server to include the hostname of " "the collation client that generated the log entry in each entry." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2669 +#: ../../../admin-guide/files/records.yaml.en.rst:2669 msgid "The number of seconds between collation server connection retries." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2674 +#: ../../../admin-guide/files/records.yaml.en.rst:2674 msgid "" "Specifies how log files are rolled. You can specify the following values:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2679 +#: ../../../admin-guide/files/records.yaml.en.rst:2679 msgid "Disables log file rolling." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2680 +#: ../../../admin-guide/files/records.yaml.en.rst:2680 msgid "" "Enables log file rolling at specific intervals during the day (specified " "with the :ts:cv:`proxy.config.log.rolling_interval_sec` and :ts:cv:`proxy." "config.log.rolling_offset_hr` variables)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2683 +#: ../../../admin-guide/files/records.yaml.en.rst:2683 msgid "" "Enables log file rolling when log files reach a specific size (specified " "with :ts:cv:`proxy.config.log.rolling_size_mb`)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2685 +#: ../../../admin-guide/files/records.yaml.en.rst:2685 msgid "" "Enables log file rolling at specific intervals during the day or when log " "files reach a specific size (whichever occurs first)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2687 +#: ../../../admin-guide/files/records.yaml.en.rst:2687 msgid "" "Enables log file rolling at specific intervals during the day when log " "files reach a specific size (i.e. at a specified time if the file is of the " "specified size)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2695 +#: ../../../admin-guide/files/records.yaml.en.rst:2695 msgid "" "The log file rolling interval, in seconds. The minimum value is ``60`` (1 " "minute). The maximum, and default, value is 86400 seconds (one day)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2697 +#: ../../../admin-guide/files/records.yaml.en.rst:2697 msgid "" "If you start Traffic Server within a few minutes of the next rolling time, " "then rolling might not occur until the next rolling time." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2702 +#: ../../../admin-guide/files/records.yaml.en.rst:2702 msgid "" "The file rolling offset hour. The hour of the day that starts the log " "rolling period." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2707 +#: ../../../admin-guide/files/records.yaml.en.rst:2707 msgid "" "The size, in megabytes, that log files must reach before rolling takes " "place. The minimum value for this setting is ``10``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2713 +#: ../../../admin-guide/files/records.yaml.en.rst:2713 msgid "" "Enables (``1``) or disables (``0``) automatic deletion of rolled files." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2718 +#: ../../../admin-guide/files/records.yaml.en.rst:2718 msgid "" "Configures |TS| to log only a sample of transactions rather than every " "transaction. You can specify the following values:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2724 +#: ../../../admin-guide/files/records.yaml.en.rst:2724 msgid "Log every transaction." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2725 +#: ../../../admin-guide/files/records.yaml.en.rst:2725 msgid "Log every second transaction." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2726 +#: ../../../admin-guide/files/records.yaml.en.rst:2726 msgid "Log every third transaction." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2727 +#: ../../../admin-guide/files/records.yaml.en.rst:2727 msgid "*n*" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2727 +#: ../../../admin-guide/files/records.yaml.en.rst:2727 msgid "... and so on..." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2734 +#: ../../../admin-guide/files/records.yaml.en.rst:2734 msgid "" "How often Traffic Server executes log related periodic tasks, in seconds" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2740 +#: ../../../admin-guide/files/records.yaml.en.rst:2740 msgid "" "If set to a non-zero value :arg:`N` then any connection that takes longer " "than :arg:`N` milliseconds from accept to completion will cause its timing " @@ -4183,11 +4183,11 @@ msgid "" "type:`transaction milestones `." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2745 +#: ../../../admin-guide/files/records.yaml.en.rst:2745 msgid "Diagnostic Logging Configuration" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2757 +#: ../../../admin-guide/files/records.yaml.en.rst:2757 msgid "" "The diagnosic output configuration variables control where Traffic Server " "should log diagnostic output. Messages at each diagnostic level can be " @@ -4195,159 +4195,159 @@ msgid "" "message destinations are:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2765 +#: ../../../admin-guide/files/records.yaml.en.rst:2765 msgid "``O``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2765 +#: ../../../admin-guide/files/records.yaml.en.rst:2765 msgid "Log to standard output." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2766 +#: ../../../admin-guide/files/records.yaml.en.rst:2766 msgid "``E``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2766 +#: ../../../admin-guide/files/records.yaml.en.rst:2766 msgid "Log to standard error." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2767 +#: ../../../admin-guide/files/records.yaml.en.rst:2767 msgid "``S``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2767 +#: ../../../admin-guide/files/records.yaml.en.rst:2767 msgid "Log to syslog." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2768 +#: ../../../admin-guide/files/records.yaml.en.rst:2768 msgid "``L``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2768 +#: ../../../admin-guide/files/records.yaml.en.rst:2768 msgid "Log to ``diags.log``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2773 +#: ../../../admin-guide/files/records.yaml.en.rst:2773 msgid "To log debug diagnostics to both syslog and `diags.log`::" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2779 +#: ../../../admin-guide/files/records.yaml.en.rst:2779 msgid "Annotates diagnostic messages with the source code location." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2783 +#: ../../../admin-guide/files/records.yaml.en.rst:2783 msgid "" "Enables logging for diagnostic messages whose log level is `diag` or " "`debug`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2787 +#: ../../../admin-guide/files/records.yaml.en.rst:2787 msgid "" "Each |TS| `diag` and `debug` level message is annotated with a subsystem " "tag. This configuration contains a regular expression that filters the " "messages based on the tag. Some commonly used debug tags are:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2792 +#: ../../../admin-guide/files/records.yaml.en.rst:2792 msgid "Tag" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2792 +#: ../../../admin-guide/files/records.yaml.en.rst:2792 msgid "Subsystem usage" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2794 +#: ../../../admin-guide/files/records.yaml.en.rst:2794 msgid "dns" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2794 +#: ../../../admin-guide/files/records.yaml.en.rst:2794 msgid "DNS query resolution" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2795 +#: ../../../admin-guide/files/records.yaml.en.rst:2795 msgid "http_hdrs" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2795 +#: ../../../admin-guide/files/records.yaml.en.rst:2795 msgid "Logs the headers for HTTP requests and responses" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2796 +#: ../../../admin-guide/files/records.yaml.en.rst:2796 msgid "privileges" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2796 +#: ../../../admin-guide/files/records.yaml.en.rst:2796 msgid "Privilege elevation" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2797 +#: ../../../admin-guide/files/records.yaml.en.rst:2797 msgid "TLS termination and certificate processing" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2800 +#: ../../../admin-guide/files/records.yaml.en.rst:2800 msgid "" "|TS| plugins will typically log debug messages using the :c:func:`TSDebug` " "API, passing the plugin name as the debug tag." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2806 +#: ../../../admin-guide/files/records.yaml.en.rst:2806 msgid "" "Specifies how the diagnostics log is rolled. You can specify the following " "values:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2811 +#: ../../../admin-guide/files/records.yaml.en.rst:2811 msgid "Disables diagnostics log rolling." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2812 +#: ../../../admin-guide/files/records.yaml.en.rst:2812 msgid "" "Enables diagnostics log rolling at specific intervals (specified with :ts:" "cv:`proxy.config.diags.logfile.rolling_interval_sec`). The \"clock\" starts " "ticking on |TS| startup." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2815 +#: ../../../admin-guide/files/records.yaml.en.rst:2815 msgid "" "Enables diagnostics log rolling when the diagnostics log reaches a specific " "size (specified with :ts:cv:`proxy.config.diags.logfile.rolling_size_mb`)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2824 +#: ../../../admin-guide/files/records.yaml.en.rst:2824 msgid "" "Specifies how often the diagnostics log is rolled, in seconds. The timer " "starts on Traffic Server bootup." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2830 +#: ../../../admin-guide/files/records.yaml.en.rst:2830 msgid "Specifies at what size to roll the diagnostics log at." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2833 +#: ../../../admin-guide/files/records.yaml.en.rst:2833 msgid "Reverse Proxy" msgstr "リバースプロキシー" -#: ../../../admin-guide/files/records.config.en.rst:2838 +#: ../../../admin-guide/files/records.yaml.en.rst:2838 msgid "Enables (``1``) or disables (``0``) HTTP reverse proxy." msgstr "" "HTTP リバースプロキシーを有効化 (``1``) もしくは無効化 (``0``) します。" -#: ../../../admin-guide/files/records.config.en.rst:2843 +#: ../../../admin-guide/files/records.yaml.en.rst:2843 msgid "" "The URL to which to redirect requests with no host headers (reverse proxy)." msgstr "" "(リバースプロキシーで) host ヘッダーが無いリクエストのリダイレクト先となる " "URL です。" -#: ../../../admin-guide/files/records.config.en.rst:2847 +#: ../../../admin-guide/files/records.yaml.en.rst:2847 msgid "URL Remap Rules" msgstr "URL リマップルール" -#: ../../../admin-guide/files/records.config.en.rst:2851 +#: ../../../admin-guide/files/records.yaml.en.rst:2851 msgid "Sets the name of the :file:`remap.config` file." msgstr ":file:`remap.config` ファイルの名前を設定します。" -#: ../../../admin-guide/files/records.config.en.rst:2856 +#: ../../../admin-guide/files/records.yaml.en.rst:2856 msgid "" "Set this variable to ``1`` if you want Traffic Server to serve requests " "only from origin servers listed in the mapping rules of the :file:`remap." @@ -4359,7 +4359,7 @@ msgstr "" "``1`` に設定してください。リクエストがマッチしなかった場合、ブラウザーはエ" "ラーを受け取ります。" -#: ../../../admin-guide/files/records.config.en.rst:2865 +#: ../../../admin-guide/files/records.yaml.en.rst:2865 msgid "" "Set this variable to ``1`` if you want to retain the client host header in " "a request during remapping." @@ -4367,11 +4367,11 @@ msgstr "" "クライアントが送信したリクエスト内の host ヘッダーをリマッピングの中で保持し" "たい場合にこの変数を ``1`` に設定してください。" -#: ../../../admin-guide/files/records.config.en.rst:2871 +#: ../../../admin-guide/files/records.yaml.en.rst:2871 msgid "SSL Termination" msgstr "SSL ターミネーション" -#: ../../../admin-guide/files/records.config.en.rst:2875 +#: ../../../admin-guide/files/records.yaml.en.rst:2875 msgid "" "Configures the set of encryption, digest, authentication, and key exchange " "algorithms provided by OpenSSL which |TS| will use for SSL connections. For " @@ -4380,13 +4380,13 @@ msgid "" "org/docs/manmaster/apps/ciphers.html>`_." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2881 +#: ../../../admin-guide/files/records.yaml.en.rst:2881 msgid "" "The current default, included in the ``records.config.default`` example " "configuration is:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2884 +#: ../../../admin-guide/files/records.yaml.en.rst:2884 msgid "" "ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-" "AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-" @@ -4401,11 +4401,11 @@ msgid "" "CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2888 +#: ../../../admin-guide/files/records.yaml.en.rst:2888 msgid "Enables (``1``) or disables (``0``) TLSv1." msgstr "TLSv1 を有効化 (``1``) もしくは無効化 (``0``) します。" -#: ../../../admin-guide/files/records.config.en.rst:2892 +#: ../../../admin-guide/files/records.yaml.en.rst:2892 msgid "" "Enables (``1``) or disables (``0``) TLS v1.1. If not specified, enabled by " "default. [Requires OpenSSL v1.0.1 and higher]" @@ -4413,7 +4413,7 @@ msgstr "" "TLS v1.1 を有効化 (``1``) もしくは無効化 (``0``) します。指定しない場合、デ" "フォルトで有効です。[OpenSSL v1.0.1 以上が必要 ]" -#: ../../../admin-guide/files/records.config.en.rst:2896 +#: ../../../admin-guide/files/records.yaml.en.rst:2896 #, fuzzy msgid "" "Enables (``1``) or disables (``0``) TLS v1.2. If not specified, enabled by " @@ -4422,11 +4422,11 @@ msgstr "" "TLS v1.1 を有効化 (``1``) もしくは無効化 (``0``) します。指定しない場合、デ" "フォルトで有効です。[OpenSSL v1.0.1 以上が必要 ]" -#: ../../../admin-guide/files/records.config.en.rst:2900 +#: ../../../admin-guide/files/records.yaml.en.rst:2900 msgid "Sets the client certification level:" msgstr "クライアント証明レベルを設定します。" -#: ../../../admin-guide/files/records.config.en.rst:2905 +#: ../../../admin-guide/files/records.yaml.en.rst:2905 #, fuzzy msgid "" "Client certificates are **ignored**. |TS| does not verify client " @@ -4437,7 +4437,7 @@ msgstr "" "ん。Traffic Server へのアクセスは Traffic Server の ( アクセスコントロールリ" "ストなどの ) 設定オプションに依存します。" -#: ../../../admin-guide/files/records.config.en.rst:2908 +#: ../../../admin-guide/files/records.yaml.en.rst:2908 #, fuzzy msgid "" "Client certificates are **optional**. If a client has a certificate, then " @@ -4450,7 +4450,7 @@ msgstr "" "スが拒否されない限りクライアントは Traffic Server へのアクセスを許可されま" "す。" -#: ../../../admin-guide/files/records.config.en.rst:2912 +#: ../../../admin-guide/files/records.yaml.en.rst:2912 #, fuzzy msgid "" "Client certificates are **required**. The client must be authenticated " @@ -4460,37 +4460,37 @@ msgstr "" "クライアントは SSL ハンドシェイクの中で認証されなければなりません。証明書を" "持たないクライアントは Traffic Server へのアクセスが許可されません。" -#: ../../../admin-guide/files/records.config.en.rst:2919 +#: ../../../admin-guide/files/records.yaml.en.rst:2919 msgid "" "Sets the number of SSL threads to use, this defaults to 0 (autoconfigure)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2924 +#: ../../../admin-guide/files/records.yaml.en.rst:2924 msgid "" "Autoconfigure. This will allow |TS| to determine the appropriate number of " "threads" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2926 +#: ../../../admin-guide/files/records.yaml.en.rst:2926 msgid "``-1``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2926 +#: ../../../admin-guide/files/records.yaml.en.rst:2926 msgid "" "Disable. This makes ``ET_NET`` threads behave like ``ET_SSL`` threads. Note " "that this does not disable SSL, it simply allows another thread pool to " "assist in SSL tasks without dedicated SSL threads." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2930 +#: ../../../admin-guide/files/records.yaml.en.rst:2930 msgid ">\\ ``0``" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2930 +#: ../../../admin-guide/files/records.yaml.en.rst:2930 msgid "Use a non-zero number of dedicated SSL threads." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2935 +#: ../../../admin-guide/files/records.yaml.en.rst:2935 msgid "" "The location of the :file:`ssl_multicert.config` file, relative to the " "Traffic Server configuration directory. In the following example, if the " @@ -4503,7 +4503,7 @@ msgstr "" "trafficserver` で、Traffic Server SSL 設定ファイルと対応する証明書が `/etc/" "trafficserver/ssl` にあります。::" -#: ../../../admin-guide/files/records.config.en.rst:2948 +#: ../../../admin-guide/files/records.yaml.en.rst:2948 msgid "" "The location of the SSL certificates and chains used for accepting and " "validation new SSL sessions. If this is a relative path, it is appended to " @@ -4516,7 +4516,7 @@ msgstr "" "す。:file:`ssl_multicert.config` に書かれているすべての証明書と証明書チェー" "ンはこのパスからの相対パスで読み込まれます。" -#: ../../../admin-guide/files/records.config.en.rst:2956 +#: ../../../admin-guide/files/records.yaml.en.rst:2956 msgid "" "The location of the SSL certificate private keys. Change this variable only " "if the private key is not located in the SSL certificate file. All private " @@ -4527,7 +4527,7 @@ msgstr "" "合のみ変更してください。:file:`ssl_multicert.config` に書かれているすべての" "秘密鍵はこのパスからの相対パスで読み込まれます。" -#: ../../../admin-guide/files/records.config.en.rst:2964 +#: ../../../admin-guide/files/records.yaml.en.rst:2964 msgid "" "The name of a file containing a global certificate chain that should be " "used with every server certificate. This file is only used if there are " @@ -4541,7 +4541,7 @@ msgstr "" "config.ssl.server.cert.path` で指定されたパスからの相対パスで読み込まれま" "す。" -#: ../../../admin-guide/files/records.config.en.rst:2972 +#: ../../../admin-guide/files/records.yaml.en.rst:2972 msgid "" "The name of a file containing a set of Diffie-Hellman key exchange " "parameters. If not specified, 2048-bit DH parameters from RFC 5114 are " @@ -4549,25 +4549,25 @@ msgid "" "been selected." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2979 +#: ../../../admin-guide/files/records.yaml.en.rst:2979 msgid "" "The location of the certificate authority file that client certificates " "will be verified against." msgstr "クライアント証明書が検証される証明書認証局ファイルの場所です。" -#: ../../../admin-guide/files/records.config.en.rst:2984 +#: ../../../admin-guide/files/records.yaml.en.rst:2984 msgid "" "The filename of the certificate authority that client certificates will be " "verified against." msgstr "クライアント証明書が検証される証明書認証局のファイル名です。" -#: ../../../admin-guide/files/records.config.en.rst:2989 +#: ../../../admin-guide/files/records.yaml.en.rst:2989 msgid "" "The location of the :file:`ssl_ticket.key` file, relative to the :ts:cv:" "`proxy.config.ssl.server.cert.path` directory." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:2994 +#: ../../../admin-guide/files/records.yaml.en.rst:2994 msgid "" "This configuration specifies the maximum number of bytes to write into a " "SSL record when replying over a SSL session. In some circumstances this " @@ -4576,13 +4576,13 @@ msgid "" "size)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3000 +#: ../../../admin-guide/files/records.yaml.en.rst:3000 msgid "" "The default of ``0`` means to always write all available data into a single " "SSL record." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3003 +#: ../../../admin-guide/files/records.yaml.en.rst:3003 msgid "" "A value of ``-1`` means TLS record size is dynamically determined. The " "strategy employed is to use small TLS records that fit into a single TCP " @@ -4592,25 +4592,25 @@ msgid "" "mechanism is repeated again." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3012 +#: ../../../admin-guide/files/records.yaml.en.rst:3012 msgid "Enables the SSL session cache:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3017 +#: ../../../admin-guide/files/records.yaml.en.rst:3017 msgid "Disables the session cache entirely." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3018 +#: ../../../admin-guide/files/records.yaml.en.rst:3018 msgid "Enables the session cache using OpenSSL's implementation." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3019 +#: ../../../admin-guide/files/records.yaml.en.rst:3019 msgid "" "Default. Enables the session cache using |TS|'s implementation. This " "implementation should perform much better than the OpenSSL implementation." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3026 +#: ../../../admin-guide/files/records.yaml.en.rst:3026 msgid "" "This configuration specifies the lifetime of SSL session cache entries in " "seconds. If it is ``0``, then the SSL library will use a default value, " @@ -4619,40 +4619,40 @@ msgid "" "session_cache``)" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3036 +#: ../../../admin-guide/files/records.yaml.en.rst:3036 msgid "" "This will set the OpenSSL auto clear flag. Auto clear is enabled by default " "with ``1`` it can be disabled by changing this setting to ``0``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3041 +#: ../../../admin-guide/files/records.yaml.en.rst:3041 msgid "" "This configuration specifies the maximum number of entries the SSL session " "cache may contain." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3046 +#: ../../../admin-guide/files/records.yaml.en.rst:3046 msgid "" "This configuration specifies the number of buckets to use with the Traffic " "Server SSL session cache implementation. The TS implementation is a fixed " "size hash map where each bucket is protected by a mutex." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3052 +#: ../../../admin-guide/files/records.yaml.en.rst:3052 msgid "" "This configuration specifies the behavior of the Traffic Server SSL session " "cache implementation during lock contention on each bucket:" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3058 +#: ../../../admin-guide/files/records.yaml.en.rst:3058 msgid "Default. Don't skip session caching when bucket lock is contented." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3059 +#: ../../../admin-guide/files/records.yaml.en.rst:3059 msgid "Disable the SSL session cache for a connection during lock contention." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3064 +#: ../../../admin-guide/files/records.yaml.en.rst:3064 msgid "" "This configuration specifies the max-age value that will be used when " "adding the Strict-Transport-Security header. The value is in seconds. A " @@ -4667,7 +4667,7 @@ msgstr "" "しヘッダーをセットしません。このオプションは HTTPS のリクエストでのみ使用さ" "れ HTTP リクエストではヘッダーはセットされません。" -#: ../../../admin-guide/files/records.config.en.rst:3073 +#: ../../../admin-guide/files/records.yaml.en.rst:3073 msgid "" "Enables (``1``) or disables (``0``) adding the includeSubdomain value to " "the Strict-Transport-Security header. proxy.config.ssl.hsts_max_age needs " @@ -4677,7 +4677,7 @@ msgstr "" "(``1``) もしくは無効化 (``0``) します。この設定の効果を得るためには proxy." "config.ssl.hsts_max_age が ``-1`` 以外の値に設定されている必要があります。" -#: ../../../admin-guide/files/records.config.en.rst:3079 +#: ../../../admin-guide/files/records.yaml.en.rst:3079 msgid "" "This configuration specifies whether the client is able to initiate " "renegotiation of the SSL connection. The default of ``0``, means the " @@ -4687,7 +4687,7 @@ msgstr "" "します。デフォルトは ``0`` で、クライアントが再交渉を始められないことを意味" "します。" -#: ../../../admin-guide/files/records.config.en.rst:3085 +#: ../../../admin-guide/files/records.yaml.en.rst:3085 msgid "" "Enables (``1``) or disables (``0``) elevation of traffic_server privileges " "during loading of SSL certificates. By enabling this, SSL certificate " @@ -4698,45 +4698,45 @@ msgstr "" "くは無効化 (``0``) します。これを有効化することで、証明書の脆弱性を低減する" "ために SSL 証明書ファイルのアクセス権限を制限できるようになります。" -#: ../../../admin-guide/files/records.config.en.rst:3090 +#: ../../../admin-guide/files/records.yaml.en.rst:3090 msgid "" "This feature requires Traffic Server to be built with POSIX capabilities " "enabled." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3095 +#: ../../../admin-guide/files/records.yaml.en.rst:3095 msgid "" "When enabled this limits the total duration for the server side SSL " "handshake." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3102 +#: ../../../admin-guide/files/records.yaml.en.rst:3102 msgid "" "When enabled this turns on wire tracing of SSL connections that meet the " "conditions specified by wire_trace_percentage, wire_trace_addr and " "wire_trace_server_name." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3108 +#: ../../../admin-guide/files/records.yaml.en.rst:3108 msgid "" "This specifies the percentage of traffic meeting the other wire_trace " "conditions to be traced." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3113 +#: ../../../admin-guide/files/records.yaml.en.rst:3113 msgid "This specifies the client IP for which wire_traces should be printed." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3117 +#: ../../../admin-guide/files/records.yaml.en.rst:3117 msgid "" "This specifies the server name for which wire_traces should be printed." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3122 +#: ../../../admin-guide/files/records.yaml.en.rst:3122 msgid "Client-Related Configuration" msgstr "クライアント関連の設定" -#: ../../../admin-guide/files/records.config.en.rst:3126 +#: ../../../admin-guide/files/records.yaml.en.rst:3126 msgid "" "Configures Traffic Server to verify the origin server certificate with the " "Certificate Authority (CA)." @@ -4744,17 +4744,17 @@ msgstr "" "Traffic Server がオリジンサーバー証明書を証明書認証局 (CA) で検証するように" "設定します。" -#: ../../../admin-guide/files/records.config.en.rst:3131 +#: ../../../admin-guide/files/records.yaml.en.rst:3131 msgid "The filename of SSL client certificate installed on Traffic Server." msgstr "" "Traffic Server にインストールされた SSL クライアント証明書のファイル名。" -#: ../../../admin-guide/files/records.config.en.rst:3135 +#: ../../../admin-guide/files/records.yaml.en.rst:3135 msgid "" "The location of the SSL client certificate installed on Traffic Server." msgstr "Traffic Server にインストールされた SSL クライアント証明書の場所。" -#: ../../../admin-guide/files/records.config.en.rst:3140 +#: ../../../admin-guide/files/records.yaml.en.rst:3140 msgid "" "The filename of the Traffic Server private key. Change this variable only " "if the private key is not located in the Traffic Server SSL client " @@ -4763,7 +4763,7 @@ msgstr "" "Traffic Server 秘密鍵のファイル名。この変数は秘密鍵が Traffic Server SSL ク" "ライアント証明書ファイル内に無い場合のみ変更してください。" -#: ../../../admin-guide/files/records.config.en.rst:3146 +#: ../../../admin-guide/files/records.yaml.en.rst:3146 msgid "" "The location of the Traffic Server private key. Change this variable only " "if the private key is not located in the SSL client certificate file." @@ -4771,62 +4771,62 @@ msgstr "" "Traffic Server 秘密鍵の場所です。この変数は秘密鍵が SSL 証明書内に無い場合の" "み変更してください。" -#: ../../../admin-guide/files/records.config.en.rst:3152 +#: ../../../admin-guide/files/records.yaml.en.rst:3152 msgid "" "The filename of the certificate authority against which the origin server " "will be verified." msgstr "検証されるオリジンサーバーに対する証明書認証局ファイルの名前です。" -#: ../../../admin-guide/files/records.config.en.rst:3157 +#: ../../../admin-guide/files/records.yaml.en.rst:3157 msgid "" "Specifies the location of the certificate authority file against which the " "origin server will be verified." msgstr "" "検証されるオリジンサーバーに対する証明書認証局ファイルの場所を指定します。" -#: ../../../admin-guide/files/records.config.en.rst:3161 +#: ../../../admin-guide/files/records.yaml.en.rst:3161 msgid "OCSP Stapling Configuration" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3165 +#: ../../../admin-guide/files/records.yaml.en.rst:3165 msgid "Enable OCSP stapling." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3170 +#: ../../../admin-guide/files/records.yaml.en.rst:3170 msgid "Disables OCSP Stapling." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3171 +#: ../../../admin-guide/files/records.yaml.en.rst:3171 msgid "" "Allows |TS| to request SSL certificate revocation status from an OCSP " "responder." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3177 +#: ../../../admin-guide/files/records.yaml.en.rst:3177 msgid "" "Number of seconds before an OCSP response expires in the stapling cache." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3183 +#: ../../../admin-guide/files/records.yaml.en.rst:3183 msgid "Timeout (in seconds) for queries to OCSP responders." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3189 +#: ../../../admin-guide/files/records.yaml.en.rst:3189 msgid "Update period (in seconds) for stapling caches." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3224 +#: ../../../admin-guide/files/records.yaml.en.rst:3224 msgid "" "The |TS| installation script detects your network interface and sets this " "variable appropriately. If your system has multiple network interfaces, " "check that this variable specifies the correct interface." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3241 +#: ../../../admin-guide/files/records.yaml.en.rst:3241 msgid "HTTP/2 Configuration" msgstr "HTTP/2 の設定" -#: ../../../admin-guide/files/records.config.en.rst:3246 +#: ../../../admin-guide/files/records.yaml.en.rst:3246 msgid "" "Enable the experimental HTTP/2 feature. This implements most of the " "specifications, with the one big exception being server PUSH." @@ -4834,7 +4834,7 @@ msgstr "" "実験的な HTTP/2 機能を有効にします。この実装はサーバプッシュを除くほぼすべて" "の仕様を実装しています。" -#: ../../../admin-guide/files/records.config.en.rst:3251 +#: ../../../admin-guide/files/records.yaml.en.rst:3251 msgid "" "This configuration will be eliminated for v6.0.0, where HTTP/2 is enabled " "by default and controlled via the ports configuration." @@ -4842,12 +4842,12 @@ msgstr "" "この設定は v6.0.0 で削除され、HTTP/2 はデフォルトで有効となり、ポート設定に" "よって制御されるようになります。" -#: ../../../admin-guide/files/records.config.en.rst:3257 -#: ../../../admin-guide/files/records.config.en.rst:3335 +#: ../../../admin-guide/files/records.yaml.en.rst:3257 +#: ../../../admin-guide/files/records.yaml.en.rst:3335 msgid "The maximum number of concurrent streams per inbound connection." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3261 +#: ../../../admin-guide/files/records.yaml.en.rst:3261 msgid "" "Reloading this value affects only new HTTP/2 connections, not the ones " "already established." @@ -4855,14 +4855,14 @@ msgstr "" "この値の再読み込みは新しい HTTP/2 のコネクションでのみ適用され、 すでに確率" "したコネクションには適用されません。" -#: ../../../admin-guide/files/records.config.en.rst:3267 +#: ../../../admin-guide/files/records.yaml.en.rst:3267 msgid "" "The minimum number of concurrent streams per inbound connection. This is " "used when :ts:cv:`proxy.config.http2.max_active_streams_in` is set larger " "than ``0``." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3274 +#: ../../../admin-guide/files/records.yaml.en.rst:3274 msgid "" "Limits the maximum number of connection wide active streams. When " "connection wide active streams are larger than this value, " @@ -4870,26 +4870,26 @@ msgid "" "http2.min_concurrent_streams_in`. To disable, set to zero (``0``)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3283 -#: ../../../admin-guide/files/records.config.en.rst:3329 +#: ../../../admin-guide/files/records.yaml.en.rst:3283 +#: ../../../admin-guide/files/records.yaml.en.rst:3329 msgid "The initial window size for inbound connections." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3288 +#: ../../../admin-guide/files/records.yaml.en.rst:3288 msgid "" "Indicates the size of the largest frame payload that the sender is willing " "to receive." msgstr "" "Traffic Server が受け取るフレームに含まれるペイロードの最大許容サイズです。" -#: ../../../admin-guide/files/records.config.en.rst:3294 +#: ../../../admin-guide/files/records.yaml.en.rst:3294 msgid "" "The maximum size of the header compression table used to decode header " "blocks." msgstr "" "ヘッダーブロックのデコードに使用されるヘッダー圧縮テーブルの最大サイズです。" -#: ../../../admin-guide/files/records.config.en.rst:3300 +#: ../../../admin-guide/files/records.yaml.en.rst:3300 msgid "" "This advisory setting informs a peer of the maximum size of header list " "that the sender is prepared to accept blocks. The default value, which is " @@ -4898,25 +4898,25 @@ msgstr "" "許容するヘッダーリストの最大数です。デフォルト値は暗黙的に無制限を意味し、" "Traffic Server では unsigned int の最大値になっています。" -#: ../../../admin-guide/files/records.config.en.rst:3307 +#: ../../../admin-guide/files/records.yaml.en.rst:3307 msgid "Enable the experimental HTTP/2 Stream Priority feature." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3310 +#: ../../../admin-guide/files/records.yaml.en.rst:3310 msgid "SPDY Configuration" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3317 +#: ../../../admin-guide/files/records.yaml.en.rst:3317 msgid "" "How long a SPDY connection will be kept open after an accept without any " "streams created." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3323 +#: ../../../admin-guide/files/records.yaml.en.rst:3323 msgid "How long a stream is kept open without activity." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3339 +#: ../../../admin-guide/files/records.yaml.en.rst:3339 msgid "" "Reloading this value affects only new SPDY connections, not the ones " "already established.." @@ -4924,15 +4924,15 @@ msgstr "" "この値の再読み込みは新しい SPDY のコネクションでのみ適用され、 すでに確率し" "たコネクションには適用されません。" -#: ../../../admin-guide/files/records.config.en.rst:3343 +#: ../../../admin-guide/files/records.yaml.en.rst:3343 msgid "Plug-in Configuration" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3347 +#: ../../../admin-guide/files/records.yaml.en.rst:3347 msgid "Specifies the location of Traffic Server plugins." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3351 +#: ../../../admin-guide/files/records.yaml.en.rst:3351 msgid "" "When this variable is set to ``0``, plugin remap callbacks are executed in " "line on network threads. If remap processing takes significant time, this " @@ -4941,93 +4941,93 @@ msgid "" "network threads to service additional requests." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3359 +#: ../../../admin-guide/files/records.yaml.en.rst:3359 msgid "SOCKS Processor" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3363 +#: ../../../admin-guide/files/records.yaml.en.rst:3363 msgid "Enables (``1``) or disables (``0``) the SOCKS processor" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3367 +#: ../../../admin-guide/files/records.yaml.en.rst:3367 msgid "Specifies the SOCKS version (``4``) or (``5``)" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3371 +#: ../../../admin-guide/files/records.yaml.en.rst:3371 msgid "" "The socks_onfig file allows you to specify ranges of IP addresses that will " "not be relayed to the SOCKS server. It can also be used to configure AUTH " "information for SOCKSv5 servers." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3377 +#: ../../../admin-guide/files/records.yaml.en.rst:3377 msgid "The activity timeout value (in seconds) for SOCKS server connections." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3383 +#: ../../../admin-guide/files/records.yaml.en.rst:3383 msgid "The timeout value (in seconds) for SOCKS server connection attempts." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3389 +#: ../../../admin-guide/files/records.yaml.en.rst:3389 msgid "" "The total number of connection attempts allowed per SOCKS server, if " "multiple servers are used." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3394 +#: ../../../admin-guide/files/records.yaml.en.rst:3394 msgid "" "The total number of connection attempts allowed to a SOCKS server Traffic " "Server bypasses the server or fails the request" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3399 +#: ../../../admin-guide/files/records.yaml.en.rst:3399 msgid "" "The timeout value (in seconds) for SOCKS server connection retry attempts." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3405 +#: ../../../admin-guide/files/records.yaml.en.rst:3405 msgid "Default list of SOCKS servers and their ports." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3409 +#: ../../../admin-guide/files/records.yaml.en.rst:3409 msgid "" "The amount of time allowed between connection retries to a SOCKS server " "that is unavailable." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3414 +#: ../../../admin-guide/files/records.yaml.en.rst:3414 msgid "" "The number of times the connection to the SOCKS server can fail before " "Traffic Server considers the server unavailable." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3419 +#: ../../../admin-guide/files/records.yaml.en.rst:3419 msgid "" "Enables (1) or disables (0) the SOCKS proxy option. As a SOCKS proxy, " "Traffic Server receives SOCKS traffic (usually on port 1080) and forwards " "all requests directly to the SOCKS server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3425 +#: ../../../admin-guide/files/records.yaml.en.rst:3425 msgid "Specifies the port on which Traffic Server accepts SOCKS traffic." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3429 +#: ../../../admin-guide/files/records.yaml.en.rst:3429 msgid "" "Specifies the port on which Traffic Server accepts HTTP proxy requests over " "SOCKS connections.." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3433 +#: ../../../admin-guide/files/records.yaml.en.rst:3433 msgid "Sockets" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3437 +#: ../../../admin-guide/files/records.yaml.en.rst:3437 msgid "" "default: ``1`` meaning ``on`` all Platforms except Linux: ``45`` seconds" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3439 +#: ../../../admin-guide/files/records.yaml.en.rst:3439 msgid "" "This directive enables operating system specific optimizations for a " "listening socket. ``defer_accept`` holds a call to ``accept(2)`` back until " @@ -5035,14 +5035,14 @@ msgid "" "seconds." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3445 +#: ../../../admin-guide/files/records.yaml.en.rst:3445 msgid "" "This directive sets the maximum number of pending connections. If it is set " "to -1, Traffic Server will automatically set this to a platform-specific " "maximum." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3451 +#: ../../../admin-guide/files/records.yaml.en.rst:3451 msgid "" "This directive will override the congestion control algorithm for incoming " "connections (accept sockets). On linux the allowed values are typically " @@ -5050,7 +5050,7 @@ msgid "" "tcp_allowed_congestion_control" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3457 +#: ../../../admin-guide/files/records.yaml.en.rst:3457 msgid "" "This directive will override the congestion control algorithm for outgoing " "connections (connect sockets). On linux the allowed values are typically " @@ -5058,91 +5058,91 @@ msgid "" "tcp_allowed_congestion_control" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3463 +#: ../../../admin-guide/files/records.yaml.en.rst:3463 msgid "" "Sets the send buffer size for connections from the client to Traffic Server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3467 +#: ../../../admin-guide/files/records.yaml.en.rst:3467 msgid "" "Sets the receive buffer size for connections from the client to Traffic " "Server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3471 +#: ../../../admin-guide/files/records.yaml.en.rst:3471 msgid "" "Turns different options \"on\" for the socket handling client connections:::" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3479 -#: ../../../admin-guide/files/records.config.en.rst:3505 +#: ../../../admin-guide/files/records.yaml.en.rst:3479 +#: ../../../admin-guide/files/records.yaml.en.rst:3505 msgid "" "This is a bitmask and you need to decide what bits to set. Therefore, you " "must set the value to ``3`` if you want to enable nodelay and keepalive " "options above." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3486 +#: ../../../admin-guide/files/records.yaml.en.rst:3486 msgid "" "Sets the send buffer size for connections from Traffic Server to the origin " "server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3491 +#: ../../../admin-guide/files/records.yaml.en.rst:3491 msgid "" "Sets the receive buffer size for connections from Traffic Server to the " "origin server." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3497 +#: ../../../admin-guide/files/records.yaml.en.rst:3497 msgid "Turns different options \"on\" for the origin server socket:::" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3509 +#: ../../../admin-guide/files/records.yaml.en.rst:3509 msgid "" "When SO_LINGER is enabled, the linger timeout time is set to 0. This is " "useful when Traffic Server and the origin server are co-located and large " "numbers of sockets are retained in the TIME_WAIT state." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3516 +#: ../../../admin-guide/files/records.yaml.en.rst:3516 msgid "" "Same as the command line option ``--accept_mss`` that sets the MSS for all " "incoming requests." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3520 +#: ../../../admin-guide/files/records.yaml.en.rst:3520 msgid "" "Set the packet mark on traffic destined for the client (the packets that " "make up a client response)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3523 -#: ../../../admin-guide/files/records.config.en.rst:3531 -#: ../../../admin-guide/files/records.config.en.rst:3538 -#: ../../../admin-guide/files/records.config.en.rst:3546 +#: ../../../admin-guide/files/records.yaml.en.rst:3523 +#: ../../../admin-guide/files/records.yaml.en.rst:3531 +#: ../../../admin-guide/files/records.yaml.en.rst:3538 +#: ../../../admin-guide/files/records.yaml.en.rst:3546 msgid "`Traffic Shaping`_" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3528 +#: ../../../admin-guide/files/records.yaml.en.rst:3528 msgid "" "Set the packet mark on traffic destined for the origin (the packets that " "make up an origin request)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3535 +#: ../../../admin-guide/files/records.yaml.en.rst:3535 msgid "" "Set the ToS/DiffServ Field on packets sent to the client (the packets that " "make up a client response)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3543 +#: ../../../admin-guide/files/records.yaml.en.rst:3543 msgid "" "Set the ToS/DiffServ Field on packets sent to the origin (the packets that " "make up an origin request)." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3550 +#: ../../../admin-guide/files/records.yaml.en.rst:3550 msgid "" "Same as the command line option ``--poll_timeout``, or ``-t``, which " "specifies the timeout used for the polling mechanism used. This timeout is " @@ -5151,7 +5151,7 @@ msgid "" "``10`` on all platforms." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3556 +#: ../../../admin-guide/files/records.yaml.en.rst:3556 msgid "" "Changing this configuration can reduce CPU usage on an idle system, since " "periodic tasks gets processed at these intervals. On busy servers, this " @@ -5162,35 +5162,35 @@ msgid "" "alternatives to this could be::" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3568 +#: ../../../admin-guide/files/records.yaml.en.rst:3568 msgid "The relevant configurations for this are::" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3579 +#: ../../../admin-guide/files/records.yaml.en.rst:3579 msgid "" "Specifies the number of task threads to run. These threads are used for " "various tasks that should be off-loaded from the normal network threads." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3584 +#: ../../../admin-guide/files/records.yaml.en.rst:3584 msgid "" "Sets the maximum number of elements that can be contained in a " "ProxyAllocator (per-thread) before returning the objects to the global pool" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3589 +#: ../../../admin-guide/files/records.yaml.en.rst:3589 msgid "" "Sets the minimum number of items a ProxyAllocator (per-thread) will " "guarantee to be holding at any one time." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3594 +#: ../../../admin-guide/files/records.yaml.en.rst:3594 msgid "" "Enable (1) the use of huge pages on supported platforms. (Currently only " "Linux)" msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3596 +#: ../../../admin-guide/files/records.yaml.en.rst:3596 msgid "" "You must also enable hugepages at the OS level. In a modern linux Kernel " "this can be done by setting ``/proc/sys/vm/nr_overcommit_hugepages`` to a " @@ -5198,7 +5198,7 @@ msgid "" "size) because these pages are only created on demand." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3601 +#: ../../../admin-guide/files/records.yaml.en.rst:3601 #, python-format msgid "" "For more information on the implications of enabling huge pages, see " @@ -5206,14 +5206,14 @@ msgid "" "%29#Page_size_trade-off>_`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3606 +#: ../../../admin-guide/files/records.yaml.en.rst:3606 msgid "" "Turn on or off support for HTTP proxying. This is rarely used, the one " "exception being if you run Traffic Server with a protocol plugin, and would " "like for it to not support HTTP requests at all." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3612 +#: ../../../admin-guide/files/records.yaml.en.rst:3612 msgid "" "Accepting inbound connections and starting the cache are independent " "operations in |TS|. This variable controls the relative timing of these " @@ -5223,20 +5223,20 @@ msgid "" "logged in :file:`diags.log`." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3622 +#: ../../../admin-guide/files/records.yaml.en.rst:3622 msgid "" "Decouple inbound connections and cache initialization. Connections will be " "accepted as soon as possible and |TS| will run regardless of the results of " "cache initialization." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3625 +#: ../../../admin-guide/files/records.yaml.en.rst:3625 msgid "" "Do not accept inbound connections until cache initialization has finished. |" "TS| will run regardless of the results of cache initialization." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3628 +#: ../../../admin-guide/files/records.yaml.en.rst:3628 msgid "" "Do not accept inbound connections until cache initialization has finished " "and been sufficiently successful that cache is enabled. This means at least " @@ -5245,7 +5245,7 @@ msgid "" "will shut down." msgstr "" -#: ../../../admin-guide/files/records.config.en.rst:3633 +#: ../../../admin-guide/files/records.yaml.en.rst:3633 msgid "" "Do not accept inbound connections until cache initialization has finished " "and been completely successful. This requires at least one cache span in :" diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/files/remap.config.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/files/remap.config.en.po index fd9048081e4..ddd8337ae78 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/files/remap.config.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/files/remap.config.en.po @@ -437,13 +437,13 @@ msgid "" "When acting as a reverse proxy for multiple servers, Traffic Server is " "unable to route to URLs from older browsers that do not send the ``Host:`` " "header. As a solution, set the variable :ts:cv:`proxy.config.header.parse." -"no_host_url_redirect` in the :file:`records.config` file to the URL to " +"no_host_url_redirect` in the :file:`records.yaml` file to the URL to " "which Traffic Server will redirect requests without host headers." msgstr "" "複数のサーバーのリバースプロキシーとして振る舞うとき、Traffic Server は " "``Host:`` ヘッダーを送信しない古めのブラウザーに URL を示せません。解決策と" "して、Traffic Server がホストヘッダーの無いリクエストをリダイレクトする URL " -"を :file:`records.config` の :ts:cv:`proxy.config.header.parse." +"を :file:`records.yaml` の :ts:cv:`proxy.config.header.parse." "no_host_url_redirect` 変数に設定してください。" #: ../../../admin-guide/files/remap.config.en.rst:248 diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/error-messages.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/error-messages.en.po index 7c223fc8c70..91e7e23bd10 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/error-messages.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/error-messages.en.po @@ -52,7 +52,7 @@ msgstr "" #: ../../../admin-guide/monitoring/error-messages.en.rst:33 msgid "" -"The port specified in :file:`records.config` that accepts incoming HTTP " +"The port specified in :file:`records.yaml` that accepts incoming HTTP " "requests is not valid." msgstr "" diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/logging/log-formats.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/logging/log-formats.en.po index 9967d78afb2..fa105ce87d0 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/logging/log-formats.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/logging/log-formats.en.po @@ -187,10 +187,10 @@ msgstr "" #: ../../../admin-guide/monitoring/logging/log-formats.en.rst:97 msgid "" "These formats may be used by enabling the :ts:cv:`proxy.config.log." -"custom_logs_enabled` setting in :file:`records.config` and adding " +"custom_logs_enabled` setting in :file:`records.yaml` and adding " "appropriate entries to :file:`logging.config`." msgstr "" -"これらのフォーマットは :file:`records.config` の :ts:cv:`proxy.config.log." +"これらのフォーマットは :file:`records.yaml` の :ts:cv:`proxy.config.log." "custom_logs_enabled` 設定を有効にし、 :file:`logging.config` に適切なエント" "リを追加することで使えるようになります。" diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/logging/managing-logs.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/logging/managing-logs.en.po index 30f60803bb1..ed25467b28c 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/logging/managing-logs.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/logging/managing-logs.en.po @@ -105,7 +105,7 @@ msgid "To set log management options, follow the steps below:" msgstr "" #: ../../../admin-guide/monitoring/logging/managing-logs.en.rst:74 -msgid "In the :file:`records.config` file, edit the following variables" +msgid "In the :file:`records.yaml` file, edit the following variables" msgstr "" #: ../../../admin-guide/monitoring/logging/managing-logs.en.rst:76 @@ -388,7 +388,7 @@ msgid "" "You can fine-tune log file rolling settings for a custom log file in the :" "ref:`LogObject` specification in :file:`logging.config`. The custom log " "file uses the rolling settings in its :ref:`LogObject`, which override the " -"default settings you specify in Traffic Manager or :file:`records.config` " +"default settings you specify in Traffic Manager or :file:`records.yaml` " "described above." msgstr "" diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/logging/understanding.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/logging/understanding.en.po index d90f6ba59b7..3a15a99c729 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/logging/understanding.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/monitoring/logging/understanding.en.po @@ -95,7 +95,7 @@ msgid "" "By default, |TS| creates both error and event log files and records system " "information in system log files. You can disable event logging and/or error " "logging by setting the configuration variable :ts:cv:`proxy.config.log." -"logging_enabled` in :file:`records.config` to one of the following values:" +"logging_enabled` in :file:`records.yaml` to one of the following values:" msgstr "" #: ../../../admin-guide/monitoring/logging/understanding.en.rst:67 diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/performance/index.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/performance/index.en.po index 1a49d1d425f..4958a72355d 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/performance/index.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/performance/index.en.po @@ -217,7 +217,7 @@ msgstr "" msgid "" "|TS| itself, of course, has many options you may want to consider adjusting " "to achieve optimal performance in your environment. Many of these settings " -"are recorded in :file:`records.config` and may be adjusted with the :option:" +"are recorded in :file:`records.yaml` and may be adjusted with the :option:" "`traffic_ctl config set` command line utility while the server is operating." msgstr "" @@ -232,7 +232,7 @@ msgstr "" #: ../../../admin-guide/performance/index.en.rst:185 msgid "" "By default, |TS| creates one thread per CPU core on the host system. This " -"may be adjusted with the following settings in :file:`records.config`:" +"may be adjusted with the following settings in :file:`records.yaml`:" msgstr "" #: ../../../admin-guide/performance/index.en.rst:188 @@ -257,7 +257,7 @@ msgid "" "adjust the thread affinity configuration to take advantage of cache " "pipelines and faster memory access, as well as preventing possibly costly " "thread migrations across sockets. This is adjusted with :ts:cv:`proxy." -"config.exec_thread.affinity` in :file:`records.config`. ::" +"config.exec_thread.affinity` in :file:`records.yaml`. ::" msgstr "" #: ../../../admin-guide/performance/index.en.rst:204 @@ -290,7 +290,7 @@ msgstr "" #: ../../../admin-guide/performance/index.en.rst:226 msgid "" "While all of the timeouts described below may be set globally for your |TS| " -"instance using :file:`records.config`, many of them are also overridable on " +"instance using :file:`records.yaml`, many of them are also overridable on " "a per-transaction basis by plugins (including :ref:`admin-plugins-conf-" "remap`). This allows the possibility for adjusting timeout value for " "individual subsets of your cache." diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/authproxy.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/authproxy.en.po index c9e6dbaf5fb..650701c56d5 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/authproxy.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/authproxy.en.po @@ -39,7 +39,7 @@ msgid "" "if a document is found in the cache. This will have the effect of serving " "the document without consulting the ``AuthProxy`` plugin. you can disable " "this behavior by setting :ts:cv:`proxy.config.http.doc_in_cache_skip_dns` " -"to ``0`` in :file:`records.config`." +"to ``0`` in :file:`records.yaml`." msgstr "" #: ../../admin-guide/plugins/authproxy.en.rst:23 diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/conf_remap.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/conf_remap.en.po index 230f0c56bbc..59e3f54f648 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/conf_remap.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/conf_remap.en.po @@ -46,7 +46,7 @@ msgstr "" #: ../../../admin-guide/plugins/conf_remap.en.rst:31 msgid "" "|TS| provides a plethora of configuration options, but specifying the " -"values of those options in :file:`records.config` is global. All requests, " +"values of those options in :file:`records.yaml` is global. All requests, " "regardless of the cache object or its origin, will be evaluated within the " "same collection of settings. Sometimes you may want |TS| to behave " "differently for portions of your cache." @@ -138,7 +138,7 @@ msgid "" "directives in a separate text file. The location and name is entirely up to " "you, but we'll use `/etc/trafficserver/cdn_conf_remap.config` here. The " "contents of this file should mirror how configuration directives are " -"written in :file:`records.config`::" +"written in :file:`records.yaml`::" msgstr "" #: ../../../admin-guide/plugins/conf_remap.en.rst:98 @@ -209,7 +209,7 @@ msgstr "" #~ "When using a separate configuration file, the standard :file:`records." #~ "config` syntax is used, for example::" #~ msgstr "" -#~ "分割された設定ファイルを使用するときは、:file:`records.config` の標準構文" +#~ "分割された設定ファイルを使用するときは、:file:`records.yaml` の標準構文" #~ "が使用されます。例::" #~ msgid "" diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/header_rewrite.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/header_rewrite.en.po index 4c85629e878..b29cc1ac8ac 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/header_rewrite.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/header_rewrite.en.po @@ -762,7 +762,7 @@ msgid "" "Allows you to override the value of a |TS| configuration variable for the " "current connection. The variables specified by ```` must be " "overridable. For details on available |TS| configuration variables, consult " -"the documentation for :file:`records.config`. You can read more about " +"the documentation for :file:`records.yaml`. You can read more about " "overridable configuration variables in the developer's documentation for :" "ref:`ts-overridable-config`." msgstr "" diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/url_sig.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/url_sig.en.po index b75cda0d9a0..97be0bf4870 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/url_sig.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/plugins/url_sig.en.po @@ -373,7 +373,7 @@ msgstr "" msgid "" "To include debugging output for this plugin in your |TS| logs, adjust the " "values for :ts:cv:`proxy.config.diags.debug.enabled` and :ts:cv:`proxy." -"config.diags.debug.tags` in your :file:`records.config` as so::" +"config.diags.debug.tags` in your :file:`records.yaml` as so::" msgstr "" #: ../../../admin-guide/plugins/url_sig.en.rst:253 diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/security/index.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/security/index.en.po index ad49238bd9e..39dacd5cc78 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/security/index.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/security/index.en.po @@ -159,13 +159,13 @@ msgstr "" #: ../../../admin-guide/security/index.en.rst:106 msgid "" "Set the port number used for SSL communication using :ts:cv:`proxy.config." -"http.server_ports` in :file:`records.config`." +"http.server_ports` in :file:`records.yaml`." msgstr "" #: ../../../admin-guide/security/index.en.rst:109 msgid "" "Set the appropriate base path for your SSL certificates and private keys " -"in :file:`records.config`. ::" +"in :file:`records.yaml`. ::" msgstr "" #: ../../../admin-guide/security/index.en.rst:115 @@ -178,7 +178,7 @@ msgstr "" #: ../../../admin-guide/security/index.en.rst:122 msgid "" "*Optional*: Configure the use of client certificates using the variable :ts:" -"cv:`proxy.config.ssl.client.certification_level` in :file:`records.config`. " +"cv:`proxy.config.ssl.client.certification_level` in :file:`records.yaml`. " "If you configure Traffic Server to require client certificates, then " "Traffic Server verifies the client certificate during the SSL handshake " "that authenticates the client. If you configure Traffic Server to not " @@ -230,7 +230,7 @@ msgid "" "*Optional*: Configure the use of Certification Authorities (CAs). CAs add " "security by verifying the identity of the person requesting a certificate. " "The list of acceptable CA signers is configured with :ts:cv:`proxy.config." -"ssl.CA.cert.path` in :file:`records.config`. ::" +"ssl.CA.cert.path` in :file:`records.yaml`. ::" msgstr "" #: ../../../admin-guide/security/index.en.rst:151 @@ -337,7 +337,7 @@ msgstr "" #: ../../../admin-guide/security/index.en.rst:230 msgid "" "Add the collection of authorized Certificate Authorities to the Traffic " -"Server configuration in :file:`records.config` using the settings :ts:cv:" +"Server configuration in :file:`records.yaml` using the settings :ts:cv:" "`proxy.config.ssl.client.CA.cert.path` and :ts:cv:`proxy.config.ssl.client." "CA.cert.filename`. ::" msgstr "" @@ -421,7 +421,7 @@ msgstr "" #: ../../../admin-guide/security/index.en.rst:301 msgid "" "To configure Traffic Server to use OCSP Stapling, edit the following " -"variables in :file:`records.config` file:" +"variables in :file:`records.yaml` file:" msgstr "" #: ../../../admin-guide/security/index.en.rst:304 @@ -469,7 +469,7 @@ msgstr "" #: ../../../admin-guide/security/index.en.rst:328 msgid "" "Enable the *Split DNS* option by adjusting :ts:cv:`proxy.config.dns." -"splitDNS.enabled` in :file:`records.config`. ::" +"splitDNS.enabled` in :file:`records.yaml`. ::" msgstr "" #~ msgid "" diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/transparent-proxy/bridge.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/transparent-proxy/bridge.en.po index cab77733217..f29b174fc80 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/transparent-proxy/bridge.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/transparent-proxy/bridge.en.po @@ -199,7 +199,7 @@ msgid "" "To configure Traffic Server set the following values in :file:`records." "config`" msgstr "" -"Traffic Server を設定するために次の値を :file:`records.config` に設定してく" +"Traffic Server を設定するために次の値を :file:`records.yaml` に設定してく" "ださい。" #: ../../../admin-guide/transparent-proxy/bridge.en.rst:128 diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/transparent-proxy/router-inline.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/transparent-proxy/router-inline.en.po index 887c4215b53..5f71ec06dea 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/transparent-proxy/router-inline.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/transparent-proxy/router-inline.en.po @@ -129,7 +129,7 @@ msgid "" "To configure Traffic Server set the following values in :file:`records." "config`" msgstr "" -"Traffic Server を設定するために次の値を :file:`records.config` に設定してく" +"Traffic Server を設定するために次の値を :file:`records.yaml` に設定してく" "ださい。" #: ../../admin-guide/transparent-proxy/router-inline.en.rst:81 diff --git a/doc/locale/ja/LC_MESSAGES/admin-guide/transparent-proxy/wccp-configuration.en.po b/doc/locale/ja/LC_MESSAGES/admin-guide/transparent-proxy/wccp-configuration.en.po index d4c7fed49e0..59e9ad6a625 100644 --- a/doc/locale/ja/LC_MESSAGES/admin-guide/transparent-proxy/wccp-configuration.en.po +++ b/doc/locale/ja/LC_MESSAGES/admin-guide/transparent-proxy/wccp-configuration.en.po @@ -58,11 +58,11 @@ msgid "" "Finally Traffic Server itself must be configured for transparency and use " "of WCCP. The former is again very similar to the standard use, while WCCP " "configuration is specific to WCCP and uses a separate configuration file, " -"referred to by the :file:`records.config` file." +"referred to by the :file:`records.yaml` file." msgstr "" "最後に Traffic Server 自体が透過性と WCCP を使用するように設定されなければな" "りません。構成方法もまた標準的な使用とよく似ており、WCCP の設定は WCCP に特" -"化していて分離された設定ファイルを使用しますが、:file:`records.config` ファ" +"化していて分離された設定ファイルを使用しますが、:file:`records.yaml` ファ" "イルにより参照されます。" #: ../../admin-guide/transparent-proxy/wccp-configuration.en.rst:32 diff --git a/doc/locale/ja/LC_MESSAGES/appendices/command-line/traffic_crashlog.en.po b/doc/locale/ja/LC_MESSAGES/appendices/command-line/traffic_crashlog.en.po index 66f8354ff51..19762158ec5 100644 --- a/doc/locale/ja/LC_MESSAGES/appendices/command-line/traffic_crashlog.en.po +++ b/doc/locale/ja/LC_MESSAGES/appendices/command-line/traffic_crashlog.en.po @@ -31,7 +31,7 @@ msgstr "" #: ../../appendices/command-line/traffic_crashlog.en.rst:91 msgid "" -":manpage:`records.config(5)`, :manpage:`traffic_manager(8)`, :manpage:" +":manpage:`records.yaml(5)`, :manpage:`traffic_manager(8)`, :manpage:" "`traffic_server(8)`" msgstr "" diff --git a/doc/locale/ja/LC_MESSAGES/appendices/command-line/traffic_ctl.en.po b/doc/locale/ja/LC_MESSAGES/appendices/command-line/traffic_ctl.en.po index a9618ea7914..acde4258bca 100644 --- a/doc/locale/ja/LC_MESSAGES/appendices/command-line/traffic_ctl.en.po +++ b/doc/locale/ja/LC_MESSAGES/appendices/command-line/traffic_ctl.en.po @@ -164,7 +164,7 @@ msgstr "" #: ../../../appendices/command-line/traffic_ctl.en.rst:133 msgid "" "If this flag is provided, :option:`traffic_ctl config get` will emit " -"results in :file:`records.config` format." +"results in :file:`records.yaml` format." msgstr "" #: ../../../appendices/command-line/traffic_ctl.en.rst:139 @@ -319,5 +319,5 @@ msgid "See also" msgstr "参考" #: ../../../appendices/command-line/traffic_ctl.en.rst:281 -msgid ":manpage:`records.config(5)`, :manpage:`storage.config(5)`" -msgstr ":manpage:`records.config(5)`, :manpage:`storage.config(5)`" +msgid ":manpage:`records.yaml(5)`, :manpage:`storage.config(5)`" +msgstr ":manpage:`records.yaml(5)`, :manpage:`storage.config(5)`" diff --git a/doc/locale/ja/LC_MESSAGES/appendices/faq.en.po b/doc/locale/ja/LC_MESSAGES/appendices/faq.en.po index 4b469ac3f34..a9a2671f492 100644 --- a/doc/locale/ja/LC_MESSAGES/appendices/faq.en.po +++ b/doc/locale/ja/LC_MESSAGES/appendices/faq.en.po @@ -237,10 +237,10 @@ msgid "" "If you want to run in reverse proxy only mode (wherein Traffic Server does " "not serve requests that fail to match a map rule), then you must set the " "configuration variable :ts:cv:`proxy.config.url_remap.remap_required` to " -"``1`` in :file:`records.config`." +"``1`` in :file:`records.yaml`." msgstr "" "リバースプロキシーだけのモード (マップルールにマッチしないリクエストには " -"Traffic Server は応えなくなります) にしたい場合は、 :file:`records.config` " +"Traffic Server は応えなくなります) にしたい場合は、 :file:`records.yaml` " "の設定変数 :ts:cv:`proxy.config.url_remap.remap_required` を ``1`` にしなけ" "ればなりません。" @@ -1132,7 +1132,7 @@ msgstr "" msgid "" "Make sure you're looking in the correct directory. By default, Traffic " "Server creates log files in the ``logs`` directory. This can be modified by " -"changing :ts:cv:`proxy.config.log.logfile_dir` in :file:`records.config`." +"changing :ts:cv:`proxy.config.log.logfile_dir` in :file:`records.yaml`." msgstr "" "正しいディレクトリを見ているかを確認してください。デフォルトでは Traffic " "Server はログファイルを ``logs`` ディレクトリに作成します。これは :file:" @@ -1153,14 +1153,14 @@ msgstr "" #: ../../../appendices/faq.en.rst:530 msgid "" "Check that logging is enabled by checking the value of the :ts:cv:`proxy." -"config.log.logging_enabled` variable in :file:`records.config`." +"config.log.logging_enabled` variable in :file:`records.yaml`." msgstr "" -"ログ出力が有効になっているかどうかを :file:`records.config` の :ts:cv:" +"ログ出力が有効になっているかどうかを :file:`records.yaml` の :ts:cv:" "`proxy.config.log.logging_enabled` 変数の値を見て確認してください。" #: ../../../appendices/faq.en.rst:533 msgid "" -"Check that a log format is enabled. In :file:`records.config`, select the " +"Check that a log format is enabled. In :file:`records.yaml`, select the " "standard or custom format by editing variables in the Logging Config " "section." msgstr "" @@ -1234,9 +1234,9 @@ msgstr "" msgid "" "If necessary, you can adjust the maximum number of connections supported by " "Traffic Server by editing :ts:cv:`proxy.config.net.connections_throttle` " -"in :file:`records.config`." +"in :file:`records.yaml`." msgstr "" -"必要ならば :file:`records.config` の :ts:cv:`proxy.config.net." +"必要ならば :file:`records.yaml` の :ts:cv:`proxy.config.net." "connections_throttle` を編集することで Traffic Server がサポートする接続の最" "大数を調整することが出来ます。" @@ -1312,10 +1312,10 @@ msgid "" "origin servers. If you cannot avoid such timeouts by otherwise addressing " "the performance on your origin servers, you may adjust the origin " "connection timeout in Traffic Server by changing :ts:cv:`proxy.config.http." -"connect_attempts_timeout` in :file:`records.config` to a larger value." +"connect_attempts_timeout` in :file:`records.yaml` to a larger value." msgstr "" "デフォルトでは Traffic Server はオリジンサーバーに接続する際に 30 秒でタイム" "アウトします。オリジンサーバーのパフォーマンスを改善してこのタイムアウトを回" -"避することが出来ない場合は、 :file:`records.config` の :ts:cv:`proxy.config." +"避することが出来ない場合は、 :file:`records.yaml` の :ts:cv:`proxy.config." "http.connect_attempts_timeout` をより大きな値に変更することで Traffic " "Server のオリジンサーバーへの接続のタイムアウトを調整することが出来ます。" diff --git a/doc/locale/ja/LC_MESSAGES/developer-guide/api/functions/TSAPI.en.po b/doc/locale/ja/LC_MESSAGES/developer-guide/api/functions/TSAPI.en.po index d74a3862f4d..92124b48ab5 100644 --- a/doc/locale/ja/LC_MESSAGES/developer-guide/api/functions/TSAPI.en.po +++ b/doc/locale/ja/LC_MESSAGES/developer-guide/api/functions/TSAPI.en.po @@ -30,7 +30,7 @@ msgstr "" "Generated-By: Babel 2.1.1\n" #: ../../developer-guide/api/functions/TSAPI.en.rst:167 -msgid ":file:`plugin.config`, :file:`records.config`" +msgid ":file:`plugin.config`, :file:`records.yaml`" msgstr "" #: ../../developer-guide/api/functions/TSAPI.en.rst:173 @@ -313,7 +313,7 @@ msgstr "" "Traffic Server が最初にスタートするとき、読み込まれる必要のあるすべての共有" "ライブラリの名前を決定するために plugin.config ファイルを参照します。 " "plugin.config ファイルは個々のプラグインの初期化関数 :func:`TSPluginInit` に" -"渡される引数も定義します。:file:`records.config` ファイルは個々のプラグイン" +"渡される引数も定義します。:file:`records.yaml` ファイルは個々のプラグイン" "共有ライブラリのパスを定義します。" #: ../../developer-guide/api/functions/TSAPI.en.rst:31 diff --git a/doc/locale/ja/LC_MESSAGES/developer-guide/api/functions/TSHttpOverridableConfig.en.po b/doc/locale/ja/LC_MESSAGES/developer-guide/api/functions/TSHttpOverridableConfig.en.po index c6a61874b1a..7cf834ff19c 100644 --- a/doc/locale/ja/LC_MESSAGES/developer-guide/api/functions/TSHttpOverridableConfig.en.po +++ b/doc/locale/ja/LC_MESSAGES/developer-guide/api/functions/TSHttpOverridableConfig.en.po @@ -45,14 +45,14 @@ msgstr "解説" #: ../../../developer-guide/api/functions/TSHttpOverridableConfig.en.rst:45 msgid "" -"Some of the values that are set in :file:`records.config` can be changed " +"Some of the values that are set in :file:`records.yaml` can be changed " "for a specific transaction. It is important to note that these functions " "change the configuration values stored for the transaction, which is not " "quite the same as changing the actual operating values of the transaction. " "The critical effect is the value must be changed before it is used by the " "transaction - after that, changes will not have any effect." msgstr "" -":file:`records.config` に設定されるいくつかの値は特定のトランザクションにお" +":file:`records.yaml` に設定されるいくつかの値は特定のトランザクションにお" "いて変更することが可能です。これらの関数はトランザクション用に格納された設定" "値を変更すること、つまりトランザクションが実際に処理する際の値を変更するのと" "まったく同じではないことに注意することが大切です。その重要な影響は値がトラン" diff --git a/doc/locale/ja/LC_MESSAGES/developer-guide/architecture/architecture.en.po b/doc/locale/ja/LC_MESSAGES/developer-guide/architecture/architecture.en.po index 009c9049178..bfa0854ca27 100644 --- a/doc/locale/ja/LC_MESSAGES/developer-guide/architecture/architecture.en.po +++ b/doc/locale/ja/LC_MESSAGES/developer-guide/architecture/architecture.en.po @@ -1203,10 +1203,10 @@ msgstr "" #: ../../../developer-guide/architecture/architecture.en.rst:566 msgid "" -"The target fragment size can set with the :file:`records.config` value :ts:" +"The target fragment size can set with the :file:`records.yaml` value :ts:" "cv:`proxy.config.cache.target_fragment_size`." msgstr "" -"ターゲットフラグメントサイズは :file:`records.config` の値 :ts:cv:`proxy." +"ターゲットフラグメントサイズは :file:`records.yaml` の値 :ts:cv:`proxy." "config.cache.target_fragment_size` で設定できます。" #: ../../../developer-guide/architecture/architecture.en.rst:569 @@ -1276,11 +1276,11 @@ msgstr "" #: ../../../developer-guide/architecture/architecture.en.rst:600 msgid "" -"The comment in earlier versions of the :file:`records.config` documentation " +"The comment in earlier versions of the :file:`records.yaml` documentation " "which indicated that this value must be a power of two were, unfortunately, " "mistaken and have been corrected." msgstr "" -":file:`records.config` のドキュメントの以前の版のコメントでこの値が 2 の冪乗" +":file:`records.yaml` のドキュメントの以前の版のコメントでこの値が 2 の冪乗" "でなければならないと述べていましたが、それは間違いだったため修正されました。" #: ../../../developer-guide/architecture/architecture.en.rst:607 @@ -1470,8 +1470,8 @@ msgid "Built in constraints." msgstr "組込みの制約。" #: ../../../developer-guide/architecture/architecture.en.rst:689 -msgid "Settings in :file:`records.config`." -msgstr ":file:`records.config` の設定。" +msgid "Settings in :file:`records.yaml`." +msgstr ":file:`records.yaml` の設定。" #: ../../../developer-guide/architecture/architecture.en.rst:690 msgid "Settings in :file:`cache.config`." @@ -1483,11 +1483,11 @@ msgstr "プラグインの操作。" #: ../../../developer-guide/architecture/architecture.en.rst:693 msgid "" -"The initial internal checks, along with their :file:`records.config` " +"The initial internal checks, along with their :file:`records.yaml` " "overrides[#cacheability-overrides]_, are done in ``HttpTransact::" "is_request_cache_lookupable``." msgstr "" -"初期の内部チェック、それらの :file:`records.config` を伴った オーバーライド" +"初期の内部チェック、それらの :file:`records.yaml` を伴った オーバーライド" "[#cacheability-overrides]_ は ``HttpTransact::is_request_cache_lookupable`` " "内で処理されます。" @@ -1569,7 +1569,7 @@ msgid "" "can allow for the response to be cached. It is disabled by default, for " "best performance." msgstr "" -":file:`records.config` の :ts:cv:`proxy.config.http.cache.range.lookup` がゼ" +":file:`records.yaml` の :ts:cv:`proxy.config.http.cache.range.lookup` がゼ" "ロでない値である場合に限りキャッシュバリッドです。これはレンジリクエストが" "キャッシュ可能であることを意味しません。キャッシュから満たされるかもしれない" "というだけです。加えて、 :ts:cv:`proxy.config.http.cache.range.write` をレン" @@ -1730,7 +1730,7 @@ msgstr "" "込みながら読込み* とはあるトランザクションでオブジェクトをキャッシュに書き込" "みながら別のトランザクションでキャッシュからオブジェクトを配信することです。" "使用するためにはいくつかの設定が必要になります。 :ref:`admin-configuration-" -"reducing-origin-requests` を参照してください。 :file:`records.config` で明示" +"reducing-origin-requests` を参照してください。 :file:`records.yaml` で明示" "的に有効にする必要があります。そうしなければ、オブジェクトが現在書込まれてい" "るか更新されている場合はキャッシュ読込みは失敗するでしょう。" @@ -1800,14 +1800,14 @@ msgstr "" #: ../../../developer-guide/architecture/architecture.en.rst:822 msgid "" -"How this age is used is determined by the :file:`records.config` setting " +"How this age is used is determined by the :file:`records.yaml` setting " "for :ts:cv:`proxy.config.http.cache.when_to_revalidate`. If this is ``0`` " "then the built calculations are used which compare the freshness limits " "with document age, modified by any of the client supplied cache control " "values (``max-age``, ``min-fresh``, ``max-stale``) unless explicitly " "overridden in :file:`cache.config`." msgstr "" -"この経過時間がどのように利用されるかは :file:`records.config` の :ts:cv:" +"この経過時間がどのように利用されるかは :file:`records.yaml` の :ts:cv:" "`proxy.config.http.cache.when_to_revalidate` によって決定されます。これが " "``0`` なら組み立てられた計算を使って新鮮さの限界とドキュメントの経過時間を比" "較します。ドキュメントの経過時間は :file:`cache.config` で明示的に上書きされ" diff --git a/doc/locale/ja/LC_MESSAGES/developer-guide/config-vars.en.po b/doc/locale/ja/LC_MESSAGES/developer-guide/config-vars.en.po index 96038c9a44c..2a91ff6b684 100644 --- a/doc/locale/ja/LC_MESSAGES/developer-guide/config-vars.en.po +++ b/doc/locale/ja/LC_MESSAGES/developer-guide/config-vars.en.po @@ -34,7 +34,7 @@ msgstr "" #: ../../../developer-guide/config-vars.en.rst:60 msgid "" -"Adding a new configuration variable in :file:`records.config` requires a " +"Adding a new configuration variable in :file:`records.yaml` requires a " "number of steps which are mostly documented here." msgstr "" @@ -316,7 +316,7 @@ msgstr "" #: ../../../developer-guide/config-vars.en.rst:194 msgid "" -"A configuration variable should be documented in :file:`records.config`. " +"A configuration variable should be documented in :file:`records.yaml`. " "There are many examples in the file already that can be used for guidance. " "The general format is to use the tag ::" msgstr "" @@ -383,9 +383,9 @@ msgstr "" #: ../../../developer-guide/config-vars.en.rst:229 msgid "" "In general, a new configuration variable should not be present in the " -"default :file:`records.config`. If it is added, such defaults should be " +"default :file:`records.yaml`. If it is added, such defaults should be " "added to the file ``proxy/config/records.config.default.in``. This is used " -"to generate the default :file:`records.config`. Just add the variable to " +"to generate the default :file:`records.yaml`. Just add the variable to " "the file in an appropriate place with a proper default as this will now " "override whatever default you put in the code for new installs." msgstr "" @@ -399,7 +399,7 @@ msgid "" "The simplest mechanism for handling updates is the " "``REC_EstablishStaticConfigXXX`` family of functions. This mechanism will " "cause the value in the indicated instance to be updated in place when an " -"update to :file:`records.config` occurs. This is done asynchronously using " +"update to :file:`records.yaml` occurs. This is done asynchronously using " "atomic operations. Use of these variables must keep that in mind." msgstr "" diff --git a/doc/locale/ja/LC_MESSAGES/developer-guide/debugging/debug-builds.en.po b/doc/locale/ja/LC_MESSAGES/developer-guide/debugging/debug-builds.en.po index b5958100c21..1df449f3225 100644 --- a/doc/locale/ja/LC_MESSAGES/developer-guide/debugging/debug-builds.en.po +++ b/doc/locale/ja/LC_MESSAGES/developer-guide/debugging/debug-builds.en.po @@ -37,7 +37,7 @@ msgid "" "A debugger can set breakpoints in a plugin. Use a Traffic Server debug " "build and compile the plugin with the ``-g`` option. A debugger can also be " "used to analyze a core dump. To generate core, set the size limit of the " -"core files in the :file:`records.config` file to -1 as follows:" +"core files in the :file:`records.yaml` file to -1 as follows:" msgstr "" #: ../../developer-guide/debugging/debug-builds.en.rst:34 diff --git a/doc/locale/ja/LC_MESSAGES/developer-guide/debugging/debug-tags.en.po b/doc/locale/ja/LC_MESSAGES/developer-guide/debugging/debug-tags.en.po index eb3a6f17de2..797cf3eacb6 100644 --- a/doc/locale/ja/LC_MESSAGES/developer-guide/debugging/debug-tags.en.po +++ b/doc/locale/ja/LC_MESSAGES/developer-guide/debugging/debug-tags.en.po @@ -57,7 +57,7 @@ msgstr "" #: ../../../developer-guide/debugging/debug-tags.en.rst:43 msgid "" -"Set the following variables in :file:`records.config` (in the Traffic " +"Set the following variables in :file:`records.yaml` (in the Traffic " "Server ``config`` directory):" msgstr "" diff --git a/doc/locale/ja/LC_MESSAGES/developer-guide/plugins/getting-started/a-simple-plugin.en.po b/doc/locale/ja/LC_MESSAGES/developer-guide/plugins/getting-started/a-simple-plugin.en.po index 12156f19633..b9981660597 100644 --- a/doc/locale/ja/LC_MESSAGES/developer-guide/plugins/getting-started/a-simple-plugin.en.po +++ b/doc/locale/ja/LC_MESSAGES/developer-guide/plugins/getting-started/a-simple-plugin.en.po @@ -39,7 +39,7 @@ msgstr "" #: ../../developer-guide/plugins/getting-started/a-simple-plugin.en.rst:35 msgid "" -"Add the path to your plugin shared library into the :file:`records.config` " +"Add the path to your plugin shared library into the :file:`records.yaml` " "file." msgstr "" diff --git a/doc/locale/ja/LC_MESSAGES/developer-guide/plugins/plugin-management/settings-and-statistics.en.po b/doc/locale/ja/LC_MESSAGES/developer-guide/plugins/plugin-management/settings-and-statistics.en.po index 61427a18b21..752ddcc7315 100644 --- a/doc/locale/ja/LC_MESSAGES/developer-guide/plugins/plugin-management/settings-and-statistics.en.po +++ b/doc/locale/ja/LC_MESSAGES/developer-guide/plugins/plugin-management/settings-and-statistics.en.po @@ -36,25 +36,25 @@ msgstr "" msgid "" "Your plugin might need to know information about Traffic Server's current " "configuration and performance. The functions described in this section read " -"this information from the Traffic Server :file:`records.config` file. " +"this information from the Traffic Server :file:`records.yaml` file. " "Configuration settings are stored in ``CONFIG`` variables and statistics " "are stored in ``PROCESS`` variables." msgstr "" #: ../../developer-guide/plugins/plugin-management/settings-and-statistics.en.rst:33 msgid "" -"Not all ``CONFIG`` and ``PROCESS`` variables in :file:`records.config` are " +"Not all ``CONFIG`` and ``PROCESS`` variables in :file:`records.yaml` are " "relevant to Traffic Server's configuration and statistics. Therefore, " -"retrieve only the :file:`records.config` variables that are documented in " +"retrieve only the :file:`records.yaml` variables that are documented in " "the :ref:`admin-guide`." msgstr "" #: ../../developer-guide/plugins/plugin-management/settings-and-statistics.en.rst:38 msgid "" "To retrieve a variable, you need to know its type (``int``, ``counter``, " -"``float``, or ``string``). Plugins store the :file:`records.config` values " +"``float``, or ``string``). Plugins store the :file:`records.yaml` values " "as an ``TSMgmtInt``, ``TSMgmtCounter``, ``TSMgmtFloat``, or " -"``TSMgmtString``. You can look up :file:`records.config` variable types in " +"``TSMgmtString``. You can look up :file:`records.yaml` variable types in " "the :ref:`admin-guide`." msgstr "" diff --git a/doc/locale/ja/LC_MESSAGES/developer-guide/troubleshooting-tips/unable-to-load-plugins.en.po b/doc/locale/ja/LC_MESSAGES/developer-guide/troubleshooting-tips/unable-to-load-plugins.en.po index 0d8b906e4ad..829b604d19f 100644 --- a/doc/locale/ja/LC_MESSAGES/developer-guide/troubleshooting-tips/unable-to-load-plugins.en.po +++ b/doc/locale/ja/LC_MESSAGES/developer-guide/troubleshooting-tips/unable-to-load-plugins.en.po @@ -53,7 +53,7 @@ msgstr "" #: ../../developer-guide/troubleshooting-tips/unable-to-load-plugins.en.rst:34 msgid "" -"Add the path to your plugin shared library to the :file:`records.config` " +"Add the path to your plugin shared library to the :file:`records.yaml` " "file." msgstr "" diff --git a/doc/locale/ja/LC_MESSAGES/getting-started.en.po b/doc/locale/ja/LC_MESSAGES/getting-started.en.po index 8afd0f607a7..670af5d570c 100644 --- a/doc/locale/ja/LC_MESSAGES/getting-started.en.po +++ b/doc/locale/ja/LC_MESSAGES/getting-started.en.po @@ -380,7 +380,7 @@ msgstr "" #: ../../getting-started.en.rst:246 msgid "" -"Within the :file:`records.config` configuration file, ensure that the " +"Within the :file:`records.yaml` configuration file, ensure that the " "following settings have been configured as shown below::" msgstr "" @@ -518,7 +518,7 @@ msgid "" msgstr "" #: ../../getting-started.en.rst:339 -msgid ":file:`records.config`::" +msgid ":file:`records.yaml`::" msgstr "" #: ../../getting-started.en.rst:347 @@ -556,7 +556,7 @@ msgid "" "Contrary to a reverse proxy, where you have a defined list of origin " "servers for which you wish to proxy (and optionally cache), a forward proxy " "is used to proxy (and optionally cache) for arbitrary remote hosts. As " -"such, the following settings in :file:`records.config` are the base " +"such, the following settings in :file:`records.yaml` are the base " "configuration for a minimal forward proxy::" msgstr "" diff --git a/doc/locale/ja/LC_MESSAGES/getting-started/index.en.po b/doc/locale/ja/LC_MESSAGES/getting-started/index.en.po index 329cce2e91e..0fe6a868014 100644 --- a/doc/locale/ja/LC_MESSAGES/getting-started/index.en.po +++ b/doc/locale/ja/LC_MESSAGES/getting-started/index.en.po @@ -382,7 +382,7 @@ msgstr "" #: ../../../getting-started/index.en.rst:246 msgid "" -"Within the :file:`records.config` configuration file, ensure that the " +"Within the :file:`records.yaml` configuration file, ensure that the " "following settings have been configured as shown below::" msgstr "" @@ -523,7 +523,7 @@ msgid "" msgstr "" #: ../../../getting-started/index.en.rst:339 -msgid ":file:`records.config`::" +msgid ":file:`records.yaml`::" msgstr "" #: ../../../getting-started/index.en.rst:347 @@ -561,7 +561,7 @@ msgid "" "Contrary to a reverse proxy, where you have a defined list of origin " "servers for which you wish to proxy (and optionally cache), a forward proxy " "is used to proxy (and optionally cache) for arbitrary remote hosts. As " -"such, the following settings in :file:`records.config` are the base " +"such, the following settings in :file:`records.yaml` are the base " "configuration for a minimal forward proxy::" msgstr "" diff --git a/doc/manpages.py b/doc/manpages.py index 6ef5e096279..eec6f891731 100644 --- a/doc/manpages.py +++ b/doc/manpages.py @@ -62,7 +62,7 @@ u'Traffic Server parent cache configuration file', None, '5'), ('admin-guide/files/plugin.config.en', 'plugin.config', u'Traffic Server global plugin configuration file', None, '5'), - ('admin-guide/files/records.config.en', 'records.config', + ('admin-guide/files/records.yaml.en', 'records.yaml', u'Traffic Server configuration file', None, '5'), ('admin-guide/files/remap.config.en', 'remap.config', u'Traffic Server remap rules configuration file', None, '5'), diff --git a/include/records/P_RecCore.h b/include/records/P_RecCore.h index 9613222d82b..42f2e5a02bf 100644 --- a/include/records/P_RecCore.h +++ b/include/records/P_RecCore.h @@ -34,6 +34,8 @@ #include #include +#include + // records, record hash-table, and hash-table rwlock extern RecRecord *g_records; extern std::unordered_map g_records_ht; @@ -41,7 +43,7 @@ extern ink_rwlock g_records_rwlock; extern int g_num_records; extern RecModeT g_mode_type; -// records.config items +// records.yaml items extern const char *g_rec_config_fpath; extern std::unordered_set g_rec_config_contents_ht; extern ink_mutex g_rec_config_lock; @@ -78,6 +80,7 @@ RecErrT RecGetRecord_Xmalloc(const char *name, RecDataT data_type, RecData *data RecErrT RecReadStatsFile(); RecErrT RecSyncStatsFile(); RecErrT RecReadConfigFile(); +swoc::Errata RecReadYamlConfigFile(); //------------------------------------------------------------------------- // Misc diff --git a/include/records/RecYAMLDecoder.h b/include/records/RecYAMLDecoder.h new file mode 100644 index 00000000000..b5f2f8822dd --- /dev/null +++ b/include/records/RecYAMLDecoder.h @@ -0,0 +1,85 @@ +/** @file + + Public RecYamlDecoder declarations + + @section license License + + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you 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. + */ + +#pragma once + +#include "records/RecYAMLDefs.h" + +/// @brief Create a configuration record based on the passed @c YAML node +/// +/// This function will try to get the records details from the RecordElement +/// defined in the RecordsConfig.cc, if the records is defined then all the details +/// like record type and value will be used. If the records is not defined then this +/// function will try to deduce this values from the @c YAML node instead, for that +/// it's necessary for the node to have a type associated, this is done by using a +/// @c YAML tag for the type. (!!float, !!int, etc). +/// +/// @note Nodes that aren't defined in ATS, like nodes that are registered by plugins +/// should specify the type in the yaml configuration, otherwise will be ignored as +/// we cannot assume any type. +/// +/// @param node Parsed configuration node. +/// @param value Parsed Value node. +/// @param errata Output variable, errors will be added in the passed Errata. +void SetRecordFromYAMLNode(const CfgNode &field, swoc::Errata &errata); + +/// @brief Open and parse a records.yaml config file. +/// +/// This function parses the yaml file, then it calls @c ParseRecordsFromYAML to handle the file content. +/// This function does not lock, make sure you work around the @c g_records_rwlock +/// @param path Path to the configuration file +/// @param handler Function callback to handle each parsed node and value. +/// @return This function will collect details about the parsing. +swoc::Errata RecYAMLConfigFileParse(const char *path, RecYAMLNodeHandler handler); + +/// +/// @brief This function parses the YAML root node ("ts") and convert each field +/// into a record style object. +/// +/// As we keep the internal records without a change we should rebuild each records name +/// from a YAML structure, this function parses the yaml and while walking down to the scalar +/// node it builds the record name, this where the handler gets called. +/// +/// Example: +/// +/// ts: +/// exec_thread: +/// autoconfig: +/// scale: 1.0 +/// +/// -> Will be flatten to "proxy.config.exec_thread.autoconfig.scale". Note that this function +/// prefix with "proxy.config" to the generated record name. +/// +/// @note @c handler will be called every time the parser found a scalar node, so the caller of this +/// function should handle the parsed node. This function will not modify any internal records data, this +/// is up to the handler to do it. +/// +/// @note This function is separated from RecYAMLConfigFileParse as this can also be called +/// independently, i.e.: From a RPC handler. +/// +/// @param root Top YAML node, it should contain the "ts" element. +/// @param handle Callback that will process each parsed node. +/// @param lock true if we want this function to lock g_records_rwlock. If you are locking already, +/// then leave it as false. +/// @return swoc::Errata Collected notes from the YAML parsing +swoc::Errata ParseRecordsFromYAML(YAML::Node root, RecYAMLNodeHandler handler, bool lock = false); diff --git a/include/records/RecYAMLDefs.h b/include/records/RecYAMLDefs.h new file mode 100644 index 00000000000..b9465e93472 --- /dev/null +++ b/include/records/RecYAMLDefs.h @@ -0,0 +1,96 @@ +/** @file + + Public RecCore declarations + + @section license License + + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you 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. + */ + +#pragma once + +#include +#include + +#include +#include "tscpp/util/ts_errata.h" + +struct CfgNode; + +/// +/// @brief Handler callback signature to deal with the found record. +/// +/// +using RecYAMLNodeHandler = std::function; +//------------------------------------------------------------------------------ +/// +/// @brief A wrapper class around a @c YAML::Node which also holds the record name. +/// The record name is constructed base on every field name, so every child field will be appended to the +/// parent name using a dot as separator. +/// +/// +struct CfgNode { + // /// @brief Construct a configuration node using just the @c YAML::Node + // /// @param n The parsed @c YAML::node. + // CfgNode(YAML::Node const &n, YAML::Node const &v) : node{n}, value_node{v} {} + + /// @brief Construct a configuration node using just the @c YAML::Node and the @c record_name + /// @param n The parsed @c YAML::node. + /// @param base_record_name The base record name from where the record name should be built up. + CfgNode(YAML::Node const &n, YAML::Node const &v, std::string_view base_record_name) : node{n}, value_node{v} + { + _legacy.record_name = base_record_name; + } + + /// @brief Returns the built record name. + /// + /// The record name was build up base on the yaml structure: i.e.: + /// + /// diags: + /// debug: + /// tag: rpc + /// + /// this function will return diags.debug.tag + std::string_view + get_record_name() const + { + return _legacy.record_name; + } + + /// @brief Append field name in order to build up the record name. + void + append_field_name() const + { + if (!_legacy.record_name.empty()) { + _legacy.record_name.append("."); + _legacy.record_name.append(node.as()); + } else { + _legacy.record_name.append(node.as()); + } + } + + // public + YAML::Node node; + YAML::Node value_node; + +private: + /// @brief Keep track of legacy stuff like the name. + struct Legacy { + std::string record_name; + }; + mutable Legacy _legacy; +}; diff --git a/include/tscore/Filenames.h b/include/tscore/Filenames.h index 24c3edf87e0..c828acca2ad 100644 --- a/include/tscore/Filenames.h +++ b/include/tscore/Filenames.h @@ -26,7 +26,7 @@ namespace ts namespace filename { constexpr const char *STORAGE = "storage.config"; - constexpr const char *RECORDS = "records.config"; + constexpr const char *RECORDS = "records.yaml"; constexpr const char *VOLUME = "volume.config"; constexpr const char *PLUGIN = "plugin.config"; diff --git a/iocore/aio/Makefile.am b/iocore/aio/Makefile.am index 41fc5ade45d..da0509a3bea 100644 --- a/iocore/aio/Makefile.am +++ b/iocore/aio/Makefile.am @@ -56,11 +56,12 @@ test_AIO_LDADD = \ libinkaio.a \ $(top_builddir)/src/records/librecords_p.a \ $(top_builddir)/mgmt/libmgmt_p.la \ + $(top_builddir)/mgmt/libmgmt_c.la \ $(top_builddir)/iocore/eventsystem/libinkevent.a \ $(top_builddir)/src/tscore/libtscore.la \ $(top_builddir)/src/tscpp/util/libtscpputil.la \ $(top_builddir)/proxy/shared/libUglyLogStubs.a \ - @SWOC_LIBS@ @HWLOC_LIBS@ + @SWOC_LIBS@ @HWLOC_LIBS@ @YAMLCPP_LIBS@ include $(top_srcdir)/build/tidy.mk diff --git a/iocore/eventsystem/Makefile.am b/iocore/eventsystem/Makefile.am index 15265d5a60f..10c3e548758 100644 --- a/iocore/eventsystem/Makefile.am +++ b/iocore/eventsystem/Makefile.am @@ -77,7 +77,7 @@ check_PROGRAMS = test_IOBuffer \ test_LD_FLAGS = \ @AM_LDFLAGS@ \ - @OPENSSL_LDFLAGS@ @SWOC_LDFLAGS@ + @OPENSSL_LDFLAGS@ @SWOC_LDFLAGS@ @YAMLCPP_LDFLAGS@ test_CPP_FLAGS = \ $(AM_CPPFLAGS) \ @@ -99,7 +99,7 @@ test_LD_ADD = \ $(top_builddir)/src/tscore/libtscore.la \ $(top_builddir)/src/tscpp/util/libtscpputil.la \ $(top_builddir)/proxy/shared/libUglyLogStubs.a \ - @HWLOC_LIBS@ @SWOC_LIBS@ + @HWLOC_LIBS@ @SWOC_LIBS@ @YAMLCPP_LIBS@ test_EventSystem_SOURCES = unit_tests/test_EventSystem.cc test_EventSystem_CPPFLAGS = $(test_CPP_FLAGS) diff --git a/iocore/hostdb/HostDB.cc b/iocore/hostdb/HostDB.cc index ee8511d27b3..1cf63076610 100644 --- a/iocore/hostdb/HostDB.cc +++ b/iocore/hostdb/HostDB.cc @@ -407,7 +407,7 @@ HostDBCache::start(int flags) // Read configuration // Command line overrides manager configuration. // - REC_ReadConfigInt32(hostdb_enable, "proxy.config.hostdb"); + REC_ReadConfigInt32(hostdb_enable, "proxy.config.hostdb.enabled"); REC_ReadConfigString(storage_path, "proxy.config.hostdb.storage_path", sizeof(storage_path)); REC_ReadConfigString(hostdb_filename, "proxy.config.hostdb.filename", sizeof(hostdb_filename)); diff --git a/iocore/hostdb/Makefile.am b/iocore/hostdb/Makefile.am index 1dd35ca40ee..1855570ef90 100644 --- a/iocore/hostdb/Makefile.am +++ b/iocore/hostdb/Makefile.am @@ -58,7 +58,7 @@ test_RefCountCache_SOURCES = \ test_LD_FLAGS = \ @AM_LDFLAGS@ \ - @SWOC_LDFLAGS@ @OPENSSL_LDFLAGS@ + @SWOC_LDFLAGS@ @OPENSSL_LDFLAGS@ @YAMLCPP_LDFLAGS@ test_CPP_FLAGS = \ $(AM_CPPFLAGS) \ @@ -74,11 +74,12 @@ test_CPP_FLAGS = \ test_LD_ADD = \ $(top_builddir)/src/records/librecords_p.a \ $(top_builddir)/mgmt/libmgmt_p.la \ + $(top_builddir)/mgmt/libmgmt_c.la \ $(top_builddir)/iocore/eventsystem/libinkevent.a \ $(top_builddir)/src/tscore/libtscore.la \ $(top_builddir)/src/tscpp/util/libtscpputil.la \ $(top_builddir)/proxy/shared/libUglyLogStubs.a \ - @SWOC_LIBS@ @HWLOC_LIBS@ + @SWOC_LIBS@ @HWLOC_LIBS@ @YAMLCPP_LIBS@ test_RefCountCache_CPPFLAGS = $(test_CPP_FLAGS) diff --git a/iocore/net/Makefile.am b/iocore/net/Makefile.am index dfe19ffccb2..4278a1898d9 100644 --- a/iocore/net/Makefile.am +++ b/iocore/net/Makefile.am @@ -79,8 +79,9 @@ test_UDPNet_LDFLAGS = \ test_UDPNet_LDADD = \ libinknet.a \ $(top_builddir)/iocore/eventsystem/libinkevent.a \ - $(top_builddir)/mgmt/libmgmt_p.la \ $(top_builddir)/src/records/librecords_p.a \ + $(top_builddir)/mgmt/libmgmt_p.la \ + $(top_builddir)/mgmt/libmgmt_c.la \ $(top_builddir)/src/tscore/libtscore.la $(top_builddir)/src/tscpp/util/libtscpputil.la \ $(top_builddir)/proxy/hdrs/libhdrs.a \ $(top_builddir)/proxy/ParentSelectionStrategy.o \ @@ -114,8 +115,9 @@ test_libinknet_LDFLAGS = \ test_libinknet_LDADD = \ libinknet.a \ $(top_builddir)/iocore/eventsystem/libinkevent.a \ - $(top_builddir)/mgmt/libmgmt_p.la \ $(top_builddir)/src/records/librecords_p.a \ + $(top_builddir)/mgmt/libmgmt_p.la \ + $(top_builddir)/mgmt/libmgmt_c.la \ $(top_builddir)/proxy/hdrs/libhdrs.a \ $(top_builddir)/src/tscore/libtscore.la \ $(top_builddir)/src/tscpp/util/libtscpputil.la \ diff --git a/iocore/net/SSLConfig.cc b/iocore/net/SSLConfig.cc index 95d2b6aedf1..efb9c58dd1d 100644 --- a/iocore/net/SSLConfig.cc +++ b/iocore/net/SSLConfig.cc @@ -250,12 +250,12 @@ SSLConfigParams::initialize() } #ifdef SSL_OP_NO_TLSv1_3 - REC_ReadConfigInteger(option, "proxy.config.ssl.TLSv1_3"); + REC_ReadConfigInteger(option, "proxy.config.ssl.TLSv1_3.enabled"); if (!option) { ssl_ctx_options |= SSL_OP_NO_TLSv1_3; } - REC_ReadConfigInteger(option, "proxy.config.ssl.client.TLSv1_3"); + REC_ReadConfigInteger(option, "proxy.config.ssl.client.TLSv1_3.enabled"); if (!option) { ssl_client_ctx_options |= SSL_OP_NO_TLSv1_3; } @@ -334,14 +334,15 @@ SSLConfigParams::initialize() REC_ReadConfigStringAlloc(ssl_server_ca_cert_filename, "proxy.config.ssl.CA.cert.filename"); REC_ReadConfigStringAlloc(CACertRelativePath, "proxy.config.ssl.CA.cert.path"); + set_paths_helper(CACertRelativePath, ssl_server_ca_cert_filename, &serverCACertPath, &serverCACertFilename); ats_free(ssl_server_ca_cert_filename); ats_free(CACertRelativePath); // SSL session cache configurations - REC_ReadConfigInteger(ssl_origin_session_cache, "proxy.config.ssl.origin_session_cache"); + REC_ReadConfigInteger(ssl_origin_session_cache, "proxy.config.ssl.origin_session_cache.enabled"); REC_ReadConfigInteger(ssl_origin_session_cache_size, "proxy.config.ssl.origin_session_cache.size"); - REC_ReadConfigInteger(ssl_session_cache, "proxy.config.ssl.session_cache"); + REC_ReadConfigInteger(ssl_session_cache, "proxy.config.ssl.session_cache.value"); REC_ReadConfigInteger(ssl_session_cache_size, "proxy.config.ssl.session_cache.size"); REC_ReadConfigInteger(ssl_session_cache_num_buckets, "proxy.config.ssl.session_cache.num_buckets"); REC_ReadConfigInteger(ssl_session_cache_skip_on_contention, "proxy.config.ssl.session_cache.skip_cache_on_bucket_contention"); diff --git a/lib/perl/lib/Apache/TS.pm.in b/lib/perl/lib/Apache/TS.pm.in index e6ca7bbd743..a6bd1903d44 100644 --- a/lib/perl/lib/Apache/TS.pm.in +++ b/lib/perl/lib/Apache/TS.pm.in @@ -54,7 +54,7 @@ Apache::TS - a collection of Perl interfaces to manage Apache Traffic Server ins my $recedit = new Apache::TS::Config::Records(file => "etc/trafficserver/records.config.default"); # Threads - $recedit->set(conf => "proxy.config.exec_thread.autoconfig", val => "0"); + $recedit->set(conf => "proxy.config.exec_thread.autoconfig.enabled", val => "0"); # ... # Write it all out $recedit->write(file => "etc/trafficserver/records.config"); diff --git a/lib/perl/lib/Apache/TS/Config/Records.pm b/lib/perl/lib/Apache/TS/Config/Records.pm index 168f658943f..d19ee8beaa3 100644 --- a/lib/perl/lib/Apache/TS/Config/Records.pm +++ b/lib/perl/lib/Apache/TS/Config/Records.pm @@ -259,7 +259,7 @@ You probably shouldn't modify this array. Modify one configuration value, with the provided value. Both the conf name and the value are required. Example: - $r->set(conf => "proxy.config.exec_thread.autoconfig", + $r->set(conf => "proxy.config.exec_thread.autoconfig.enabled", val => "0"); conf is short for "config", val is short for "value", and all are @@ -270,7 +270,7 @@ acceptable. Remove a specified configuration, the mandatory option is conf (or "config"). Example: - $r->remove(conf => "proxy.config.exec_thread.autoconfig"); + $r->remove(conf => "proxy.config.exec_thread.autoconfig.enabled"); =item append diff --git a/mgmt/Makefile.am b/mgmt/Makefile.am index c123a264acf..63b5ddb6989 100644 --- a/mgmt/Makefile.am +++ b/mgmt/Makefile.am @@ -53,7 +53,8 @@ libmgmt_p_la_SOURCES = \ libmgmt_p_la_LIBADD = \ libmgmt_c.la \ - $(top_builddir)/mgmt/utils/libutils_p.la + $(top_builddir)/mgmt/utils/libutils_p.la \ + @YAMLCPP_LIBS@ include $(top_srcdir)/build/tidy.mk diff --git a/mgmt/RecordsConfig.cc b/mgmt/RecordsConfig.cc index 3bf7cf9f77f..d56863c1ebe 100644 --- a/mgmt/RecordsConfig.cc +++ b/mgmt/RecordsConfig.cc @@ -76,7 +76,7 @@ static const RecordElement RecordsConfig[] = , {RECT_CONFIG, "proxy.config.cache.max_disk_errors", RECD_INT, "5", RECU_DYNAMIC, RR_NULL, RECC_NULL, nullptr, RECA_NULL} , - {RECT_CONFIG, "proxy.config.output.logfile", RECD_STRING, "traffic.out", RECU_RESTART_TM, RR_REQUIRED, RECC_NULL, nullptr, + {RECT_CONFIG, "proxy.config.output.logfile.name", RECD_STRING, "traffic.out", RECU_RESTART_TM, RR_REQUIRED, RECC_NULL, nullptr, RECA_NULL} , {RECT_CONFIG, "proxy.config.output.logfile_perm", RECD_STRING, "rw-r--r--", RECU_RESTART_TS, RR_NULL, RECC_NULL, nullptr, RECA_NULL} @@ -105,7 +105,7 @@ static const RecordElement RecordsConfig[] = , // Traffic Server Execution threads configuration // By default Traffic Server set number of execution threads equal to total CPUs - {RECT_CONFIG, "proxy.config.exec_thread.autoconfig", RECD_INT, "1", RECU_RESTART_TS, RR_NULL, RECC_INT, "[0-1]", RECA_READ_ONLY} + {RECT_CONFIG, "proxy.config.exec_thread.autoconfig.enabled", RECD_INT, "1", RECU_RESTART_TS, RR_NULL, RECC_INT, "[0-1]", RECA_READ_ONLY} , {RECT_CONFIG, "proxy.config.exec_thread.autoconfig.scale", RECD_FLOAT, "1.0", RECU_RESTART_TS, RR_NULL, RECC_NULL, nullptr, RECA_READ_ONLY} , @@ -911,7 +911,7 @@ static const RecordElement RecordsConfig[] = //# HostDB //# //############################################################################## - {RECT_CONFIG, "proxy.config.hostdb", RECD_INT, "1", RECU_DYNAMIC, RR_NULL, RECC_NULL, "[0-1]", RECA_NULL} + {RECT_CONFIG, "proxy.config.hostdb.enabled", RECD_INT, "1", RECU_DYNAMIC, RR_NULL, RECC_NULL, "[0-1]", RECA_NULL} , // # up to 511 characters, may not be changed while running {RECT_CONFIG, "proxy.config.hostdb.filename", RECD_STRING, "host.db", RECU_RESTART_TS, RR_NULL, RECC_NULL, nullptr, RECA_NULL} @@ -966,7 +966,7 @@ static const RecordElement RecordsConfig[] = //########################################################################## {RECT_CONFIG, "proxy.config.tunnel.activity_check_period", RECD_INT, "0", RECU_DYNAMIC, RR_NULL, RECC_INT, "[0-100]", RECA_NULL} , - {RECT_CONFIG, "proxy.config.tunnel.prewarm", RECD_INT, "0", RECU_RESTART_TS, RR_NULL, RECC_INT, "[0-1]", RECA_NULL} + {RECT_CONFIG, "proxy.config.tunnel.prewarm.enabled", RECD_INT, "0", RECU_RESTART_TS, RR_NULL, RECC_INT, "[0-1]", RECA_NULL} , {RECT_CONFIG, "proxy.config.tunnel.prewarm.max_stats_size", RECD_INT, "100", RECU_RESTART_TS, RR_NULL, RECC_INT, "[5-65536]", RECA_NULL} , @@ -1098,7 +1098,7 @@ static const RecordElement RecordsConfig[] = // Disable this when using some versions of OpenSSL that causes crashes. See TS-2355. {RECT_CONFIG, "proxy.config.ssl.TLSv1_2", RECD_INT, "1", RECU_RESTART_TS, RR_NULL, RECC_INT, "[0-1]", RECA_NULL} , - {RECT_CONFIG, "proxy.config.ssl.TLSv1_3", RECD_INT, "1", RECU_RESTART_TS, RR_NULL, RECC_INT, "[0-1]", RECA_NULL} + {RECT_CONFIG, "proxy.config.ssl.TLSv1_3.enabled", RECD_INT, "1", RECU_RESTART_TS, RR_NULL, RECC_INT, "[0-1]", RECA_NULL} , {RECT_CONFIG, "proxy.config.ssl.client.TLSv1", RECD_INT, "0", RECU_RESTART_TS, RR_NULL, RECC_INT, "[0-1]", RECA_NULL} , @@ -1106,7 +1106,7 @@ static const RecordElement RecordsConfig[] = , {RECT_CONFIG, "proxy.config.ssl.client.TLSv1_2", RECD_INT, "1", RECU_RESTART_TS, RR_NULL, RECC_INT, "[0-1]", RECA_NULL} , - {RECT_CONFIG, "proxy.config.ssl.client.TLSv1_3", RECD_INT, "1", RECU_RESTART_TS, RR_NULL, RECC_INT, "[0-1]", RECA_NULL} + {RECT_CONFIG, "proxy.config.ssl.client.TLSv1_3.enabled", RECD_INT, "1", RECU_RESTART_TS, RR_NULL, RECC_INT, "[0-1]", RECA_NULL} , {RECT_CONFIG, "proxy.config.ssl.server.cipher_suite", RECD_STRING, "ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-CCM:ECDHE-ECDSA-AES128-CCM:ECDHE-ECDSA-AES256-CCM8:ECDHE-ECDSA-AES128-CCM8:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-CCM8:DHE-RSA-AES128-CCM8:DHE-RSA-AES256-CCM:DHE-RSA-AES128-CCM:DHE-RSA-AES256-SHA256:DHE-RSA-AES128-SHA256:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-CCM8:AES128-CCM8:AES256-CCM:AES128-CCM:AES256-SHA256:AES128-SHA2", RECU_RESTART_TS, RR_NULL, RECC_NULL, nullptr, RECA_NULL} , @@ -1159,11 +1159,11 @@ static const RecordElement RecordsConfig[] = , {RECT_CONFIG, "proxy.config.ssl.client.scheme_proto_mismatch_policy", RECD_INT, "2", RECU_DYNAMIC, RR_NULL, RECC_NULL, nullptr, RECA_NULL} , - {RECT_CONFIG, "proxy.config.ssl.origin_session_cache", RECD_INT, "1", RECU_RESTART_TS, RR_NULL, RECC_NULL, nullptr, RECA_NULL} + {RECT_CONFIG, "proxy.config.ssl.origin_session_cache.enabled", RECD_INT, "1", RECU_RESTART_TS, RR_NULL, RECC_NULL, nullptr, RECA_NULL} , {RECT_CONFIG, "proxy.config.ssl.origin_session_cache.size", RECD_INT, "10240", RECU_RESTART_TS, RR_NULL, RECC_NULL, nullptr, RECA_NULL} , - {RECT_CONFIG, "proxy.config.ssl.session_cache", RECD_INT, "2", RECU_RESTART_TS, RR_NULL, RECC_NULL, nullptr, RECA_NULL} + {RECT_CONFIG, "proxy.config.ssl.session_cache.value", RECD_INT, "2", RECU_RESTART_TS, RR_NULL, RECC_NULL, nullptr, RECA_NULL} , {RECT_CONFIG, "proxy.config.ssl.session_cache.size", RECD_INT, "102400", RECU_RESTART_TS, RR_NULL, RECC_NULL, nullptr, RECA_NULL} , @@ -1530,3 +1530,15 @@ RecordsConfigIterate(RecordElementCallback callback, void *data) callback(&RecordsConfig[i], data); } } + +const RecordElement * +GetRecordElementByName(std::string_view name) +{ + for (unsigned i = 0; i < countof(RecordsConfig); ++i) { + if (strncmp(RecordsConfig[i].name, name.data(), name.size()) == 0) { + return &RecordsConfig[i]; + } + } + + return nullptr; +} diff --git a/mgmt/RecordsConfig.h b/mgmt/RecordsConfig.h index 01ac4ef5a72..ebb710afc83 100644 --- a/mgmt/RecordsConfig.h +++ b/mgmt/RecordsConfig.h @@ -50,3 +50,6 @@ typedef void (*RecordElementCallback)(const RecordElement *, void *); void RecordsConfigIterate(RecordElementCallback, void *); void LibRecordsConfigInit(); // initializes RecordsConfigIndex + +/// Query the @c RecordsConfig array by name. +const RecordElement *GetRecordElementByName(std::string_view name); diff --git a/mgmt/config/FileManager.cc b/mgmt/config/FileManager.cc index fd084cdf066..bf6a48b5268 100644 --- a/mgmt/config/FileManager.cc +++ b/mgmt/config/FileManager.cc @@ -53,11 +53,11 @@ handle_file_reload(std::string const &fileName, std::string const &configName) ts::Errata ret; // TODO: make sure records holds the name after change, if not we should change it. if (fileName == ts::filename::RECORDS) { - if (RecReadConfigFile() == REC_ERR_OKAY) { + if (auto zret = RecReadYamlConfigFile(); zret) { RecConfigWarnIfUnregistered(); } else { std::string str; - ret.push(1, ts::bwprint(str, "Error reading {}.", fileName)); + ret.push(1, ts::bwprint(str, "Error reading {}. {}", fileName)); } } else { RecT rec_type; diff --git a/mgmt/rpc/Makefile.am b/mgmt/rpc/Makefile.am index d4b12b45649..a6213dd2730 100644 --- a/mgmt/rpc/Makefile.am +++ b/mgmt/rpc/Makefile.am @@ -104,7 +104,7 @@ test_jsonrpcserver_CPPFLAGS = \ @YAMLCPP_INCLUDES@ test_jsonrpcserver_LDFLAGS = \ - @AM_LDFLAGS@ + @AM_LDFLAGS@ @SWOC_LDFLAGS@ @YAMLCPP_LDFLAGS@ test_jsonrpcserver_SOURCES = \ server/unit_tests/unit_test_main.cc \ @@ -122,8 +122,9 @@ test_jsonrpcserver_LDADD = \ $(top_builddir)/src/tscpp/util/libtscpputil.la \ $(top_builddir)/src/tscore/libtscore.la \ $(top_builddir)/mgmt/libmgmt_p.la \ + $(top_builddir)/mgmt/libmgmt_c.la \ $(top_builddir)/proxy/shared/libUglyLogStubs.a \ - @YAMLCPP_LIBS@ @HWLOC_LIBS@ + @YAMLCPP_LIBS@ @HWLOC_LIBS@ @SWOC_LIBS@ @YAMLCPP_LIBS@ ########################################################################################### diff --git a/proxy/http/PreWarmConfig.cc b/proxy/http/PreWarmConfig.cc index f2149219810..832ab523577 100644 --- a/proxy/http/PreWarmConfig.cc +++ b/proxy/http/PreWarmConfig.cc @@ -30,7 +30,7 @@ PreWarmConfigParams::PreWarmConfigParams() { // RECU_RESTART_TS - REC_EstablishStaticConfigByte(enabled, "proxy.config.tunnel.prewarm"); + REC_EstablishStaticConfigByte(enabled, "proxy.config.tunnel.prewarm.enabled"); REC_EstablishStaticConfigInteger(max_stats_size, "proxy.config.tunnel.prewarm.max_stats_size"); // RECU_DYNAMIC diff --git a/proxy/http3/Makefile.am b/proxy/http3/Makefile.am index 98046b4df51..b0dcbd019b7 100644 --- a/proxy/http3/Makefile.am +++ b/proxy/http3/Makefile.am @@ -83,7 +83,7 @@ test_LDADD = \ @HWLOC_LIBS@ @SWOC_LIBS@ test_libhttp3_CPPFLAGS = $(test_CPPFLAGS) -test_libhttp3_LDFLAGS = @AM_LDFLAGS@ +test_libhttp3_LDFLAGS = @AM_LDFLAGS@ @YAMLCPP_LDFLAGS@ test_libhttp3_LDADD = $(test_LDADD) test_libhttp3_SOURCES = \ ./test/main.cc \ @@ -92,7 +92,7 @@ test_libhttp3_SOURCES = \ ./Http3Frame.cc test_qpack_CPPFLAGS = $(test_CPPFLAGS) -test_qpack_LDFLAGS = @AM_LDFLAGS@ +test_qpack_LDFLAGS = @AM_LDFLAGS@ @YAMLCPP_LDFLAGS@ test_qpack_LDADD = $(test_LDADD) test_qpack_SOURCES = \ ./test/main_qpack.cc \ diff --git a/proxy/logging/LogConfig.cc b/proxy/logging/LogConfig.cc index 435d7d1c9dd..8ecdf563443 100644 --- a/proxy/logging/LogConfig.cc +++ b/proxy/logging/LogConfig.cc @@ -242,7 +242,7 @@ LogConfig::read_configuration_variables() register_rolled_log_auto_delete(MANAGER_LOG_FILENAME, val); // For traffic.out - char *configured_name(REC_ConfigReadString("proxy.config.output.logfile")); + char *configured_name(REC_ConfigReadString("proxy.config.output.logfile.name")); const char *traffic_logname = configured_name ? configured_name : "traffic.out"; val = static_cast(REC_ConfigReadInteger("proxy.config.output.logfile.rolling_min_count")); register_rolled_log_auto_delete(traffic_logname, val); diff --git a/src/records/Makefile.am b/src/records/Makefile.am index 91cd7b5d32b..7cdfb7d208f 100644 --- a/src/records/Makefile.am +++ b/src/records/Makefile.am @@ -29,6 +29,8 @@ AM_CPPFLAGS += \ -I$(abs_top_srcdir)/mgmt/utils \ -I$(abs_top_srcdir)/include \ -I$(abs_top_srcdir)/lib \ + -I$(abs_top_srcdir)/ \ + @YAMLCPP_INCLUDES@\ @SWOC_INCLUDES@\ $(TS_INCLUDES) @@ -46,6 +48,7 @@ librecords_COMMON = \ P_RecMessage.h \ P_RecUtils.h \ RecConfigParse.cc \ + RecYAMLDecoder.cc \ RecCore.cc \ RecDebug.cc \ RecFile.cc \ @@ -77,7 +80,7 @@ test_librecords_LDADD = \ $(top_builddir)/src/tscpp/util/libtscpputil.la \ $(top_builddir)/src/tscore/libtscore.la \ $(top_builddir)/proxy/shared/libUglyLogStubs.a \ - @SWOC_LIBS@ @HWLOC_LIBS@ @LIBCAP@ + @SWOC_LIBS@ @HWLOC_LIBS@ @LIBCAP@ @YAMLCPP_LIBS@ test_librecords_on_eventsystem_CPPFLAGS = $(AM_CPPFLAGS)\ -I$(abs_top_srcdir)/tests/include @@ -93,7 +96,7 @@ test_librecords_on_eventsystem_LDADD = \ $(top_builddir)/src/tscpp/util/libtscpputil.la \ $(top_builddir)/src/tscore/libtscore.la \ $(top_builddir)/proxy/shared/libUglyLogStubs.a \ - @HWLOC_LIBS@ @LIBCAP@ + @HWLOC_LIBS@ @LIBCAP@ @YAMLCPP_LIBS@ @SWOC_LIBS@ clang-tidy-local: $(sort $(DIST_SOURCES)) $(CXX_Clang_Tidy) diff --git a/src/records/P_RecCore.cc b/src/records/P_RecCore.cc index dca06da7f01..61cb1982d6d 100644 --- a/src/records/P_RecCore.cc +++ b/src/records/P_RecCore.cc @@ -33,6 +33,9 @@ #include "records/P_RecUtils.h" #include "records/P_RecMessage.h" #include "records/P_RecCore.h" +#include "records/RecYAMLDecoder.h" + +#include "swoc/bwf_std.h" #include @@ -401,6 +404,21 @@ RecReadConfigFile() return REC_ERR_OKAY; } +swoc::Errata +RecReadYamlConfigFile() +{ + RecDebug(DL_Debug, "Reading '%s'", g_rec_config_fpath); + + // lock our hash table + ink_rwlock_wrlock(&g_records_rwlock); // review this lock maybe it should be done inside the API + + // Parse the actual file and hash the values. + auto ret = RecYAMLConfigFileParse(g_rec_config_fpath, SetRecordFromYAMLNode); + + ink_rwlock_unlock(&g_records_rwlock); + return ret; +} + //------------------------------------------------------------------------- // RecExecConfigUpdateCbs //------------------------------------------------------------------------- diff --git a/src/records/RecConfigParse.cc b/src/records/RecConfigParse.cc index 4b8558d0176..c989323e86c 100644 --- a/src/records/RecConfigParse.cc +++ b/src/records/RecConfigParse.cc @@ -36,6 +36,9 @@ #include "records/P_RecCore.h" #include "tscore/I_Layout.h" +#include "records/RecYAMLDefs.h" +#include "records/RecYAMLDecoder.h" + const char *g_rec_config_fpath = nullptr; std::unordered_set g_rec_config_contents_ht; ink_mutex g_rec_config_lock; @@ -260,3 +263,18 @@ RecConfigFileParse(const char *path, RecConfigEntryCallback handler) return REC_ERR_OKAY; } + +swoc::Errata +RecYAMLConfigFileParse(const char *path, RecYAMLNodeHandler handler) +{ + try { + auto root = YAML::LoadFile(path); + if (auto ret = ParseRecordsFromYAML(root, handler); !ret.empty()) { + return ret; + } + } catch (std::exception const &ex) { + return swoc::Errata(ERRATA_ERROR, "Error parsing {}. {}", path, ex.what()); + } + + return {}; +} diff --git a/src/records/RecCore.cc b/src/records/RecCore.cc index 8f9dbdd5fcc..9159cd44d44 100644 --- a/src/records/RecCore.cc +++ b/src/records/RecCore.cc @@ -25,12 +25,14 @@ #include "tscore/ink_memory.h" #include "tscore/ink_string.h" #include "tscore/Filenames.h" +#include "tscore/ts_file.h" #include "RecordsConfig.h" #include "records/P_RecFile.h" #include "records/P_RecCore.h" #include "records/P_RecUtils.h" #include "tscore/I_Layout.h" +#include "tscpp/util/ts_errata.h" // This is needed to manage the size of the librecords record. It can't be static, because it needs to be modified // and used (read) from several binaries / modules. @@ -220,16 +222,33 @@ RecCoreInit(RecModeT mode_type, Diags *_diags) ink_mutex_init(&g_rec_config_lock); g_rec_config_fpath = ats_stringdup(RecConfigReadConfigPath(nullptr, ts::filename::RECORDS)); + + // Make sure there is no legacy file, if so we fail. This is to avoid issues with someone not knowing + // that we now are using records.yaml + ts::file::path old_config{RecConfigReadConfigPath(nullptr, "records.config")}; + if (ts::file::exists(old_config)) { + RecLog(DL_Warning, "Found a legacy config file. %s", old_config.c_str()); + return REC_ERR_FAIL; + } + if (RecFileExists(g_rec_config_fpath) == REC_ERR_FAIL) { RecLog(DL_Warning, "Could not find '%s', system will run with defaults\n", ts::filename::RECORDS); file_exists = false; } if (file_exists) { - RecReadConfigFile(); + auto err = RecReadYamlConfigFile(); + RecLog(DL_Note, "records parsing completed."); + if (!err.empty()) { + std::string text; + RecLog(DL_Note, "%s", swoc::bwprint(text, "{}", err).c_str()); + } + } else { + RecLog(DL_Note, "%s does not exist.", g_rec_config_fpath); } } + RecLog(DL_Note, "%s finished loading", std::string{g_rec_config_fpath}.c_str()); g_initialized = true; return REC_ERR_OKAY; diff --git a/src/records/RecYAMLDecoder.cc b/src/records/RecYAMLDecoder.cc new file mode 100644 index 00000000000..a1ec05bfa7b --- /dev/null +++ b/src/records/RecYAMLDecoder.cc @@ -0,0 +1,213 @@ +/** @file + + Decode the records.yaml configuration file. + + @section license License + + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you 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. + */ + +#include "records/P_RecCore.h" +#include "records/RecYAMLDecoder.h" +#include "records/RecYAMLDefs.h" + +#include "tscore/Diags.h" + +#include "RecordsConfig.h" + +#include + +#include +#include + +static std::array Node_Type_to_Str{{"Undefined", "Null", "Scalar", "Sequence", "Map"}}; +namespace +{ +constexpr std::string_view CONFIG_RECORD_PREFIX{"proxy.config"}; +const inline std::string RECORD_YAML_ROOT_STR{"ts"}; + +// I will move this to a common place. +constexpr std::string_view YAML_FLOAT_TAG_URI{"tag:yaml.org,2002:float"}; +constexpr std::string_view YAML_INT_TAG_URI{"tag:yaml.org,2002:int"}; +constexpr std::string_view YAML_STR_TAG_URI{"tag:yaml.org,2002:str"}; +constexpr std::string_view YAML_BOOL_TAG_URI{"tag:yaml.org,2002:bool"}; +constexpr std::string_view YAML_NULL_TAG_URI{"tag:yaml.org,2002:null"}; + +} // namespace + +namespace detail +{ +void flatten_node(CfgNode const &field, RecYAMLNodeHandler handler, swoc::Errata &errata); +std::pair try_deduce_type(YAML::Node const &node); + +// Helper class to make the code less verbose when lock is needed. +struct scoped_cond_lock { + scoped_cond_lock(bool lock = false) : _lock(lock) + { + if (_lock) { + ink_rwlock_wrlock(&g_records_rwlock); + } + } + ~scoped_cond_lock() + { + if (_lock) { + ink_rwlock_unlock(&g_records_rwlock); + } + } + bool _lock{false}; +}; +} // namespace detail + +void +SetRecordFromYAMLNode(CfgNode const &field, swoc::Errata &errata) +{ + std::string record_name{field.get_record_name()}; + RecT rec_type{RecT::RECT_CONFIG}; + RecDataT data_type{RecDataT::RECD_NULL}; + + // this function (GetRec..) should be generic and possibly getting the value either + // from where it gets it currently or a schema file. + if (const auto *found = GetRecordElementByName(record_name.c_str()); found) { + if (REC_TYPE_IS_STAT(found->type)) { + ink_release_assert(REC_TYPE_IS_STAT(found->type)); + } + rec_type = found->type; + data_type = found->value_type; + } else { + std::string field_name = field.node.as(); + + // Not registered in ATS, could be a plugin or an invalid(not registered) records. + // Externally registered records should have the type set in each field (!!int, !!float, etc), otherwise we will not be able to + // deduce the type and we could end up doing a bad type cast at the end. So we say if there is no type(tag) specified, then + // we ignore it. + auto [dtype, e] = detail::try_deduce_type(field.value_node); + if (!e.empty()) { + errata.note(ERRATA_WARN, "Ignoring field '{}' at Line {}. Not registered and {}", field_name, field.node.Mark().line + 1, e); + // We can't continue without knowing the type. + return; + } + data_type = dtype; // field tags found. + } + + std::string nvalue = field.value_node.as(); + std::string value_str = RecConfigOverrideFromEnvironment(record_name.c_str(), nvalue.c_str()); + RecSourceT source = (nvalue == value_str ? REC_SOURCE_EXPLICIT : REC_SOURCE_ENV); + + if (source == REC_SOURCE_ENV) { + errata.note(ERRATA_DEBUG, "'{}' was override with '{}' using an env variable", record_name, value_str); + } + + RecData data; + memset(&data, 0, sizeof(RecData)); + RecDataSetFromString(data_type, &data, value_str.c_str()); + RecSetRecord(rec_type, record_name.c_str(), data_type, &data, nullptr, source, false); + RecDataZero(data_type, &data); +}; + +swoc::Errata +ParseRecordsFromYAML(YAML::Node root, RecYAMLNodeHandler handler, bool lock /*false by default*/) +{ + [[maybe_unused]] detail::scoped_cond_lock cond_lock(lock); + + swoc::Errata errata; + if (YAML::NodeType::Map != root.Type()) { + return swoc::Errata(ERRATA_NOTE, "Node is expected to be a map, got '{}' instead.", root.Type()); + } + + if (auto ts = root[RECORD_YAML_ROOT_STR]; ts.size()) { + for (auto &&n : ts) { + detail::flatten_node({n.first, n.second, CONFIG_RECORD_PREFIX}, handler, errata); + } + } else { + return swoc::Errata(ERRATA_NOTE, "'ts' root key not present or no fields to read."); + } + + return errata; +} + +namespace detail +{ +std::pair +try_deduce_type(YAML::Node const &node) +{ + // Using the tag. + std::string_view tag = node.Tag(); + if (tag == YAML_FLOAT_TAG_URI) { + return {RecDataT::RECD_FLOAT, {}}; + } else if (tag == YAML_INT_TAG_URI) { + return {RecDataT::RECD_INT, {}}; + } else if (tag == YAML_STR_TAG_URI) { + return {RecDataT::RECD_STRING, {}}; + } else if (tag == YAML_INT_TAG_URI) { + return {RecDataT::RECD_INT, {}}; + } else if (tag == YAML_BOOL_TAG_URI) { + return {RecDataT::RECD_INT, {}}; + } else if (tag == YAML_NULL_TAG_URI) { + return {RecDataT::RECD_NULL, {}}; + } + std::string text; + return {RecDataT::RECD_NULL, swoc::bwprint(text, "Unknown tag type '{}'", tag)}; +} + +/// @brief Iterate over a node and build up the field name from it. +/// +/// This function walks down a YAML node till it find a scalar type while building the record name, so if a node is something like +/// this: +/// +/// diags: +/// debug: +/// enabled: 0 +/// +/// this function will build up the record name "diags.debug.enabled" and then it prepend the "proxy.config" to each name, this +/// will be the record name already known by ATS. Every time a scalar node is completed then the handler function will be called. +/// +/// @param field Parent node. +/// @param handler Scalar node function handler, called every time a scalar type is found. +/// @param errata Holds the errors detected. +void +flatten_node(CfgNode const &field, RecYAMLNodeHandler handler, swoc::Errata &errata) +{ + switch (field.value_node.Type()) { + case YAML::NodeType::Map: { + field.append_field_name(); + for (auto &it : field.value_node) { + flatten_node({it.first, it.second, field.get_record_name()}, handler, errata); + } + } break; + case YAML::NodeType::Sequence: + case YAML::NodeType::Scalar: { + field.append_field_name(); + handler(field, errata); + } break; + default:; // done + } +} +} // namespace detail + +namespace swoc +{ +BufferWriter & +bwformat(BufferWriter &w, bwf::Spec const &spec, YAML::NodeType::value type) +{ + return w.write(Node_Type_to_Str[type]); +} +BufferWriter & +bwformat(BufferWriter &w, bwf::Spec const &spec, YAML::Node const &node) +{ + return w.write(node.as()); +} +} // namespace swoc diff --git a/src/traffic_crashlog/Makefile.inc b/src/traffic_crashlog/Makefile.inc index a69054be11f..52435cd54eb 100644 --- a/src/traffic_crashlog/Makefile.inc +++ b/src/traffic_crashlog/Makefile.inc @@ -45,4 +45,4 @@ traffic_crashlog_traffic_crashlog_LDADD = \ $(top_builddir)/iocore/net/libinknet.a \ $(top_builddir)/src/tscore/libtscore.la \ $(top_builddir)/src/tscpp/util/libtscpputil.la \ - @HWLOC_LIBS@ + @HWLOC_LIBS@ @SWOC_LIBS@ @YAMLCPP_LIBS@ diff --git a/src/traffic_server/Makefile.inc b/src/traffic_server/Makefile.inc index 5b90af730f2..abd49f1871b 100644 --- a/src/traffic_server/Makefile.inc +++ b/src/traffic_server/Makefile.inc @@ -61,6 +61,7 @@ traffic_server_traffic_server_SOURCES = \ shared/overridable_txn_vars.cc \ traffic_server/traffic_server.cc + if BUILD_TESTS traffic_server_traffic_server_SOURCES += \ traffic_server/InkAPITest.cc @@ -74,6 +75,7 @@ traffic_server_traffic_server_LDADD = \ $(top_builddir)/proxy/hdrs/libhdrs.a \ $(top_builddir)/proxy/shared/libdiagsconfig.a \ $(top_builddir)/mgmt/libmgmt_p.la \ + $(top_builddir)/mgmt/libmgmt_c.la \ $(top_builddir)/iocore/utils/libinkutils.a \ $(top_builddir)/iocore/dns/libinkdns.a \ $(top_builddir)/iocore/hostdb/libinkhostdb.a \ diff --git a/src/traffic_server/traffic_server.cc b/src/traffic_server/traffic_server.cc index e0cf1075662..222a070e857 100644 --- a/src/traffic_server/traffic_server.cc +++ b/src/traffic_server/traffic_server.cc @@ -384,7 +384,7 @@ class DiagsLogContinuation : public Continuation { SET_HANDLER(&DiagsLogContinuation::periodic); - char *configured_traffic_out_name(REC_ConfigReadString("proxy.config.output.logfile")); + char *configured_traffic_out_name(REC_ConfigReadString("proxy.config.output.logfile.name")); traffic_out_name = std::string(configured_traffic_out_name); ats_free(configured_traffic_out_name); } @@ -954,7 +954,7 @@ cmd_verify(char * /* cmd ATS_UNUSED */) fprintf(stderr, "INFO: Successfully loaded %s\n\n", ts::filename::REMAP); } - if (RecReadConfigFile() != REC_ERR_OKAY) { + if (auto ret = RecReadYamlConfigFile(); !ret.empty()) { exitStatus |= (1 << 1); fprintf(stderr, "ERROR: Failed to load %s, exitStatus %d\n\n", ts::filename::RECORDS, exitStatus); } else { @@ -1600,7 +1600,7 @@ adjust_num_of_net_threads(int nthreads) int nth_auto_config = 1; int num_of_threads_tmp = 1; - REC_ReadConfigInteger(nth_auto_config, "proxy.config.exec_thread.autoconfig"); + REC_ReadConfigInteger(nth_auto_config, "proxy.config.exec_thread.autoconfig.enabled"); Debug("threads", "initial number of net threads is %d", nthreads); Debug("threads", "net threads auto-configuration %s", nth_auto_config ? "enabled" : "disabled"); diff --git a/tests/Pipfile b/tests/Pipfile index da0c5dd3aac..48caf2c992e 100644 --- a/tests/Pipfile +++ b/tests/Pipfile @@ -42,6 +42,7 @@ microserver = ">=1.0.6" jsonschema = "*" python-jose = "*" +pyyaml ="*" # The latest version of Werkzeug (2.1.0) breaks httpbin because it removes # deprecated function `BaseResponse` that httpbin directly or indirectly diff --git a/tests/gold_tests/autest-site/trafficserver.test.ext b/tests/gold_tests/autest-site/trafficserver.test.ext index 89d5cfa8c4d..06b863c46b8 100755 --- a/tests/gold_tests/autest-site/trafficserver.test.ext +++ b/tests/gold_tests/autest-site/trafficserver.test.ext @@ -18,6 +18,8 @@ from __future__ import print_function import os +import yaml + from ports import get_port @@ -25,6 +27,17 @@ def make_id(s): return s.replace(".", "_").replace('-', '_') +def get_typename(s): + file_ext = os.path.splitext(s)[1] + typename = "ats:config" + + # We want the file to be handled as yaml file so we get the benefits of it. + if file_ext == ".yaml" or file_ext == ".yml": + typename = "ats:config:yaml" + + return typename + + # A mapping from log type to the log name. 'stdout' and 'stderr' are handled # specially and are used to indicate the stdout and stderr streams, # respectively. @@ -234,14 +247,15 @@ def MakeATSProcess(obj, name, command='traffic_server', select_ports=True, # config files def MakeConfigFile(self, fname): tmpname = os.path.join(config_dir, fname) - return self.File(tmpname, id=make_id(fname), typename="ats:config") + return self.File(tmpname, id=make_id(fname), typename=get_typename(fname)) AddMethodToInstance(p.Disk, MakeConfigFile) # "Core" config files are pre-defined as variables. - fname = "records.config" + fname = "records.yaml" tmpname = os.path.join(config_dir, fname) - p.Disk.File(tmpname, id=make_id(fname), typename="ats:config:records") + # Note: make_id -> We keep the records_config to be used in autests just for backward compatibility + p.Disk.File(tmpname, id=make_id("records.config"), typename="ats:config:records") fname = "cache.config" tmpname = os.path.join(config_dir, fname) @@ -475,24 +489,11 @@ class Config(File): self.content += line -class RecordsConfig(Config, dict): +class YAMLFile(File): ''' - Create a "dict" representation of records.config - - This can be accessed as a multi-level dictionary - - such as: - rc['CONFIG']['proxy.config.log.hostname'] + Class representing a YAML config file. ''' - reverse_kind_map = { - str: 'STRING', - int: 'INT', - float: 'FLOAT', - } - - line_template = 'CONFIG {name} {kind} {val}\n' - def __init__(self, runable, name, @@ -500,8 +501,11 @@ class RecordsConfig(Config, dict): size=None, content_tester=None, execute=False, - runtime=True): - super(RecordsConfig, self).__init__( + runtime=True, + content=None, + root_tag=None): + + super(YAMLFile, self).__init__( runable, name, exists=None, @@ -509,23 +513,120 @@ class RecordsConfig(Config, dict): content_tester=None, execute=False, runtime=True) + self.__root_tag = root_tag + self.__content = {} + self.WriteCustomOn(self._do_write) def _do_write(self, name): host.WriteVerbosef('ats-config-file', "Writing out file {0}", name) - if len(self) > 0: + + def float_representer(dumper, value): + return dumper.represent_scalar(u'tag:yaml.org,2002:float', str(value), style="'") + + def int_representer(dumper, value): + return dumper.represent_scalar(u'tag:yaml.org,2002:int', str(value), style="'") + + if len(self.__content) > 0: with open(name, 'w') as f: - for name, val in self.items(): - f.write( - self.line_template.format( - name=name, - kind=self.reverse_kind_map[type(val)], - val=val) - ) + yaml.add_representer(float, float_representer) + yaml.add_representer(int, int_representer) + updated_content = {} + if self.__root_tag: + updated_content[self.__root_tag] = self.__content + else: + updated_content = self.__content + + yaml.dump(updated_content, f) + return (True, "Writing config file {0}".format(os.path.split(self.Name)[-1]), "Success") + def __update(self, content, out): + for key, value in content.items(): + if key in out: + if isinstance(out[key], dict) == False: + out.update(content) + continue + + self.__update(value, out[key]) + else: + out[key] = {} + out[key] = value + + def update(self, content): + data = {} + if isinstance(content, str): # from new style + data = yaml.load(content, Loader=yaml.Loader) + else: + data = content # Already an object. + + self.__update(data, self.__content) + + +class RecordsYAML(YAMLFile): + def __init__(self, + runable, + name, + exists=None, + size=None, + content_tester=None, + execute=False, + runtime=True): + super(RecordsYAML, self).__init__( + runable, + name, + exists, + size, + content_tester, + execute, + runtime, + root_tag="ts") + + def _make_obj_from_legacy_record(self, config, var, value): + ''' + Walk the record down and build up the YAML structure. + ''' + key = '' + index = var.find('.') + if index < 0: # last part + config[var] = value + else: + key = var[:index] + if key not in config: + config[key] = {} + + self._make_obj_from_legacy_record(config[key], var[index + 1:], value) + + def __legacy_update(self, obj): + config = {} + for name, value in obj.items(): + ori_name = name + if name.startswith("proxy.config."): + name = name[len("proxy.config."):] + elif name.startswith("local.config."): + name = name[len("local.config."):] + # Maybe an non standard variable name. + + # unwrap the record and make it a YAML field. + self._make_obj_from_legacy_record(config, name, value) + + super(RecordsYAML, self).update(config) + + def update(self, data): + if isinstance(data, dict): + ''' + If the data is already parsed or (more likely) is a legacy objects + we still support it, so update from the passed object. + ''' + self.__legacy_update(data) + else: + ''' + We also support plain YAML(str) to be passed on. Base class will load from the yaml parser. + ''' + super(RecordsYAML, self).update(data) + ########################################################################## @@ -550,7 +651,8 @@ def addSSLFileFromDefaultTestFolder(self, filename): RegisterFileType(Config, "ats:config") -RegisterFileType(RecordsConfig, "ats:config:records") +RegisterFileType(YAMLFile, "ats:config:yaml") +RegisterFileType(RecordsYAML, "ats:config:records") ExtendTestRun(chownForATSProcess, name="ChownForATSProcess") ExtendTest(MakeATSProcess, name="MakeATSProcess") ExtendTestRun(MakeATSProcess, name="MakeATSProcess") diff --git a/tests/gold_tests/cache/background_fill.test.py b/tests/gold_tests/cache/background_fill.test.py index 5a7d75c2f68..2cc603c13fa 100644 --- a/tests/gold_tests/cache/background_fill.test.py +++ b/tests/gold_tests/cache/background_fill.test.py @@ -27,7 +27,7 @@ class BackgroundFillTest: """ - https://docs.trafficserver.apache.org/en/latest/admin-guide/files/records.config.en.html#proxy-config-http-background-fill-completed-threshold + https://docs.trafficserver.apache.org/en/latest/admin-guide/files/records.yaml.en.html#proxy-config-http-background-fill-completed-threshold """ class State(Enum): diff --git a/tests/gold_tests/cont_schedule/schedule_on_pool.test.py b/tests/gold_tests/cont_schedule/schedule_on_pool.test.py index 633970cc360..d42eb023fe9 100644 --- a/tests/gold_tests/cont_schedule/schedule_on_pool.test.py +++ b/tests/gold_tests/cont_schedule/schedule_on_pool.test.py @@ -28,7 +28,7 @@ Test.testName = 'Test TSContScheduleOnPool API' ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 32, 'proxy.config.accept_threads': 1, diff --git a/tests/gold_tests/cont_schedule/schedule_on_thread.test.py b/tests/gold_tests/cont_schedule/schedule_on_thread.test.py index 10e99af1522..0ac1756e6b9 100644 --- a/tests/gold_tests/cont_schedule/schedule_on_thread.test.py +++ b/tests/gold_tests/cont_schedule/schedule_on_thread.test.py @@ -28,7 +28,7 @@ Test.testName = 'Test TSContScheduleOnThread API' ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 32, 'proxy.config.accept_threads': 1, diff --git a/tests/gold_tests/cont_schedule/thread_affinity.test.py b/tests/gold_tests/cont_schedule/thread_affinity.test.py index 3ac4e632674..580a0d7d44a 100644 --- a/tests/gold_tests/cont_schedule/thread_affinity.test.py +++ b/tests/gold_tests/cont_schedule/thread_affinity.test.py @@ -28,7 +28,7 @@ Test.testName = 'Test TSContThreadAffinity APIs' ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 32, 'proxy.config.accept_threads': 1, diff --git a/tests/gold_tests/pluginTest/stek_share/stek_share.test.py b/tests/gold_tests/pluginTest/stek_share/stek_share.test.py index 53ac26eff85..80973a422ba 100644 --- a/tests/gold_tests/pluginTest/stek_share/stek_share.test.py +++ b/tests/gold_tests/pluginTest/stek_share/stek_share.test.py @@ -159,31 +159,31 @@ 'cert_verify_str: /C=US/ST=IL/O=Yahoo/OU=Edge/CN=stek-share' ]) -ts1.Disk.records_config.update({'proxy.config.diags.debug.enabled': 1, 'proxy.config.diags.debug.tags': 'stek_share', 'proxy.config.exec_thread.autoconfig': 0, 'proxy.config.exec_thread.limit': 4, 'proxy.config.ssl.server.cert.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.server.private_key.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.session_cache': 2, 'proxy.config.ssl.session_cache.size': 1024, 'proxy.config.ssl.session_cache.timeout': 7200, 'proxy.config.ssl.session_cache.num_buckets': 16, 'proxy.config.ssl.server.session_ticket.enable': 1, 'proxy.config.ssl.server.cipher_suite': +ts1.Disk.records_config.update({'proxy.config.diags.debug.enabled': 1, 'proxy.config.diags.debug.tags': 'stek_share', 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.limit': 4, 'proxy.config.ssl.server.cert.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.server.private_key.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.session_cache.value': 2, 'proxy.config.ssl.session_cache.size': 1024, 'proxy.config.ssl.session_cache.timeout': 7200, 'proxy.config.ssl.session_cache.num_buckets': 16, 'proxy.config.ssl.server.session_ticket.enable': 1, 'proxy.config.ssl.server.cipher_suite': 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA:DHE-DSS-AES256-SHA:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA'}) ts1.Disk.plugin_config.AddLine('stek_share.so {0}'.format(stek_share_conf_path_1)) ts1.Disk.ssl_multicert_config.AddLine('dest_ip=* ssl_cert_name=self_signed.crt ssl_key_name=self_signed.key') ts1.Disk.remap_config.AddLine('map / http://127.0.0.1:{0}'.format(server.Variables.Port)) -ts2.Disk.records_config.update({'proxy.config.diags.debug.enabled': 1, 'proxy.config.diags.debug.tags': 'stek_share', 'proxy.config.exec_thread.autoconfig': 0, 'proxy.config.exec_thread.limit': 4, 'proxy.config.ssl.server.cert.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.server.private_key.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.session_cache': 2, 'proxy.config.ssl.session_cache.size': 1024, 'proxy.config.ssl.session_cache.timeout': 7200, 'proxy.config.ssl.session_cache.num_buckets': 16, 'proxy.config.ssl.server.session_ticket.enable': 1, 'proxy.config.ssl.server.cipher_suite': +ts2.Disk.records_config.update({'proxy.config.diags.debug.enabled': 1, 'proxy.config.diags.debug.tags': 'stek_share', 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.limit': 4, 'proxy.config.ssl.server.cert.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.server.private_key.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.session_cache.value': 2, 'proxy.config.ssl.session_cache.size': 1024, 'proxy.config.ssl.session_cache.timeout': 7200, 'proxy.config.ssl.session_cache.num_buckets': 16, 'proxy.config.ssl.server.session_ticket.enable': 1, 'proxy.config.ssl.server.cipher_suite': 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA:DHE-DSS-AES256-SHA:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA'}) ts2.Disk.plugin_config.AddLine('stek_share.so {0}'.format(stek_share_conf_path_2)) ts2.Disk.ssl_multicert_config.AddLine('dest_ip=* ssl_cert_name=self_signed.crt ssl_key_name=self_signed.key') ts2.Disk.remap_config.AddLine('map / http://127.0.0.1:{0}'.format(server.Variables.Port)) -ts3.Disk.records_config.update({'proxy.config.diags.debug.enabled': 1, 'proxy.config.diags.debug.tags': 'stek_share', 'proxy.config.exec_thread.autoconfig': 0, 'proxy.config.exec_thread.limit': 4, 'proxy.config.ssl.server.cert.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.server.private_key.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.session_cache': 2, 'proxy.config.ssl.session_cache.size': 1024, 'proxy.config.ssl.session_cache.timeout': 7200, 'proxy.config.ssl.session_cache.num_buckets': 16, 'proxy.config.ssl.server.session_ticket.enable': 1, 'proxy.config.ssl.server.cipher_suite': +ts3.Disk.records_config.update({'proxy.config.diags.debug.enabled': 1, 'proxy.config.diags.debug.tags': 'stek_share', 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.limit': 4, 'proxy.config.ssl.server.cert.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.server.private_key.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.session_cache.value': 2, 'proxy.config.ssl.session_cache.size': 1024, 'proxy.config.ssl.session_cache.timeout': 7200, 'proxy.config.ssl.session_cache.num_buckets': 16, 'proxy.config.ssl.server.session_ticket.enable': 1, 'proxy.config.ssl.server.cipher_suite': 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA:DHE-DSS-AES256-SHA:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA'}) ts3.Disk.plugin_config.AddLine('stek_share.so {0}'.format(stek_share_conf_path_3)) ts3.Disk.ssl_multicert_config.AddLine('dest_ip=* ssl_cert_name=self_signed.crt ssl_key_name=self_signed.key') ts3.Disk.remap_config.AddLine('map / http://127.0.0.1:{0}'.format(server.Variables.Port)) -ts4.Disk.records_config.update({'proxy.config.diags.debug.enabled': 1, 'proxy.config.diags.debug.tags': 'stek_share', 'proxy.config.exec_thread.autoconfig': 0, 'proxy.config.exec_thread.limit': 4, 'proxy.config.ssl.server.cert.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.server.private_key.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.session_cache': 2, 'proxy.config.ssl.session_cache.size': 1024, 'proxy.config.ssl.session_cache.timeout': 7200, 'proxy.config.ssl.session_cache.num_buckets': 16, 'proxy.config.ssl.server.session_ticket.enable': 1, 'proxy.config.ssl.server.cipher_suite': +ts4.Disk.records_config.update({'proxy.config.diags.debug.enabled': 1, 'proxy.config.diags.debug.tags': 'stek_share', 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.limit': 4, 'proxy.config.ssl.server.cert.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.server.private_key.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.session_cache.value': 2, 'proxy.config.ssl.session_cache.size': 1024, 'proxy.config.ssl.session_cache.timeout': 7200, 'proxy.config.ssl.session_cache.num_buckets': 16, 'proxy.config.ssl.server.session_ticket.enable': 1, 'proxy.config.ssl.server.cipher_suite': 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA:DHE-DSS-AES256-SHA:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA'}) ts4.Disk.plugin_config.AddLine('stek_share.so {0}'.format(stek_share_conf_path_4)) ts4.Disk.ssl_multicert_config.AddLine('dest_ip=* ssl_cert_name=self_signed.crt ssl_key_name=self_signed.key') ts4.Disk.remap_config.AddLine('map / http://127.0.0.1:{0}'.format(server.Variables.Port)) -ts5.Disk.records_config.update({'proxy.config.diags.debug.enabled': 1, 'proxy.config.diags.debug.tags': 'stek_share', 'proxy.config.exec_thread.autoconfig': 0, 'proxy.config.exec_thread.limit': 4, 'proxy.config.ssl.server.cert.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.server.private_key.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.session_cache': 2, 'proxy.config.ssl.session_cache.size': 1024, 'proxy.config.ssl.session_cache.timeout': 7200, 'proxy.config.ssl.session_cache.num_buckets': 16, 'proxy.config.ssl.server.session_ticket.enable': 1, 'proxy.config.ssl.server.cipher_suite': +ts5.Disk.records_config.update({'proxy.config.diags.debug.enabled': 1, 'proxy.config.diags.debug.tags': 'stek_share', 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.limit': 4, 'proxy.config.ssl.server.cert.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.server.private_key.path': '{0}'.format(Test.RunDirectory), 'proxy.config.ssl.session_cache.value': 2, 'proxy.config.ssl.session_cache.size': 1024, 'proxy.config.ssl.session_cache.timeout': 7200, 'proxy.config.ssl.session_cache.num_buckets': 16, 'proxy.config.ssl.server.session_ticket.enable': 1, 'proxy.config.ssl.server.cipher_suite': 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA:DHE-DSS-AES256-SHA:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA'}) ts5.Disk.plugin_config.AddLine('stek_share.so {0}'.format(stek_share_conf_path_5)) ts5.Disk.ssl_multicert_config.AddLine('dest_ip=* ssl_cert_name=self_signed.crt ssl_key_name=self_signed.key') diff --git a/tests/gold_tests/pluginTest/traffic_dump/traffic_dump.test.py b/tests/gold_tests/pluginTest/traffic_dump/traffic_dump.test.py index d6c996bdc09..4aa84f4785f 100644 --- a/tests/gold_tests/pluginTest/traffic_dump/traffic_dump.test.py +++ b/tests/gold_tests/pluginTest/traffic_dump/traffic_dump.test.py @@ -59,7 +59,7 @@ 'proxy.config.ssl.CA.cert.filename': f'{ts.Variables.SSLDir}/signer.pem', 'proxy.config.exec_thread.autoconfig.scale': 1.0, 'proxy.config.http.host_sni_policy': 2, - 'proxy.config.ssl.TLSv1_3': 0, + 'proxy.config.ssl.TLSv1_3.enabled': 0, 'proxy.config.ssl.client.verify.server.policy': 'PERMISSIVE', 'proxy.config.http.connect_ports': f"{server.Variables.http_port}", diff --git a/tests/gold_tests/pluginTest/traffic_dump/traffic_dump_response_body.test.py b/tests/gold_tests/pluginTest/traffic_dump/traffic_dump_response_body.test.py index a8e2be4e419..45bac86713f 100644 --- a/tests/gold_tests/pluginTest/traffic_dump/traffic_dump_response_body.test.py +++ b/tests/gold_tests/pluginTest/traffic_dump/traffic_dump_response_body.test.py @@ -50,7 +50,7 @@ 'proxy.config.ssl.CA.cert.filename': f'{ts.Variables.SSLDir}/signer.pem', 'proxy.config.exec_thread.autoconfig.scale': 1.0, 'proxy.config.http.host_sni_policy': 2, - 'proxy.config.ssl.TLSv1_3': 0, + 'proxy.config.ssl.TLSv1_3.enabled': 0, 'proxy.config.ssl.client.verify.server.policy': 'PERMISSIVE', }) diff --git a/tests/gold_tests/pluginTest/traffic_dump/traffic_dump_sni_filter.test.py b/tests/gold_tests/pluginTest/traffic_dump/traffic_dump_sni_filter.test.py index 6999293a4b0..33f2af0e102 100644 --- a/tests/gold_tests/pluginTest/traffic_dump/traffic_dump_sni_filter.test.py +++ b/tests/gold_tests/pluginTest/traffic_dump/traffic_dump_sni_filter.test.py @@ -52,7 +52,7 @@ 'proxy.config.ssl.CA.cert.filename': f'{ts.Variables.SSLDir}/signer.pem', 'proxy.config.exec_thread.autoconfig.scale': 1.0, 'proxy.config.http.host_sni_policy': 2, - 'proxy.config.ssl.TLSv1_3': 0, + 'proxy.config.ssl.TLSv1_3.enabled': 0, 'proxy.config.ssl.client.verify.server.policy': 'PERMISSIVE', }) diff --git a/tests/gold_tests/records/gold/full_records.yaml b/tests/gold_tests/records/gold/full_records.yaml new file mode 100644 index 00000000000..71098cb4730 --- /dev/null +++ b/tests/gold_tests/records/gold/full_records.yaml @@ -0,0 +1,614 @@ +ts: + accept_threads: 1 + alarm: + abs_path: nullpt + bin: example_alarm_bin.sh + script_runtime: 5 + allocator: + dontdump_iobuffers: 1 + hugepages: 0 + thread_freelist_low_watermark: 32 + thread_freelist_size: 512 + body_factory: + enable_customizations: 1 + enable_logging: 0 + response_max_size: 8192 + response_suppression_mode: 0 + template_base: NONE + cache: + agg_write_backlog: 5242880 + alt_rewrite_max_size: 4096 + dir: + sync_frequency: 60 + enable_checksum: 0 + enable_read_while_writer: 1 + force_sector_size: 0 + hit_evacuate_percent: 0 + hit_evacuate_size_limit: 0 + hostdb: + disable_reverse_lookup: 0 + sync_frequency: 0 + limits: + http: + max_alts: 5 + log: + alternate: + eviction: 0 + max_disk_errors: 5 + max_doc_size: 0 + min_average_object_size: 8000 + mutex_retry_delay: 2 + permit: + pinning: 0 + ram_cache: + algorithm: 1 + compress: 0 + compress_percent: 90 + size: -1 + use_seen_filter: 1 + ram_cache_cutoff: 4194304 + read_while_writer: + max_retries: 10 + read_while_writer_retry: + delay: 50 + select_alternate: 1 + target_fragment_size: 1048576 + threads_per_disk: 8 + config_update_interval_ms: 3000 + core_limit: -1 + diags: + action: + enabled: 0 + debug: + enabled: 0 + tags: http|dns + throttling_interval_msec: 0 + logfile: + filename: diags.log + rolling_enabled: 0 + rolling_interval_sec: 3600 + rolling_min_count: 0 + rolling_size_mb: 10 + logfile_perm: rw-r--r-- + output: + alert: L + debug: E + diag: E + emergency: L + error: L + fatal: L + note: L + status: L + warning: L + show_location: 1 + dns: + connection_mode: 0 + dedicated_thread: 0 + failover_number: 5 + failover_period: 60 + local_ipv4: null + local_ipv6: null + lookup_timeout: 20 + max_dns_in_flight: 2048 + max_tcp_continuous_failures: 10 + nameservers: null + resolv_conf: /etc/resolv.conf + retries: 5 + round_robin_nameservers: 1 + search_default_domains: 0 + splitDNS: + enabled: 0 + validate_query_name: 0 + dump_mem_info_frequency: 0 + error: + logfile: + filename: error.log + exec_thread: + affinity: 1 + autoconfig: + enabled: 1 + scale: 1.0 + limit: 2 + listen: 0 + hostdb: + enabled: 1 + fail: + timeout: 0 + filename: host.db + host_file: + interval: 86400 + path: null + io: + max_buffer_index: 8 + ip_resolve: null + lookup_timeout: 30 + max_count: -1 + max_size: 10M + migrate_on_demand: 0 + partitions: 64 + re_dns_on_reload: 0 + round_robin_max_count: 16 + serve_stale_for: 0 + strict_round_robin: 0 + timed_round_robin: 0 + timeout: 86400 + ttl_mode: 0 + verify_after: 720 + http: + accept_no_activity_timeout: 120 + allow_half_open: 1 + allow_multi_range: 0 + anonymize_remove_client_ip: 0 + anonymize_remove_cookie: 0 + anonymize_remove_from: 0 + anonymize_remove_referer: 0 + anonymize_remove_user_agent: 0 + attach_server_session_to_client: 0 + auth_server_session_private: 1 + background_fill_active_timeout: 0 + background_fill_completed_threshold: 0.0 + cache: + cache_responses_to_cookies: 1 + cache_urls_that_look_dynamic: 1 + generation: -1 + guaranteed_max_lifetime: 31536000 + guaranteed_min_lifetime: 0 + heuristic_lm_factor: 0.1 + heuristic_max_lifetime: 86400 + heuristic_min_lifetime: 3600 + http: 1 + ignore_accept_charset_mismatch: 2 + ignore_accept_encoding_mismatch: 2 + ignore_accept_language_mismatch: 2 + ignore_accept_mismatch: 2 + ignore_authentication: 0 + ignore_client_cc_max_age: 1 + ignore_client_no_cache: 1 + ignore_server_no_cache: 0 + ims_on_client_no_cache: 1 + max_open_read_retries: -1 + max_open_write_retries: 1 + max_stale_age: 604800 + open_read_retry_time: 10 + open_write_fail_action: 0 + post_method: 0 + range: + lookup: 1 + write: 0 + required_headers: 2 + when_to_revalidate: 0 + chunking: + size: 4096 + chunking_enabled: 1 + connect: + dead: + policy: 2 + connect_attempts_max_retries: 3 + connect_attempts_max_retries_dead_server: 1 + connect_attempts_rr_retries: 3 + connect_attempts_timeout: 30 + connect_ports: '443' + default_buffer_size: 8 + default_buffer_water_mark: 32768 + disallow_post_100_continue: 0 + doc_in_cache_skip_dns: 1 + down_server: + cache_time: 60 + enable_http_info: 0 + enable_http_stats: 1 + enabled: 1 + errors: + log_error_pages: 1 + flow_control: + enabled: 0 + high_water: 0 + low_water: 0 + forward: + proxy_auth_to_parent: 0 + forward_connect_method: 0 + header_field_max_size: 131070 + host_sni_policy: 2 + insert_age_in_response: 1 + insert_client_ip: 1 + insert_forwarded: none + insert_request_via_str: 1 + insert_response_via_str: 0 + insert_squid_x_forwarded_for: 1 + keep_alive_enabled_in: 1 + keep_alive_enabled_out: 1 + keep_alive_no_activity_timeout_in: 120 + keep_alive_no_activity_timeout_out: 120 + keep_alive_post_out: 1 + max_post_size: 0 + max_proxy_cycles: 0 + negative_caching_enabled: 0 + negative_caching_lifetime: 1800 + negative_caching_list: '2' + negative_revalidating_enabled: 1 + negative_revalidating_lifetime: 1800 + no_dns_just_forward_to_parent: 0 + no_origin_server_dns: 0 + normalize_ae: 1 + number_of_redirections: 0 + parent_proxies: nullpt + parent_proxy: + disable_connect_tunneling: 0 + disable_parent_markdowns: 0 + enable_parent_timeout_markdowns: 0 + fail_threshold: 10 + mark_down_hostdb: 0 + per_parent_connect_attempts: 2 + retry_time: 300 + self_detect: 2 + total_connect_attempts: 4 + per_server: + connection: + alert_delay: 60 + match: both + max: 0 + min: 0 + post: + check: + content_length: + enabled: 1 + post_copy_size: 2048 + proxy_protocol_allowlist: none + proxy_protocol_out: -1 + push_method_enabled: 0 + redirect: + actions: routable:follow + redirect_host_no_port: 1 + redirect_use_orig_cache_key: 0 + referer_default_redirect: http://www.example.com/ + referer_filter: 0 + referer_format_redirect: 0 + request_buffer_enabled: 0 + request_header_max_size: 131072 + request_line_max_size: 65535 + request_via_str: ApacheTrafficServer + response_header_max_size: 131072 + response_server_enabled: 1 + response_server_str: ATS/ + response_via_str: ApacheTrafficServer + send_100_continue_response: 0 + send_http11_requests: 1 + server_max_connections: 0 + server_ports: '80' + server_session_sharing: + match: both + pool: thread + slow: + log: + threshold: 0 + strict_uri_parsing: 2 + transaction_active_timeout_in: 900 + transaction_active_timeout_out: 0 + transaction_no_activity_timeout_in: 30 + transaction_no_activity_timeout_out: 30 + uncacheable_requests_bypass_parent: 1 + use_client_source_port: 0 + use_client_target_addr: 0 + wait_for_cache: 0 + websocket: + max_number_of_connections: -1 + http2: + accept_no_activity_timeout: 120 + active_timeout_in: 0 + connection: + slow: + log: + threshold: 0 + default_buffer_water_mark: -1 + header_table_size: 4096 + header_table_size_limit: 65536 + initial_window_size_in: 65535 + max_active_streams_in: 0 + max_concurrent_streams_in: 100 + max_frame_size: 16384 + max_header_list_size: 131072 + max_ping_frames_per_minute: 60 + max_priority_frames_per_minute: 120 + max_settings_frames_per_minute: 14 + max_settings_per_frame: 7 + max_settings_per_minute: 14 + min_avg_window_update: 2560.0 + min_concurrent_streams_in: 10 + no_activity_timeout_in: 120 + push_diary_size: 256 + stream: + slow: + log: + threshold: 0 + stream_error_rate_threshold: 0.1 + stream_error_sampling_threshold: 10 + stream_priority_enabled: 0 + write_buffer_block_size: 262144 + write_size_threshold: 0.5 + write_time_threshold: 100 + zombie_debug_timeout_in: 0 + http3: + header_table_size: 0 + max_header_list_size: 4096 + max_settings: 10 + num_placeholders: 100 + qpack_blocked_streams: 0 + http_ui_enabled: 0 + incoming_ip_to_bind: null + log: + ascii_buffer_size: 36864 + auto_delete_rolled_files: 1 + file_stat_frequency: 32 + hostname: localhost + io: + max_buffer_index: 8 + log_buffer_size: 9216 + log_fast_buffer: 0 + logfile_perm: rw-r--r-- + logging_enabled: 3 + max_line_size: 9216 + max_secs_per_buffer: 5 + max_space_mb_for_logs: 25000 + max_space_mb_headroom: 1000 + periodic_tasks_interval: 5 + preproc_threads: 1 + rolling_allow_empty: 0 + rolling_enabled: 1 + rolling_interval_sec: 86400 + rolling_max_count: 0 + rolling_min_count: 0 + rolling_offset_hr: 0 + rolling_size_mb: 10 + sampling_frequency: 1 + space_used_frequency: 2 + throttling_interval_msec: 60000 + memory: + max_usage: 0 + mlock_enabled: 0 + msg: + io: + max_buffer_index: 8 + net: + accept_period: 10 + connections_throttle: 30000 + default_inactivity_timeout: 86400 + defer_accept: 1 + event_period: 10 + inactivity_check_frequency: 1 + listen_backlog: -1 + max_connections_in: 30000 + max_requests_in: 0 + poll_timeout: 10 + retry_delay: 10 + sock_mss_in: 0 + sock_notsent_lowat: 32768 + sock_option_flag_in: '0x1' + sock_option_flag_out: '0x1' + sock_option_tfo_queue_size_in: 10000 + sock_packet_mark_in: '0x0' + sock_packet_mark_out: '0x0' + sock_packet_tos_in: '0x0' + sock_packet_tos_out: '0x0' + sock_recv_buffer_size_in: 0 + sock_recv_buffer_size_out: 0 + sock_send_buffer_size_in: 0 + sock_send_buffer_size_out: 0 + tcp_congestion_control_in: val + tcp_congestion_control_out: val + throttle_delay: 50 + outgoing_ip_to_bind: null + output: + logfile: + name: traffic.out + rolling_enabled: 0 + rolling_interval_sec: 3600 + rolling_min_count: 0 + rolling_size_mb: 100 + logfile_perm: rw-r--r-- + payload: + io: + max_buffer_index: 8 + plugin: + dynamic_reload_mode: 1 + load_elevated: 0 + vc: + default_buffer_index: 8 + default_buffer_water_mark: 0 + product_company: Apache Software Foundation + product_name: Traffic Server + product_vendor: Apache + proxy_name: traffic_server + quic: + ack_delay_exponent_in: 3 + ack_delay_exponent_out: 3 + active_cid_limit_in: 4 + active_cid_limit_out: 8 + client: + cm_exercise_enabled: 0 + quantum_readiness_test_enabled: 0 + session_file: null + supported_groups: P-256:X25519:P-384:P-52 + vn_exercise_enabled: 0 + congestion_control: + initial_window: 12000 + loss_reduction_factor: 0.5 + max_datagram_size: 1200 + minimum_window: 2400 + persistent_congestion_threshold: 3 + connection_table: + size: 65521 + disable_active_migration: 0 + initial_max_data_in: 65536 + initial_max_data_out: 65536 + initial_max_stream_data_bidi_local_in: 0 + initial_max_stream_data_bidi_local_out: 4096 + initial_max_stream_data_bidi_remote_in: 4096 + initial_max_stream_data_bidi_remote_out: 0 + initial_max_stream_data_uni_in: 4096 + initial_max_stream_data_uni_out: 4096 + initial_max_streams_bidi_in: 100 + initial_max_streams_bidi_out: 100 + initial_max_streams_uni_in: 100 + initial_max_streams_uni_out: 100 + instance_id: 0 + loss_detection: + granularity: 1 + initial_rtt: 500 + packet_threshold: 3 + time_threshold: 1.25 + max_ack_delay_in: 25 + max_ack_delay_out: 25 + no_activity_timeout_in: 30000 + no_activity_timeout_out: 30000 + num_alt_connection_ids: 8 + preferred_address_ipv4: null + preferred_address_ipv6: null + qlog_dir: null + server: + quantum_readiness_test_enabled: 0 + stateless_retry_enabled: 0 + supported_groups: P-256:X25519:P-384:P-52 + raw_stat_sync_interval_ms: 5000 + remote_sync_interval_ms: 5000 + res_track_memory: 0 + restart: + active_client_threshold: 0 + stop_listening: 0 + reverse_proxy: + enabled: 1 + socks: + accept_enabled: 0 + accept_port: 1080 + connection_attempts: 4 + default_servers: val + http_port: 80 + per_server_connection_attempts: 1 + server_connect_timeout: 10 + server_fail_threshold: 2 + server_retry_time: 300 + server_retry_timeout: 300 + socks_needed: 0 + socks_timeout: 100 + socks_version: 4 + srv_enabled: 0 + ssl: + CA: + cert: + filename: null + TLSv1: 0 + TLSv1_1: 0 + TLSv1_2: 1 + TLSv1_3: + enabled: 1 + allow_client_renegotiation: 0 + async: + handshake: + enabled: 0 + cert: + load_elevated: 0 + client: + CA: + cert: + filename: null + TLSv1: 0 + TLSv1_1: 0 + TLSv1_2: 1 + TLSv1_3: + cipher_suites: TLS_AES_256_GCM_SHA384:TLS_AES_128_GCM_SHA256:TLS_CHACHA20_POLY1305_SHA256 + enabled: 1 + alpn_protocols: null + cert: + filename: null + certification_level: 0 + cipher_suite: ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-CCM8:ECDHE-ECDSA-AES256-CCM:DHE-RSA-AES256-CCM8:DHE-RSA-AES256-CCM:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-ARIA256-GCM-SHA384:ECDHE-ARIA256-GCM-SHA384:DHE-DSS-ARIA256-GCM-SHA384:DHE-RSA-ARIA256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:ECDHE-ECDSA-CAMELLIA256-SHA384:ECDHE-RSA-CAMELLIA256-SHA384:DHE-RSA-CAMELLIA256-SHA256:DHE-DSS-CAMELLIA256-SHA256:RSA-PSK-AES256-GCM-SHA384:RSA-PSK-CHACHA20-POLY1305:RSA-PSK-ARIA256-GCM-SHA384:AES256-GCM-SHA384:AES256-CCM8:AES256-CCM:ARIA256-GCM-SHA384:AES256-SHA256:CAMELLIA256-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:DHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-CCM8:ECDHE-ECDSA-AES128-CCM:DHE-RSA-AES128-CCM8:DHE-RSA-AES128-CCM:ECDHE-ECDSA-ARIA128-GCM-SHA256:ECDHE-ARIA128-GCM-SHA256:DHE-DSS-ARIA128-GCM-SHA256:DHE-RSA-ARIA128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:ECDHE-ECDSA-CAMELLIA128-SHA256:ECDHE-RSA-CAMELLIA128-SHA256:DHE-RSA-CAMELLIA128-SHA256:DHE-DSS-CAMELLIA128-SHA256:RSA-PSK-AES128-GCM-SHA256:RSA-PSK-ARIA128-GCM-SHA256:AES128-GCM-SHA256:AES128-CCM8:AES128-CCM:ARIA128-GCM-SHA256:AES128-SHA256:CAMELLIA128-SHA256 + groups_list: null + private_key: + filename: null + scheme_proto_mismatch_policy: 2 + sni_policy: host + verify: + server: + policy: ENFORCED + properties: ALL + engine: + conf_file: null + handshake_timeout_in: 30 + hsts_include_subdomains: 0 + hsts_max_age: -1 + keylog_file: null + ktls: + enabled: 0 + max_record_size: 0 + misc: + io: + max_buffer_index: 8 + ocsp: + cache_timeout: 3600 + enabled: 0 + request_timeout: 10 + update_period: 60 + origin_session_cache: + enabled: 1 + size: 10240 + server: + TLSv1_3: + cipher_suites: TLS_AES_256_GCM_SHA384:TLS_AES_128_GCM_SHA256:TLS_CHACHA20_POLY1305_SHA256 + allow_early_data_params: 0 + cert_chain: + filename: null + cipher_suite: ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-CCM:ECDHE-ECDSA-AES128-CCM:ECDHE-ECDSA-AES256-CCM8:ECDHE-ECDSA-AES128-CCM8:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-CCM8:DHE-RSA-AES128-CCM8:DHE-RSA-AES256-CCM:DHE-RSA-AES128-CCM:DHE-RSA-AES256-SHA256:DHE-RSA-AES128-SHA256:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-CCM8:AES128-CCM8:AES256-CCM:AES128-CCM:AES256-SHA256:AES128-SHA2 + dhparams_file: null + groups_list: null + honor_cipher_order: 1 + max_early_data: 0 + multicert: + exit_on_load_fail: 1 + prioritize_chacha: 0 + session_ticket: + enable: 1 + number: 2 + ticket_key: + filename: null + session_cache: + auto_clear: 1 + num_buckets: 256 + size: 102400 + skip_cache_on_bucket_contention: 0 + timeout: 0 + value: 2 + stat_api: + max_stats_allowed: 256 + stop: + shutdown_timeout: 0 + system: + file_max_pct: 0.9 + task_threads: 2 + thread: + default: + stackguard_pages: 1 + stacksize: 1048576 + max_heartbeat_mseconds: 60 + tunnel: + activity_check_period: 0 + prewarm: + algorithm: 2 + enabled: 0 + event_period: 1000 + max_stats_size: 100 + udp: + enable_gso: 0 + free_cancelled_pkts_sec: 10 + periodic_cleanup: 10 + send_retries: 0 + threads: 0 + url_remap: + min_rules_required: 0 + pristine_host_hdr: 0 + remap_required: 1 + strategies: + filename: strategies.yaml + wccp: + addr: some + services: some + websocket: + active_timeout: 3600 + no_activity_timeout: 600 diff --git a/tests/gold_tests/records/gold/renamed_records.out b/tests/gold_tests/records/gold/renamed_records.out new file mode 100644 index 00000000000..fca402fc517 --- /dev/null +++ b/tests/gold_tests/records/gold/renamed_records.out @@ -0,0 +1,11 @@ +``` +┌■ 8 Renamed records: +└┬──» #1 : proxy.config.output.logfile -> proxy.config.output.logfile.name + ├──» #2 : proxy.config.exec_thread.autoconfig -> proxy.config.exec_thread.autoconfig.enabled + ├──» #3 : proxy.config.hostdb -> proxy.config.hostdb.enabled + ├──» #4 : proxy.config.tunnel.prewarm -> proxy.config.tunnel.prewarm.enabled + ├──» #5 : proxy.config.ssl.origin_session_cache -> proxy.config.ssl.origin_session_cache.enabled + ├──» #6 : proxy.config.ssl.session_cache -> proxy.config.ssl.session_cache.value + ├──» #7 : proxy.config.ssl.TLSv1_3 -> proxy.config.ssl.TLSv1_3.enabled + └──» #8 : proxy.config.ssl.client.TLSv1_3 -> proxy.config.ssl.client.TLSv1_3.enabled +``` diff --git a/tests/gold_tests/records/gold/renamed_records.yaml b/tests/gold_tests/records/gold/renamed_records.yaml new file mode 100644 index 00000000000..15fe41bc33d --- /dev/null +++ b/tests/gold_tests/records/gold/renamed_records.yaml @@ -0,0 +1,22 @@ +ts: + exec_thread: + autoconfig: + enabled: 1 + hostdb: + enabled: 1 + output: + logfile: + name: traffic.out + ssl: + TLSv1_3: + enabled: 0 + client: + TLSv1_3: + enabled: 0 + origin_session_cache: + enabled: 0 + session_cache: + value: 0 + tunnel: + prewarm: + enabled: 0 diff --git a/tests/gold_tests/records/legacy_config/full_records.config b/tests/gold_tests/records/legacy_config/full_records.config new file mode 100644 index 00000000000..fc21c7ea81b --- /dev/null +++ b/tests/gold_tests/records/legacy_config/full_records.config @@ -0,0 +1,494 @@ +CONFIG proxy.config.product_company STRING Apache Software Foundation +CONFIG proxy.config.product_vendor STRING Apache +CONFIG proxy.config.product_name STRING Traffic Server +CONFIG proxy.config.proxy_name STRING traffic_server +CONFIG proxy.config.core_limit INT -1 +CONFIG proxy.config.mlock_enabled INT 0 +CONFIG proxy.config.dump_mem_info_frequency INT 0 +CONFIG proxy.config.http_ui_enabled INT 0 +CONFIG proxy.config.cache.max_disk_errors INT 5 +CONFIG proxy.config.output.logfile STRING traffic.out +CONFIG proxy.config.output.logfile_perm STRING rw-r--r-- +CONFIG proxy.config.output.logfile.rolling_enabled INT 0 +CONFIG proxy.config.output.logfile.rolling_interval_sec INT 3600 +CONFIG proxy.config.output.logfile.rolling_size_mb INT 100 +CONFIG proxy.config.output.logfile.rolling_min_count INT 0 +CONFIG proxy.config.res_track_memory INT 0 +CONFIG proxy.config.memory.max_usage INT 0 +CONFIG proxy.config.system.file_max_pct FLOAT 0.9 +CONFIG proxy.config.exec_thread.autoconfig INT 1 +CONFIG proxy.config.exec_thread.autoconfig.scale FLOAT 1.0 +CONFIG proxy.config.exec_thread.limit INT 2 +CONFIG proxy.config.exec_thread.affinity INT 1 +CONFIG proxy.config.exec_thread.listen INT 0 +CONFIG proxy.config.accept_threads INT 1 +CONFIG proxy.config.task_threads INT 2 +CONFIG proxy.config.thread.default.stacksize INT 1048576 +CONFIG proxy.config.thread.default.stackguard_pages INT 1 +CONFIG proxy.config.restart.active_client_threshold INT 0 +CONFIG proxy.config.restart.stop_listening INT 0 +CONFIG proxy.config.stop.shutdown_timeout INT 0 +CONFIG proxy.config.thread.max_heartbeat_mseconds INT 60 +CONFIG proxy.config.srv_enabled INT 0 +CONFIG proxy.config.http.cache.ignore_accept_mismatch INT 2 +CONFIG proxy.config.http.cache.ignore_accept_language_mismatch INT 2 +CONFIG proxy.config.http.cache.ignore_accept_encoding_mismatch INT 2 +CONFIG proxy.config.http.cache.ignore_accept_charset_mismatch INT 2 +CONFIG proxy.config.http.websocket.max_number_of_connections INT -1 +CONFIG proxy.config.http.number_of_redirections INT 0 +CONFIG proxy.config.http.redirect_use_orig_cache_key INT 0 +CONFIG proxy.config.http.redirect_host_no_port INT 1 +CONFIG proxy.config.http.post_copy_size INT 2048 +CONFIG proxy.config.http.redirect.actions STRING routable:follow +CONFIG proxy.config.diags.debug.enabled INT 0 +CONFIG proxy.config.diags.debug.tags STRING http|dns +CONFIG proxy.config.diags.debug.throttling_interval_msec INT 0 +CONFIG proxy.config.diags.action.enabled INT 0 +CONFIG proxy.config.diags.show_location INT 1 +CONFIG proxy.config.diags.output.diag STRING E +CONFIG proxy.config.diags.output.debug STRING E +CONFIG proxy.config.diags.output.status STRING L +CONFIG proxy.config.diags.output.note STRING L +CONFIG proxy.config.diags.output.warning STRING L +CONFIG proxy.config.diags.output.error STRING L +CONFIG proxy.config.diags.output.fatal STRING L +CONFIG proxy.config.diags.output.alert STRING L +CONFIG proxy.config.diags.output.emergency STRING L +CONFIG proxy.config.diags.logfile_perm STRING rw-r--r-- +CONFIG proxy.config.diags.logfile.filename STRING diags.log +CONFIG proxy.config.diags.logfile.rolling_enabled INT 0 +CONFIG proxy.config.diags.logfile.rolling_interval_sec INT 3600 +CONFIG proxy.config.diags.logfile.rolling_size_mb INT 10 +CONFIG proxy.config.diags.logfile.rolling_min_count INT 0 +CONFIG proxy.config.error.logfile.filename STRING error.log +CONFIG proxy.config.udp.free_cancelled_pkts_sec INT 10 +CONFIG proxy.config.udp.periodic_cleanup INT 10 +CONFIG proxy.config.udp.send_retries INT 0 +CONFIG proxy.config.udp.threads INT 0 +CONFIG proxy.config.udp.enable_gso INT 0 +CONFIG proxy.config.alarm.bin STRING example_alarm_bin.sh +CONFIG proxy.config.alarm.abs_path STRING nullpt +CONFIG proxy.config.alarm.script_runtime INT 5 +CONFIG proxy.config.http.allow_half_open INT 1 +CONFIG proxy.config.http.enabled INT 1 +CONFIG proxy.config.http.server_ports STRING 80 +CONFIG proxy.config.http.wait_for_cache INT 0 +CONFIG proxy.config.http.insert_request_via_str INT 1 +CONFIG proxy.config.http.insert_response_via_str INT 0 +CONFIG proxy.config.http.request_via_str STRING ApacheTrafficServer +CONFIG proxy.config.http.response_via_str STRING ApacheTrafficServer +CONFIG proxy.config.http.response_server_enabled INT 1 +CONFIG proxy.config.http.response_server_str STRING ATS/ +CONFIG proxy.config.http.no_dns_just_forward_to_parent INT 0 +CONFIG proxy.config.http.uncacheable_requests_bypass_parent INT 1 +CONFIG proxy.config.http.no_origin_server_dns INT 0 +CONFIG proxy.config.http.use_client_target_addr INT 0 +CONFIG proxy.config.http.use_client_source_port INT 0 +CONFIG proxy.config.http.keep_alive_enabled_in INT 1 +CONFIG proxy.config.http.keep_alive_enabled_out INT 1 +CONFIG proxy.config.http.keep_alive_post_out INT 1 +CONFIG proxy.config.http.request_buffer_enabled INT 0 +CONFIG proxy.config.http.chunking_enabled INT 1 +CONFIG proxy.config.http.chunking.size INT 4096 +CONFIG proxy.config.http.flow_control.enabled INT 0 +CONFIG proxy.config.http.flow_control.high_water INT 0 +CONFIG proxy.config.http.flow_control.low_water INT 0 +CONFIG proxy.config.http.post.check.content_length.enabled INT 1 +CONFIG proxy.config.http.strict_uri_parsing INT 2 +CONFIG proxy.config.http.send_http11_requests INT 1 +CONFIG proxy.config.http.send_100_continue_response INT 0 +CONFIG proxy.config.http.disallow_post_100_continue INT 0 +CONFIG proxy.config.http.server_session_sharing.match STRING both +CONFIG proxy.config.http.server_session_sharing.pool STRING thread +CONFIG proxy.config.http.default_buffer_size INT 8 +CONFIG proxy.config.http.default_buffer_water_mark INT 32768 +CONFIG proxy.config.plugin.vc.default_buffer_index INT 8 +CONFIG proxy.config.plugin.vc.default_buffer_water_mark INT 0 +CONFIG proxy.config.http.enable_http_info INT 0 +CONFIG proxy.config.http.server_max_connections INT 0 +CONFIG proxy.config.http.per_server.connection.max INT 0 +CONFIG proxy.config.http.per_server.connection.match STRING both +CONFIG proxy.config.http.per_server.connection.alert_delay INT 60 +CONFIG proxy.config.http.per_server.connection.min INT 0 +CONFIG proxy.config.http.attach_server_session_to_client INT 0 +CONFIG proxy.config.http.max_proxy_cycles INT 0 +CONFIG proxy.config.net.max_connections_in INT 30000 +CONFIG proxy.config.net.max_requests_in INT 0 +CONFIG proxy.config.http.referer_filter INT 0 +CONFIG proxy.config.http.referer_format_redirect INT 0 +CONFIG proxy.config.http.referer_default_redirect STRING http://www.example.com/ +CONFIG proxy.config.http.auth_server_session_private INT 1 +CONFIG proxy.config.http.max_post_size INT 0 +CONFIG proxy.config.http.parent_proxies STRING nullpt +CONFIG proxy.config.http.parent_proxy.retry_time INT 300 +CONFIG proxy.config.http.parent_proxy.fail_threshold INT 10 +CONFIG proxy.config.http.parent_proxy.total_connect_attempts INT 4 +CONFIG proxy.config.http.parent_proxy.per_parent_connect_attempts INT 2 +CONFIG proxy.config.http.parent_proxy.mark_down_hostdb INT 0 +CONFIG proxy.config.http.parent_proxy.self_detect INT 2 +CONFIG proxy.config.http.parent_proxy.enable_parent_timeout_markdowns INT 0 +CONFIG proxy.config.http.parent_proxy.disable_parent_markdowns INT 0 +CONFIG proxy.config.http.forward.proxy_auth_to_parent INT 0 +CONFIG proxy.config.http.doc_in_cache_skip_dns INT 1 +CONFIG proxy.config.http.keep_alive_no_activity_timeout_in INT 120 +CONFIG proxy.config.http.keep_alive_no_activity_timeout_out INT 120 +CONFIG proxy.config.websocket.no_activity_timeout INT 600 +CONFIG proxy.config.websocket.active_timeout INT 3600 +CONFIG proxy.config.http.transaction_no_activity_timeout_in INT 30 +CONFIG proxy.config.http.transaction_no_activity_timeout_out INT 30 +CONFIG proxy.config.http.transaction_active_timeout_in INT 900 +CONFIG proxy.config.http.transaction_active_timeout_out INT 0 +CONFIG proxy.config.http.accept_no_activity_timeout INT 120 +CONFIG proxy.config.http.background_fill_active_timeout INT 0 +CONFIG proxy.config.http.background_fill_completed_threshold FLOAT 0.0 +CONFIG proxy.config.http.connect_attempts_max_retries INT 3 +CONFIG proxy.config.http.connect_attempts_max_retries_dead_server INT 1 +CONFIG proxy.config.http.connect_attempts_rr_retries INT 3 +CONFIG proxy.config.http.connect_attempts_timeout INT 30 +CONFIG proxy.config.http.connect.dead.policy INT 2 +CONFIG proxy.config.http.down_server.cache_time INT 60 +CONFIG proxy.config.http.negative_revalidating_enabled INT 1 +CONFIG proxy.config.http.negative_revalidating_lifetime INT 1800 +CONFIG proxy.config.http.negative_caching_enabled INT 0 +CONFIG proxy.config.http.negative_caching_lifetime INT 1800 +CONFIG proxy.config.http.negative_caching_list STRING 2 +CONFIG proxy.config.http.anonymize_remove_from INT 0 +CONFIG proxy.config.http.anonymize_remove_referer INT 0 +CONFIG proxy.config.http.anonymize_remove_user_agent INT 0 +CONFIG proxy.config.http.anonymize_remove_cookie INT 0 +CONFIG proxy.config.http.anonymize_remove_client_ip INT 0 +CONFIG proxy.config.http.insert_client_ip INT 1 +CONFIG proxy.config.http.insert_squid_x_forwarded_for INT 1 +CONFIG proxy.config.http.insert_forwarded STRING none +CONFIG proxy.config.http.proxy_protocol_allowlist STRING none +CONFIG proxy.config.http.proxy_protocol_out INT -1 +CONFIG proxy.config.http.insert_age_in_response INT 1 +CONFIG proxy.config.http.enable_http_stats INT 1 +CONFIG proxy.config.http.allow_multi_range INT 0 +CONFIG proxy.config.http.normalize_ae INT 1 +CONFIG proxy.config.http.request_line_max_size INT 65535 +CONFIG proxy.config.http.header_field_max_size INT 131070 +CONFIG proxy.config.http.request_header_max_size INT 131072 +CONFIG proxy.config.http.response_header_max_size INT 131072 +CONFIG proxy.config.http.push_method_enabled INT 0 +CONFIG proxy.config.http.cache.http INT 1 +CONFIG proxy.config.http.cache.generation INT -1 +CONFIG proxy.config.http.cache.ignore_client_no_cache INT 1 +CONFIG proxy.config.http.cache.ignore_client_cc_max_age INT 1 +CONFIG proxy.config.http.cache.ims_on_client_no_cache INT 1 +CONFIG proxy.config.http.cache.ignore_server_no_cache INT 0 +CONFIG proxy.config.http.cache.cache_responses_to_cookies INT 1 +CONFIG proxy.config.http.cache.ignore_authentication INT 0 +CONFIG proxy.config.http.cache.cache_urls_that_look_dynamic INT 1 +CONFIG proxy.config.http.cache.post_method INT 0 +CONFIG proxy.config.http.cache.max_open_read_retries INT -1 +CONFIG proxy.config.http.cache.open_read_retry_time INT 10 +CONFIG proxy.config.http.cache.max_open_write_retries INT 1 +CONFIG proxy.config.http.cache.open_write_fail_action INT 0 +CONFIG proxy.config.http.cache.when_to_revalidate INT 0 +CONFIG proxy.config.http.cache.required_headers INT 2 +CONFIG proxy.config.http.cache.max_stale_age INT 604800 +CONFIG proxy.config.http.cache.range.lookup INT 1 +CONFIG proxy.config.http.cache.range.write INT 0 +CONFIG proxy.config.http.cache.heuristic_min_lifetime INT 3600 +CONFIG proxy.config.http.cache.heuristic_max_lifetime INT 86400 +CONFIG proxy.config.http.cache.heuristic_lm_factor FLOAT 0.10 +CONFIG proxy.config.http.cache.guaranteed_min_lifetime INT 0 +CONFIG proxy.config.http.cache.guaranteed_max_lifetime INT 31536000 +CONFIG proxy.config.http.errors.log_error_pages INT 1 +CONFIG proxy.config.http.slow.log.threshold INT 0 +CONFIG proxy.config.http2.connection.slow.log.threshold INT 0 +CONFIG proxy.config.http2.stream.slow.log.threshold INT 0 +CONFIG proxy.config.body_factory.enable_customizations INT 1 +CONFIG proxy.config.body_factory.enable_logging INT 0 +CONFIG proxy.config.body_factory.response_max_size INT 8192 +CONFIG proxy.config.body_factory.response_suppression_mode INT 0 +CONFIG proxy.config.body_factory.template_base STRING NONE +CONFIG proxy.config.socks.socks_needed INT 0 +CONFIG proxy.config.socks.socks_version INT 4 +CONFIG proxy.config.socks.socks_timeout INT 100 +CONFIG proxy.config.socks.server_connect_timeout INT 10 +CONFIG proxy.config.socks.per_server_connection_attempts INT 1 +CONFIG proxy.config.socks.connection_attempts INT 4 +CONFIG proxy.config.socks.server_retry_timeout INT 300 +CONFIG proxy.config.socks.default_servers STRING val +CONFIG proxy.config.socks.server_retry_time INT 300 +CONFIG proxy.config.socks.server_fail_threshold INT 2 +CONFIG proxy.config.socks.accept_enabled INT 0 +CONFIG proxy.config.socks.accept_port INT 1080 +CONFIG proxy.config.socks.http_port INT 80 +CONFIG proxy.config.ssl.misc.io.max_buffer_index INT 8 +CONFIG proxy.config.hostdb.io.max_buffer_index INT 8 +CONFIG proxy.config.payload.io.max_buffer_index INT 8 +CONFIG proxy.config.msg.io.max_buffer_index INT 8 +CONFIG proxy.config.log.io.max_buffer_index INT 8 +CONFIG proxy.config.net.connections_throttle INT 30000 +CONFIG proxy.config.net.listen_backlog INT -1 +CONFIG proxy.config.net.defer_accept INT 1 +CONFIG proxy.config.net.sock_recv_buffer_size_in INT 0 +CONFIG proxy.config.net.sock_send_buffer_size_in INT 0 +CONFIG proxy.config.net.sock_option_flag_in INT 0x1 +CONFIG proxy.config.net.sock_packet_mark_in INT 0x0 +CONFIG proxy.config.net.sock_packet_tos_in INT 0x0 +CONFIG proxy.config.net.sock_recv_buffer_size_out INT 0 +CONFIG proxy.config.net.sock_send_buffer_size_out INT 0 +CONFIG proxy.config.net.sock_option_flag_out INT 0x1 +CONFIG proxy.config.net.sock_packet_mark_out INT 0x0 +CONFIG proxy.config.net.sock_packet_tos_out INT 0x0 +CONFIG proxy.config.net.sock_mss_in INT 0 +CONFIG proxy.config.net.sock_notsent_lowat INT 32768 +CONFIG proxy.config.net.poll_timeout INT 10 +CONFIG proxy.config.net.default_inactivity_timeout INT 86400 +CONFIG proxy.config.net.inactivity_check_frequency INT 1 +CONFIG proxy.config.net.event_period INT 10 +CONFIG proxy.config.net.accept_period INT 10 +CONFIG proxy.config.net.retry_delay INT 10 +CONFIG proxy.config.net.throttle_delay INT 50 +CONFIG proxy.config.net.sock_option_tfo_queue_size_in INT 10000 +CONFIG proxy.config.net.tcp_congestion_control_in STRING val +CONFIG proxy.config.net.tcp_congestion_control_out STRING val +CONFIG proxy.config.cache.hit_evacuate_percent INT 0 +CONFIG proxy.config.cache.hit_evacuate_size_limit INT 0 +CONFIG proxy.config.cache.permit.pinning INT 0 +CONFIG proxy.config.cache.ram_cache.size INT -1 +CONFIG proxy.config.cache.ram_cache.algorithm INT 1 +CONFIG proxy.config.cache.ram_cache.use_seen_filter INT 1 +CONFIG proxy.config.cache.ram_cache.compress INT 0 +CONFIG proxy.config.cache.ram_cache.compress_percent INT 90 +CONFIG proxy.config.cache.dir.sync_frequency INT 60 +CONFIG proxy.config.cache.hostdb.disable_reverse_lookup INT 0 +CONFIG proxy.config.cache.select_alternate INT 1 +CONFIG proxy.config.cache.ram_cache_cutoff INT 4194304 +CONFIG proxy.config.cache.limits.http.max_alts INT 5 +CONFIG proxy.config.cache.log.alternate.eviction INT 0 +CONFIG proxy.config.cache.force_sector_size INT 0 +CONFIG proxy.config.cache.target_fragment_size INT 1048576 +CONFIG proxy.config.cache.max_doc_size INT 0 +CONFIG proxy.config.cache.min_average_object_size INT 8000 +CONFIG proxy.config.cache.threads_per_disk INT 8 +CONFIG proxy.config.cache.agg_write_backlog INT 5242880 +CONFIG proxy.config.cache.enable_checksum INT 0 +CONFIG proxy.config.cache.alt_rewrite_max_size INT 4096 +CONFIG proxy.config.cache.enable_read_while_writer INT 1 +CONFIG proxy.config.cache.mutex_retry_delay INT 2 +CONFIG proxy.config.cache.read_while_writer.max_retries INT 10 +CONFIG proxy.config.cache.read_while_writer_retry.delay INT 50 +CONFIG proxy.config.dns.lookup_timeout INT 20 +CONFIG proxy.config.dns.retries INT 5 +CONFIG proxy.config.dns.search_default_domains INT 0 +CONFIG proxy.config.dns.failover_number INT 5 +CONFIG proxy.config.dns.failover_period INT 60 +CONFIG proxy.config.dns.max_dns_in_flight INT 2048 +CONFIG proxy.config.dns.max_tcp_continuous_failures INT 10 +CONFIG proxy.config.dns.validate_query_name INT 0 +CONFIG proxy.config.dns.splitDNS.enabled INT 0 +CONFIG proxy.config.dns.nameservers STRING nullptr +CONFIG proxy.config.dns.local_ipv6 STRING nullptr +CONFIG proxy.config.dns.local_ipv4 STRING nullptr +CONFIG proxy.config.dns.resolv_conf STRING /etc/resolv.conf +CONFIG proxy.config.dns.round_robin_nameservers INT 1 +CONFIG proxy.config.dns.dedicated_thread INT 0 +CONFIG proxy.config.dns.connection_mode INT 0 +CONFIG proxy.config.hostdb.ip_resolve STRING nullptr +CONFIG proxy.config.hostdb INT 1 +CONFIG proxy.config.hostdb.filename STRING host.db +CONFIG proxy.config.hostdb.max_count INT -1 +CONFIG proxy.config.hostdb.round_robin_max_count INT 16 +CONFIG proxy.config.hostdb.max_size INT 10M +CONFIG proxy.config.hostdb.partitions INT 64 +CONFIG proxy.config.hostdb.ttl_mode INT 0 +CONFIG proxy.config.hostdb.lookup_timeout INT 30 +CONFIG proxy.config.hostdb.timeout INT 86400 +CONFIG proxy.config.hostdb.verify_after INT 720 +CONFIG proxy.config.hostdb.fail.timeout INT 0 +CONFIG proxy.config.hostdb.re_dns_on_reload INT 0 +CONFIG proxy.config.hostdb.serve_stale_for INT 0 +CONFIG proxy.config.hostdb.migrate_on_demand INT 0 +CONFIG proxy.config.hostdb.strict_round_robin INT 0 +CONFIG proxy.config.hostdb.timed_round_robin INT 0 +CONFIG proxy.config.cache.hostdb.sync_frequency INT 0 +CONFIG proxy.config.hostdb.host_file.path STRING nullptr +CONFIG proxy.config.hostdb.host_file.interval INT 86400 +CONFIG proxy.config.tunnel.activity_check_period INT 0 +CONFIG proxy.config.tunnel.prewarm INT 0 +CONFIG proxy.config.tunnel.prewarm.max_stats_size INT 100 +CONFIG proxy.config.tunnel.prewarm.event_period INT 1000 +CONFIG proxy.config.tunnel.prewarm.algorithm INT 2 +CONFIG proxy.config.http.connect_ports STRING 443 +CONFIG proxy.config.config_update_interval_ms INT 3000 +CONFIG proxy.config.raw_stat_sync_interval_ms INT 5000 +CONFIG proxy.config.remote_sync_interval_ms INT 5000 +CONFIG proxy.config.log.logging_enabled INT 3 +CONFIG proxy.config.log.log_buffer_size INT 9216 +CONFIG proxy.config.log.log_fast_buffer INT 0 +CONFIG proxy.config.log.max_secs_per_buffer INT 5 +CONFIG proxy.config.log.max_space_mb_for_logs INT 25000 +CONFIG proxy.config.log.max_space_mb_headroom INT 1000 +CONFIG proxy.config.log.hostname STRING localhost +CONFIG proxy.config.log.logfile_perm STRING rw-r--r-- +CONFIG proxy.config.log.preproc_threads INT 1 +CONFIG proxy.config.log.rolling_enabled INT 1 +CONFIG proxy.config.log.rolling_interval_sec INT 86400 +CONFIG proxy.config.log.rolling_offset_hr INT 0 +CONFIG proxy.config.log.rolling_size_mb INT 10 +CONFIG proxy.config.log.rolling_min_count INT 0 +CONFIG proxy.config.log.rolling_max_count INT 0 +CONFIG proxy.config.log.rolling_allow_empty INT 0 +CONFIG proxy.config.log.auto_delete_rolled_files INT 1 +CONFIG proxy.config.log.sampling_frequency INT 1 +CONFIG proxy.config.log.space_used_frequency INT 2 +CONFIG proxy.config.log.file_stat_frequency INT 32 +CONFIG proxy.config.log.ascii_buffer_size INT 36864 +CONFIG proxy.config.log.max_line_size INT 9216 +CONFIG proxy.config.log.periodic_tasks_interval INT 5 +CONFIG proxy.config.log.throttling_interval_msec INT 60000 +CONFIG proxy.config.reverse_proxy.enabled INT 1 +CONFIG proxy.config.url_remap.strategies.filename STRING strategies.yaml +CONFIG proxy.config.url_remap.remap_required INT 1 +CONFIG proxy.config.url_remap.pristine_host_hdr INT 0 +CONFIG proxy.config.plugin.dynamic_reload_mode INT 1 +CONFIG proxy.config.url_remap.min_rules_required INT 0 +CONFIG proxy.config.ssl.server.session_ticket.enable INT 1 +CONFIG proxy.config.ssl.server.session_ticket.number INT 2 +CONFIG proxy.config.ssl.TLSv1 INT 0 +CONFIG proxy.config.ssl.TLSv1_1 INT 0 +CONFIG proxy.config.ssl.TLSv1_2 INT 1 +CONFIG proxy.config.ssl.TLSv1_3 INT 1 +CONFIG proxy.config.ssl.client.TLSv1 INT 0 +CONFIG proxy.config.ssl.client.TLSv1_1 INT 0 +CONFIG proxy.config.ssl.client.TLSv1_2 INT 1 +CONFIG proxy.config.ssl.client.TLSv1_3 INT 1 +CONFIG proxy.config.ssl.server.cipher_suite STRING ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-CCM:ECDHE-ECDSA-AES128-CCM:ECDHE-ECDSA-AES256-CCM8:ECDHE-ECDSA-AES128-CCM8:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-CCM8:DHE-RSA-AES128-CCM8:DHE-RSA-AES256-CCM:DHE-RSA-AES128-CCM:DHE-RSA-AES256-SHA256:DHE-RSA-AES128-SHA256:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-CCM8:AES128-CCM8:AES256-CCM:AES128-CCM:AES256-SHA256:AES128-SHA2 +CONFIG proxy.config.ssl.client.cipher_suite STRING ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-CCM8:ECDHE-ECDSA-AES256-CCM:DHE-RSA-AES256-CCM8:DHE-RSA-AES256-CCM:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-ARIA256-GCM-SHA384:ECDHE-ARIA256-GCM-SHA384:DHE-DSS-ARIA256-GCM-SHA384:DHE-RSA-ARIA256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:ECDHE-ECDSA-CAMELLIA256-SHA384:ECDHE-RSA-CAMELLIA256-SHA384:DHE-RSA-CAMELLIA256-SHA256:DHE-DSS-CAMELLIA256-SHA256:RSA-PSK-AES256-GCM-SHA384:RSA-PSK-CHACHA20-POLY1305:RSA-PSK-ARIA256-GCM-SHA384:AES256-GCM-SHA384:AES256-CCM8:AES256-CCM:ARIA256-GCM-SHA384:AES256-SHA256:CAMELLIA256-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:DHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-CCM8:ECDHE-ECDSA-AES128-CCM:DHE-RSA-AES128-CCM8:DHE-RSA-AES128-CCM:ECDHE-ECDSA-ARIA128-GCM-SHA256:ECDHE-ARIA128-GCM-SHA256:DHE-DSS-ARIA128-GCM-SHA256:DHE-RSA-ARIA128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:ECDHE-ECDSA-CAMELLIA128-SHA256:ECDHE-RSA-CAMELLIA128-SHA256:DHE-RSA-CAMELLIA128-SHA256:DHE-DSS-CAMELLIA128-SHA256:RSA-PSK-AES128-GCM-SHA256:RSA-PSK-ARIA128-GCM-SHA256:AES128-GCM-SHA256:AES128-CCM8:AES128-CCM:ARIA128-GCM-SHA256:AES128-SHA256:CAMELLIA128-SHA256 +CONFIG proxy.config.ssl.server.honor_cipher_order INT 1 +CONFIG proxy.config.ssl.server.prioritize_chacha INT 0 +CONFIG proxy.config.ssl.client.certification_level INT 0 +CONFIG proxy.config.ssl.client.alpn_protocols STRING nullptr +CONFIG proxy.config.ssl.server.cert_chain.filename STRING nullptr +CONFIG proxy.config.ssl.server.multicert.exit_on_load_fail INT 1 +CONFIG proxy.config.ssl.server.ticket_key.filename STRING nullptr +CONFIG proxy.config.ssl.CA.cert.filename STRING nullptr +CONFIG proxy.config.ssl.client.verify.server.policy STRING ENFORCED +CONFIG proxy.config.ssl.client.verify.server.properties STRING ALL +CONFIG proxy.config.ssl.client.cert.filename STRING nullptr +CONFIG proxy.config.ssl.client.private_key.filename STRING nullptr +CONFIG proxy.config.ssl.client.CA.cert.filename STRING nullptr +CONFIG proxy.config.ssl.client.sni_policy STRING host +CONFIG proxy.config.ssl.client.scheme_proto_mismatch_policy INT 2 +CONFIG proxy.config.ssl.origin_session_cache INT 1 +CONFIG proxy.config.ssl.origin_session_cache.size INT 10240 +CONFIG proxy.config.ssl.session_cache INT 2 +CONFIG proxy.config.ssl.session_cache.size INT 102400 +CONFIG proxy.config.ssl.session_cache.num_buckets INT 256 +CONFIG proxy.config.ssl.session_cache.skip_cache_on_bucket_contention INT 0 +CONFIG proxy.config.ssl.max_record_size INT 0 +CONFIG proxy.config.ssl.session_cache.timeout INT 0 +CONFIG proxy.config.ssl.session_cache.auto_clear INT 1 +CONFIG proxy.config.ssl.hsts_max_age INT -1 +CONFIG proxy.config.ssl.hsts_include_subdomains INT 0 +CONFIG proxy.config.ssl.allow_client_renegotiation INT 0 +CONFIG proxy.config.ssl.server.dhparams_file STRING nullptr +CONFIG proxy.config.ssl.handshake_timeout_in INT 30 +CONFIG proxy.config.ssl.cert.load_elevated INT 0 +CONFIG proxy.config.ssl.server.groups_list STRING nullptr +CONFIG proxy.config.ssl.client.groups_list STRING nullptr +CONFIG proxy.config.ssl.server.max_early_data INT 0 +CONFIG proxy.config.ssl.server.allow_early_data_params INT 0 +CONFIG proxy.config.ssl.keylog_file STRING nullptr +CONFIG proxy.config.ssl.ktls.enabled INT 0 +CONFIG proxy.config.ssl.ocsp.enabled INT 0 +CONFIG proxy.config.ssl.ocsp.cache_timeout INT 3600 +CONFIG proxy.config.ssl.ocsp.request_timeout INT 10 +CONFIG proxy.config.ssl.ocsp.update_period INT 60 +CONFIG proxy.config.ssl.server.TLSv1_3.cipher_suites STRING TLS_AES_256_GCM_SHA384:TLS_AES_128_GCM_SHA256:TLS_CHACHA20_POLY1305_SHA256 +CONFIG proxy.config.ssl.client.TLSv1_3.cipher_suites STRING TLS_AES_256_GCM_SHA384:TLS_AES_128_GCM_SHA256:TLS_CHACHA20_POLY1305_SHA256 +CONFIG proxy.config.wccp.addr STRING some +CONFIG proxy.config.wccp.services STRING some +CONFIG proxy.config.plugin.load_elevated INT 0 +CONFIG proxy.config.http.parent_proxy.disable_connect_tunneling INT 0 +CONFIG proxy.config.http.forward_connect_method INT 0 +CONFIG proxy.config.http2.stream_priority_enabled INT 0 +CONFIG proxy.config.http2.max_concurrent_streams_in INT 100 +CONFIG proxy.config.http2.min_concurrent_streams_in INT 10 +CONFIG proxy.config.http2.max_active_streams_in INT 0 +CONFIG proxy.config.http2.initial_window_size_in INT 65535 +CONFIG proxy.config.http2.max_frame_size INT 16384 +CONFIG proxy.config.http2.header_table_size INT 4096 +CONFIG proxy.config.http2.max_header_list_size INT 131072 +CONFIG proxy.config.http2.accept_no_activity_timeout INT 120 +CONFIG proxy.config.http2.no_activity_timeout_in INT 120 +CONFIG proxy.config.http2.active_timeout_in INT 0 +CONFIG proxy.config.http2.push_diary_size INT 256 +CONFIG proxy.config.http2.zombie_debug_timeout_in INT 0 +CONFIG proxy.config.http2.stream_error_rate_threshold FLOAT 0.1 +CONFIG proxy.config.http2.stream_error_sampling_threshold INT 10 +CONFIG proxy.config.http2.max_settings_per_frame INT 7 +CONFIG proxy.config.http2.max_settings_per_minute INT 14 +CONFIG proxy.config.http2.max_settings_frames_per_minute INT 14 +CONFIG proxy.config.http2.max_ping_frames_per_minute INT 60 +CONFIG proxy.config.http2.max_priority_frames_per_minute INT 120 +CONFIG proxy.config.http2.min_avg_window_update FLOAT 2560.0 +CONFIG proxy.config.http2.header_table_size_limit INT 65536 +CONFIG proxy.config.http2.write_buffer_block_size INT 262144 +CONFIG proxy.config.http2.write_size_threshold FLOAT 0.5 +CONFIG proxy.config.http2.write_time_threshold INT 100 +CONFIG proxy.config.http2.default_buffer_water_mark INT -1 +CONFIG proxy.config.http3.header_table_size INT 0 +CONFIG proxy.config.http3.max_header_list_size INT 4096 +CONFIG proxy.config.http3.qpack_blocked_streams INT 0 +CONFIG proxy.config.http3.num_placeholders INT 100 +CONFIG proxy.config.http3.max_settings INT 10 +CONFIG proxy.config.quic.instance_id INT 0 +CONFIG proxy.config.quic.connection_table.size INT 65521 +CONFIG proxy.config.quic.num_alt_connection_ids INT 8 +CONFIG proxy.config.quic.server.stateless_retry_enabled INT 0 +CONFIG proxy.config.quic.client.vn_exercise_enabled INT 0 +CONFIG proxy.config.quic.client.cm_exercise_enabled INT 0 +CONFIG proxy.config.quic.client.quantum_readiness_test_enabled INT 0 +CONFIG proxy.config.quic.server.quantum_readiness_test_enabled INT 0 +CONFIG proxy.config.quic.server.supported_groups STRING P-256:X25519:P-384:P-52 +CONFIG proxy.config.quic.client.supported_groups STRING P-256:X25519:P-384:P-52 +CONFIG proxy.config.quic.client.session_file STRING nullptr +CONFIG proxy.config.quic.qlog_dir STRING nullptr +CONFIG proxy.config.quic.no_activity_timeout_in INT 30000 +CONFIG proxy.config.quic.no_activity_timeout_out INT 30000 +CONFIG proxy.config.quic.preferred_address_ipv4 STRING nullptr +CONFIG proxy.config.quic.preferred_address_ipv6 STRING nullptr +CONFIG proxy.config.quic.initial_max_data_in INT 65536 +CONFIG proxy.config.quic.initial_max_data_out INT 65536 +CONFIG proxy.config.quic.initial_max_stream_data_bidi_local_in INT 0 +CONFIG proxy.config.quic.initial_max_stream_data_bidi_local_out INT 4096 +CONFIG proxy.config.quic.initial_max_stream_data_bidi_remote_in INT 4096 +CONFIG proxy.config.quic.initial_max_stream_data_bidi_remote_out INT 0 +CONFIG proxy.config.quic.initial_max_stream_data_uni_in INT 4096 +CONFIG proxy.config.quic.initial_max_stream_data_uni_out INT 4096 +CONFIG proxy.config.quic.initial_max_streams_bidi_in INT 100 +CONFIG proxy.config.quic.initial_max_streams_bidi_out INT 100 +CONFIG proxy.config.quic.initial_max_streams_uni_in INT 100 +CONFIG proxy.config.quic.initial_max_streams_uni_out INT 100 +CONFIG proxy.config.quic.ack_delay_exponent_in INT 3 +CONFIG proxy.config.quic.ack_delay_exponent_out INT 3 +CONFIG proxy.config.quic.max_ack_delay_in INT 25 +CONFIG proxy.config.quic.max_ack_delay_out INT 25 +CONFIG proxy.config.quic.active_cid_limit_in INT 4 +CONFIG proxy.config.quic.active_cid_limit_out INT 8 +CONFIG proxy.config.quic.disable_active_migration INT 0 +CONFIG proxy.config.quic.loss_detection.packet_threshold INT 3 +CONFIG proxy.config.quic.loss_detection.time_threshold FLOAT 1.25 +CONFIG proxy.config.quic.loss_detection.granularity INT 1 +CONFIG proxy.config.quic.loss_detection.initial_rtt INT 500 +CONFIG proxy.config.quic.congestion_control.max_datagram_size INT 1200 +CONFIG proxy.config.quic.congestion_control.initial_window INT 12000 +CONFIG proxy.config.quic.congestion_control.minimum_window INT 2400 +CONFIG proxy.config.quic.congestion_control.loss_reduction_factor FLOAT 0.5 +CONFIG proxy.config.quic.congestion_control.persistent_congestion_threshold INT 3 +CONFIG proxy.config.incoming_ip_to_bind STRING nullptr +CONFIG proxy.config.outgoing_ip_to_bind STRING nullptr +CONFIG proxy.config.stat_api.max_stats_allowed INT 256 +CONFIG proxy.config.allocator.thread_freelist_size INT 512 +CONFIG proxy.config.allocator.thread_freelist_low_watermark INT 32 +CONFIG proxy.config.allocator.hugepages INT 0 +CONFIG proxy.config.allocator.dontdump_iobuffers INT 1 +CONFIG proxy.config.ssl.async.handshake.enabled INT 0 +CONFIG proxy.config.ssl.engine.conf_file STRING nullptr +CONFIG proxy.config.http.host_sni_policy INT 2 diff --git a/tests/gold_tests/records/legacy_config/old_records.config b/tests/gold_tests/records/legacy_config/old_records.config new file mode 100644 index 00000000000..63de6b11c89 --- /dev/null +++ b/tests/gold_tests/records/legacy_config/old_records.config @@ -0,0 +1,9 @@ +# Only records that will be renamed. +CONFIG proxy.config.output.logfile STRING traffic.out +CONFIG proxy.config.exec_thread.autoconfig INT 1 +CONFIG proxy.config.hostdb INT 1 +CONFIG proxy.config.tunnel.prewarm INT 0 +CONFIG proxy.config.ssl.origin_session_cache INT 0 +CONFIG proxy.config.ssl.session_cache INT 0 +CONFIG proxy.config.ssl.TLSv1_3 INT 0 +CONFIG proxy.config.ssl.client.TLSv1_3 INT 0 diff --git a/tests/gold_tests/records/old_config_fail.test.py b/tests/gold_tests/records/old_config_fail.test.py new file mode 100644 index 00000000000..66ffa6a188d --- /dev/null +++ b/tests/gold_tests/records/old_config_fail.test.py @@ -0,0 +1,32 @@ +''' +''' +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you 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. + +Test.Summary = 'Test old config ATS startup' + +ts = Test.MakeATSProcess("ts") +ts.Disk.MakeConfigFile('records.config').AddLine('dummy file!') + + +tr = Test.AddTestRun("Start ATS with both, new(yaml) and legacy records config") +tr.Processes.Default.Command = 'echo 1' +tr.Processes.Default.ReturnCode = 0 +tr.Processes.Default.StartBefore(ts) + +ts.Disk.traffic_out.Content = Testers.ContainsExpression( + "WARNING: Found a legacy config file", + "It should fail when legacy config is found.") diff --git a/tests/gold_tests/records/records_config_to_yaml.test.py b/tests/gold_tests/records/records_config_to_yaml.test.py new file mode 100644 index 00000000000..7b160eb218d --- /dev/null +++ b/tests/gold_tests/records/records_config_to_yaml.test.py @@ -0,0 +1,43 @@ +''' +''' +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you 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. +import os +import yaml + +Test.Summary = 'Testing ATS records to yaml script.' + + +file_suffix = 1 + +# case 1 TLS with no data +tr = Test.AddTestRun("Test records to yaml convert script - full file") + +tr.Setup.Copy(os.path.join(Test.Variables.BuildRoot, "tools/records/convert2yaml.py")) +tr.Setup.Copy('legacy_config/full_records.config') +tr.Processes.Default.Command = f'python3 convert2yaml.py -f full_records.config --save2 generated{file_suffix}.yaml --yaml --mute' +f = tr.Disk.File(f"generated{file_suffix}.yaml") +f.Content = "gold/full_records.yaml" + +file_suffix = file_suffix + 1 + +tr = Test.AddTestRun("Test records to yaml convert script -only renamed records.") +tr.Setup.Copy(os.path.join(Test.Variables.BuildRoot, "tools/records/convert2yaml.py")) +tr.Setup.Copy('legacy_config/old_records.config') +tr.Processes.Default.Command = f'python3 convert2yaml.py -f old_records.config --save2 generated{file_suffix}.yaml --yaml' +tr.Processes.Default.Stream = 'gold/renamed_records.out' +f = tr.Disk.File(f"generated{file_suffix}.yaml") +f.Content = "gold/renamed_records.yaml" diff --git a/tests/gold_tests/records/records_yaml.test.py b/tests/gold_tests/records/records_yaml.test.py new file mode 100644 index 00000000000..e00a5e3f8c2 --- /dev/null +++ b/tests/gold_tests/records/records_yaml.test.py @@ -0,0 +1,108 @@ +''' +''' +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you 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. + +from jsonrpc import Notification, Request, Response + +Test.Summary = 'Basic records test. Testing the new records.yaml logic and making sure it works as expected.' + +ts = Test.MakeATSProcess("ts") + +ts.Disk.records_config.update( + ''' + diags: + debug: + enabled: 1 + tags: rpc|rec + ssl: + client: + cert: + filename: null + dns: + nameservers: null + test: + not_registered: + + # we expect this to be parsed and added to the records but inform that + # the record field is not registered. + field1: !!int 1 + + # we expect this to fail and report while parsing as the field is not + # registered nor have a valid type + # field2: 0 # we cant test this now as traffic_layout will output the error and setup.cli.ext will fail + # to encode json + field2: 0 + + cache: + # test multipliers with and without tag + ram_cache: + size: 30G + ''' +) + +# 0 - We want to make sure that the unregistered records are still being detected. +tr = Test.AddTestRun("Load unregistered records") +tr.Processes.Default.Command = 'echo 1' +tr.Processes.Default.ReturnCode = 0 +tr.Processes.Default.StartBefore(ts) + +var1 = 'proxy.config.test.not_registered.field1' +ts.Disk.diags_log.Content = Testers.ContainsExpression( + f"Unrecognized configuration value '{var1}'", + "Field should be ignored") +var2 = 'proxy.config.test.not_registered.field2' +ts.Disk.diags_log.Content += Testers.ContainsExpression( + f"Unrecognized configuration value '{var2}", + "Field should be ignored") + + +# 1 +tr = Test.AddTestRun("Query unregistered records.") + + +def check_response(resp: Response): + if resp.is_error(): + return (False, resp.error_as_str()) + + lst = resp.result['recordList'] + + if len(lst) != 2: + return (False, "Should be 2 records only.") + + for el in lst: + rec = el['record'] + if rec['registered'] != "false": + return (False, f"{rec['record_name']} should not be registered") + + return (True, "All good") + + +tr.AddJsonRPCClientRequest(ts, Request.admin_lookup_records( + [{"record_name_regex": "proxy.config.test.not_registered.field", "rec_types": ["1", "16"]}])) + +# do our own check on the response. +tr.Processes.Default.Streams.stdout = Testers.CustomJSONRPCResponse(check_response) + +# 2 +tctl = Test.AddTestRun("Test field with multiplier") +tctl.Processes.Default.Command = 'traffic_ctl config get proxy.config.cache.ram_cache.size' +tctl.Processes.Default.Env = ts.Env +tctl.Processes.Default.ReturnCode = 0 +tctl.Processes.Default.Streams.stdout = Testers.ContainsExpression( + 'proxy.config.cache.ram_cache.size: 32212254720', + 'Should hold the configured value.' +) diff --git a/tests/gold_tests/shutdown/emergency.test.py b/tests/gold_tests/shutdown/emergency.test.py index 3e4d9abdef4..c9518a7520f 100644 --- a/tests/gold_tests/shutdown/emergency.test.py +++ b/tests/gold_tests/shutdown/emergency.test.py @@ -28,7 +28,7 @@ Test.testName = 'Emergency Shutdown Test' ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 16, 'proxy.config.accept_threads': 1, diff --git a/tests/gold_tests/shutdown/fatal.test.py b/tests/gold_tests/shutdown/fatal.test.py index a36ea44e515..a15201e80e4 100644 --- a/tests/gold_tests/shutdown/fatal.test.py +++ b/tests/gold_tests/shutdown/fatal.test.py @@ -28,7 +28,7 @@ Test.testName = 'Fatal Shutdown Test' ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 16, 'proxy.config.accept_threads': 1, diff --git a/tests/gold_tests/thread_config/thread_config.test.py b/tests/gold_tests/thread_config/thread_config.test.py index 0ef86a1599b..f2a9772e71b 100644 --- a/tests/gold_tests/thread_config/thread_config.test.py +++ b/tests/gold_tests/thread_config/thread_config.test.py @@ -23,7 +23,7 @@ ts = Test.MakeATSProcess('ts-1_exec-0_accept-1_task-1_aio') ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 1, 'proxy.config.accept_threads': 0, @@ -41,7 +41,7 @@ ts = Test.MakeATSProcess('ts-1_exec-1_accept-2_task-8_aio') ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 1, 'proxy.config.accept_threads': 1, @@ -58,7 +58,7 @@ ts = Test.MakeATSProcess('ts-1_exec-10_accept-10_task-32_aio') ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 1, 'proxy.config.accept_threads': 10, @@ -75,7 +75,7 @@ ts = Test.MakeATSProcess('ts-2_exec-0_accept-1_task-1_aio') ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 2, 'proxy.config.accept_threads': 0, @@ -92,7 +92,7 @@ ts = Test.MakeATSProcess('ts-2_exec-1_accept-2_task-8_aio') ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 2, 'proxy.config.accept_threads': 1, @@ -109,7 +109,7 @@ ts = Test.MakeATSProcess('ts-2_exec-10_accept-10_task-32_aio') ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 2, 'proxy.config.accept_threads': 10, @@ -126,7 +126,7 @@ ts = Test.MakeATSProcess('ts-32_exec-0_accept-1_task-1_aio') ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 32, 'proxy.config.accept_threads': 0, @@ -143,7 +143,7 @@ ts = Test.MakeATSProcess('ts-32_exec-1_accept-2_task-8_aio') ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 32, 'proxy.config.accept_threads': 1, @@ -160,7 +160,7 @@ ts = Test.MakeATSProcess('ts-32_exec-10_accept-10_task-32_aio') ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 32, 'proxy.config.accept_threads': 10, @@ -177,7 +177,7 @@ ts = Test.MakeATSProcess('ts-100_exec-0_accept-1_task-1_aio') ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 100, 'proxy.config.accept_threads': 0, @@ -194,7 +194,7 @@ ts = Test.MakeATSProcess('ts-100_exec-1_accept-2_task-8_aio') ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 100, 'proxy.config.accept_threads': 1, @@ -211,7 +211,7 @@ ts = Test.MakeATSProcess('ts-100_exec-10_accept-10_task-32_aio') ts.Disk.records_config.update({ - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.5, 'proxy.config.exec_thread.limit': 100, 'proxy.config.accept_threads': 10, diff --git a/tests/gold_tests/tls/tls_0rtt_server.test.py b/tests/gold_tests/tls/tls_0rtt_server.test.py index 829a68be657..0dfc116e76c 100644 --- a/tests/gold_tests/tls/tls_0rtt_server.test.py +++ b/tests/gold_tests/tls/tls_0rtt_server.test.py @@ -112,11 +112,11 @@ ts.Disk.records_config.update({ 'proxy.config.diags.debug.enabled': 1, 'proxy.config.diags.debug.tags': 'http', - 'proxy.config.exec_thread.autoconfig': 0, + 'proxy.config.exec_thread.autoconfig.enabled': 0, 'proxy.config.exec_thread.limit': 8, 'proxy.config.ssl.server.cert.path': '{0}'.format(ts.Variables.SSLDir), 'proxy.config.ssl.server.private_key.path': '{0}'.format(ts.Variables.SSLDir), - 'proxy.config.ssl.session_cache': 2, + 'proxy.config.ssl.session_cache.value': 2, 'proxy.config.ssl.session_cache.size': 512000, 'proxy.config.ssl.session_cache.timeout': 7200, 'proxy.config.ssl.session_cache.num_buckets': 32768, diff --git a/tests/gold_tests/tls/tls_client_verify.test.py b/tests/gold_tests/tls/tls_client_verify.test.py index 5fc83918257..e94268f2ead 100644 --- a/tests/gold_tests/tls/tls_client_verify.test.py +++ b/tests/gold_tests/tls/tls_client_verify.test.py @@ -46,7 +46,7 @@ 'proxy.config.ssl.client.certification_level': 2, 'proxy.config.ssl.CA.cert.filename': '{0}/signer.pem'.format(ts.Variables.SSLDir), 'proxy.config.exec_thread.autoconfig.scale': 1.0, - 'proxy.config.ssl.TLSv1_3': 0 + 'proxy.config.ssl.TLSv1_3.enabled': 0 }) ts.Disk.ssl_multicert_config.AddLine( diff --git a/tests/gold_tests/tls/tls_client_verify3.test.py b/tests/gold_tests/tls/tls_client_verify3.test.py index d6ab615d230..356fd6fd4ca 100644 --- a/tests/gold_tests/tls/tls_client_verify3.test.py +++ b/tests/gold_tests/tls/tls_client_verify3.test.py @@ -47,7 +47,7 @@ 'proxy.config.url_remap.pristine_host_hdr': 1, 'proxy.config.ssl.client.certification_level': 2, 'proxy.config.ssl.CA.cert.filename': f'{ts.Variables.SSLDir}/aaa-ca.pem', - 'proxy.config.ssl.TLSv1_3': 0 + 'proxy.config.ssl.TLSv1_3.enabled': 0 }) ts.Disk.ssl_multicert_config.AddLine( diff --git a/tests/gold_tests/tls/tls_keepalive.test.py b/tests/gold_tests/tls/tls_keepalive.test.py index 7bc742a3914..6694aacba6b 100644 --- a/tests/gold_tests/tls/tls_keepalive.test.py +++ b/tests/gold_tests/tls/tls_keepalive.test.py @@ -40,7 +40,7 @@ ts.Disk.records_config.update({ 'proxy.config.ssl.server.cert.path': '{0}'.format(ts.Variables.SSLDir), 'proxy.config.ssl.server.private_key.path': '{0}'.format(ts.Variables.SSLDir), - 'proxy.config.ssl.TLSv1_3': 0, + 'proxy.config.ssl.TLSv1_3.enabled': 0, 'proxy.config.exec_thread.autoconfig.scale': 1.0, 'proxy.config.log.max_secs_per_buffer': 1 }) diff --git a/tests/gold_tests/tls/tls_origin_session_reuse.test.py b/tests/gold_tests/tls/tls_origin_session_reuse.test.py index 289d836f9a1..ea640821cbd 100644 --- a/tests/gold_tests/tls/tls_origin_session_reuse.test.py +++ b/tests/gold_tests/tls/tls_origin_session_reuse.test.py @@ -83,14 +83,14 @@ 'proxy.config.ssl.server.cert.path': '{0}'.format(ts1.Variables.SSLDir), 'proxy.config.ssl.server.private_key.path': '{0}'.format(ts1.Variables.SSLDir), 'proxy.config.exec_thread.autoconfig.scale': 1.0, - 'proxy.config.ssl.session_cache': 2, + 'proxy.config.ssl.session_cache.value': 2, 'proxy.config.ssl.session_cache.size': 4096, 'proxy.config.ssl.session_cache.num_buckets': 256, 'proxy.config.ssl.session_cache.skip_cache_on_bucket_contention': 0, 'proxy.config.ssl.session_cache.timeout': 0, 'proxy.config.ssl.session_cache.auto_clear': 1, 'proxy.config.ssl.server.session_ticket.enable': 1, - 'proxy.config.ssl.origin_session_cache': 1, + 'proxy.config.ssl.origin_session_cache.enabled': 1, 'proxy.config.ssl.origin_session_cache.size': 1, 'proxy.config.ssl.client.verify.server.policy': 'PERMISSIVE', }) @@ -101,14 +101,14 @@ 'proxy.config.ssl.server.cert.path': '{0}'.format(ts2.Variables.SSLDir), 'proxy.config.ssl.server.private_key.path': '{0}'.format(ts2.Variables.SSLDir), 'proxy.config.exec_thread.autoconfig.scale': 1.0, - 'proxy.config.ssl.session_cache': 2, + 'proxy.config.ssl.session_cache.value': 2, 'proxy.config.ssl.session_cache.size': 4096, 'proxy.config.ssl.session_cache.num_buckets': 256, 'proxy.config.ssl.session_cache.skip_cache_on_bucket_contention': 0, 'proxy.config.ssl.session_cache.timeout': 0, 'proxy.config.ssl.session_cache.auto_clear': 1, 'proxy.config.ssl.server.session_ticket.enable': 1, - 'proxy.config.ssl.origin_session_cache': 1, + 'proxy.config.ssl.origin_session_cache.enabled': 1, 'proxy.config.ssl.origin_session_cache.size': 1, 'proxy.config.ssl.client.verify.server.policy': 'PERMISSIVE', }) @@ -117,14 +117,14 @@ 'proxy.config.ssl.server.cert.path': '{0}'.format(ts3.Variables.SSLDir), 'proxy.config.ssl.server.private_key.path': '{0}'.format(ts3.Variables.SSLDir), 'proxy.config.exec_thread.autoconfig.scale': 1.0, - 'proxy.config.ssl.session_cache': 2, + 'proxy.config.ssl.session_cache.value': 2, 'proxy.config.ssl.session_cache.size': 4096, 'proxy.config.ssl.session_cache.num_buckets': 256, 'proxy.config.ssl.session_cache.skip_cache_on_bucket_contention': 0, 'proxy.config.ssl.session_cache.timeout': 0, 'proxy.config.ssl.session_cache.auto_clear': 1, 'proxy.config.ssl.server.session_ticket.enable': 1, - 'proxy.config.ssl.origin_session_cache': 1, + 'proxy.config.ssl.origin_session_cache.enabled': 1, 'proxy.config.ssl.origin_session_cache.size': 1, 'proxy.config.ssl.client.verify.server.policy': 'PERMISSIVE', }) @@ -135,14 +135,14 @@ 'proxy.config.ssl.server.cert.path': '{0}'.format(ts4.Variables.SSLDir), 'proxy.config.ssl.server.private_key.path': '{0}'.format(ts4.Variables.SSLDir), 'proxy.config.exec_thread.autoconfig.scale': 1.0, - 'proxy.config.ssl.session_cache': 2, + 'proxy.config.ssl.session_cache.value': 2, 'proxy.config.ssl.session_cache.size': 4096, 'proxy.config.ssl.session_cache.num_buckets': 256, 'proxy.config.ssl.session_cache.skip_cache_on_bucket_contention': 0, 'proxy.config.ssl.session_cache.timeout': 0, 'proxy.config.ssl.session_cache.auto_clear': 1, 'proxy.config.ssl.server.session_ticket.enable': 1, - 'proxy.config.ssl.origin_session_cache': 0, + 'proxy.config.ssl.origin_session_cache.enabled': 0, 'proxy.config.ssl.origin_session_cache.size': 1, 'proxy.config.ssl.client.verify.server.policy': 'PERMISSIVE', }) diff --git a/tests/gold_tests/tls/tls_session_key_logging.test.py b/tests/gold_tests/tls/tls_session_key_logging.test.py index a96bbbe40ed..1f241be57be 100644 --- a/tests/gold_tests/tls/tls_session_key_logging.test.py +++ b/tests/gold_tests/tls/tls_session_key_logging.test.py @@ -68,7 +68,11 @@ def setupTS(self, enable_secrets_logging): # Remove the keylog_file configuration automatically configured via the # trafficserver AuTest extension. - del self.ts.Disk.records_config['proxy.config.ssl.keylog_file'] + self.ts.Disk.records_config.update( + ''' + ssl: + keylog_file: null + ''') if enable_secrets_logging: self.ts.Disk.records_config.update({ diff --git a/tests/gold_tests/tls/tls_session_reuse.test.py b/tests/gold_tests/tls/tls_session_reuse.test.py index 5e2b931f956..664c706ebf4 100644 --- a/tests/gold_tests/tls/tls_session_reuse.test.py +++ b/tests/gold_tests/tls/tls_session_reuse.test.py @@ -68,7 +68,7 @@ 'proxy.config.ssl.server.private_key.path': '{0}'.format(ts1.Variables.SSLDir), 'proxy.config.ssl.server.cipher_suite': 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA:DHE-DSS-AES256-SHA:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA', 'proxy.config.exec_thread.autoconfig.scale': 1.0, - 'proxy.config.ssl.session_cache': 2, + 'proxy.config.ssl.session_cache.value': 2, 'proxy.config.ssl.session_cache.size': 4096, 'proxy.config.ssl.session_cache.num_buckets': 256, 'proxy.config.ssl.session_cache.skip_cache_on_bucket_contention': 0, @@ -81,7 +81,7 @@ 'proxy.config.ssl.server.private_key.path': '{0}'.format(ts2.Variables.SSLDir), 'proxy.config.ssl.server.cipher_suite': 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA:DHE-DSS-AES256-SHA:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA', 'proxy.config.exec_thread.autoconfig.scale': 1.0, - 'proxy.config.ssl.session_cache': 2, + 'proxy.config.ssl.session_cache.value': 2, 'proxy.config.ssl.session_cache.size': 4096, 'proxy.config.ssl.session_cache.num_buckets': 256, 'proxy.config.ssl.session_cache.skip_cache_on_bucket_contention': 0, @@ -94,7 +94,7 @@ 'proxy.config.ssl.server.private_key.path': '{0}'.format(ts3.Variables.SSLDir), 'proxy.config.ssl.server.cipher_suite': 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA:DHE-DSS-AES256-SHA:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA', 'proxy.config.exec_thread.autoconfig.scale': 1.0, - 'proxy.config.ssl.session_cache': 0, + 'proxy.config.ssl.session_cache.value': 0, 'proxy.config.ssl.session_cache.size': 4096, 'proxy.config.ssl.session_cache.num_buckets': 256, 'proxy.config.ssl.session_cache.skip_cache_on_bucket_contention': 0, diff --git a/tests/gold_tests/tls/tls_sni_host_policy.test.py b/tests/gold_tests/tls/tls_sni_host_policy.test.py index 99e38e70f2d..ba3edf8d2c9 100644 --- a/tests/gold_tests/tls/tls_sni_host_policy.test.py +++ b/tests/gold_tests/tls/tls_sni_host_policy.test.py @@ -47,7 +47,7 @@ 'proxy.config.ssl.CA.cert.filename': '{0}/signer.pem'.format(ts.Variables.SSLDir), 'proxy.config.exec_thread.autoconfig.scale': 1.0, 'proxy.config.http.host_sni_policy': 2, - 'proxy.config.ssl.TLSv1_3': 0, + 'proxy.config.ssl.TLSv1_3.enabled': 0, 'proxy.config.diags.debug.enabled': 1, 'proxy.config.diags.debug.tags': 'ssl', }) diff --git a/tests/gold_tests/tls_hooks/tls_hooks.test.py b/tests/gold_tests/tls_hooks/tls_hooks.test.py index 38f11f9d84c..29762e5c0f8 100644 --- a/tests/gold_tests/tls_hooks/tls_hooks.test.py +++ b/tests/gold_tests/tls_hooks/tls_hooks.test.py @@ -38,7 +38,7 @@ 'proxy.config.diags.debug.tags': 'ssl_hook_test', 'proxy.config.ssl.server.cert.path': '{0}'.format(ts.Variables.SSLDir), 'proxy.config.ssl.server.private_key.path': '{0}'.format(ts.Variables.SSLDir), - 'proxy.config.ssl.TLSv1_3': 0, + 'proxy.config.ssl.TLSv1_3.enabled': 0, }) ts.Disk.ssl_multicert_config.AddLine( diff --git a/tools/records/convert2yaml.py b/tools/records/convert2yaml.py new file mode 100644 index 00000000000..0cb6cdc90e6 --- /dev/null +++ b/tools/records/convert2yaml.py @@ -0,0 +1,310 @@ +#!/usr/bin/env python3 +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you 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. +# + +import argparse +import sys +import json +import traceback +import yaml +import tempfile +import fileinput + +import io + +from io import StringIO +from string import Template +from pydoc import locate +from jsonschema import validate +from jsonschema.exceptions import ValidationError +from colorama import init, Fore, Back, Style +init(autoreset=True) + +Remapped_Vars = {} + +Renamed_Records = { + # as it can have a numeric value [0-2] + 'proxy.config.output.logfile': 'proxy.config.output.logfile.name', + 'proxy.config.exec_thread.autoconfig': 'proxy.config.exec_thread.autoconfig.enabled', + 'proxy.config.hostdb': 'proxy.config.hostdb.enabled', + 'proxy.config.tunnel.prewarm': 'proxy.config.tunnel.prewarm.enabled', + 'proxy.config.ssl.origin_session_cache': 'proxy.config.ssl.origin_session_cache.enabled', + 'proxy.config.ssl.session_cache': 'proxy.config.ssl.session_cache.value', + 'proxy.config.ssl.TLSv1_3': 'proxy.config.ssl.TLSv1_3.enabled', + 'proxy.config.ssl.client.TLSv1_3': 'proxy.config.ssl.client.TLSv1_3.enabled' +} + +############################################################################################### +############################################################################################### + + +def red(text, bright=False): + return f"{Style.BRIGHT if bright else ''}{Fore.RED}{text}{Style.RESET_ALL}" + + +def bright(text, color=Fore.GREEN): + return f'{Style.BRIGHT}{color}{text}{Style.RESET_ALL}' + + +def error(): + return f"{red('[E] ', True)}" + + +def fancy_chain_print(lst, isError=False): + output = StringIO() + if len(lst) == 1: + output.write(f'» {lst[0]}\n') + s = output.getvalue() + output.close() + return s + space = '' + output.write(f'┌■ {lst[0]}\n') + if len(lst) > 2: + space = ' ' + # from 2nd till end-1 + output.write(f'└┬──» {lst[1]}\n') + for x in lst[2:-1]: + output.write(f' ├──» {x}\n') + + z = lst[-1] + output.write(f'{space}└──» {z}\n') + + s = output.getvalue() + output.close() + return s + + +def progressbar(it, size=60, out=sys.stdout, mute=False): + count = len(it) + + def show(j): + x = int(size * j / count) + if not mute: + print("[{}{}] {}/{}".format("█" * x, "░" * (size - x), j, count), + end='\r', file=out, flush=True) + show(0) + for i, item in enumerate(it): + yield item + + show(i + 1) + if not mute: + print("\n", flush=True, file=out) + + +def validate_schema(data, schema_filename): + if schema_filename: + with open(schema_filename, 'r') as f: + s = f.read() + sdata = json.loads(s) + try: + # validate will throw if invalid schema. + if schema_filename: + validate(instance=data, schema=sdata) + except ValidationError as ve: + return str(ve) + + return "" + + +def save_to_file(filename, is_json, typerepr, data): + + def float_representer(dumper, value): + return dumper.represent_scalar(u'tag:yaml.org,2002:float', str(value), style="'") + + def int_representer(dumper, value): + return dumper.represent_scalar(u'tag:yaml.org,2002:int', str(value), style="'") + + def bool_representer(dumper, value): + return dumper.represent_scalar(u'tag:yaml.org,2002:bool', str(value), style="'") + + def null_representer(dumper, value): + return dumper.represent_scalar(u'tag:yaml.org,2002:null', str(value), style="'") + + with open(filename, 'w') as f: + if is_json: + json.dump(data, f, indent=4, sort_keys=True) + else: + if 'float' in typerepr: + yaml.add_representer(float, float_representer) + if 'int' in typerepr: + yaml.add_representer(int, int_representer) + if 'bool' in typerepr: + yaml.add_representer(bool, bool_representer) + if 'null' in typerepr: + yaml.add_representer(None, null_representer) + yaml.dump(data, f) + + +def print_summary(): + if len(Remapped_Vars): + out = [] + out.append(f'{Style.BRIGHT}{Fore.GREEN}{len(Remapped_Vars)} Renamed records:{Style.RESET_ALL}') + idx = 1 + for k, v in Remapped_Vars.items(): + out.append(f'{Style.BRIGHT}{Fore.GREEN}#{idx}{Style.RESET_ALL} : {k} -> {Style.BRIGHT}{Fore.GREEN}{v}{Style.RESET_ALL}') + idx = idx + 1 + + print(fancy_chain_print(out)) + + +def get_value(type, value): + def have_multipliers(value, mps): + for m in mps: + if value.endswith(m): + return True + + return False + + if value == 'nullptr' or value == 'NULL': + return None + + # We want to make the type right when inserting the element into the dict. + if type == 'FLOAT': + return float(value) + elif type == 'INT': + # We need to make it YAML compliant as this will be an int, so if contains + # any special character like hex or a multiplier, then we make a string. ATS will + # parse it as string anyway. + if value.startswith('0x') or have_multipliers(value, ['K', 'M', 'G', 'T']): + return str(value) + else: + return int(value) + elif type == 'STRING': + return str(value) + + return None + + +def add_object(config, var, value, type=None): + key = '' + index = var.find('.') + if index < 0: # last part + config[var] = get_value(type, value) + else: + key = var[:index] + if key not in config: + config[key] = {} + + add_object(config[key], var[index + 1:], value, type=type) + + +def fix_record_names(file): + temp = tempfile.NamedTemporaryFile(prefix='records.config_', delete=False) + + for l in fileinput.input(files=file): + elements = l.split() + if len(elements) == 4: + rec_name = elements[1] + if rec_name in Renamed_Records: + elements[1] = Renamed_Records[rec_name] + + rec_line = ' '.join(elements) + temp.write(rec_line.encode('utf-8')) + temp.write(b'\n') + Remapped_Vars[rec_name] = Renamed_Records[rec_name] + + continue + # if elements len diff from 4 .. well.. it shouldn't. + temp.write(l.encode('utf-8')) + + temp.close() + return temp.name + + +def handle_file_input(args): + if args.file is None: + raise Exception("Hey!! there is no file!") + + config = {} + + # Fix the names first. + filename = fix_record_names(args.file) + with open(filename, "r+") as f: + lines = f.readlines() + num_lines = len(lines) + for idx in progressbar(range(num_lines), 40, mute=args.mute): + line = lines[idx] + if '#' == line[0] or '\n' == line[0] or ' ' == line[0]: + idx = idx + 1 + continue + s = line.split(' ', maxsplit=3) # keep values all together + name = s[1] + type = s[2] + value = s[3] + + # We ignore the prefix and work away from there. + if name.startswith("proxy.config."): + name = name[len("proxy.config."):] + elif name.startswith("local.config."): + name = name[len("local.config."):] + elif args.node and name.startswith("proxy.node."): + name = name[len("proxy."):] + + # Build the object + add_object(config, name, value[:-1], type) + idx = idx + 1 + + ts = {} + ts['ts'] = config + + if args.schema: + err = validate_schema(ts, args.schema) + if err: + raise Exception("Schema failed.") + + save_to_file(args.save2, args.json, args.typerepr, ts) + + f.close() + return + + +if __name__ == '__main__': + parser = argparse.ArgumentParser(description='records.config to YAML/JSON convert tool') + parser.add_argument('-f', '--file', help='records.config input file.') + parser.add_argument('-n', '--node', help="Include 'proxy.node' variables in the parser.", action='store_true') + parser.add_argument('-t', '--typerepr', help="Use type representers (list)", required=False, default=['']) + parser.add_argument('-s', '--schema', help="Validate the output using a json schema file.") + parser.add_argument('-S', '--save2', help="Save to file.", required=True) + parser.add_argument( + '-m', + '--mute', + help="Be quiet, do not output anything, except for errors", + required=False, + action='store_true') + kk = parser.add_mutually_exclusive_group(required=True) + kk.add_argument('-j', '--json', help="Output as json", action='store_true') + kk.add_argument('-y', '--yaml', help="Output as yaml", action='store_true') + parser.set_defaults(func=handle_file_input) + args = parser.parse_args() + + try: + func = args.func + except AttributeError: + parser.error("Too few arguments") + try: + func(args) + if args.mute is False: + print_summary() + + except Exception as e: + print("Something went wrong: {}".format(e)) + + print(traceback.format_exc()) + sys.exit(1) + + sys.exit(0)