home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / progs / pari / pari_137 / emxuser.doc < prev    next >
Text File  |  1992-09-17  |  10KB  |  328 lines
  1. ===============================================================================
  2. user.doc          emx 0.8e     USER'S GUIDE                         13-Sep-1992
  3. ===============================================================================
  4.  
  5. Hardware Requirements
  6. ---------------------
  7.  
  8. - emx requires an 80386 CPU (80386DX, 80386SX, i486)
  9.  
  10. - emx requires an 80387 coprocessor (or i486 processor) if floating point
  11.   math is to be used under DOS
  12.  
  13.  
  14. DOS Notes
  15. ---------
  16.  
  17. - emx requires DOS 3.0 or later
  18.  
  19. - emx does not support DPMI
  20.  
  21. - emx does not support DESQview without VCPI (use QEMM-386 with DESQview)
  22.  
  23. - If emx doesn't work under DESQview (especially if it displays the
  24.   message `Nonmaskable interrupt (NMI)', either set the protection
  25.   level to 0 or use the WATCHDOG=0 option of QEMM-386.
  26.  
  27. - emx supports VCPI
  28.  
  29. - emx supports XMS. Do not use emx with himem.sys 2.06 or earlier.
  30.  
  31. - emx checks for XMS version number 2.00 or later and for
  32.   XMS driver revision 2.06 or later, as older himem.sys drivers
  33.   don't work correctly. You can override this check by giving
  34.   the -O command line option (for drivers using a different
  35.   revision numbering scheme), but emx may not work with your
  36.   XMS driver, anyway. Actually, emx has not been tested with
  37.   himem.sys 2.05; 2.04 fails, 2.06 works.
  38.  
  39. - emx supports VDISK.SYS 3.3 and later and most other RAM disk drivers
  40.  
  41. - emx uses (or tries to use) all available memory, whether conventional,
  42.   extended, or expanded memory. But it does not use extended memory
  43.   AND expanded memory at the same time. If there isn't enough memory,
  44.   emx will swap to disk. The swapper file will be created in the directory
  45.   given by the EMXTMP environment variable. If EMXTMP is not set,
  46.   TMP will be used. If both variables are not set, the swapper file
  47.   will be created in the root directory of the current drive.
  48.  
  49. - Do not put BREAK=ON in your config.sys file. BREAK=ON causes
  50.   problems with lots of other programs as well.
  51.  
  52.  
  53. OS/2 Notes
  54. ----------
  55.  
  56. - emx requires OS/2 2.0
  57.  
  58. - emx does not run in DOS mode of OS/2
  59.  
  60.  
  61. DOS Programs
  62. ------------
  63.  
  64. emx.exe         DOS extender
  65. emxl.exe        emx loader
  66.  
  67.  
  68. OS/2 dynamic link libraries
  69. ---------------------------
  70.  
  71. emx.dll         emx for OS/2 2.0
  72. emxio.dll       access to hardware ports for emx programs under OS/2 2.0
  73. emxlibc.dll     emx C library
  74.  
  75.  
  76. Usage (DOS)
  77. -----------
  78.  
  79. emx options (set via the EMXOPT environment variable):
  80.  
  81.     -c  Disable core dumps caused by signals other than SIGKILL
  82.  
  83.     -d  Don't use extended memory
  84.  
  85.     -e  Don't check for 387 coprocessor. Assume no coprocessor is present
  86.  
  87.     -h# Set DOS file handle limit to #. The number # must be between 10
  88.         and 255. This option is ignored for DOS versions earlier than
  89.         3.30. This option does not change the emx limit for the number of
  90.         files per process -- that limit is always 40
  91.  
  92.     -m1 Running on Fujitsu FMR70 (not implemented yet)
  93.  
  94.     -m2 Running on NEC PC-98 (not implemented yet)
  95.  
  96.     -m3 Running on Inboard 386/PC
  97.  
  98.     -o  Send register dump (of exception) to stdout (instead of CON,
  99.         for redirecting register dump)
  100.  
  101.     -r* Prepend drive letter * to absolute path names. If a path name starts
  102.         with / but does not start with //, /dev/ or /pipe/, * followed by a
  103.         colon will be prepended. If -rd has been given, the file name
  104.         \mydir\abc will be translated to d:\mydir\abc. Note: this option can
  105.         cause unexpected effects
  106.  
  107.     -t  Truncate file names to 8.3
  108.  
  109.     -O  Override XMS version check
  110.  
  111.     -V  Display emx version
  112.  
  113.  
  114. Usage (OS/2)
  115. ------------
  116.  
  117. You can use the following options in the EMXOPT environment variable:
  118.  
  119.     -c  Disable core dumps caused by signals other than SIGKILL
  120.  
  121.     -h# Set OS/2 file handle limit to #. The number # must be between 10 and
  122.         255
  123.  
  124.     -r* Prepend drive letter * to absolute path names. If a path name starts
  125.         with / but does not start with //, /dev/ or /pipe/, * followed by a
  126.         colon will be prepended. If -rd has been given, the file name
  127.         \mydir\abc will be translated to d:\mydir\abc. Note: this option can
  128.         cause unexpected effects
  129.  
  130.     -t  Truncate file names to 8.3
  131.  
  132.     -E  Run debuggee in same session (window) as debugger
  133.  
  134. If OS/2 says
  135.  
  136.     SYS1804: The system cannot find the file EMX.
  137.  
  138. when running a program compiled for emx, you haven't set LIBPATH
  139. correctly.
  140.  
  141.  
  142. Environment variables
  143. ---------------------
  144.  
  145. EMXOPT          emx options
  146. EMXPATH         search path for programs
  147. PATH            search path for program (used if EMXPATH fails)
  148.  
  149.  
  150. Environment variables (DOS)
  151. ---------------------------
  152.  
  153. EMX             path name of emx.exe, used by emxl.exe
  154. EMXTMP          directory for swapper file
  155. TMP             used if EMXTMP is not set
  156.  
  157. If the program name doesn't contain a drive and directory name, the
  158. current directory will be searched first, then all directories listed
  159. in EMXPATH and PATH.
  160.  
  161. If the program name contains a drive or directory name, no search
  162. will be done, only the given path name is tried.
  163.  
  164.  
  165. Messages (DOS)
  166. --------------
  167.  
  168. Cannot create swapper file
  169.  
  170.     The swapper file could not be created. Remedy: Make sure the
  171.     swapper file can be created in the directory given by the
  172.     EMXTMP (or TMP) environment variable. If EMXTMP and TMP are not
  173.     set, emx will create the swapper file in the root directory of
  174.     the current drive.
  175.  
  176. Cannot enable A20
  177.  
  178.     emx tried to enable address line A20 and failed. Remedy:
  179.     Contact the author.
  180.  
  181. Cannot enable A20 via XMS
  182.  
  183.     emx tried to enable address line A20 by calling the XMS driver.
  184.     Unfortunately, A20 couldn't be enabled. Remedy: unknown.
  185.  
  186. Cannot open program file
  187.  
  188.     The program file given on the emx command line could not be
  189.     found or opened. Remedy: Type the correct file name.
  190.     (This should not happen with bound programs.)
  191.  
  192. Cannot read program file
  193.  
  194.     An error occured while reading the program file. Remedy:
  195.     Make sure the program file given on the emx command line
  196.     is valid (this does not apply to bound programs).
  197.     Maybe some other program accesses that file.
  198.  
  199. DPMI not supported
  200.  
  201.     The current version of emx cannot use DPMI. Maybe some future
  202.     version will do. Remedy: End the DPMI server (Windows 3.0).
  203.  
  204. Exception ...
  205.  
  206.     The program run by emx did something illegal. Remedy: Report to
  207.     the supplier of the program.
  208.  
  209. Illegal syscall function
  210. Illegal viocall function
  211.  
  212.     The program run by emx has called an invalid system function.
  213.     Remedy: Report to the supplier of the program.
  214.  
  215. Invalid arguments for DOS function xx
  216.  
  217.     The program run by emx has used invalid arguments for a system
  218.     function. Remedy: Report to the supplier of the program.
  219.  
  220. Invalid program file
  221.  
  222.     The program file given on the emx command line (or bound to emx)
  223.     is corrupt. Remedy: Reload the program from diskette. If this doesn't
  224.     help you should contact the supplier of the program.
  225.  
  226. Invalid special function code: xx
  227.  
  228.     The program run by emx has called an invalid system function.
  229.     Remedy: Report to the supplier of the program.
  230.  
  231. Linear address space exhausted
  232.  
  233.     The program run by emx uses far too much memory. Remedy: Complain to
  234.     the author.
  235.  
  236. Nonmaskable interrupt (NMI) at xxxx:yyyyyyyy
  237.  
  238.     A nonmaskable interrupt occured. Maybe this is due to a memory
  239.     error. Remedy: If you're using DESQview, either set the protection
  240.     level to 0 or use the WATCHDOG=0 option of QEMM-386. Otherwise,
  241.     run a program for testing memory.
  242.  
  243. Out of memory
  244. Out of memory (RM)
  245. Out of memory (swapper)
  246.  
  247.     There isn't enough memory for running emx. Remedy: Remove some
  248.     drivers and/or resident programs. Or add memory to your machine.
  249.  
  250. Out of stacks
  251.  
  252.     emx run out of local stacks. Remedy: Complain to the author.
  253.  
  254. Out of swap space
  255.  
  256.     The program run by emx uses far too much memory. Remedy: Complain
  257.     to the author.
  258.  
  259. Program aborted
  260.  
  261.     You've aborted the program by answering `Abort' after a critical
  262.     error had occured.
  263.  
  264. Program stopped
  265.  
  266.     You've stopped the program by hitting Ctrl-C or Ctrl-Break.
  267.  
  268. Swapper file I/O error
  269.  
  270.     emx couldn't read or write the swapper file. Remedy: Make sure
  271.     there is enough space on the drive used for the swapper file.
  272.     Use the EMXTMP (or TMP) environment variable to tell emx where
  273.     to create the swapper file. If neither EMXTMP nor TMP is set,
  274.     emx will create the swapper file in the root directory of the
  275.     current drive.
  276.  
  277. This program does not run in DOS mode of OS/2
  278.  
  279.     DOS emulation of OS/2 doesn't support emx. Remedy: Boot DOS or use
  280.     OS/2 2.0.
  281.  
  282. This program requires an 80386 CPU
  283.  
  284.     You need an 80386DX, 80386SX, or i486 CPU for running emx.
  285.     Remedy: Get another computer.
  286.  
  287. This program requires DOS 3.0 or later
  288.  
  289.     If emx is bound with an application program into one executable,
  290.     DOS 3.0 or later is required for execution.
  291.  
  292. Too many processes
  293.  
  294.     emx supports up to 4 processes. You've tried to start 5 processes.
  295.  
  296. Unexpected interrupt
  297.  
  298.     This cannot happen. Remedy: Report to the author.
  299.  
  300. Unsupported VDISK.SYS version
  301.  
  302.     emx doesn't support the VDISK.SYS device driver you're using.
  303.     Remedy: Remove VDISK.SYS or use a different version. emx should
  304.     work with VDISK.SYS 3.3 or later.
  305.  
  306. Unsupported XMS version
  307.  
  308.     emx requires himem.sys 2.06 or later (older versions are too buggy).
  309.     Remedy: Get a newer himem.sys. If you're not using himem.sys, use
  310.     the -O option of emx and tell the author whether this works or not.
  311.  
  312. Unusable interrupt vector mappings set by VCPI server
  313.  
  314.     The configuration of the VCPI server (EMS driver) is illegal.
  315.     Remedy: Read the manual of the EMS driver.
  316.  
  317. Virtual mode not supported without VCPI
  318.  
  319.     A VCPI server is required to run emx if the CPU is in virtual mode.
  320.     You'll get this message if you're using an EMS driver (EMS emulator)
  321.     which doesn't support VCPI or if you've disabled EMS. Remedy: Remove
  322.     the EMS driver, use an EMS driver which supports VCPI or enable EMS
  323.     if it has been disabled (for instance, remove the NOEMS keyword from
  324.     the command line of the EMS driver).
  325.  
  326.  
  327. --------------------------- END OF USER.DOC ---------------------------------
  328.