Build/configure

How to use the x3270 family configure script.

The basic way to configure an x3270 family build on a POSIX system is with this command: ./configure

Selective configure
If you only want to build a subset of the programs, you can limit the scope of the configure script with the following options. Note that the options are cumulative, so you can specify exactly the set of programs you want.
 * --enable-unix
 * --disable-unix
 * Include or exclude all of the Unix (POSIX) programs


 * --enable-windows
 * --disable-windows
 * Include or exclude all of the Windows programs


 * --enable-x3270
 * --disable-x3270
 * Include or exclude x3270


 * --enable-c3270
 * --disable-c3270
 * Include or exclude c3270


 * --enable-s3270
 * --disable-s3270
 * Include or exclude s3270


 * --enable-tcl3270
 * --disable-tcl3270
 * Include or exclude tcl3270


 * --enable-pr3287
 * --disable-pr3287
 * Include or exclude pr3287


 * --enable-ws3270
 * --disable-ws3270
 * Include or exclude the Windows version of s3270


 * --enable-wc3270
 * --disable-wc3270
 * Include or exclude wc3270


 * --enable-wpr3287
 * --disable-wpr3287
 * Include or exclude the Windows version of pr3287

When you limit the configuration this way, it changes the top-level make targets, so make, make install, make clean and make clobber will operate only on the programs you have configured.

Common configure options

 * --help
 * Display a help message.


 * --help=recursive
 * Display a help message for all subdirectories. Many individual programs and libraries have unique options and this will display them all.


 * -C
 * Use a cache for test results. Speeds up the process considerably.

POSIX program configure options
These apply only to POSIX programs; the options for Windows programs are fixed.
 * --prefix=prefix
 * Install architecture-independent files under prefix (defaults to /usr/local)


 * --exec-prefix=eprefix
 * Install architecture-dependent files (executables) under eprefix (defaults to prefix)


 * --bindir=dir
 * Install user executables in dir (defaults to eprefix/bin)


 * --sysconfdir=dir
 * Install configuration files (ibm_hosts, character sets) in dir (defaults to prefix/etc).


 * --disable-dbcs
 * Leave out DBCS (Double Byte Character Set) support.


 * --disable-local-process
 * Leave out local process (connecting to "-e shell_command") support. This will be automatically disabled if the local system does not support the forkpty library call.


 * --disable-stransport
 * macOS only: Use OpenSSL instead of Secure Transport for TLS support. (Secure Transport is deprecated and has several known issues.) If this option is given, --with-openssl= (see below) may also need to be specified if TLS support is still desired. New in 4.3 This is the default.


 * --enable-stransport
 * New in 4.3 macOS only: Use Secure Transport instead of OpenSSL for TLS support.


 * --disable-tls
 * Leave out TLS support. It will be automatically disabled if the appropriate TLS library cannot be found.


 * --with-openssl=dir
 * Specifies the directory where the OpenSSL library and header files are installed. Note that this option was previously called --with-ssl=.

Build variables
These variables are defined on the ./configure command line with the syntax NAME=value
 * BUILDCC
 * New in 4.3 Defines the path of the native ('build') C compiler. Normally this is the same as CC, but if you are cross-compiling for POSIX, you will need to specify this in order for the local tools (which execute on the build machine) to build properly.