| 5 | | For general description refer to GDAL official website, consult https://gdal.org/user/configoptions.html |
| 6 | | |
| 7 | | Help appreciated to get the following content migrated as well to the official doc. |
| 8 | | See https://gdal.org/user/configoptions.html#list-of-configuration-options-and-where-they-apply |
| 9 | | |
| 10 | | == What Configuration Options Exist? == |
| 11 | | |
| 12 | | Traditionally there hasn't been a good registry of configuration options, and they are often added adhoc to drivers to provide particular workarounds. Below are some of the software wide configuration options. In some cases particular format drivers will document their configuration options, if any, in the user documentation - as is done for the [http://www.gdal.org/frmt_jp2kak.html JP2KAK] and [http://www.gdal.org/frmt_ecw.html ECW] drivers. |
| 13 | | |
| 14 | | == Generic Options == |
| 15 | | |
| 16 | | === CPL_DEBUG === |
| 17 | | |
| 18 | | This may be set to ON, OFF or specific prefixes. If it is ON, all debug messages are reported to stdout. If it is OFF or unset no debug messages are reported. If it is set to a particular value, then only debug messages with that "type" value will be reported. For instance debug messages from the HFA driver are normally reported with type "HFA" (seen in the message). |
| 19 | | |
| 20 | | At the commandline this can also be set with --debug <value> as well as with --config CPL_DEBUG <value>. |
| 21 | | |
| 22 | | === CPL_LOG === |
| 23 | | |
| 24 | | This is used for setting the log file path. |
| 25 | | |
| 26 | | === CPL_LOG_ERRORS === |
| 27 | | |
| 28 | | Set to "ON" for printing error messages. Use together with "CPL_LOG" for directing them into a file. |
| 29 | | |
| 30 | | === CPL_TIMESTAMP === |
| 31 | | |
| 32 | | Set to "ON" to add timestamps to CPL debug messages (so assumes that CPL_DEBUG is enabled) |
| 33 | | |
| 34 | | === CPL_MAX_ERROR_REPORTS === |
| 35 | | |
| 36 | | === CPL_ACCUM_ERROR_MSG === |
| 37 | | |
| 38 | | === CPL_TMPDIR === |
| 39 | | |
| 40 | | By default, temporary files are written into current working directory. Sometimes this is not optimal and it would be better to write temporary files on bigger or faster drives (SSD). |
| 41 | | |
| 42 | | === CPL_VSIL_CURL_ALLOWED_EXTENSIONS === |
| 43 | | |
| 44 | | Consider that only the files whose extension ends up with one that is listed in CPL_VSIL_CURL_ALLOWED_EXTENSIONS exist on the server. This can speed up dramatically open experience, in case the server cannot return a file list. |
| 45 | | For example: |
| 46 | | {{{ |
| 47 | | gdalinfo --config CPL_VSIL_CURL_ALLOWED_EXTENSIONS ".tif" /vsicurl/http://igskmncngs506.cr.usgs.gov/gmted/Global_tiles_GMTED/075darcsec/bln/W030/30N030W_20101117_gmted_bln075.tif |
| 48 | | }}} |
| 49 | | |
| 50 | | |
| 51 | | === CPL_VSIL_CURL_NON_CACHED === |
| 52 | | |
| 53 | | A global LRU cache of 16 MB shared among all downloaded content |
| 54 | | is enabled by default, and content in it may be reused after a file handle |
| 55 | | has been closed and reopen. Starting with GDAL 2.3, the |
| 56 | | CPL_VSIL_CURL_NON_CACHED configuration option can be set to values like |
| 57 | | "/vsis3/bucket/foo.tif:/vsis3/another_bucket/some_directory", |
| 58 | | so that at file handle closing, all cached content related to the mentionned |
| 59 | | file(s) is no longer cached. This can help when dealing with resources that |
| 60 | | can be modified during execution of GDAL related code. |
| 61 | | |
| 62 | | === CPL_VSIL_ZIP_ALLOWED_EXTENSIONS === |
| 63 | | |
| 64 | | Add to zip FS handler default extensions array (zip, kmz, dwf, ods, xlsx) additional extensions listed in CPL_VSIL_ZIP_ALLOWED_EXTENSIONS config option. The extensions divided by comma. |
| 65 | | |
| 66 | | |
| 67 | | === VSI_CACHE === |
| 68 | | Starting with GDAL 1.10, when using the VSI interface files can be cached in RAM by setting the configuration option VSI_CACHE to TRUE. The cache size defaults to 25 MB, but can be modified by setting the configuration option VSI_CACHE_SIZE (in bytes). |
| 69 | | |
| 70 | | When enabled, this cache is used for most I/O in GDAL, including local files. Be wary of large values for VSI_CACHE_SIZE when opening VRT datasources containing many source rasters, as this is a per-file cache. |
| 71 | | |
| 72 | | === GDAL_DATA === |
| 73 | | |
| 74 | | Path to directory containing various GDAL data files (EPSG CSV files, S-57 definition files, DXF header and footer files, ...). |
| 75 | | |
| 76 | | This option is read by the GDAL and OGR driver registration functions. It is used to expand EPSG codes into their description in the OSR model (WKT based). |
| 77 | | |
| 78 | | On some builds (Unix), the value can be hard-coded at compilation time to point to the path after installation (/usr/share/gdal/data for example). On Windows platform, this option must be generally declared. |
| 79 | | |
| 80 | | === GDAL_DISABLE_CPLLOCALEC === |
| 81 | | |
| 82 | | If set to YES (default is NO) this option will disable the normal behavior of the CPLLocaleC class which forces the numeric locale to "C" for selected chunks of code using the setlocale() call. Behavior of setlocale() in multi-threaded applications may be undependable but use of this option may result in problem formatting and interpreting numbers properly. |
| 83 | | |
| 84 | | === GDAL_FILENAME_IS_UTF8 === |
| 85 | | |
| 86 | | 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. |
| 87 | | |
| 88 | | === GDAL_HTTP_VERSION === |
| 89 | | |
| 90 | | (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. |
| 91 | | |
| 92 | | === GDAL_HTTP_MULTIPLEX === |
| 93 | | |
| 94 | | (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. |
| 95 | | |
| 96 | | === GDAL_HTTP_MULTIRANGE === |
| 97 | | |
| 98 | | (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. |
| 99 | | |
| 100 | | === GDAL_HTTP_MERGE_CONSECUTIVE_RANGES === |
| 101 | | |
| 102 | | (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. |
| 103 | | |
| 104 | | === GEOTIFF_CSV === |
| 105 | | |
| 106 | | |
| 107 | | == GDAL Options == |
| 108 | | |
| 109 | | === GDAL_DISABLE_READDIR_ON_OPEN === |
| 110 | | |
| 111 | | Defaults to FALSE. |
| 112 | | |
| 113 | | By default (GDAL_DISABLE_READDIR_ON_OPEN=FALSE), GDAL establishes a list of all the files in the directory of the file passed to GDALOpen(). This can result in speed-ups in some use cases, but also to major slow downs when the directory contains thousands of other files. When set to TRUE, GDAL will not try to establish the list of files. |
| 114 | | |
| 115 | | If set to EMPTY_DIR, only the file that is being opened will be seen when a GDAL driver will request sibling files, so this is a way to disable loading side-car/auxiliary files. |
| 116 | | |
| 117 | | === GDAL_CACHEMAX === |
| 118 | | |
| 119 | | This option controls the default GDAL raster block cache size. If its value is small (less than 100000), it is assumed to be measured in megabytes, otherwise in bytes. Starting with GDAL 2.1, the value can be set to "X%" to mean X% of the usable physical RAM. Note that this value is only consulted the first time the cache size is requested overriding the initial default (40MB up to GDAL 2.0, 5% of the usable physical RAM starting with GDAL 2.1). To change this value programmatically during operation of the program it is better to use GDALSetCacheMax(int nNewSize) (always in bytes). Since GDAL 1.8.0, it is possible to specify a 64bit value through GDAL_CACHEMAX or with GDALSetCacheMax64(GIntBig nNewSize) (but the maximum practical value on 32 bit OS is between 2 and 4 GB. It is the responsibility of the user to set a consistant value) |
| 120 | | |
| 121 | | === GDAL_SKIP === |
| 122 | | |
| 123 | | Used by GDALDriverManager::AutoSkipDrivers() |
| 124 | | |
| 125 | | This option can be used to unregister one or several GDAL drivers. This can be useful when a driver tries to open a dataset that it should not recognize, or when several drivers are built-in that can open the same datasets (for example JP2MrSID, JP2ECW, JPEG2000 and JP2KAK for JPEG2000 datasets). The value of this option must be a space delimited list of the short name of the GDAL drivers to unregister. |
| 126 | | |
| 127 | | This option must be set before calling GDALAllRegister(), or an explicit call to GDALDriverManager::AutoSkipDrivers() will be required. |
| 128 | | |
| 129 | | === GDAL_DRIVER_PATH === |
| 130 | | |
| 131 | | Used by GDALDriverManager::AutoLoadDrivers() |
| 132 | | |
| 133 | | This function will automatically load drivers from shared libraries. It searches the "driver path" for .so (or .dll) files that start with the prefix "gdal_X.so". It then tries to load them and then tries to call a function within them called GDALRegister_X() where the 'X' is the same as the remainder of the shared library basename ('X' is case sensitive), or failing that to call GDALRegisterMe(). |
| 134 | | |
| 135 | | There are a few rules for the driver path. If the GDAL_DRIVER_PATH environment variable it set, it is taken to be a list of directories to search separated by colons on UNIX, or semi-colons on Windows. Otherwise the /usr/local/lib/gdalplugins directory, and (if known) the lib/gdalplugins subdirectory of the gdal home directory are searched on UNIX and $(BINDIR)\gdalplugins on Windows. |
| 136 | | |
| 137 | | This option must be set before calling GDALAllRegister(), or an explicit call to GDALDriverManager::AutoLoadDrivers() will be required. |
| 138 | | |
| 139 | | === GDAL_FORCE_CACHING === |
| 140 | | |
| 141 | | Defaults to NO. |
| 142 | | |
| 143 | | When set to YES, the GDALDataset::RasterIO() and GDALRasterBand::RasterIO() will use cached IO (access block by block through GDALRasterBand::IReadBlock() API) instead of a potential driver specific implementation of IRasterIO(). This will only have an effect on drivers that specialize IRasterIO() at the dataset or raster band level, for example JP2KAK, NITF, HFA, WCS, ECW, MrSID, JPEG, ... |
| 144 | | |
| 145 | | === GDAL_VALIDATE_CREATION_OPTIONS === |
| 146 | | |
| 147 | | Defaults to YES. |
| 148 | | |
| 149 | | When using GDALDriver::Create() or GDALDriver::CreateCopy() (for example when using the -co option of gdal_translate or gdalwarp utilies) , GDAL checks by default that the passed creation options match the syntax of the allowed options declared by the driver. If they don't match the syntax, a warning will be emitted. There should be hardly any reason to set this option to FALSE, as it's either a sign of a user typo, or an error in the declared options of the driver. The latter should be worth a bug report. |
| 150 | | |
| 151 | | === GDAL_IGNORE_AXIS_ORIENTATION === |
| 152 | | |
| 153 | | === GMLJP2OVERRIDE === |
| 154 | | |
| 155 | | === GDAL_JP2K_ALT_OFFSETVECTOR_ORDER === |
| 156 | | |
| 157 | | === GDAL_PAM_ENABLED === |
| 158 | | |
| 159 | | PAM support can be enabled (resp. disabled) in GDAL by setting the GDAL_PAM_ENABLED configuration option (via CPLSetConfigOption(), or the environment) to the value of YES (resp. NO). Note: The default value is build dependant and defaults to YES in Windows and Unix builds. See [http://gdal.org/classGDALPamDataset.html GDALPamDataset] for more information. Note that setting this option to OFF may have subtle/silent side-effects on various drivers that rely on PAM functionality. |
| 160 | | |
| 161 | | === GDAL_PAM_MODE === |
| 162 | | |
| 163 | | === GDAL_PAM_PROXY_DIR === |
| 164 | | |
| 165 | | === GDAL_MAX_DATASET_POOL_SIZE === |
| 166 | | |
| 167 | | Defaults to 100. Used by gcore/gdalproxypool.cpp |
| 168 | | |
| 169 | | Number of datasets that can be opened simultaneously by the GDALProxyPool mechanism (used by VRT for example). Can be |
| 170 | | increased to get better random I/O performance with VRT mosaics made of numerous underlying raster files. Be careful : on Linux systems, the |
| 171 | | number of file handles that can be opened by a process is generally limited to 1024. |
| 172 | | |
| 173 | | === GDAL_SWATH_SIZE === |
| 174 | | |
| 175 | | Defaults to 10000000 (10 MB). Used by gcore/rasterio.cpp |
| 176 | | |
| 177 | | Size of the swath when copying raster data from one dataset to another one (in bytes). Should not be smaller than GDAL_CACHEMAX |
| 178 | | |
| 179 | | === USE_RRD === |
| 180 | | |
| 181 | | Defaults to NO. Used by gcore/gdaldefaultoverviews.cpp |
| 182 | | |
| 183 | | Can be set to YES to use Erdas Imagine format (.aux) as overview format. See [http://gdal.org/gdaladdo.html gdaladdo] documentation. |
| 184 | | |
| 185 | | == GeoTIFF driver options == |
| 186 | | |
| 187 | | All the below options are documented in the [http://gdal.org/frmt_gtiff.html GTiff driver] documentation. |
| 188 | | |
| 189 | | === GTIFF_IGNORE_READ_ERRORS === |
| 190 | | |
| 191 | | === ESRI_XML_PAM === |
| 192 | | |
| 193 | | === JPEG_QUALITY_OVERVIEW === |
| 194 | | |
| 195 | | === GDAL_TIFF_INTERNAL_MASK === |
| 196 | | |
| 197 | | === GDAL_TIFF_INTERNAL_MASK_TO_8BIT === |
| 198 | | |
| 199 | | === TIFF_USE_OVR === |
| 200 | | |
| 201 | | === GTIFF_POINT_GEO_IGNORE === |
| 202 | | |
| 203 | | === GTIFF_REPORT_COMPD_CS === |
| 204 | | |
| 205 | | === GDAL_ENABLE_TIFF_SPLIT === |
| 206 | | |
| 207 | | === GDAL_TIFF_OVR_BLOCKSIZE === |
| 208 | | |
| 209 | | == GRIB driver options == |
| 210 | | |
| 211 | | All the below options are documented in the [http://gdal.org/frmt_grib.html GRIB driver] documentation. |
| 212 | | |
| 213 | | === GRIB_NORMALIZE_UNITS === |
| 214 | | |
| 215 | | |
| 216 | | == GDAL/OGR HTTP options == |
| 217 | | |
| 218 | | === CPL_CURL_VERBOSE === |
| 219 | | |
| 220 | | Set to "YES" to get the curl library to display a lot of verbose information about its operations. Very useful for libcurl and/or protocol debugging and understanding. |
| 221 | | |
| 222 | | === GDAL_HTTP_AUTH === |
| 223 | | |
| 224 | | Set value to [BASIC/NTLM/GSSNEGOTIATE/ANY] to tell libcurl which authentication method(s) you want it to use. See http://curl.haxx.se/libcurl/c/curl_easy_setopt.html#CURLOPTHTTPAUTH for more information. |
| 225 | | |
| 226 | | === GDAL_HTTP_USERPWD === |
| 227 | | |
| 228 | | The HTTP user and password to use for the connection. Must be in the form of [user name]:[password]. Use GDAL_HTTP_AUTH to decide the authentication method. |
| 229 | | |
| 230 | | When using NTLM, you can set the domain by prepending it to the user name and separating the domain and name with a forward (/) or backward slash (\). Like this: "domain/user:password" or "domain\user:password". Some HTTP servers (on Windows) support this style even for Basic authentication. |
| 231 | | |
| 232 | | === GDAL_HTTP_PROXY === |
| 233 | | |
| 234 | | Set HTTP proxy to use. The parameter should be the host name or dotted IP address. To specify port number in this string, append :[port] to the end of the host name. The proxy string may be prefixed with [protocol]:// since any such prefix will be ignored. The proxy's port number may optionally be specified with the separate option. If not specified, libcurl will default to using port 1080 for proxies. |
| 235 | | |
| 236 | | GDAL respects the environment variables http_proxy, ftp_proxy, all_proxy etc, if any of those are set. GDAL_HTTP_PROXY option does however override any possibly set environment variables. |
| 237 | | |
| 238 | | === GDAL_HTTP_PROXYUSERPWD === |
| 239 | | |
| 240 | | The HTTP user and password to use for the connection to the HTTP proxy. Must be in the form of [user name]:[password]. |
| 241 | | |
| 242 | | === GDAL_PROXY_AUTH === |
| 243 | | |
| 244 | | Set value to [BASIC/NTLM/DIGEST/ANY] to tell libcurl which authentication method(s) you want it to use for your proxy authentication. See http://curl.haxx.se/libcurl/c/curl_easy_setopt.html#CURLOPTPROXYAUTH for more information |
| 245 | | |
| 246 | | === CPL_CURL_GZIP === |
| 247 | | |
| 248 | | Sets the contents of the Accept-Encoding header sent in a HTTP request to gzip, and enables decoding of a response when a Content-Encoding: header |
| 249 | | |
| 250 | | === GDAL_HTTP_TIMEOUT === |
| 251 | | |
| 252 | | Set HTTP timeout value, where value is in seconds |
| 253 | | |
| 254 | | === GDAL_HTTP_USERAGENT === |
| 255 | | |
| 256 | | When set this string is will be used to set the User-Agent: header in the http request sent to the remote server |
| 257 | | |
| 258 | | === GDAL_HTTP_UNSAFESSL === |
| 259 | | |
| 260 | | Set to "YES" to get the curl library to skip SSL host / certificate verification. |
| 261 | | |
| 262 | | == OGR Options == |
| 263 | | |
| 264 | | === PROJSO === |
| 265 | | |
| 266 | | Used by ogr/ogrct.cpp |
| 267 | | |
| 268 | | The name of the PROJ.4 DLL or shared library to try and load at runtime. For example "/home/bob/libproj.so". If not set, OGR will try to load : |
| 269 | | * libproj.so on Linux/Unix platforms |
| 270 | | * proj.dll on Windows platforms |
| 271 | | * libproj.dylib on MacOSX platforms |
| 272 | | * libproj-0.dll on MinGW32 builds |
| 273 | | * cygproj-0.dll on Cygwin builds |
| 274 | | |
| 275 | | === CENTER_LONG === |
| 276 | | |
| 277 | | === CHECK_WITH_INVERT_PROJ === |
| 278 | | |
| 279 | | Used by ogr/ogrct.cpp and apps/gdalwarp.cpp. Added in GDAL/OGR 1.7.0 |
| 280 | | |
| 281 | | This option can be used to control the behaviour of gdalwarp when warping global datasets or when transforming from/to polar projections, which causes coordinates discontinuities. See http://trac.osgeo.org/gdal/ticket/2305. |
| 282 | | |
| 283 | | The background is that proj.4 does not guarantee that converting from src_srs to dst_srs and then from dst_srs to src_srs will yield to the initial coordinates. This can cause to errors in the computation of the target bounding box of gdalwarp, or to visual artifacts. |
| 284 | | |
| 285 | | If CHECK_WITH_INVERT_PROJ option is not set, gdalwarp will check that the the computed coordinates of the edges of the target image are in the validity area of the target projection. If they are not, it will retry computing them by setting CHECK_WITH_INVERT_PROJ=TRUE that forces ogrct.cpp to check the consistency of each requested projection result with the invert projection. |
| 286 | | |
| 287 | | If set to NO, gdalwarp will behave like GDAL/OGR < 1.7.0 |
| 288 | | |
| 289 | | === THRESHOLD === |
| 290 | | |
| 291 | | Used by ogr/ogrct.cpp. Added in GDAL/OGR 1.7.0 |
| 292 | | |
| 293 | | Used in combination with CHECK_WITH_INVERT_PROJ=TRUE. Define the acceptable threshold used to check if the roundtrip from src_srs to dst_srs and from dst_srs to srs_srs yield to the initial coordinates. The value must be expressed in the units of the source SRS (typically degrees for a geographic SRS, meters for a projected SRS) |
| 294 | | |
| 295 | | === OGR_DEBUG_ORGANIZE_POLYGONS === |
| 296 | | |
| 297 | | Used by OGRGeometryFactory::organizePolygons(). Defaults to NO. |
| 298 | | |
| 299 | | If set to YES, organizePolygons(), which is in particular used when reading Shapefiles with Polygon geometry, will use GEOS to check the topological relationship of the subparts of multipolygons. This will slow down processing. There should be no reason to set this option to YES, except for debugging purposes. |
| 300 | | |
| 301 | | === OGR_ARC_STEPSIZE === |
| 302 | | |
| 303 | | Used by OGR_G_CreateFromGML() (for gml:Arc and gml:Circle) and OGRGeometryFactory::approximateArcAngles() to stroke arc to linestrings. Defaults to 4 (degrees). Added in GDAL/OGR 1.8.0 |
| 304 | | |
| 305 | | The largest step in degrees along the arc. |
| 306 | | |
| 307 | | === OGR_ENABLE_PARTIAL_REPROJECTION === |
| 308 | | |
| 309 | | Used by OGRLineString::transform(). Defaults to NO. Added in GDAL/OGR 1.8.0 |
| 310 | | |
| 311 | | Can be set to YES to remove points that can't be reprojected. See #3758 for the purpose of this option. |
| 312 | | |
| 313 | | === OGR_FORCE_ASCII === |
| 314 | | |
| 315 | | Used by OGRGetXML_UTF8_EscapedString() function and by GPX, KML, GeoRSS and GML drivers. Defaults to YES |
| 316 | | |
| 317 | | Those XML based drivers should write UTF8 content. If they are provided with non UTF8 content, they will replace each non-ASCII character by '?' when OGR_FORCE_ASCII=YES. |
| 318 | | |
| 319 | | Set to NO to preserve the content, but beware that the resulting XML file will not be valid and will require manual edition of the encoding in the XML header. |
| 320 | | |
| 321 | | === SHAPE_ENCODING === |
| 322 | | |
| 323 | | Added in GDAL/OGR 1.9.0. |
| 324 | | |
| 325 | | Shapefile driver specific. This may be set to a OGR Character Encoding name in order to force all DBF files opened with the shapefile driver to be treated as having that encoding instead of trying to interpret the encoding setting of the file itself. |
| 326 | | |
| 327 | | === DXF_ENCODING === |
| 328 | | |
| 329 | | DXF driver specific. This may be set to a OGR Character Encoding name in order to force all DXF files opened with the DXF driver to be treated as having that encoding instead of trying to interpret the encoding setting of the file itself. |
| 330 | | |
| 331 | | === GML_INVERT_AXIS_ORDER_IF_LAT_LONG === |
| 332 | | |
| 333 | | GML driver specific. Added in GDAL/OGR 1.8.0. See [http://gdal.org/ogr/drv_gml.html GML driver] documentation. Also impacts WFS driver behaviour. |
| 334 | | |
| 335 | | === GML_CONSIDER_EPSG_AS_URN === |
| 336 | | |
| 337 | | GML driver specific. Added in GDAL/OGR 1.8.0. See [http://gdal.org/ogr/drv_gml.html GML driver] documentation. Also impacts WFS driver behaviour. |
| 338 | | |
| 339 | | === GML_SAVE_RESOLVED_TO === |
| 340 | | |
| 341 | | GML driver specific. Added in GDAL/OGR 1.8.0. See [http://gdal.org/ogr/drv_gml.html GML driver] documentation. |
| 342 | | |
| 343 | | === GML_SKIP_RESOLVE_ELEMS === |
| 344 | | |
| 345 | | GML driver specific. Added in GDAL/OGR 1.8.0. See [http://gdal.org/ogr/drv_gml.html GML driver] documentation. |
| 346 | | |
| 347 | | === GML_FIELDTYPES === |
| 348 | | |
| 349 | | GML driver specific. See [http://gdal.org/ogr/drv_gml.html GML driver] documentation. |
| 350 | | |
| 351 | | === GML_GFS_TEMPLATE === |
| 352 | | |
| 353 | | GML driver specific. Added in GDAL/OGR 1.9.0. See [http://gdal.org/ogr/drv_gml.html GML driver] documentation. |
| 354 | | |
| 355 | | === GML_EXPOSE_FID === |
| 356 | | |
| 357 | | GML driver specific. Added in GDAL/OGR 1.9.0. See [http://gdal.org/ogr/drv_gml.html GML driver] documentation. |
| 358 | | |
| 359 | | === GML_EXPOSE_GML_ID === |
| 360 | | |
| 361 | | GML driver specific. Added in GDAL/OGR 1.9.0. See [http://gdal.org/ogr/drv_gml.html GML driver] documentation. |
| 362 | | |
| 363 | | === OGR_WFS_PAGING_ALLOWED === |
| 364 | | |
| 365 | | WFS driver specific. Added in GDAL/OGR 1.8.0. See [http://gdal.org/ogr/drv_wfs.html WFS driver] documentation. |
| 366 | | |
| 367 | | === OGR_WFS_PAGE_SIZE === |
| 368 | | |
| 369 | | WFS driver specific. Added in GDAL/OGR 1.8.0. See [http://gdal.org/ogr/drv_wfs.html WFS driver] documentation. |
| 370 | | |
| 371 | | === OGR_WFS_BASE_START_INDEX === |
| 372 | | |
| 373 | | WFS driver specific. Added in GDAL/OGR 1.10. The default base start index is 0, as mandated by the specification. The OGR_WFS_BASE_START_INDEX configuration option can however be set to 1 to be compatible with the server implementations that considered the first feature to be at index 1. |
| 374 | | |
| 375 | | === OGR_WFS_USE_STREAMING === |
| 376 | | |
| 377 | | WFS driver specific. Added in GDAL/OGR 1.10. The WFS driver will read the GML content as a stream instead as a whole file, which will improve interactivity and help when the content cannot fit into memory. This can be turned off by setting the OGR_WFS_USE_STREAMING configuration option to NO if this is not desirable (for example, when iterating several times on a layer that can fit into memory). |
| 378 | | |
| 379 | | === OGR_WFS_LOAD_MULTIPLE_LAYER_DEFN === |
| 380 | | |
| 381 | | WFS driver specific. Added in GDAL/OGR 1.9.0. Can be set to OFF to prevent emitting DescribeFeatureType for multiple layers at once (which is the new behaviour of the WFS driver in OGR 1.9.0 for better efficiency) |
| 382 | | |
| 383 | | === SQLITE_LIST_ALL_TABLES === |
| 384 | | |
| 385 | | SQLite driver specific. Set to "YES" to list all tables (not just the tables listed in the geometry_columns table) |
| 386 | | |
| 387 | | === OGR_SQLITE_CACHE === |
| 388 | | |
| 389 | | SQLite driver specific. Added in GDAL/OGR 1.9.0. Can be set to e.g. to `OGR_SQLITE_CACHE=1024` to define the internal Page Cache size [value being measured in MB]; if your hardware has enough available RAM, defining a Cache size as big as 512MB (or even 1024MB) may sometimes help a lot in order to get better performance. |
| 390 | | |
| 391 | | === OGR_SQLITE_SYNCHRONOUS === |
| 392 | | |
| 393 | | SQLite driver specific. Setting `OGR_SQLITE_SYNCHRONOUS=OFF` might also increase performance when creating SQLite databases (although at the expense of integrity in case of interruption/crash). |
| 394 | | |
| 395 | | === OGR_SQLITE_LIST_VIRTUAL_OGR === |
| 396 | | |
| 397 | | SQLite driver specific. Added in GDAL/OGR 1.10. Set to "YES" to list VirtualOGR layers. Defaults to "NO" as there might be some security implications if a user is provided with a file and doesn't know that there are virtual OGR tables in it. |
| 398 | | |
| 399 | | === OGR_EDIGEO_FONT_SIZE_FACTOR === |
| 400 | | |
| 401 | | EDIGEO driver specific. Added in GDAL/OGR 1.9.0. See [http://gdal.org/ogr/drv_edigeo.html EDIGEO driver] documentation. |
| 402 | | |
| 403 | | === OGR_EDIGEO_CREATE_LABEL_LAYERS === |
| 404 | | |
| 405 | | EDIGEO driver specific. Added in GDAL/OGR 1.9.0. See [http://gdal.org/ogr/drv_edigeo.html EDIGEO driver] documentation. |
| 406 | | |
| 407 | | === OGR_EDIGEO_RECODE_TO_UTF8 === |
| 408 | | |
| 409 | | EDIGEO driver specific. Added in GDAL/OGR 1.9.0. Can be set to OFF to prevent recoding strings in LATIN-1 to UTF-8. |
| 410 | | |
| 411 | | === OGR_PDF_READ_NON_STRUCTURED === |
| 412 | | |
| 413 | | The PDF driver can read and write geospatial PDF with vector features. Vector read support requires linking to one of the above mentioned dependent libraries, but write support does not. The driver can read vector features encoded according to PDF's logical structure facilities (as described by "§10.6 - Logical Structure" of PDF spec), or retrieve only vector geometries for other vector PDF files. If there is no such logical structure, the driver will not try to interpret the vector content of the PDF, unless you defined the OGR_PDF_READ_NON_STRUCTURED configuration option to YES. |
| 414 | | |
| 415 | | === OGR_SKIP === |
| 416 | | |
| 417 | | This option can be used to unregister one or several OGR drivers. This can be useful when a driver tries to open a datasource that it should not recognize, or when several drivers are built-in that can open the same datasets (for example KML, LIBKML datasources). The value of this option must be a comma delimited list of the short name of the OGR drivers to unregister. |
| 418 | | |
| 419 | | === OSM_CONFIG_FILE === |
| 420 | | |
| 421 | | |
| 422 | | OSM driver specific. The default configuration file for OSM driver is an osmconf.ini file in the data folder of the GDAL distribution. An alternate path can be set this configuration option. |
| 423 | | |
| 424 | | === OSM_MAX_TMPFILE_SIZE === |
| 425 | | |
| 426 | | OSM driver specific. By default tempfile is kept in RAM if it remains under 100 MB and thereafter on disk. The threshold can be adjusted with this configuration option. |
| 427 | | |
| 428 | | === SXF_RSC_FILENAME === |
| 429 | | |
| 430 | | SXF driver specific. The driver uses classifiers (RSC files) to map feature from SXF to layers. To be used automatically, the RSC file should have the same name as SXF file. User can provide RSC file path using config option SXF_RSC_FILENAME. This config option overrides the use of same name RSC. |
| 431 | | |
| 432 | | === SXF_LAYER_FULLNAME === |
| 433 | | |
| 434 | | SXF driver specific. This option allows choosing which layer names to use. If SXF_LAYER_FULLNAME is TRUE - the driver uses long names, if FALSE - short |
| 435 | | |
| 436 | | === SXF_SET_VERTCS === |
| 437 | | |
| 438 | | SXF driver specific. Add to SRS of SXF layers VERT_CS if it present in map description section of the file. Default is NO. |
| 439 | | |
| 440 | | === OGR_PG_RETRIEVE_FID === |
| 441 | | |
| 442 | | PostGIS driver specific. Retrieve FID after insert feature. Default is TRUE. |
| 443 | | |
| 444 | | === OGR_PG_CURSOR_PAGE === |
| 445 | | |
| 446 | | PostgreSQL driver specific. Set the number of rows retrieved for each cursor fetch. |
| 447 | | |
| 448 | | === PG_USE_COPY === |
| 449 | | |
| 450 | | This may be "YES" for using COPY for inserting data to PostgreSQL. COPY is significantly faster than INSERT. Starting with GDAL 2.0, COPY is used by default when inserting from a table that has just been created. |
| 451 | | |
| 452 | | === PG_USE_BASE64 === |
| 453 | | (GDAL >= 1.8.0) If set to "YES", geometries will be fetched as BASE64 encoded EWKB instead of canonical HEX encoded EWKB. This reduces the amount of data to be transferred from 2 N to 1.333 N, where N is the size of EWKB data. However, it might be a bit slower than fetching in canonical form when the client and the server are on the same machine, so the default is NO. |
| 454 | | |
| 455 | | === OGR_TRUNCATE === |
| 456 | | (GDAL >= 1.11) If set to "YES", the content of the table will be first erased with the SQL TRUNCATE command before inserting the first feature. This is an alternative to using the -overwrite flag of ogr2ogr, that avoids views based on the table to be destroyed. Typical use case: "ogr2ogr -append PG:dbname=foo abc.shp --config OGR_TRUNCATE YES". |
| 457 | | |
| 458 | | === TAB_APPROX_GEOTRANSFORM === |
| 459 | | |
| 460 | | When reading a .tab file for raster georeferencing (for example with a .tif), tell if an approximate geotransform from the GCP of the .tab file is acceptable. Default is FALSE. (GDAL >= 2.0) |
| 461 | | |
| 462 | | === SHAPE_RESTORE_SHX === |
| 463 | | |
| 464 | | Added in GDAL/OGR 2.1.0. |
| 465 | | |
| 466 | | Shapefile driver specific. If set to YES driver try to restore/build a missing .shx file |
| | 5 | An index of configuration options is provided on the GDAL official website at https://gdal.org/user/configoptions.html |
