# ws3270 Build Instructions

## Using MinGW

### Under Cygwin

ws3270 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 ws3270 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 ws3270, start a Cygwin shell, cd to the `ws3270-3.3` directory, and type:

       make

ws3270 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

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

       make

### With OpenSSL Support

To build an OpenSSL version of ws3270 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 ws3270. If for some reason you later want to build a non-SSL ws3270, pass the command-line option `NO_SSL=1` to make.

## Using Microsoft Command-Line Tools

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

       nmake /f Msc\Makefile

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

Note that to build an OpenSSL version of ws3270, 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 ws3270 is included with the full-suite source distribution, in the file `VS\ws3270\ws3270.vcsproj`.

Also see the note in the previous section about OpenSSL.