$Id: README,v 1.10.4.1 2006/07/01 15:09:33 jklowden Exp $
README for FreeTDS 0.64
Saturday 1 July 2006

* to build FreeTDS read the file INSTALL,
* see also the FreeTDS Users Guide,
  http://www.freetds.org/userguide/

FreeTDS is a free (open source) implementation of Sybase's db-lib,
ct-lib, and ODBC libraries. FreeTDS builds and runs on every flavor of
unix-like systems we've heard of, as well as Win32 (with or without
Cygwin), VMS, and Mac OS X.  Failure to build on your system is probably
considered a bug.  It has C language bindings, and works also with Perl
and PHP, among others.  

FreeTDS is licensed under the GNU LGPL license. See COPYING.LIB for
details.  

Other files you might want to peruse:

AUTHORS		Who's involved
BUGS		Some things we fixed, or think we did
ChangeLog	Detailed list of changes
NEWS		Summary of feature changes and fixes
README		This file
TODO		The roadmap, such as it is

Also, doc/api_status.txt shows which functions are implemented.  

************************************
** Warning regarding Sybase 12.5! **
************************************

Do Not Use TDS version 4.2 to connect to Sybase 12.5. Please!  

While we don't like to put the bad news first, neither do we want you to
hurt your server.  We know that our implementation of TDS 4.2 gives
Sybase 12.5 a bad case of heartburn.  In short: it crashes the server.  

We don't know what it is about our version of TDS 4.2 that Sybase 12.5
doesn't like, and we'd like to figure it out eventually.  But in the
meanwhile, until we can find the problem and fix it, please don't use
that combination.  Unless you want to help us test it, that is.  

FreeTDS 0.63 works fine with Sybase 12.5 if you use TDS version 5.0.  

If you are using Sybase 12.5 and anything above is not clear to you,
please see the User Guide.  If it is still not clear after that, please
write to the FreeTDS mailing list.  We'd rather answer your questions
while your server is still running.  

Thank you.  We return now to your regularly scheduled README, already in
progress. 

New in this version
===================

ct-lib
------

Ct-lib now sports bcp and cursors.  The largest missing feature is now
placeholder support compatible with Perl's DBD::Sybase.  

ODBC
----

ODBC continues to be improved.  It is now compatible with OpenOffice.org, for
example, and even works with Oracle's OTL libary.  It has better 64-bit
support.  

Applications
------------

This version includes two new applications, bsqldb and defncopy.  See their man
pages for details.  

etc.
----

Naturally, there have been other improvements as well.  This version compiles
and runs better than its predecessors.  



Documentation
=============

A User Guide, in sgml and html form, is included in this distribution. 
Also included is a reference manual, generated in HTML with Doxygen. 
"make install" installs the HTML documentation, by default to
/usr/local/share/doc/freetds-<version>.  


Note to Users
=============

Submissions of test programs (self-contained programs that demonstrate
functionality or problems) are greatly appreciated.  They should
create any tables needed (since we obviously don't have access to your
database) and populate them.  Unit tests for any of the libraries
is appreciated

Notes to Developers
===================

The code is split into several pieces.

1) tds directory is the wire level stuff, it should be independent of
   the library using it, this will allow db-lib, ct-lib, and ODBC to
   sit on top.

2) db-lib directory. This is the actual db-lib code which runs on top of
   tds.

3) ct-lib directory. This is the ct-lib code which runs on top of tds. 

4) server directory. This will be a set of server routines basically
   to impersonate a dataserver, functions like send_login_ack() etc...

5) odbc directory. ODBC implementation over tds.  Uses iODBC or
   unixODBC as a driver manager.  You need to have one of those if you
   are using the ODBC CLI.

6) unittests directories. Test harness code for ct-lib, db-lib, ODBC and
   libtds.

6) samples directories. Sample code for getting started with Perl,
   PHP, etc...

7) pool directory. A connection pooling server for TDS.  Useful if you
   have a connection limited license.  Needs some hacking to get
   configured but is quite stable once configured correctly. Contact
   the list if interested in how to use it.

Please look at doc/getting_started.txt for a description of what is
going on in the code.

Side note: Brian, as many free software authors, appreciates postcards
from all over. So if you live someplace neat (read: not Michigan) and
want to send one, email him (brian (a] bruns.org) for his current snail mail
address.

Indexes created Sat Nov 28 12:39:51 UTC 2009

Terms of Use | Privacy | Trademarks | Copyright Policy | Site Guidelines | Help
Your use of this web site or any of its content or software indicates your agreement to be bound by these Terms of Use.
Copyright © 1995-2008 Sun Microsystems, Inc.