MSYS

MSYS (Minimal SYSstem) provides an easy way to use the COIN-OS build system with compilers/linkers of your own choice, such as the Microsoft command line C++ cl compiler. MSYS is an application that gives the user a Bourne shell that can run configure scripts and Makefiles. No compilers come with MSYS. In the Cygwin, MinGW, and MSYS hierarchy, it is at the bottom the food chain in terms of tools provided. However, it is very easy to use and build the OS project with MSYS. In this discussion we assume that the user has downloaded the OS source code (most likely with TortoiseSVN) and that the cl compiler is present. The project is built using the following steps.

Note:

• If you wish to use the third-party software with MSYS it is best to get wget. See .

• Do not put any imbedded blanks in the path to the OS project.

Execute the following steps to use the Microsoft C++ cl compiler with MSYS.

Step 1.

Download MSYS at

http://sourceforge.net/project/showfiles.php?group_id=2435&package_id=24963

and install. Double clicking on the MSYS icon will open a Bourne shell window.

Step 2.

Download Visual Studio Express C++ at

http://msdn2.microsoft.com/en-us/express/future/bb421473.aspx

and install.

Step 3.

The part of the OS library responsible for communication with a remote server depends on some underlying Windows socket header files and libraries. Therefore it is necessary to also download and install the Windows Platform SDK. Download the necessary files at

http://msdn2.microsoft.com/en-us/express/aa700755.aspx

and install.

Step 4.

Set the Visual Studio environment variables so that paths to the necessary libraries and header files are recognized. Assuming that a standard installation was done for the Visual Studio Express and the Windows Platform SDK set the variables as follows:

PATH=C:\Program Files\Microsoft Visual Studio 8\Common7\IDE;
C:\Program Files\Microsoft Visual Studio 8\VC\BIN;
C:\Program Files\Microsoft Visual Studio 8\Common7\Tools;
C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\bin;
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727;
C:\Program Files\Microsoft Visual Studio 8\VC\VCPackages


INCLUDE=C:\Program Files\Microsoft Visual Studio 8\VC\INCLUDE;
C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Include

LIB = C:\Program Files\Microsoft Visual Studio 8\VC\LIB;
C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\lib;
C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Lib

The environment variables can be set using the System Properties in the Windows Control Panel.

Step 5.

In the MSYS command window connect to the root of the OS project and run configure script and then make as described in Section 4.1.

Run an Example! If make test works, proceed to Section 10 to run the key executable, OSSolverService.

Microsoft Windows users that wish to obtain MSYS for building the OS project can download the appropriate software at http://sourceforge.net/project/showfiles.php?group_id=2435. The user may find this Web site confusing. It is only necessary to download what is referred to as the MSYS Base System. As of this writing the most recent version is MSYS-1.0.11. This file is listed as bash-3.1-MSYS-1.0.11 and the binary download is

http://downloads.sourceforge.net/mingw/bash-3.1-MSYS-1.0.11-1.tar.bz2?modtime=1195140582&big_mirror=1

This will provide the necessary Bourne shell for executing the configure scripts. Users that want to edit the source code in the parsers described in Section 7.4 will need the additional tools , flex and bison. These are listed at the Web site as

bison-2.3-MSYS-1.0.11
flex-2.5.33-MSYS-1.0.11
regex-0.12-MSYS-1.0.11

The last one contains an important DLL, msys-regex-0.dll, without which flex will not start.