FairCom Low-Level API for C

Command-Line Compile - Linux

This section explains the steps to compile and run the Low-Level tutorial from the Linux command line/command shell.

If the FairCom Database Engine is not already running on your machine, start the server. See Setting up the FairCom Database Engine.

Compiling

To compile the Low-Level tutorial from the Linux command line, follow these steps:

1. CD into the proper folder:

   drivers/c.lowlevel/tutorials/cmdline

2. Execute make:

   >make

3. If make works, it prints...

   The lowlevel tutorials are ready to run.

   Type 'make run' to run the tutorials.

Running

Be sure the FairCom Database Engine is running.

To run the tutorial from the Linux command line, follow these steps from the same folder you compiled from:

1. Type the following:

   >make run

2. The make file will run the tutorial.

If you see a c-tree error, you can look it up in the Error Code Reference.

See the Troubleshooting section below for solutions to common problems.

When running, the tutorial should look similar to the text below:

c-treeACE Version 12

Simple Low Level Function Example

Successfully created data files and indices

A)dd D)elete Q)uit:

See the Compile Using Microsoft Visual Studio IDE section for directions on how to use this tutorial.

Note: On systems running a glibc version older than 2.17, the tutorials need to be linked with librt by adding -lrt to the SYSLIBS macro in the makefile. If you are running a system with glbic older than 2.17, edit the makefile and uncomment -lrt.

Troubleshooting

This section lists some of the errors that can occur when compiling and running this tutorials:

Could not initialize c-tree
Error 133 on file -1

The most common cause of this runtime error is that the FairCom Database Engine is not running. Remember that the c-tree evaluation license times out after 3 hours, so the server might have exited and needs to be re-started. See Setting up the FairCom Database Engine for details.