summaryrefslogtreecommitdiff
path: root/README-win32.md
blob: afa338aa641acc4d1cfacf2d9a6ca9d1555c8419 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
# Using rabbitmq-c on Windows

There are three approaches to building rabbitmq-c under Windows:

- THE PREFERRED METHOD:
  Build using CMake, which will cover building with MSVC or MinGW
  See the README file for details on how to build with cmake.

- Build using the MinGW/MSYS (MinGW/MSYS is a port of the GNU
  toolchain and utilities to Windows, including the gcc compiler).
  The results of building in this way are native Windows DLLs and
  EXEs, and can be used without having MinGW installed.  The drawback
  to this approach is that you cannot safely call the resulting
  librabbitmq DLL from code compiled with Microsoft's C compiler.  The
  advantage is that the whole of rabbitmq-c can be built under
  Windows, including the tools.

- Build using Microsoft's C compiler.  You will still need to install
  MinGW/MSYS in order to run the rabbitmq-c build scripts, but
  Microsoft's compiler is used to compile the code.  The resulting
  librabbitmq DLL can be used from code compiled with Microsoft's C
  compiler (i.e. code developed in Visual Studio).  The downside to
  this approach is that the rabbitmq-c tools cannot be built, due to
  dependencies on other libraries.


## Common steps

With either of the approaches, the initial steps are the same: You
should download and install MinGW/MSYS and Python.

Installing installing the relevant parts of MinGW/MSYS can be fairly
time consuming - there are dozens of files to be downloaded and
unpacked.  To make it easier, we provide a bash script that automates
this process, in `rabbitmq-c/etc/install-mingw.sh`.  You can run this
script under cygwin or Linux (obviously if you use Linux you'll need
to transfer the resulting files over to the Windows machine).

Note that some MinGW packages are .tar.lzma files, so it requires a
system with the xz compression utility and a tar that supports the -J
option.  Recent cygwin and Linux distros should be fine here.

Run the install-mingw.sh script specifying the destination directory,
e.g.

  $ etc/install-mingw.sh mingw

This will download all the required MinGW/MSYS packages, and unpack
them into the `mingw` directory.

The other prerequisite for the rabbitmq-c build is Python.  The
Windows installer from python.org for the latest 2.x version of Python
will do fine.

You will also need to copy the source code for rabbitmq-c and
rabbitmq-codegen somewhere under your `mingw` directory.

Then to start the MSYS bash shell, open a `cmd` window, and ensure
that both the MinGW bin directory and the python install directory are
in the path, e.g.

  C:\>set PATH=%PATH%;C:\mingw\bin;C:\Python27

Then start bash, and run the following mount command (substituting the
Windows path of your MinGW install if it isn't `C:\mingw`):

  C:\>bash
  bash-3.1$ mount 'C:\mingw' /mingw

Finally, go to wherever you copied the rabbitmq-c source.

  bash-3.1$ cd /rabbitmq-c


## Building rabbitmq-c with Microsoft's C compiler

The Microsoft C/C++ compiler is part of MS Visual Studio, including
the gratis Visual Studio Express.  Visual Studio 2005 and higher are
known to work.

Start by following the steps in the previous section.  The GNU build
tools have limited support for Microsoft toolchain, but the
install-mingw.sh script will install versions of the packages that are
known to be suitable.  In particular, only libtool version 2.2.7a is
known to work; later versions have been reported to introduce
problems.

Once you are at the bash prompt, build rabbitmq-c by running the
script in `rabbitmq-c/etc/build-ms.sh`:

  bash-3.1$ etc/build-ms.sh

You should end up with a directory `build` containing the librabbitmq
DLL, the corresponding .lib file, and header files.  These are
sufficient to create applications using librabbitmq within Visual
Studio.

build-ms.sh produces 32-bit binaries by default.  If you have an
appropriate version of Visual Studio (e.g. VS2010), you can build
64-bit binaries with:

  bash-3.1$ etc/build-ms.sh --enable-64-bit


## Building rabbitmq-c with gcc

There is no script to build rabbitmq-c with gcc, but it is as
documented in the README file:

  bash-3.1$ autoreconf -i && ./configure && make

You can run the resulting tool EXEs without needing the rest of MinGW.  To do
this, copy the following files into a single directory:

- rabbitmq-c/tools/.libs/*.exe

- rabbitmq-c/librabbitmq/.libs/librabbitmq-0.dll

- /bin/libpopt-0.dll

- /bin/libiconv-2.dll

- /bin/libintl-8.dll