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