source: general/genutils/unixodbc.xml@ 63bb3941

10.0 10.1 11.0 11.1 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 63bb3941 was 63bb3941, checked in by Randy McMurchy <randy@…>, 15 years ago

Updated to unixODBC-2.2.12

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6747 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 11.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY unixodbc-download-http "http://www.unixodbc.org/unixODBC-&unixodbc-version;.tar.gz">
8 <!ENTITY unixodbc-download-ftp "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/unixODBC-&unixodbc-version;.tar.gz">
9 <!ENTITY unixodbc-md5sum "9a116aad4059c31d231b626ffdf1869a">
10 <!ENTITY unixodbc-size "2.7 MB">
11 <!ENTITY unixodbc-buildsize "101 MB">
12 <!ENTITY unixodbc-time "3.5 SBU (includes building the GUI tools)">
13]>
14
15<sect1 id="unixodbc" xreflabel="unixODBC-&unixodbc-version;">
16 <?dbhtml filename="unixodbc.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>unixODBC-&unixodbc-version;</title>
24
25 <indexterm zone="unixodbc">
26 <primary sortas="a-unixODBC">unixODBC</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to unixODBC</title>
31
32 <para>The <application>unixODBC</application> package is an Open Source
33 ODBC (Open DataBase Connectivity) sub-system and an ODBC SDK for Linux, Mac
34 OSX, and UNIX. ODBC is an open specification for providing application
35 developers with a predictable API with which to access data sources. Data
36 sources include SQL Servers and any data source with an ODBC Driver.
37 <application>unixODBC</application> contains the following components used
38 to assist with the manipulation of ODBC data sources: a driver manager, an
39 installer library and command line tool, command line tools to help install
40 a driver and work with SQL, drivers and driver setup libraries and a suite
41 of graphical tools used to administer ODBC, test drivers and browse data
42 sources.</para>
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>Download (HTTP): <ulink url="&unixodbc-download-http;"/></para>
48 </listitem>
49 <listitem>
50 <para>Download (FTP): <ulink url="&unixodbc-download-ftp;"/></para>
51 </listitem>
52 <listitem>
53 <para>Download MD5 sum: &unixodbc-md5sum;</para>
54 </listitem>
55 <listitem>
56 <para>Download size: &unixodbc-size;</para>
57 </listitem>
58 <listitem>
59 <para>Estimated disk space required: &unixodbc-buildsize;</para>
60 </listitem>
61 <listitem>
62 <para>Estimated build time: &unixodbc-time;</para>
63 </listitem>
64 </itemizedlist>
65
66 <bridgehead renderas="sect3">unixODBC Dependencies</bridgehead>
67
68 <bridgehead renderas="sect4">Optional</bridgehead>
69 <para role="optional"><xref linkend="qt"/> (required to build the GUI tools),
70 <ulink url="http://www.gnu.org/software/pth/">GNU Pth</ulink> and
71 <ulink url="http://www.hughes.com.au/products/msql/">Mini SQL</ulink></para>
72
73 <note>
74 <para>There is a circular dependency with <application>Qt</application>
75 and <application>unixODBC</application>. If you need to build the
76 <application>Qt</application> <application>unixODBC</application>
77 plugin module, you will have to build and install
78 <application>unixODBC</application> once without the GUI tools to satisfy
79 the <application>Qt</application> build. Then, after
80 <application>Qt</application> has been installed, you'll need to build
81 and install <application>unixODBC</application> again if you wish to
82 build the GUI tools.</para>
83 </note>
84
85 <para condition="html" role="usernotes">User Notes:
86 <ulink url="&blfs-wiki;/unixodbc"/></para>
87
88 </sect2>
89
90 <sect2 role="installation">
91 <title>Installation of unixODBC</title>
92
93 <para>Install <application>unixODBC</application> by running the following
94 commands:</para>
95
96<screen><userinput>./configure --prefix=/usr \
97 --sysconfdir=/etc/unixodbc \
98 --enable-fdb \
99 --disable-gui &amp;&amp;
100make</userinput></screen>
101
102 <para>This package does not come with a test suite.</para>
103
104 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
105
106<screen role="root"><userinput>make install &amp;&amp;
107
108find doc -name "Makefile*" -exec rm {} \; &amp;&amp;
109chmod 644 doc/{lst,ProgrammerManual/Tutorial}/* &amp;&amp;
110
111install -v -m755 -d /usr/share/doc/unixODBC-&unixodbc-version; &amp;&amp;
112cp -v -R doc/* /usr/share/doc/unixODBC-&unixodbc-version;</userinput></screen>
113
114 </sect2>
115
116 <sect2 role="commands">
117 <title>Command Explanations</title>
118
119 <!-- <para><parameter>-enable-ltdllib</parameter>: This parameter causes the
120 build to use the system-installed version of
121 <application>Libtool</application>.</para> -->
122
123 <para><parameter>--enable-fdb</parameter>: This parameter enables support
124 for file-based data access.</para>
125
126 <para><parameter>--disable-gui</parameter>: This parameter disables
127 building the GUI tools. Remove it if you have
128 <application>Qt</application> installed and wish to build the GUI
129 tools.</para>
130
131 </sect2>
132
133 <sect2 role="configuration">
134 <title>Configuring unixODBC</title>
135
136 <sect3 id="unixodbc-config">
137 <title>Config Files</title>
138 <para><filename>/etc/unixodbc/*</filename></para>
139
140 <indexterm zone="unixodbc unixodbc-config">
141 <primary sortas="e-etc-unixodbc-">/etc/unixodbc/*</primary>
142 </indexterm>
143 </sect3>
144
145 <sect3><title>Configuration Information</title>
146
147 <para>The files in <filename class='directory'>/etc/unixodbc</filename>
148 are meant to be configured by the system administrator (or the ODBC site
149 administrator if appropriate privileges are granted to
150 <filename class='directory'>/etc/unixodbc</filename>). These files
151 are not meant to be directly edited. The ODBC installer library is
152 responsible for reading and writing the
153 <application>unixODBC</application> config files.</para>
154
155 <para>Unfortunately, there are no <command>man</command> or
156 <command>info</command> pages for the various programs available in the
157 <application>unixODBC</application> package. Along with the information
158 in the <quote>Short Descriptions</quote> below and the documentation
159 installed in <filename
160 class='directory'>/usr/share/doc/unixODBC-&unixodbc-version;</filename>,
161 there are many <filename>README</filename> files throughout the source
162 tree where the use and functionality of the programs can be found.
163 Additionally, you can use the parameter <option>-?</option> with the
164 non-GUI tools for syntax and usage information. Lastly, the
165 <application>unixODBC</application> web site at <ulink
166 url="http://www.unixodbc.org/"/> has very good information.</para>
167
168 </sect3>
169
170 </sect2>
171
172 <sect2 role="content">
173 <title>Contents</title>
174
175 <segmentedlist>
176 <segtitle>Installed Programs</segtitle>
177 <segtitle>Installed Libraries</segtitle>
178 <segtitle>Installed Directories</segtitle>
179
180 <seglistitem>
181 <seg>DataManager, DataManagerII, ODBCConfig, dltest, isql, iusql,
182 odbc_config, odbcinst and odbctest</seg>
183 <seg>libboundparam.so, libesoobS.so, libgtrtst.so, libmimerS.so,
184 libnn.so, libodbc.so, libodbccr.so, libodbcdrvcfg1S.so,
185 libodbcdrvcfg2S.so, libodbcinst.so, libodbcinstQ.so, libodbcminiS.so,
186 libodbcmyS.so, libodbcnnS.so, libodbcpsql.so, libodbcpsqlS.so,
187 libodbctxt.so, libodbctxtS.so, liboplodbcS.so, liboraodbcS.so,
188 libsapdbS.so, libtdsS.so and libtemplate.so</seg>
189 <seg>/etc/unixodbc and /usr/share/doc/unixODBC-&unixodbc-version;</seg>
190 </seglistitem>
191 </segmentedlist>
192
193 <variablelist>
194 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
195 <?dbfo list-presentation="list"?>
196 <?dbhtml list-presentation="table"?>
197
198 <varlistentry id="DataManager">
199 <term><command>DataManager</command></term>
200 <listitem>
201 <para>is a graphical program which can be used to browse/explore ODBC
202 data sources.</para>
203 <indexterm zone="unixodbc DataManager">
204 <primary sortas="b-DataManager">DataManager</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
209 <varlistentry id="DataManagerII">
210 <term><command>DataManagerII</command></term>
211 <listitem>
212 <para>is an enhanced version of <command>DataManager</command>.</para>
213 <indexterm zone="unixodbc DataManagerII">
214 <primary sortas="b-DataManagerII">DataManagerII</primary>
215 </indexterm>
216 </listitem>
217 </varlistentry>
218
219 <varlistentry id="ODBCConfig">
220 <term><command>ODBCConfig</command></term>
221 <listitem>
222 <para>is a graphical program used to make configuration of ODBC data
223 sources extremely easy.</para>
224 <indexterm zone="unixodbc ODBCConfig">
225 <primary sortas="b-ODBCConfig">ODBCConfig</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry id="dltest">
231 <term><command>dltest</command></term>
232 <listitem>
233 <para>is a utility used to check a share library to see if it can be
234 loaded and if a given symbol exists in it.</para>
235 <indexterm zone="unixodbc dltest">
236 <primary sortas="b-dltest">dltest</primary>
237 </indexterm>
238 </listitem>
239 </varlistentry>
240
241 <varlistentry id="isql">
242 <term><command>isql</command></term>
243 <listitem>
244 <para>is a utility which can be used to submit SQL to a data source
245 and to format/output results. It can be used in batch or interactive
246 mode.</para>
247 <indexterm zone="unixodbc isql">
248 <primary sortas="b-isql">isql</primary>
249 </indexterm>
250 </listitem>
251 </varlistentry>
252
253 <varlistentry id="iusql">
254 <term><command>iusql</command></term>
255 <listitem>
256 <para>provides the same functionality as the <command>isql</command>
257 program.</para>
258 <indexterm zone="unixodbc iusql">
259 <primary sortas="b-iusql">iusql</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 <varlistentry id="odbc_config">
265 <term><command>odbc_config</command></term>
266 <listitem>
267 <para>is used to find out details about the installation of
268 the <application>unixODBC</application> package.</para>
269 <indexterm zone="unixodbc odbc_config">
270 <primary sortas="b-odbc_config">odbc_config</primary>
271 </indexterm>
272 </listitem>
273 </varlistentry>
274
275 <varlistentry id="odbcinst">
276 <term><command>odbcinst</command></term>
277 <listitem>
278 <para> is a utility created for install script/RPM writers. It is a
279 command line interface to key functionality in the
280 <filename class='libraryfile'>libodbcinst</filename> library. It does
281 not copy any files (i.e., libraries) but it will modify the ODBC
282 System Information for the user.</para>
283 <indexterm zone="unixodbc odbcinst">
284 <primary sortas="b-odbcinst">odbcinst</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 <varlistentry id="odbctest">
290 <term><command>odbctest</command></term>
291 <listitem>
292 <para>is a graphical program used to test the ODBC API.</para>
293 <indexterm zone="unixodbc odbctest">
294 <primary sortas="b-odbctest">odbctest</primary>
295 </indexterm>
296 </listitem>
297 </varlistentry>
298
299 </variablelist>
300
301 </sect2>
302
303</sect1>
Note: See TracBrowser for help on using the repository browser.