home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / editor / beav / user.doc < prev    next >
Text File  |  1994-01-30  |  11KB  |  345 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. Run a bound program by typing its name.
  80.  
  81. Run an a.out file by typing
  82.  
  83.     emx [options] program [arguments]
  84.  
  85. emx options (can also be used in EMXOPT):
  86.  
  87.     -c  Disable core dumps caused by signals other than SIGKILL
  88.  
  89.     -d  Don't use extended memory
  90.  
  91.     -e  Don't check for 387 coprocessor. Assume no coprocessor is present
  92.  
  93.     -h# Set DOS file handle limit to #. The number # must be between 10
  94.         and 255. This option is ignored for DOS versions earlier than
  95.         3.30. This option does not change the emx limit for the number of
  96.         files per process -- that limit is always 40
  97.  
  98.     -m1 Running on Fujitsu FMR70 (not implemented yet)
  99.  
  100.     -m2 Running on NEC PC-98 (not implemented yet)
  101.  
  102.     -m3 Running on Inboard 386/PC
  103.  
  104.     -o  Send register dump (of exception) to stdout (instead of CON,
  105.         for redirecting register dump)
  106.  
  107.     -r* Prepend drive letter * to absolute path names. If a path name starts
  108.         with / but does not start with //, /dev/ or /pipe/, * followed by a
  109.         colon will be prepended. If -rd has been given, the file name
  110.         \mydir\abc will be translated to d:\mydir\abc. Note: this option can
  111.         cause unexpected effects
  112.  
  113.     -t  Truncate file names to 8.3
  114.  
  115.     -O  Override XMS version check
  116.  
  117.     -V  Display emx version
  118.  
  119.  
  120. Options can also be stored in the environment variable EMXOPT. emx first
  121. examines the options given in EMXOPT, then the options given on the
  122. command line.
  123.  
  124.  
  125. Usage (OS/2)
  126. ------------
  127.  
  128. Run a bound program by typing its name.
  129.  
  130. You can use the following options in the EMXOPT environment variable:
  131.  
  132.     -c  Disable core dumps caused by signals other than SIGKILL
  133.  
  134.     -h# Set OS/2 file handle limit to #. The number # must be between 10 and
  135.         255
  136.  
  137.     -r* Prepend drive letter * to absolute path names. If a path name starts
  138.         with / but does not start with //, /dev/ or /pipe/, * followed by a
  139.         colon will be prepended. If -rd has been given, the file name
  140.         \mydir\abc will be translated to d:\mydir\abc. Note: this option can
  141.         cause unexpected effects
  142.  
  143.     -t  Truncate file names to 8.3
  144.  
  145.     -E  Run debuggee in same session (window) as debugger
  146.  
  147. If OS/2 says
  148.  
  149.     SYS1804: The system cannot find the file EMX.
  150.  
  151. when running a program compiled for emx, you haven't set LIBPATH
  152. correctly.
  153.  
  154.  
  155. Environment variables
  156. ---------------------
  157.  
  158. INIT            used by termcap
  159. TERM            used by termcap
  160. EMXETC          used by termcap
  161. EMXOPT          emx options
  162. EMXPATH         search path for programs
  163. PATH            search path for program (used if EMXPATH fails)
  164. TERMCAP         used by termcap
  165.  
  166.  
  167. Environment variables (DOS)
  168. ---------------------------
  169.  
  170. EMX             path name of emx.exe, used by emxl.exe
  171. EMXTMP          directory for swapper file
  172. TMP             used if EMXTMP is not set
  173.  
  174. If the program name doesn't contain a drive and directory name, the
  175. current directory will be searched first, then all directories listed
  176. in EMXPATH and PATH.
  177.  
  178. If the program name contains a drive or directory name, no search
  179. will be done, only the given path name is tried.
  180.  
  181.  
  182. Messages (DOS)
  183. --------------
  184.  
  185. Cannot create swapper file
  186.  
  187.     The swapper file could not be created. Remedy: Make sure the
  188.     swapper file can be created in the directory given by the
  189.     EMXTMP (or TMP) environment variable. If EMXTMP and TMP are not
  190.     set, emx will create the swapper file in the root directory of
  191.     the current drive.
  192.  
  193. Cannot enable A20
  194.  
  195.     emx tried to enable address line A20 and failed. Remedy:
  196.     Contact the author.
  197.  
  198. Cannot enable A20 via XMS
  199.  
  200.     emx tried to enable address line A20 by calling the XMS driver.
  201.     Unfortunately, A20 couldn't be enabled. Remedy: unknown.
  202.  
  203. Cannot open program file
  204.  
  205.     The program file given on the emx command line could not be
  206.     found or opened. Remedy: Type the correct file name.
  207.     (This should not happen with bound programs.)
  208.  
  209. Cannot read program file
  210.  
  211.     An error occured while reading the program file. Remedy:
  212.     Make sure the program file given on the emx command line
  213.     is valid (this does not apply to bound programs).
  214.     Maybe some other program accesses that file.
  215.  
  216. DPMI not supported
  217.  
  218.     The current version of emx cannot use DPMI. Maybe some future
  219.     version will do. Remedy: End the DPMI server (Windows 3.0).
  220.  
  221. Exception ...
  222.  
  223.     The program run by emx did something illegal. Remedy: Report to
  224.     the supplier of the program.
  225.  
  226. Illegal syscall function
  227. Illegal viocall function
  228.  
  229.     The program run by emx has called an invalid system function.
  230.     Remedy: Report to the supplier of the program.
  231.  
  232. Invalid arguments for DOS function xx
  233.  
  234.     The program run by emx has used invalid arguments for a system
  235.     function. Remedy: Report to the supplier of the program.
  236.  
  237. Invalid program file
  238.  
  239.     The program file given on the emx command line (or bound to emx)
  240.     is corrupt. Remedy: Reload the program from diskette. If this doesn't
  241.     help you should contact the supplier of the program.
  242.  
  243. Invalid special function code: xx
  244.  
  245.     The program run by emx has called an invalid system function.
  246.     Remedy: Report to the supplier of the program.
  247.  
  248. Linear address space exhausted
  249.  
  250.     The program run by emx uses far too much memory. Remedy: Complain to
  251.     the author.
  252.  
  253. Nonmaskable interrupt (NMI) at xxxx:yyyyyyyy
  254.  
  255.     A nonmaskable interrupt occured. Maybe this is due to a memory
  256.     error. Remedy: If you're using DESQview, either set the protection
  257.     level to 0 or use the WATCHDOG=0 option of QEMM-386. Otherwise,
  258.     run a program for testing memory.
  259.  
  260. Out of memory
  261. Out of memory (RM)
  262. Out of memory (swapper)
  263.  
  264.     There isn't enough memory for running emx. Remedy: Remove some
  265.     drivers and/or resident programs. Or add memory to your machine.
  266.  
  267. Out of stacks
  268.  
  269.     emx run out of local stacks. Remedy: Complain to the author.
  270.  
  271. Out of swap space
  272.  
  273.     The program run by emx uses far too much memory. Remedy: Complain
  274.     to the author.
  275.  
  276. Program aborted
  277.  
  278.     You've aborted the program by answering `Abort' after a critical
  279.     error had occured.
  280.  
  281. Program stopped
  282.  
  283.     You've stopped the program by hitting Ctrl-C or Ctrl-Break.
  284.  
  285. Swapper file I/O error
  286.  
  287.     emx couldn't read or write the swapper file. Remedy: Make sure
  288.     there is enough space on the drive used for the swapper file.
  289.     Use the EMXTMP (or TMP) environment variable to tell emx where
  290.     to create the swapper file. If neither EMXTMP nor TMP is set,
  291.     emx will create the swapper file in the root directory of the
  292.     current drive.
  293.  
  294. This program does not run in DOS mode of OS/2
  295.  
  296.     DOS emulation of OS/2 doesn't support emx. Remedy: Boot DOS or use
  297.     OS/2 2.0.
  298.  
  299. This program requires an 80386 CPU
  300.  
  301.     You need an 80386DX, 80386SX, or i486 CPU for running emx.
  302.     Remedy: Get another computer.
  303.  
  304. This program requires DOS 3.0 or later
  305.  
  306.     If emx is bound with an application program into one executable,
  307.     DOS 3.0 or later is required for execution.
  308.  
  309. Too many processes
  310.  
  311.     emx supports up to 4 processes. You've tried to start 5 processes.
  312.  
  313. Unexpected interrupt
  314.  
  315.     This cannot happen. Remedy: Report to the author.
  316.  
  317. Unsupported VDISK.SYS version
  318.  
  319.     emx doesn't support the VDISK.SYS device driver you're using.
  320.     Remedy: Remove VDISK.SYS or use a different version. emx should
  321.     work with VDISK.SYS 3.3 or later.
  322.  
  323. Unsupported XMS version
  324.  
  325.     emx requires himem.sys 2.06 or later (older versions are too buggy).
  326.     Remedy: Get a newer himem.sys. If you're not using himem.sys, use
  327.     the -O option of emx and tell the author whether this works or not.
  328.  
  329. Unusable interrupt vector mappings set by VCPI server
  330.  
  331.     The configuration of the VCPI server (EMS driver) is illegal.
  332.     Remedy: Read the manual of the EMS driver.
  333.  
  334. Virtual mode not supported without VCPI
  335.  
  336.     A VCPI server is required to run emx if the CPU is in virtual mode.
  337.     You'll get this message if you're using an EMS driver (EMS emulator)
  338.     which doesn't support VCPI or if you've disabled EMS. Remedy: Remove
  339.     the EMS driver, use an EMS driver which supports VCPI or enable EMS
  340.     if it has been disabled (for instance, remove the NOEMS keyword from
  341.     the command line of the EMS driver).
  342.  
  343.  
  344. --------------------------- END OF USER.DOC ---------------------------------
  345.