OpenCOBOL Install Guide †
Requirement †
OpenCOBOL requires the following external libraries to be installed:
- GNU MP (libgmp) 4.1.2 or later
- libgmp is used to implement decimal arithmetic.
GNU MP is licensed under GNU Lesser General Public License.
- GNU Libtool (libltdl)
- libltdl is used to implement dynamic CALL statements.
GNU Libtool is licensed under GNU Lesser General Public License.
NOTE - Libtool is not required for Linux and Windows (including MinGW and Cygwin)
The following libraries are optional:
- Berkeley DB (libdb) 1.85 or later
- libdb can be used to implement indexed file I/O and SORT/MERGE.
Berkeley DB is licensed under the original BSD License (1.85) or their own open-source license (2.x or later). Note that, as of 2.x, if you linked your software with Berkeley DB, you must distribute the source code of your software along with your software, or you have to pay royalty to Oracle Corporation. For more information about Oracle Berkeley DB dual licensing go to : Oracle / Embedded / Oracle Berkeley DB
- Ncurses (libncurses) 5.2 or later
- libncurses can be used to implement SCREEN SECTION.
Ncurses is licensed under a BSD-style license.
Installation †
See INSTALL for general installation instruction. Typically, this is done by the following commands:
$ ./configure $ make $ make install
NOTE: make install usually needs to be done under a root account
There are the following configure options:
--with-cc=<cc> specify C compiler command used by cobc --with-db1 use Berkeley DB 1.85 (libdb-1.85) --with-db use Berkeley DB 3.0 or later (default) --with-lfs64 use large file system for file I/O (default)
Development †
If you are a developer, consider building the latest OpenCOBOL from the CVS repository.
You need to install the following extra packages with specified minumum version before building OpenCOBOL:
- Autoconf 2.59
- Automake 1.9.6
- Libtool 1.5.24
- Gettext 0.14.1
- m4 1.4.2
- Texinfo 4.6
- Bison 1.875
- Flex 2.5.4
After checking out the latest source from the repository, run "autoreconf -i -I m4" to generate configure script. You need to run autoreconf whenever you modify configure.ac or Makefile.am.
Note to bash users; packages and the path cache †
After a first time build with make, and having a previous package installed in /usr/bin, be careful to clear the internal path cache. If bash cached a
$ cobc -V cobc (OpenCOBOL) 1.0.0 Copyright (C) 2001-2007 Keisuke Nishida Copyright (C) 2007 Roger While
that it found in /usr/bin, the newer /usr/local/bin installation will not be searched in the path, until a new session or a
$ hash -r
internal command is used to reset the path cache. Then
$ cobc -V cobc (OpenCOBOL) 1.1.0 Build date Jun 7 2008 12:37:33 Copyright (C) 2001-2008 Keisuke Nishida / Roger While
will pick up the proper local executables, and perhaps save a few minutes of confusion. This will only happen the very first time when and if cobc ends up in two places within the path search list and was used before a make install.
Note to Debian (and probably Ubuntu) users: OpenCobol fails to see libncurses †
This will cause the compiler to fail. (ncurses is used for (amongst others) the DISPLAY statement)
To fix:
Edit ld.so:
gedit /etc/ld.so.conf
and add
/usr/local/lib
to the file eg:
include /etc/ld.so.conf.d/*.conf /usr/local/lib
Create symbolic link to ncurses:
sudo ln /lib/libncurses.so.5.7 /lib/libncurses.so
Re-run ld config:
sudo ldconfig
Last-modified: Wed, 22 Dec 2010 01:02:52 GMT (886d)
