dtSearch Engine For Linux

Developer Information

The dtSearch Text Retrieval Engine for Linux provides a way for C++ and Java developers to incorporate dtSearch text retrieval functions into their applications for the Linux platform.  No dtSearch end-user products are currently available for Linux so some C++ or Java programming is needed to make any use of the Linux version. 

The dtSearch Engine for Linux is dynamically linked with these libraries:
   libicuuc.so (loaded using dlopen)
   libicudata.so (loading using dlopen)

The 64-bit version of the dtSearch Engine is built with GCC 4.9.2 under Red Hat Enterprise Linux 6.
The 32-bit version of the dtSearch Engine is built with GCC 4.4.7 under CentOS 6.9.
C++ applications that use the dtSearch Engine for Linux must be compiled with GCC 4.

The Java API requires Java version 1.4.1 or later. 

Installation Notes

After installing the files using the self-extracting installer, execute the following commands to set up symbolic links in the dtsearch/bin or bin64 folder that are needed both for C++ and Java programming.

cd /bin
cd ../bin64

Additional Resources

Frequently asked questions

New version notices

Using the dtSearch Engine in C++

See the textdemo sample application, in <dtsearch>/examples/gcc/textdemo, for an example demonstrating how to build a C++ application using the dtSearch Engine. 

To build and run the 64-bit version of textdemo:

cd dtsearch/examples/gcc/textdemo
make -f linux64.mak all
make -f linux64.mak run

To build and run the 32-bit version of textdemo:

cd dtsearch/examples/gcc/textdemo
make -f linux32.mak all
make -f linux32.mak run

Making the "all" target compiles and links the textdemo application.

Making the "run" target runs the application.   (Because textdemo is dynamically linked to the dtSearch Engine library (libdtsearch.so.6.0), it will not execute unless LD_LIBRARY_PATH includes the folder where the dtSearch Engine library is located.)

Using the dtSearch Engine in .NET Core

For .NET Core sample code, please see the <dtsearch>/examples/NetStd folder. The readme.html file for each project will explain how to start the project using dotnet.

For API documentation, please see dtSearch .NET Standard API or the help files in the dtSearch help folder.

Using the dtSearch Engine in Java

For Java classes and sample code, see the < dtsearch>/examples/java folder.  The Java interface to the dtSearch Engine is based on the Java Native Interface (JNI). Therefore, both the Java classes and a platform-specific binary executable are needed to use it.

The Java classes are in this file:


This file must be on the CLASSPATH.  Adding the dtSearch examples/java/classes folder to the CLASSPATH, or copying its contents to a folder on the CLASSPATH, will make these classes available in Java.

Under Linux, the binary executable is libdtsearch.so, which must be accessed through a symbolic link named libdtsjava.so.  To run theJavaDemo sample application:

cd dtsearch/examples/java
chmod +x runJavaDemo.sh

If you get a Java "Unsatisfied Link" exception, it means that the necessary symbolic links are not set up in dtsearch/lib.   To correct this:

cd dtsearch/bin64
chmod +x makelinks64.sh ./makelinks64.sh

API Documentation

For API documentation, please see the dtSearch help folder.

The documentation is also available online:

dtSearch Api Reference
dtSearch .NET Standard API
dtSearch Java API

Contacting dtSearch

Thank you for using the dtSearch Engine!  Please let us know if you have any questions or comments.

Sales-related inquiries:
1-800-IT-FINDS (1-800-483-4637)
301-263-0731; fax 301-263-0781

Technical questions:
301-263-0731; fax 301-263-0781

Copyright 1995-2019 dtSearch Corporation.  All rights reserved.