home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / OS2 / SSAVER2X.ZIP / EMXRT.DOC < prev    next >
Text File  |  1993-07-12  |  24KB  |  713 lines
  1. ===============================================================================
  2. emxrt.doc         emx 0.8g     USER'S GUIDE TO THE EMX RUNTIME      13-Jul-1993
  3. ===============================================================================
  4.                                      Copyright (c) 1990-1993 by Eberhard Mattes
  5.  
  6.  
  7. 1 Table of Contents
  8. ===================
  9.  
  10. 1    Table of Contents
  11. 2    Introduction to the User's Guide to the emx Runtime
  12. 2.1    Hardware requirements
  13. 2.2    Files included in the emx runtime package
  14. 3    Copyright
  15. 4    Installing the emx runtime package under OS/2 2.x
  16. 4.1    Summary for impatient OS/2 users
  17. 4.2    Detailed instructions for OS/2 users
  18. 5    Installing the emx runtime package under DOS
  19. 5.1    Summary for impatient DOS users
  20. 5.2    Detailed instructions for DOS users
  21. 6    Environment variables (OS/2 and DOS)
  22. 6.1    Environment variables (DOS)
  23. 7    DOS Notes
  24. 8    emx options
  25. 8.1    emx options (OS/2)
  26. 8.2    emx options (DOS)
  27. 9    emx messages (DOS)
  28. 10   Obtaining the complete emx package
  29. 11   The author of emx
  30.  
  31.  
  32. 2 Introduction to the User's Guide to the emx Runtime
  33. =====================================================
  34.  
  35. This is the documentation for the emx runtime package.  The emx
  36. runtime is an environment for 32-bit programs under OS/2 2.0, OS/2 2.1
  37. (OS/2 2.x, in short), MS-DOS and PC-DOS (DOS, in short).
  38.  
  39. Under OS/2, you can view the .inf version of this document by typing
  40.  
  41.     view \emx\book\emxrt
  42.  
  43. If you add \emx\book to the BOOKSHELF environment variable, you can
  44. type
  45.  
  46.     view emxrt
  47.  
  48. to view that on-line book.
  49.  
  50.  
  51. 2.1 Hardware requirements
  52. -------------------------
  53.  
  54. - emx requires an 80386 CPU (80386DX, 80386SX, i486)
  55.  
  56. - emx requires an 80387 coprocessor (or i486 processor) if floating
  57.   point math is to be used under DOS
  58.  
  59.  
  60. 2.2 Files included in the emx runtime package
  61. ---------------------------------------------
  62.  
  63. The emx runtime package includes the following files:
  64.  
  65.   \emx\bin\emx.exe              emx runtime for DOS
  66.   \emx\bin\emxbind.exe          Tool for modifying emx programs (DOS and OS/2)
  67.   \emx\bin\emxrev.cmd           Tool for finding emx revisions (OS/2)
  68.   \emx\book\emxrt.inf           The text you're looking at (VIEW version)
  69.   \emx\dll\emx.dll              emx runtime for OS/2
  70.   \emx\dll\emxio.dll            Hardware port I/O under OS/2
  71.   \emx\dll\emxlibc.dll          C library for emx programs (OS/2)
  72.   \emx\dll\emxwrap.dll          Interface to 16-bit OS/2 functions (OS/2)
  73.   \emx\doc\emxrt.doc            The text you're looking at (text version)
  74.   \emx\etc\termcap.dat          Terminal data base for termcap-based programs
  75.  
  76.  
  77. 3 Copyright
  78. ===========
  79.  
  80. emx.exe, emxbind.exe, emx.dll, emxio.dll, emxwrap.dll and emxrt.doc
  81. are
  82.  
  83.     Copyright (c) 1990-1993 by Eberhard Mattes.
  84.  
  85.     Everybody is allowed to use the emx runtime package.  You are
  86.     allowed to copy the unmodified emx runtime package if you do not
  87.     charge for the distribution.
  88.  
  89. THERE IS NO WARRANTY!
  90.  
  91.     No guarantee is made as to the proper functioning of the software.
  92.     No liability will be admitted for damage resulting from using the
  93.     software.
  94.  
  95.  
  96. 4 Installing the emx runtime package under OS/2 2.x
  97. ===================================================
  98.  
  99.  
  100. 4.1 Summary for impatient OS/2 users
  101. ------------------------------------
  102.  
  103. 1.  Add \emx\dll to LIBPATH (always use the latest copy of the .dll
  104.     files!)
  105.  
  106. 2.  Add \emx\bin to PATH
  107.  
  108. 3.  Reboot
  109.  
  110.  
  111. 4.2 Detailed instructions for OS/2 users
  112. ----------------------------------------
  113.  
  114. emx requires OS/2 2.x and does not run in DOS mode of OS/2.
  115.  
  116. Before changing config.sys, make a backup copy of that file!
  117.  
  118. The emx runtime is implemented as a set of dynamic link libraries
  119. under OS/2:
  120.  
  121. emx.dll
  122.         emx run-time support for OS/2 2.x
  123.  
  124. emxio.dll
  125.         access to hardware ports for emx programs under OS/2 2.x
  126.  
  127. emxlibc.dll
  128.         emx C library
  129.  
  130. emxwrap.dll
  131.         32-bit wrappers for 16-bit OS/2 API functions
  132.  
  133. OS/2 looks for dynamic link libraries in the directories listed in the
  134. LIBPATH statement of your config.sys file.  Note that LIBPATH is not
  135. an environment variable!
  136.  
  137. At any time, at most one version of a dynamic link library is loaded.
  138. If there are different versions of a dynamic link library in the
  139. directories listed in the LIBPATH statement, the first one listed is
  140. loaded.  If you already have installed the emx dynamic link libraries,
  141. you should be carefull to use the latest revision of those dynamic
  142. link libraries.  Newer emx dynamic link libraries work with older emx
  143. programs, but newer emx programs don't work with older emx dynamic
  144. link libraries.  To find out about already installed emx dynamic link
  145. libraries, type
  146.  
  147.     cd \emx\bin
  148.     emxrev
  149.  
  150. If no emx dynamic link libraries are installed, no output is produced.
  151. If there are emx dynamic link libraries installed, the names and
  152. revision numbers are displayed, for instance
  153.  
  154.     EMX : revision = 12
  155.     EMXIO : revision = 12
  156.     EMXLIBC : revision = 12
  157.     EMXWRAP : revision = 12
  158.  
  159. Only directories listed in the LIBPATH statement are sought.  To find
  160. out the revision numbers of the dynamic link libraries of this
  161. package, type
  162.  
  163.     emxrev -d c:\emx\dll
  164.  
  165. if you've put the emx runtime package on drive C.  After running
  166. emxrev, you should quit the command processor by typing
  167.  
  168.     exit
  169.  
  170. to release the dynamic link libraries (they have been loaded by
  171. cmd.exe as emxrev is a REXX procedure).  Otherwise, you cannot rename,
  172. overwrite or delete those files.  This also happens if one of the emx
  173. dynamic link libraries is currently used by a program.  If you get
  174. error message SYS0032, use
  175.  
  176.     pstat /L
  177.  
  178. to find out about the dynamic link libraries used by the programs
  179. currently running.  Terminate all the programs using emx.dll,
  180. emxio.dll, emxlibc.dll or emxwrap.dll.
  181.  
  182. Either copy the latest revisions of the emx dynamic link libraries
  183. (that is, those with the highest revision numbers) to a directory
  184. directory listed in the LIBPATH statement of config.sys or modify the
  185. LIBPATH statement to include the directory where the latest revisions
  186. of the emx dynamic link libraries can be found.
  187.  
  188. The directories of the LIBPATH statement are separated by semicolons.
  189. To add c:\emx\dll to the LIBPATH statement, append a semicolon -- if
  190. there is not yet a semicolon -- to the end of the line of config.sys
  191. that starts with
  192.  
  193.     LIBPATH=
  194.  
  195. Then, type the absolute name of the directory.  Example:
  196.  
  197.     LIBPATH=.;C:\OS2\DLL;C:\OS2\MDOS;C:\;C:\OS2\APPS\DLL;D:\EMX\DLL
  198.  
  199. Optionally, you can append a semicolon at the end.
  200.  
  201. Next, modify the line of config.sys starting with
  202.  
  203.     SET PATH=
  204.  
  205. to include the \emx\bin directory.  For instance, change
  206.  
  207.     SET PATH=C:\OS2;C:\OS2\SYSTEM;C:\OS2\MDOS\WINOS2;C:\OS2\INSTALL;
  208.     C:\;C:\OS2\MDOS;C:\OS2\APPS
  209.  
  210. to
  211.  
  212.     SET PATH=C:\OS2;C:\OS2\SYSTEM;C:\OS2\MDOS\WINOS2;C:\OS2\INSTALL;
  213.     C:\;C:\OS2\MDOS;C:\OS2\APPS;D:\EMX\BIN
  214.  
  215. As with LIBPATH, you have to put a semicolon between the path names
  216. and a trailing semicolon is optional.  Note that the last two examples
  217. are shown in two lines; in config.sys, however, the complete SET
  218. statement must be put into one line.
  219.  
  220. Now, you should reboot to activate the changes to config.sys.  After
  221. booting, run
  222.  
  223.     emxrev
  224.  
  225. to verify that the latest revision of emx is now active.
  226.  
  227. If OS/2 says
  228.  
  229.     SYS1804: The system cannot find the file EMX.
  230.  
  231. when running an emx program, you haven't correctly set the LIBPATH
  232. statement of config.sys.  See above for details.
  233.  
  234.  
  235. 5 Installing the emx runtime package under DOS
  236. ==============================================
  237.  
  238.  
  239. 5.1 Summary for impatient DOS users
  240. -----------------------------------
  241.  
  242. 1.  Add \emx\bin to PATH or set EMX to point to \emx\bin\emx.exe
  243.  
  244. 2.  If you're using a memory manager which implements DPMI, enable
  245.     VCPI
  246.  
  247. 3.  Remove BREAK=ON from config.sys
  248.  
  249. 4.  Reboot
  250.  
  251.  
  252. 5.2 Detailed instructions for DOS users
  253. ---------------------------------------
  254.  
  255. emx programs for DOS come in two flavours: those which load emx.exe
  256. from a separate file and those which have the emx runtime emx.exe
  257. integrated in the executable file of the application program.
  258.  
  259. Before changing autoexec.bat and config.sys, make a backup copy of
  260. these files!
  261.  
  262. If you want to use a program which loads emx.exe, you have to put
  263. emx.exe into a directory which is listed in your PATH environment
  264. variable or you have to change the PATH environment variable (in
  265. autoexec.bat) to include the directory in which emx.exe can be found.
  266. For instance, if your autoexec.bat file contains the line
  267.  
  268.     path c:\dos;d:\bin
  269.  
  270. you have installed the emx runtime on drive D, you should modify that
  271. line to read
  272.  
  273.     path c:\dos;d:\bin;d:\emx\bin
  274.  
  275. You have to put a semicolon between the path names.
  276.  
  277. Alternatively, you can set an environment variable which directly
  278. points to the emx.exe executable.  If you use this method, your
  279. program can locate emx.exe more quickly.  If you have installed the
  280. emx runtime on drive D:, you should add the following line to your
  281. autoexec.bat file:
  282.  
  283.     set emx=d:\emx\bin\emx.exe
  284.  
  285. Note that a directory name is not sufficient -- you have to type the
  286. complete path name of the emx.exe file.
  287.  
  288. Programs of the second flavour, having emx.exe integrated, don't
  289. require \emx\bin added to the PATH environment variable or the EMX
  290. environment variable being set.  The program itself, however, may need
  291. changes to your autoexec.bat file.  See the documentation accompanying
  292. the program.  The following steps are required for both flavours of
  293. emx programs.
  294.  
  295. If you're using a memory manager (such as QEMM or EMM386 or 386max)
  296. which implements DPMI (DOS Protected Mode Interface), you have to
  297. change the invokation of that memory manager to enable VCPI as emx
  298. does not support DPMI.  See the documentation of your memory for
  299. details.  If your memory manager supports DPMI only (without VCPI),
  300. you have to remove or disable the memory manager.  emx supports XMS
  301. and VCPI.
  302.  
  303. Examine your config.sys file: If there's a line
  304.  
  305.     BREAK=ON
  306.  
  307. in it, you should remove it as it causes trouble with emx and lots of
  308. other programs.
  309.  
  310. If you're using an Intel Inboard 386/PC, add the following line to
  311. autoexec.bat:
  312.  
  313.     set emxopt=-m3
  314.  
  315. If the swap file (used to swap memory pages to disk when running out
  316. of physical memory) should be in a specific directory or on a specific
  317. disk drive, set the EMXTMP environment variable in autoexec.bat.
  318. Example:
  319.  
  320.     set emxtmp=c:\tmp
  321.  
  322. Now, you should reboot to activate the changes to config.sys and
  323. autoexec.bat.
  324.  
  325.  
  326. 6 Environment variables (OS/2 and DOS)
  327. ======================================
  328.  
  329. The operation of emx and emx programs is controlled by several
  330. environment variables.  You might have to set one or more of the
  331. following environment variables:
  332.  
  333. INIT    used by termcap to find termcap.dat
  334.  
  335. TERM    used by termcap to define the terminal type
  336.  
  337. EMXETC  used by termcap to find termcap.dat
  338.  
  339. EMXOPT  emx options (see below)
  340.  
  341. EMXPATH
  342.         search path for programs (usually not relevant)
  343.  
  344. PATH    search path for program (used if EMXPATH fails)
  345.  
  346. TERMCAP
  347.         used by termcap to find termcap.dat
  348.  
  349.  
  350. 6.1 Environment variables (DOS)
  351. -------------------------------
  352.  
  353. EMX     path name of emx.exe, used by programs which are bound with
  354.         emxl.exe (the emx loader) instead of emx.exe.  Set EMX to
  355.         speed up loading of emx.exe or to load a specific version of
  356.         emx.exe
  357.  
  358. EMXTMP  directory for the swap file
  359.  
  360. TMP     used if EMXTMP is not set
  361.  
  362.  
  363. 7 DOS Notes
  364. ===========
  365.  
  366. - emx requires DOS 3.0 or later
  367.  
  368. - emx does not support DPMI
  369.  
  370. - emx does not support DESQview without VCPI (use QEMM-386 with
  371.   DESQview)
  372.  
  373. - If emx doesn't work under DESQview (especially if it displays the
  374.   message
  375.  
  376.       Nonmaskable interrupt (NMI)
  377.  
  378.   either set the protection level to 0 or use the WATCHDOG=0 option of
  379.   QEMM-386.
  380.  
  381. - emx supports VCPI
  382.  
  383. - emx supports XMS.  Do not use emx with himem.sys 2.06 or earlier.
  384.  
  385. - emx checks for XMS version number 2.00 or later and for XMS driver
  386.   revision 2.06 or later, as older himem.sys drivers don't work
  387.   correctly.  You can override this check by using the -O emx option
  388.   (for drivers using a different revision numbering scheme), but emx
  389.   may not work with your XMS driver, anyway.  Actually, emx has not
  390.   been tested with himem.sys 2.05; 2.04 fails, 2.06 works.
  391.  
  392. - emx supports vdisk.sys 3.3 and later and most other RAM disk drivers
  393.  
  394. - emx uses (or tries to use) all available memory, whether
  395.   conventional, extended, or expanded memory.  But it does not use
  396.   extended memory AND expanded memory at the same time.  If there
  397.   isn't enough memory, emx will swap to disk.  The swap file will be
  398.   created in the directory given by the EMXTMP environment variable.
  399.   If EMXTMP is not set, TMP will be used.  If both variables are not
  400.   set, the swap file will be created in the root directory of the
  401.   current drive.
  402.  
  403.  
  404. 8 emx options
  405. =============
  406.  
  407. You can customize emx by setting the EMXOPT environment variable.
  408. This environment variable contains a list of options, similar to
  409. command line options.  The options must be separated by at least one
  410. blank.  Example:
  411.  
  412.     set emxopt=-c -h40
  413.  
  414.  
  415. 8.1 emx options (OS/2)
  416. ----------------------
  417.  
  418. -c      Disable core dumps caused by signals other than SIGKILL
  419.  
  420. -h#     Set OS/2 file handle limit to #.  The number # must be between
  421.         10 and 255
  422.  
  423. -r*     Prepend drive letter * to absolute path names.  If a path name
  424.         starts with / but does not start with //, /dev/ or /pipe/, *
  425.         followed by a colon will be prepended.  If -rd has been given,
  426.         the file name \mydir\abc will be translated to d:\mydir\abc.
  427.         Note: this option can cause unexpected effects
  428.  
  429. -t      Truncate file names to 8.3
  430.  
  431. -E      Run debuggee in same session (window) as debugger
  432.  
  433.  
  434. 8.2 emx options (DOS)
  435. ---------------------
  436.  
  437. -c      Disable core dumps caused by signals other than SIGKILL
  438.  
  439. -d      Don't use extended memory
  440.  
  441. -e      Don't check for 387 coprocessor.  Assume no coprocessor is
  442.         present
  443.  
  444. -h#     Set DOS file handle limit to #.  The number # must be between
  445.         10 and 255.  This option is ignored for DOS versions earlier
  446.         than 3.30.  This option does not change the emx limit for the
  447.         number of files per process -- that limit is always 40
  448.  
  449. -m1     Running on Fujitsu FMR70 (not implemented yet)
  450.  
  451. -m2     Running on NEC PC-98 (not implemented yet)
  452.  
  453. -m3     Running on Intel Inboard 386/PC
  454.  
  455. -o      Send the register dump of an exception to stdout.  Without -o,
  456.         the register dump is sent to the CON device.  You need -o for
  457.         redirecting the register dump to a file
  458.  
  459. -r*     Prepend drive letter * to absolute path names.  If a path name
  460.         starts with / but does not start with //, /dev/ or /pipe/, *
  461.         followed by a colon will be prepended.  If -rd has been given,
  462.         the file name \mydir\abc will be translated to d:\mydir\abc.
  463.         Note: this option can cause unexpected effects
  464.  
  465. -t      Truncate file names to 8.3 format.  Each part of a pathname is
  466.         truncated to 8.3 format by taking the first 8 characters
  467.         before the dot and the first 3 characters after the dot.  This
  468.         is useful to compile programs on a FAT filesystem with minimal
  469.         changes
  470.  
  471. -O      Override XMS version check.  By default, emx checks for XMS
  472.         version number 2.00 or later and for XMS driver revision 2.06
  473.         or later, as older himem.sys drivers don't work correctly.
  474.         You can override this check by giving the -O option (for
  475.         drivers using a different revision numbering scheme), but emx
  476.         may not work with your XMS driver, anyway.  Actually, emx has
  477.         not been tested with himem.sys 2.05; 2.04 fails, 2.06 works
  478.  
  479. -V      Display emx version.  On program start, the emx version will
  480.         be displayed
  481.  
  482.  
  483. 9 emx messages (DOS)
  484. ====================
  485.  
  486. Abnormal program termination
  487.  
  488.     The program received the SIGABRT signal.  The abort() function was
  489.     called or SIGABRT was raised.
  490.  
  491. Cannot create swap file
  492.  
  493.     The swap file could not be created.  Remedy: make sure the swap
  494.     file can be created in the directory given by the EMXTMP (or TMP)
  495.     environment variable.  If EMXTMP and TMP are not set, emx will
  496.     create the swap file in the root directory of the current drive.
  497.  
  498. Cannot enable A20
  499.  
  500.     emx tried to enable address line A20 and failed.  Remedy: contact
  501.     the author.
  502.  
  503. Cannot enable A20 via XMS
  504.  
  505.     emx tried to enable address line A20 by calling the XMS driver.
  506.     Unfortunately, A20 couldn't be enabled.  Remedy: unknown.
  507.  
  508. Cannot open program file
  509.  
  510.     The program file given on the emx command line could not be found
  511.     or opened.  Remedy: type the correct file name.  (This should not
  512.     happen with bound programs.)
  513.  
  514. Cannot read program file
  515.  
  516.     An error occured while reading the program file.  Remedy: make
  517.     sure the program file given on the emx command line is valid (this
  518.     does not apply to bound programs).  Maybe some other program
  519.     accesses that file.
  520.  
  521. DPMI not supported
  522.  
  523.     The current version of emx cannot use DPMI.  Maybe some future
  524.     version will do.  Remedy: end the DPMI server (MS Windows).
  525.  
  526. Exception ...
  527.  
  528.     The program run by emx did something illegal.  Remedy: report to
  529.     the supplier of the program.
  530.  
  531. Illegal moucall function
  532.  
  533.     The program run by emx has called an invalid system function.
  534.     Remedy: report to the supplier of the program.
  535.  
  536. Illegal syscall function
  537.  
  538.     The program run by emx has called an invalid system function.
  539.     Remedy: report to the supplier of the program.
  540.  
  541. Illegal viocall function
  542.  
  543.     The program run by emx has called an invalid system function.
  544.     Remedy: report to the supplier of the program.
  545.  
  546. Invalid arguments for DOS function xx
  547.  
  548.     The program run by emx has used invalid arguments for a system
  549.     function.  Remedy: report to the supplier of the program.
  550.  
  551. Invalid emx option
  552.  
  553.     An option in EMXOPT or set by emxbind is not understood by emx.
  554.     Remedy: check EMXOPT.  Use emxbind -i to display the options set
  555.     by emxbind.
  556.  
  557. Invalid program file
  558.  
  559.     The program file given on the emx command line (or bound to emx)
  560.     is corrupt.  Remedy: reload the program from diskette.  If this
  561.     doesn't help you should contact the supplier of the program.
  562.  
  563. Invalid special function code: xx
  564.  
  565.     The program run by emx has called an invalid system function.
  566.     Remedy: report to the supplier of the program.
  567.  
  568. Linear address space exhausted
  569.  
  570.     The program run by emx uses far too much memory.  Remedy: complain
  571.     to the author.
  572.  
  573. Nonmaskable interrupt (NMI) at xxxx:yyyyyyyy
  574.  
  575.     A nonmaskable interrupt occured.  Maybe this is due to a memory
  576.     error.  Remedy: if you're using DESQview, either set the
  577.     protection level to 0 or use the WATCHDOG=0 option of QEMM-386.
  578.     Otherwise, run a program for testing memory.
  579.  
  580. Out of memory
  581.  
  582.     There isn't enough memory for running emx.  Remedy: remove some
  583.     drivers and/or resident programs.  Or add memory to your machine.
  584.  
  585. Out of stacks
  586.  
  587.     emx run out of local stacks.  Remedy: complain to the author.
  588.  
  589. Out of memory or swap space
  590.  
  591.     emx cannot write to the swap file because the disk is full.
  592.     Remedy: make sure there is enough space on the drive used for the
  593.     swap file.  Use the EMXTMP (or TMP) environment variable to tell
  594.     emx where to create the swap file.  If neither EMXTMP nor TMP is
  595.     set, emx will create the swap file in the root directory of the
  596.     current drive.
  597.  
  598. Out of swap space
  599.  
  600.     emx cannot write to the swap file because the disk is full.
  601.     Remedy: make sure there is enough space on the drive used for the
  602.     swap file.  Use the EMXTMP (or TMP) environment variable to tell
  603.     emx where to create the swap file.  If neither EMXTMP nor TMP is
  604.     set, emx will create the swap file in the root directory of the
  605.     current drive.
  606.  
  607. Process terminated by SIGINT
  608.  
  609.     You've stopped the program by hitting Ctrl-C or Ctrl-Break.
  610.  
  611. Program aborted
  612.  
  613.     You've aborted the program by answering `Abort' after a critical
  614.     error had occured.
  615.  
  616. Swap file I/O error
  617.  
  618.     emx couldn't read or write the swap file.
  619.  
  620. This program does not run in DOS mode of OS/2
  621.  
  622.     DOS emulation of OS/2 doesn't support emx.  Remedy: boot DOS or
  623.     use OS/2 2.x.
  624.  
  625. This program requires an 80386 CPU
  626.  
  627.     You need an 80386DX, 80386SX, or i486 CPU for running emx.
  628.     Remedy: get another computer.
  629.  
  630. This program requires DOS 3.0 or later
  631.  
  632.     If emx is bound with an application program into one executable,
  633.     DOS 3.0 or later is required for execution.
  634.  
  635. Too many processes
  636.  
  637.     emx supports up to 4 processes.  You've tried to start 5 or more
  638.     processes.
  639.  
  640. Unexpected interrupt
  641.  
  642.     This cannot happen.  Remedy: report to the author.
  643.  
  644. Unsupported VDISK.SYS version
  645.  
  646.     emx doesn't support the vdisk.sys device driver you're using.
  647.     Remedy: remove VDISK.SYS or use a different version.  emx should
  648.     work with vdisk.sys 3.3 or later.
  649.  
  650. Unsupported XMS version
  651.  
  652.     emx requires himem.sys 2.06 or later (older versions are too
  653.     buggy).  Remedy: get a newer himem.sys.  If you're not using
  654.     himem.sys, use the -O option of emx and tell the author whether
  655.     this works or not.
  656.  
  657. Unusable interrupt vector mappings set by VCPI server
  658.  
  659.     The configuration of the VCPI server (EMS driver) is illegal.
  660.     Remedy: read the manual of the EMS driver.
  661.  
  662. Virtual mode not supported without VCPI
  663.  
  664.     A VCPI server is required to run emx if the CPU is in virtual
  665.     mode.  You'll get this message if you're using an EMS driver (EMS
  666.     emulator) which doesn't support VCPI or if you've disabled EMS.
  667.     Remedy: remove the EMS driver, use an EMS driver which supports
  668.     VCPI or enable EMS if it has been disabled (for instance, remove
  669.     the NOEMS keyword from the command line of the EMS driver).
  670.  
  671. Wrong emx version
  672.  
  673.     The version of emx.exe does not match the version the program was
  674.     compiled for.  Remedy: use the copy of emx.exe that comes with the
  675.     program.  If you're using different programs which need different
  676.     versions of emx.exe, use the EMX environment variable to set the
  677.     path name of the correct version of emx.exe before running a
  678.     program which requires a version different from the default
  679.     emx.exe.  You can also use emxbind -u to put the correct version
  680.     of emx.exe into the executable files.
  681.  
  682.  
  683. 10 Obtaining the complete emx package
  684. =====================================
  685.  
  686. emx is available for anonymous ftp on
  687.  
  688.     ftp.uni-stuttgart.de [129.69.1.12]: /soft/os2/emx-0.8g
  689.     ftp-os2.nmsu.edu  [128.123.35.151]: /os2/2_x/unix/gnu/emx08g
  690.     src.doc.ic.ac.uk     [146.169.2.1]: /pub/packages/os2/2_x/unix/gnu/emx08g
  691.     ftp.informatik.tu-muenchen.de [131.159.0.198]:
  692.                                         /pub/comp/os/os2/devtools/emx+gcc
  693.  
  694.  
  695. 11 The author of emx
  696. ====================
  697.  
  698. The author of emx is
  699.  
  700.     Eberhard Mattes
  701.     Teckstrasse 81                                      (TeX: Teckstra\ss e)
  702.     D-71696 Moeglingen                                  (TeX: M\"oglingen)
  703.     Germany
  704.  
  705. Internet: mattes@azu.informatik.uni-stuttgart.de  (subject to change)
  706.  
  707. No telephone calls please!  It must be stressed that the author does
  708. not reply to letters if you don't include return postage
  709. (international postal reply coupon if you're outside Germany) and a
  710. self-addressed envelope.
  711.  
  712. --------------------------- END OF EMXRT.DOC --------------------------------
  713.