# wc3270 Build Instructions

## Using MinGW

### Under Cygwin

wc3270 can be built on Windows using the MinGW tools under Cygwin. For more information about MinGW, visit the MinGW webpage. For more information about Cygwin, visit the Cygwin webpage.

The minimum set of Cygwin packages needed to build wc3270 are:

- The default set (bash, etc.)
- The make package from the Devel group.
- The mingw-gcc-core package from the Devel group.
- The mingw-w32api package from the Devel group.

To build wc3270, start a Cygwin shell, cd to the `wc3270-3.3` directory, and type:

       make

wc3270 was developed primarily on 32-bit Windows XP and 64-bit Windows 7, but should be buildable on any Windows from 2000 on.

### On Linux

wc3270 can also be built on Linux with the MinGW cross-compiler. (This is how public releases of wc3270 are built.) On Ubuntu, this compiler is available as the mingw32 package, and the Makefile has been set up to use it. To build wc3270 on Linux with MinGW, use the command:

       make

### With OpenSSL Support

To build an OpenSSL version of wc3270 on Cygwin or Linux, you will need the header files and libraries from the full Win32 OpenSSL distribution described in the SSL Instructions (not the 'lite' version). First, install OpenSSL on your Windows box. Then create a directory called `/usr/local/OpenSSL-Win32` under Cygwin or on your Linux system. Then copy the `include` and `lib` directories from the OpenSSL distribution on the Windows box (usually located in `C:\OpenSSL-Win32`) into `/usr/local/OpenSSL-Win32` on the Cygwin or Linux system. The Makefile will find them automatically and build an SSL-based wc3270. If for some reason you later want to build a non-SSL wc3270, pass the command-line option `NO_SSL=1` to make.

## Using Microsoft Command-Line Tools

To build wc3270 using Microsoft Visual C++ command-line tools, start a Command Prompt window. At the command prompt, 'cd' to the `wc3270-3.3` directory, and type:

       nmake /f Msc\Makefile

This will build `wc3270.exe` and the utilities needed to run it.

Note that to build an OpenSSL version of wc3270, you will need the header files and libraries from the full Win32 OpenSSL distribution described in the SSL Instructions (not the 'lite' version), installed in the directory `C:\OpenSSL-Win32`.

## Using Microsoft Visual Studio

A Microsoft Visual C++ project for wc3270 (along with ws3270 and wpr3287) is included with the full-suite source distribution, in the file `VS\wc3270.vcsproj`.

Also see the note in the previous section about OpenSSL.

## Creating an Installer

The source tarball also includes an .iss file for use with Inno Setup. This is used to construct the install executable. See the Inno Setup webpage for details.