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
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
|
===============================================================================
readme.doc emx 0.9a INTRODUCTION 05-Dec-1994
===============================================================================
Copyright (c) 1990-1994 by Eberhard Mattes
*** See history.doc for important information ***
Introduction
------------
Welcome to emx 0.9a, an environment for creating 32-bit programs for
OS/2 2.x and DOS. You can use the GNU C compiler to compile programs
for emx. The main design goal of emx is to simplify porting Unix
software to OS/2 2.x and DOS. Moreover, you can create `native' OS/2
programs, including Presentation Manager applications.
The emx package includes:
- emx.dll, emxio.dll, emxwrap.dll and emxlibc.dll dynamic link
libraries for OS/2 2.x
- emx.exe DOS extender for running 32-bit programs under DOS
- emxfpemu, W. Metzenthen's FPU (387) emulator
- emxbind.exe for creating .exe files which work both under OS/2 2.x
and DOS
- emxomf.exe for converting .o object files (a.out) to .obj object
files (OMF). With emxomf and LINK386 you can create OS/2 programs
that don't need emx.dll
- emximp.exe for creating import libraries
- emxexp.exe for creating a list of export definitions from object files
- C header files and a complete C library
- a simple graphics library for 320x200 (256 colors) mode
- a library for screen output in windows
- header files and a library for using sockets of IBM TCP/IP for OS/2
Additionally, the following GNU programs are available compiled and with
patches and sources:
- GCC 2.6.3, the GNU C compiler, supporting the C, C++, and Objective
C language
- GAS 2.3, the GNU assembler
- GDB 4.13, the GNU debugger
- ld, the GNU linker
- ar, nm, size, strip, objdump: some GNU utilities for dealing with
binary files
- texinfo, the GNU documentation system
- Patches for the GNU sources
- Patched source for GCC, GAS, GDB, ld, ar, nm, size, strip, objdump,
info, makeinfo, texindex. You can compile all these programs with
the files that come with emx (but you also need a make utility, such
as dmake).
You can get the complete unpatched GNU sources by anonymous ftp from
prep.ai.mit.edu and other archives, for instance ftp.uni-stuttgart.de.
Additionally, the following libraries are provided:
- some parts of the BSD C library
- BSD curses library
- Henry Spencer's regexp library
Packages
--------
emx is packaged in the following files:
emxrt.zip emx runtime package
emxsrcr.zip Source for the emx runtime package
emxdev.zip emx development system (without compiler)
emxsrcd.zip Source for the emx development system
emxview.zip emx documentation in OS/2 .inf format
emxample.zip Sample programs
emxtest.zip Test programs (used for testing emx and the libraries)
GNU programs compiled for emx, patches and patched sources:
gnudev.zip GNU development tools compiled for emx
gnuview.zip gnudev.inf (gnudev.doc in OS/2 .inf format)
gppdev.zip Additional GNU programs and files for compiling C++
gobjcdev.zip Additional GNU programs and files for compiling
Objective C
gnupat.zip Patches for GNU sources
gnudoc.zip Documentation for GNU programs (texinfo sources)
gnuinfo.zip GNU texinfo (includes info file browser)
gnusrc.zip Patched GNU sources (ld, ar, nm, size, strip, objdump,
info, termcap, GPPDEMID)
gccsrc1.zip Patched GNU sources (GCC 2.6.3, part 1)
gccsrc2.zip Patched GNU sources (GCC 2.6.3, part 2)
gccsrc3.zip Patched GNU sources (GCC 2.6.3, part 3)
gassrc.zip Patched GNU sources (GAS 2.3)
gdbsrc1.zip Patched GNU sources (GDB 4.13, part 1)
gdbsrc2.zip Patched GNU sources (GDB 4.13, part 2)
gppsrc.zip Patched sources of libg++ 2.6.1
BSD libraries compiled for emx with sources:
bsddev.zip BSD libraries (curses etc.)
bsddoc.zip Documentation for BSD libraries
bsdsrc.zip Source for BSD libraries
Installing emx
--------------
For unpacking, you need unzip v5.0 or later which is available from
many archives. Look for files named
unzip50.exe MS-DOS executable for unzip
unz50_32.exe OS/2 32-bit executable (unzip 5.0)
unz512x2.exe OS/2 32-bit executable (unzip 5.12)
unzip512.exe OS/2 or DOS executable (unzip 5.12)
Read INSTALL.DOC to learn how to install emx.
After unpacking the emx runtime and development system packages,
you'll find further information in the following files:
\emx\doc\COPYING.EMX emx & library license, license overview
\emx\doc\COPYING GNU General Public License
\emx\doc\install.doc Installation guide
\emx\doc\emxrt.doc User's guide to the emx runtime package
\emx\doc\emxdev.doc Application developer's guide
\emx\doc\libref.doc C library reference
\emx\doc\build.doc Compiling the sources
\emx\doc\history.doc Change log
\emx\doc\future.doc Things to do
\emx\book\emxrt.inf .inf version of emxrt.doc
\emx\book\emxdev.inf .inf version of emxdev.doc (optional)
\emx\book\libref.inf .inf version of libref.doc (optional)
After unpacking the GNU and BSD packages, you'll find further
information in the following files:
\emx\doc\COPYING GNU General Public License
\emx\doc\COPYING.LIB GNU Library General Public License
\emx\doc\COPYING.BSD BSD license (for libraries bsd and curses)
\emx\doc\COPYING.IOS Additional information for iostream library
\emx\doc\gnudev.doc GNU development tools information
\emx\doc\bsddev.doc BSD library information
\emx\book\gnudev.inf .inf version of gnudev.doc (optional)
\emx\book\bsddev.inf .inf version of bsddev.doc
Legal stuff
-----------
emx is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
emx is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with emx; see the file COPYING. If not, write to
the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
See \emx\doc\COPYING.EMX and \emx\doc\COPYING for details.
Instead of a list: All the trademarks used in this document and all
the other emx documents are registered to whoever it is that owns
them.
Where to get emx
----------------
emx is available for anonymous ftp on
ftp.uni-stuttgart.de [129.69.18.15]: /pub/systems/os2/emx-0.9a
ftp-os2.cdrom.com: [192.153.46.2]: /os2/32bit/unix/emx09a
src.doc.ic.ac.uk [146.169.2.1]: /packages/os2/32bit/unix/emx09a
ftp.informatik.tu-muenchen.de [131.159.0.198]:
/pub/comp/os/os2/devtools/emx+gcc
Other files of interest
-----------------------
emx does not come with a `make' utility. I recommend dmake 3.8. It's
available for anonymous ftp on
ftp.uni-stuttgart.de [129.69.18.15]: /pub/systems/os2/programming/support/
ftp-os2.cdrom.com: [192.153.46.2]: /os2/all/program/
ftp.informatik.tu-muenchen.de [131.159.0.198]:
/pub/comp/os/os2/devtools/
Executables are in dmake38x.zip, source code is in dmake38s.zip.
dmake38.zip contains both dmake38s.zip and dmake38x.zip.
The emx graphics library currently supports only the 320x200 VGA mode
and some 16-color modes. Johannes Martin has created a graphics
library for various SVGA cards. It is available for anonymous ftp on
ftp.uni-stuttgart.de [129.69.18.15]: /pub/systems/os2/emx-0.9a/contrib/
ftp-os2.cdrom.com: [192.153.46.2]: /os2/32bit/unix/emx09a/contrib/
ftp.informatik.tu-muenchen.de [131.159.0.198]:
/pub/comp/os/os2/gnu/emx+gcc/contrib/
You need svgakt*.zip (or svgakit*.zip) and vesa*.zip (or
vesa_emx*.zip, * is the version number).
If you want to convert the texinfo files (GCC documentation, for
instance) to OS/2 on-line books (.inf files), I recommend Andreas
Kaiser's texi2ipf program:
ftp-os2.cdrom.com: [192.153.46.2]: /os2/32bit/unix/tex/txi2ipf1.zip
ftp.informatik.tu-muenchen.de [131.159.0.198]:
/pub/comp/os/os2/gnu/doc/txi2ipf1.zip
Joining the mailing list
------------------------
An emx-related mailing list has been created: emx-list. The address
for people to request to be added to or removed from the list is:
listserv@eb.ele.tue.nl
To subscribe, send a message containing
sub emx-list Joe User
to listserv@eb.ele.tue.nl. Of course, you should use your name
instead of Joe User's name. To unsubscribe, send a message containing
unsub emx-list
to listserv@eb.ele.tue.nl.
By default, your messages to emx-list are not acknowledged. To tell
the list server to send acknowledge your messages, send a message
containing
set emx-list mail ack
to listserv@eb.ele.tue.nl.
Thanks
------
Thanks to Ron Guilmette for providing copies of the ANSI C and POSIX.1
standards.
Thanks to Kolja Elsaesser, Steffen Haecker, and Kai Uwe Rommel for
contributing code to the emx C library.
Thanks to Holger Veit for preparing the TCP/IP header files.
The author
----------
The author of emx is
Eberhard Mattes
Teckstrasse 81 (TeX: Teckstra\ss e)
D-71696 Moeglingen (TeX: M\"oglingen)
Germany
Internet: mattes@azu.informatik.uni-stuttgart.de (subject to change)
No telephone calls please! It must be stressed that the author does
not reply to letters if you don't include return postage
(international postal reply coupon if you are outside Germany) and a
self-addressed envelope.
--------------------------- END OF README.DOC ------------------------------
|
