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