1
2
3
41. Using Gwenhywfar
5===================
6
71.1. Needed Components
8----------------------
9
101.1.1. GNU TLS
11
12We use the precompiled packages from the wireshark project (gnutls 1.6.0)
13which also contain all needed libraries such as libgcrypt and libgpg-error.
14
15
16
17
182. Compiling Gwenhywfar
19=======================
20
212.1. Needed Components
22----------------------
23
242.1.1. MinGW32
25
26Gwenhywfar uses MinGW32 on Windows platforms.
27MinGW32 is a project with the goal to provide a free compiler system and a
28nearly complete shell environment which allows to execute the configure
29script. The resulting DLLs and EXEs only link against Windows libraries, so
30there are no licence issues when releasing binary packages.
31These EXEs and DLLs don't need MinGW32 to be installed on the target system.
32The compiler itself is the very well known GCC.
33
34One configure command line that used to work is the following:
35
36  ./configure CPPFLAGS="$REGEX_INCLUDES $GNUTLS_INCLUDES $INTL_INCLUDES" \
37     LDFLAGS="$REGEX_LDFLAGS -lregex $GNUTLS_LDFLAGS $INTL_LDFLAGS -lintl -liconv"
38
39which just means you have to manually supply the -I/some/dir flags and
40-L/some/dir/lib flags for libregex, libintl, libiconv, and gnutls.
41
42
432.1.2. GnuTLS
44
45We use the precompiled packages from the wireshark project (gnutls 1.6.0)
46which also contain all needed libraries such as libgcrypt and libgpg-error.
47To compile gwenhywfar you will also need the developer files (ending in
48*.dll.a and *.h).
49
50
51
52
533.2. Cross-compiling on Linux
54-----------------------------
55
563.2.1. Compiling
57
58
59Gwenhywfar can be cross-compiled. The author uses Debian and its mingw
60package. To compile Gwenhywfar in that environment just use the following
61commands:
62
63>$ make -fMakefile.cvs mp-w32
64>$ make
65>$ make install DESTDIR=/tmp/gwen
66
67
683.2.2. Preparing Files for Shipping
69
70You must then take the DLLs and executables (EXE) from the folder /tmp/gwen
71and copy them into a folder for shipping. When preparing the application
72shipping folder you should have the expected file hierarchy (see above) in
73mind so that the application will find all DLLs and data.
74
75
763.2.3. Installing to the Cross-Compiler Environment
77
78If you want to compile other projects which depend on Gwenhywfar you will
79have to install some files to the cross-compilers environment. On Debian
80this is /usr/i586-mingw32/. Header files go to /usr/i586-mingw32/include
81and libraries must be installed to /usr/i586-mingw32/lib.
82Please don't install the DLLs, only the *.dll.a files, because those are
83the ones needed to compile depending projects (like AqBanking and
84Libchipcard).
85
86
87