| 1 | Cross-compiling RegLookup to Windows with MinGW
|
|---|
| 2 | ===============================================
|
|---|
| 3 |
|
|---|
| 4 | MinGW can be used to compile Windows binaries from UNIX environments.
|
|---|
| 5 | The following instructions outline the steps required to build
|
|---|
| 6 | reglookup.exe and reglookup-recover.exe. This process is experimental
|
|---|
| 7 | and Windows binaries have not been well tested. You have been warned.
|
|---|
| 8 |
|
|---|
| 9 | Prerequisites
|
|---|
| 10 | -------------
|
|---|
| 11 |
|
|---|
| 12 | - Before you start, ensure you have MinGW installed. Under Debian,
|
|---|
| 13 | install the `mingw32' package.
|
|---|
| 14 |
|
|---|
| 15 | - Download pre-compiled libiconv packages from here:
|
|---|
| 16 | http://gnuwin32.sourceforge.net/packages/libiconv.htm
|
|---|
| 17 |
|
|---|
| 18 | You will need to download the "Binaries" and "Developer files"
|
|---|
| 19 | packages, whose files are named libiconv-VERSION-bin.zip and
|
|---|
| 20 | libiconv-VERSION-lib.zip respectively.
|
|---|
| 21 |
|
|---|
| 22 | - Unpack both zip files into a designated top-level directory.
|
|---|
| 23 | Suggested commands:
|
|---|
| 24 | $ mkdir /usr/local/src/libiconv-VERSION-bin /usr/local/src/libiconv-VERSION-lib
|
|---|
| 25 | $ cd /usr/local/src/libiconv-VERSION-bin
|
|---|
| 26 | $ unzip .../path/to/libiconv-VERSION-bin.zip
|
|---|
| 27 | $ cd /usr/local/src/libiconv-VERSION-lib
|
|---|
| 28 | $ unzip .../path/to/libiconv-VERSION-lib.zip
|
|---|
| 29 |
|
|---|
| 30 |
|
|---|
| 31 | Building
|
|---|
| 32 | --------
|
|---|
| 33 |
|
|---|
| 34 | Review the top level RegLookup Makefile to ensure the settings match
|
|---|
| 35 | your environment. Find the conditional block which looks like:
|
|---|
| 36 |
|
|---|
| 37 | ################################################################################
|
|---|
| 38 | # MinGW cross-compiling build settings
|
|---|
| 39 | ifdef BUILD_MINGW
|
|---|
| 40 |
|
|---|
| 41 | ## These may need to be changed
|
|---|
| 42 | CC=i586-mingw32msvc-cc
|
|---|
| 43 | LIBICONV_PATH=/usr/local/src/libiconv-1.9.2-1-lib
|
|---|
| 44 |
|
|---|
| 45 | ## These probably do not need to be changed
|
|---|
| 46 | BIN_EXT=.exe
|
|---|
| 47 | INC:=$(INC) -I$(LIBICONV_PATH)/include
|
|---|
| 48 | EXTRA_OBJ=$(LIBICONV_PATH)/lib/libiconv.dll.a
|
|---|
| 49 |
|
|---|
| 50 | endif
|
|---|
| 51 | ################################################################################
|
|---|
| 52 |
|
|---|
| 53 |
|
|---|
| 54 | If either the CC or LIBICONV_PATH settings are incorrect for your
|
|---|
| 55 | system, either update the Makefile, or override these options at build
|
|---|
| 56 | time when you run make. For instance, the above settings in the
|
|---|
| 57 | Makefile are correct, you can execute the build by running:
|
|---|
| 58 |
|
|---|
| 59 | $ make BUILD_MINGW=1
|
|---|
| 60 |
|
|---|
| 61 | Alternatively, you may override the variables above with:
|
|---|
| 62 |
|
|---|
| 63 | $ make BUILD_MINGW=1 CC=my-mingw-binary LIBICONV_PATH=.../path/to/libiconv-VERSION-lib
|
|---|
| 64 |
|
|---|
| 65 | Once the build is complete, you'll find the .exe files under the
|
|---|
| 66 | build/bin directory.
|
|---|
| 67 |
|
|---|
| 68 |
|
|---|
| 69 | Installation
|
|---|
| 70 | ------------
|
|---|
| 71 | Naturally, there is no install Makefile target for the MinGW build
|
|---|
| 72 | process, since we aren't installing on the local system. To install
|
|---|
| 73 | these binaries on a Windows machine, simply copy over the reglookup.exe
|
|---|
| 74 | and reglookup-recover.exe files from the build/bin directory to the
|
|---|
| 75 | desired host. In addition, you will need to install the libiconv2.dll
|
|---|
| 76 | file on that host (either in the same directory as the reglookup
|
|---|
| 77 | executables, or somewhere in the DLL search path). This file is
|
|---|
| 78 | available in the libiconv-VERSION-bin.zip file you downloaded earlier,
|
|---|
| 79 | under the `bin' subdirectory.
|
|---|
| 80 |
|
|---|
