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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
tqsllib
=======
This is the TrustedQSL library, part of the TrustedQSL project:
http://sourceforge.net/projects/trustedqsl/
===================================================================
Contents
1) Prerequisites
2) Building the Library under Linux/Unix
3) Building the Library under Mac OS X
4) Building the Library under Windows.
===================================================================
1) Prerequisites
The TrustedQSL library depends on several other libraries:
OpenSSL (http://www.openssl.org/)
expat 1.x XML parser library (http://expat.sourceforge.net/)
zlib (http://www.gzip.org/zlib/)
Most Unix and unix-like workstations will have these available. For
those systems that do not, the packages are easily built. Instructions
for building under the Windows environment are given below under
"Building the "Library under Windows."
In the instructions that follow, the versions of other packages
that were used to build the tqsllib package as of the date this
document was last updated are given in parentheses.
===================================================================
2) Building the Library under Linux/Unix
The quick answer:
./configure
make
make install
That will install the library under /usr/local. It also will install
the needed header files under /usr/local/include and a sample program
that dumps the configuration file, dumptqsldata, under /usr/local/bin.
You can change the install location via:
./configure --prefix=/foo/bar
By default, both shared and static versions of the library are built.
You can change that using the standard libtool options, and you can also
specify the location of needed libraries. For details, see:
./configure --help
===================================================================
3) Building the Library under Mac OS X
This is done in much the same manner as building under Linux/Unix, above.
However, it is desirable to *not* build a dylib (shared library). Rather,
use a static library so that applications will not have to distribute and
manage the dylib as a system file.
You also may not want to install the library into system directories:
./configure --disable-shared --prefix=$HOME/tqsllib
make
make install
===================================================================
4) Building the Library under Windows
The end result of building under Windows will be a single DLL,
TQSLLIB2.DLL.
Building under Windows is a bit more complicated to set
up since the build environment has to mimic the unix environment
that is native to the other platforms. For this purpose, we used
the MSYS/MinGW environment. You also will certainly need to obtain
and build the prerequisite software. What follows is a complete
guide to installing and building everything:
Along with the software packages listed under Prerequisites, above,
the development enviromnent is set up my obtaining and installing the
following:
MinGW, MSYS and the MSYS Developer's Toolkit (DTK) (http://www.mingw.org/)
STEP 1) Set up the build environment
Install MinGW (3.1.0-1)
Install MSYS (1.0.10)
Note: MSYS should be installed to a directory path that does not
contain any spaces!
Install MSYS DTK (1.0.1)
The rest of the procedure is performed from within an MSYS shell.
Launch MSYS via the Windows Start menu. (It will be in the MinGW
program group unless you explicitly installed it elsewhere.)
**NOTE**
Since MSYS simulates a Unix-type environment, you should take note
of the following:
A) In paths, directories are separated by a forward slash (/) not
a backslash (\).
B) Unix commands are case-sensitive.
C) The 'cd' command changes the current directory. If given with
no arguments, it changes to the "home" directory. Each of the
following steps is begun from the home directory.
STEP 2) Compile OpenSSL (0.9.7e)
Install the openssl source.
cd
tar -xzf openssl-0.9.7e.tar.gz
cd openssl-0.9.7e
./config no-shared --prefix=$HOME/openssl mingw
make install_sw
STEP 3) Compile the expat library (1.95.8)
Install the expat source
cd
tar -xzf expat-1.95.8.tar.gz
cd expat-1.95.8
./configure --disable-shared --prefix=$HOME/expat
make installlib
STEP 4) Compile the zlib library (1.2.1)
Install the zlib source
cd
tar -xzf zlib-1.2.1.tar.gz
cd zlib-1.2.1
./configure --prefix=$HOME/zlib
make install
STEP 5) Compile the tqsllib library (1.6)
Install the tsqllib source
cd
tar -xzf tqsllib-1.6.tar.gz
cd tqsllib-1.6
./configure --disable-shared --prefix=$HOME/tqsllib
make install
This should result in the creation of the tqsllib2.dll
file and the dumptqsldata.exe file, both in $HOME/tqsllib/bin.
|
