FreeBSD Install Instructions for Chilkat C/C++ Libs

Install the binary distribution by extracting the files from the compressed archive. For example:

(64-bit)
gzip -d chilkat-9.5.0-x86_64-freebsd.tar.gz
tar -xf chilkat-9.5.0-x86_64-freebsd.tar

(32-bit)
gzip -d chilkat-9.5.0-x86-freebsd.tar.gz
tar -xf chilkat-9.5.0-x86-freebsd.tar

This will create a 'chilkat-9.5.0-x86_64-freebsd' sub-directory containing the Chilkat C++ binary distribution.

Setting the LD_LIBRARY_PATH search path

You will need to set the library search path LD_LIBRARY_PATH.

In the following shell commands, the <chilkat-path> denotes the full path to the chilkat-9.5.0-x86_64-freebsd directory.

For Bourne Shell, K Shell or Bash, type:

export LD_LIBRARY_PATH=<chilkat-path>/lib:$LD_LIBRARY_PATH

For C Shell, type:

setenv LD_LIBRARY_PATH "<chilkat-path>/lib:$LD_LIBRARY_PATH"

Linking with the Chilkat Shared Library

The Chilkat shared library is located in the "lib" subdirectory. It is named libchilkat-<version>.so. To link with the shared library, use the "-l" option. For example:

gcc -o my_application my_application.o -lchilkat-9.5.0 -lpthread

In order to find a shared library, the dynamic linker looks in certain directories to find the library. Generally it will look in /usr/lib and /lib. Your system may also be configured to look in other directories (with ldconfig). If you have an environment variable called LD_LIBRARY_PATH it will check the directories listed there first (paths should be separated by colons).

It is also possible to add an additional directory to the library search path with the -L option. If -L is used, then it is not necessary to set LD_LIBRARY_PATH. For example:

gcc -o my_app my_app.o -L/home/joe/chilkat-9.5.0-x86_64-freebsd/lib -lchilkat-9.5.0 -lpthread

* The "-lpthread" is required because of the POSIX threading system calls used within Chilkat.