Changes between Version 13 and Version 14 of FAQInstallationAndBuilding

Timestamp:

Jun 12, 2009, 6:59:42 AM (15 years ago)

Author:

Mateusz Łoskot

Comment:

Q: What is GDAL_DATA environment variable?

FAQInstallationAndBuilding

@@ -178 +178 @@
 This problem occurs in [http://curl.haxx.se/libcurl/ libcurl] <= 7.17.1. Perhaps, later versions of libcurl will include this fix.
 
-
 == How can i add particular LDFLAGS with GDAL < 1.5 ==
+
 export the LNK_FLAGS variable with your habitual LDFLAGS content
 {{{
@@ -188 +188 @@
 
 There are additional hints and suggestions for building GDAL with various external support libraries in the BuildHints topic.
+
+== What is GDAL_DATA environment variable? ==
+
+GDAL_DATA is an [http://en.wikipedia.org/wiki/Environment_variable environment variable] used to specify location of [source:trunk/gdal/data supporting files] used by GDAL library as well as GDAL and OGR utilities. For instance, in order for OGR and GDAL to properly evaluate EPSG codes you need to have the EPSG support files (so called dictionaries, mostly in CSV format), like [source:trunk/gdal/data/gcs.csv gcs.csv] and [source:trunk/gdal/data/pcs.csv pcs.csv], found in the directory pointed by GDAL_DATA variable.
+
+== How to set GDAL_DATA variable? ==
+
+On Linux, assuming [source:trunk/gdal/data gdal/data] supporting files are installed under ''/usr/local/share/gdal/data'' and Bash-like shell, export the variable as follows:
+{{{
+$ export GDAL_DATA=/usr/local/share/gdal/data
+}}}
+Refer to manual of your shell to learn how to set the GDAL_DATA variable permanently.
+
+On Windows, assuming supporting files are located under ''C:\GDAL\data'', in order to set the variable in current console session:
+{{{
+C:\> set GDAL_DATA=C:\GDAL\data
+}}}
+It's also possible to set GDAL_DATA variable permanently, as system-wide variable, so it's always available. Follow the instructions of [http://support.microsoft.com/default.aspx/kb/310519 How To Manage Environment Variable] guide.