postgis/doc/reference_guc.xml
Bborie Park 79efa0e64a fix GUC gdal_datapath
git-svn-id: http://svn.osgeo.org/postgis/trunk@12155 b70326c6-7e19-0410-871a-916f4a2858ee
2013-12-07 19:22:49 +00:00

82 lines
3.1 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<sect1 id="PostGIS_GUC">
<sect1info>
<abstract>
<para>This section lists custom PostGIS Grand Unified Custom Variables(GUC). These can be set globally, by database, by session or by transaction. Best set at global or database level.</para>
</abstract>
</sect1info>
<title>PostGIS Grand Unified Custom Variables (GUCs)</title>
<refentry id="postgis_backend">
<refnamediv>
<refname>postgis.backend</refname>
<refpurpose>The backend to service a function where GEOS and SFCGAL overlap. Options: geos or sfcgal. Defaults to geos.</refpurpose>
</refnamediv>
<refsection>
<title>Description</title>
<para>This GUC is only relevant if you compiled PostGIS with sfcgal support. By default <varname>geos</varname> backend is used for functions where both GEOS and SFCGAL have the same named function. This variable allows you to override and make sfcgal the backend to service the request.</para>
<para>Availability: 2.1.0</para>
</refsection>
<refsection>
<title>See Also</title>
<para><xref linkend="reference_sfcgal" /></para>
</refsection>
</refentry>
<refentry id="postgis_gdal_datapath">
<refnamediv>
<refname>postgis.gdal_datapath</refname>
<refpurpose>
A configuration option to assign the value of GDAL's GDAL_DATA option. If not set, the environmentally set GDAL_DATA variable is used.
</refpurpose>
</refnamediv>
<refsection>
<title>Description</title>
<para>
A PostgreSQL GUC variable for setting the value of GDAL's GDAL_DATA option. The <varname>postgis.gdal_datapath</varname> value should be the complete physical path to GDAL's data files.
</para>
<para>
This configuration option is of most use for Windows platforms where GDAL's data files path is not hard-coded. This option should also be set when GDAL's data files are not located in GDAL's expected path.
</para>
<note>
<para>
This option can be set in PostgreSQL's configuration file postgresql.conf. It can also be set by connection or transaction.
</para>
</note>
<para>Availability: 2.2.0</para>
<note>
<para>
Additional information about GDAL_DATA is available at GDAL's <ulink url="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Configuration Options</ulink>.
</para>
</note>
</refsection>
<refsection>
<title>Examples</title>
<para>Set and reset <varname>postgis.gdal_datapath</varname></para>
<programlisting>
SET postgis.gdal_datapath TO '/usr/local/share/gdal.hidden';
SET postgis.gdal_datapath TO default;
</programlisting>
<para>Setting on windows for a particular database</para>
<programlisting>ALTER DATABASE gisdb
SET postgis.gdal_datapath = 'C:/Program Files/PostgreSQL/9.3/gdal-data';</programlisting>
</refsection>
<refsection>
<title>See Also</title>
<para>
<xref linkend="RT_PostGIS_GDAL_Version" />, <xref linkend="RT_ST_Transform" />
</para>
</refsection>
</refentry>
</sect1>