Changes between Version 45 and Version 46 of ConfigOptions

Timestamp:

Oct 5, 2017, 10:59:34 AM (7 years ago)

Author:

Even Rouault

Comment:

Document new configuration options

ConfigOptions

@@ -65 +65 @@
 
 === CPL_TIMESTAMP ===
+
+Set to "ON" to add timestamps to CPL debug messages (so assumes that CPL_DEBUG is enabled)
 
 === CPL_MAX_ERROR_REPORTS ===
@@ -119 +121 @@
 This option only has an effect on Windows systems (using cpl_vsil_win32.cpp).  If set to "NO" (default is YES) then filenames passed to functions like VSIFOpenL() will be passed on directly to CreateFile() instead of being converted from UTF-8 to wchar_t and passed to CreateFileW().  This effectively restores the pre-GDAL1.8 behavior for handling filenames on Windows and might be appropriate for applications that treat filenames as being in the local encoding.
 
+=== GDAL_HTTP_VERSION ===
+
+(GDAL >= 2.3) Can be set to 1.0, 1.1, 2 or 2TLS to specify which HTTP version to use. Will default to 1.1 generally (except on some controlled environments, like Google Compute Engine VMs, where 2TLS will be the default). Support for HTTP/2 requires curl 7.33 or later, built against nghttp2. "2TLS" means that HTTP/2 will be attempted for HTTPS connections only. Whereas "2" means that HTTP/2 will be attempted for HTTP or HTTPS. The interest of enabling HTTP/2 is the use of HTTP/2 multiplexing when reading GeoTIFFs stored on /vsicurl/ and related virtual file systems.
+
+=== GDAL_HTTP_MULTIPLEX ===
+
+(GDAL >= 2.3) Can be set to YES or NO. Defaults to YES. Only applies on a HTTP/2 connection. If set to YES, HTTP/2 multiplexing can be used to download multiple ranges in parallel, during ReadMultiRange() requests that can be emitted by the GeoTIFF driver.
+
+=== GDAL_HTTP_MULTIRANGE ===
+
+(GDAL >= 2.3) Can be set to SINGLE_GET, SERIAL or YES. Defaults to YES. Controls how ReadMultiRange() requests emitted by the GeoTIFF driver are satisfied. SINGLE_GET means that several ranges will be expressed in the Range header of a single GET requests, which is not supported by a majority of servers (including AWS S3 or Google GCS). SERIAL means that each range will be requested sequentially. YES means that each range will be requested in parallel, using HTTP/2 multiplexing or several HTTP connections.
+
+=== GDAL_HTTP_MERGE_CONSECUTIVE_RANGES ===
+
+(GDAL >= 2.3) Can be set to YES or NO. Defaults to NO. Only applies when GDAL_HTTP_MULTIRANGE=YES. Defines if ranges of a single ReadMultiRange() request that are consecutive should be merged into a single request.
+
 === GEOTIFF_CSV ===