home *** CD-ROM | disk | FTP | other *** search
/ Internet MPEG Audio Archive / IMAA.mdf / util / dos / l3v100n / rsx / doc / install.txt < prev    next >
Text File  |  1994-01-19  |  6KB  |  213 lines
  1. --------------------------------------------------------------------------------
  2. INSTALL.TXT        DPMI-RSX  (c) Rainer Schnitker          Jan 1994
  3. --------------------------------------------------------------------------------
  4.  
  5. This file contains information about:
  6.  
  7.         Hardware Requirements
  8.         Software Requirements
  9.         Create more DPMI memory
  10.         INSTALL for EMX/GCC
  11.         INSTALL for DJGPP
  12.         Major bugs in tested DPMI-Hosts
  13.     Patch for next EMX-Update
  14.  
  15.  
  16.  
  17.  
  18.  
  19.     This program is distributed in the hope that it will be useful,
  20.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  21.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  22.     GNU General Public License for more details.
  23.  
  24.  
  25.  
  26. --------------------------------------------------------------------------------
  27.  
  28.  
  29.  
  30. Hardware Requirements:
  31. ----------------------
  32.  
  33. - RSX requires a 386SX-CPU (or higher)
  34.  
  35.   (A 387 coprocessor is not necessary, because RSX emulates it)
  36.  
  37.  
  38.  
  39.  
  40. Software Requirements:
  41. ----------------------
  42.  
  43. - A DPMI 0.9/1.0 - Server like:
  44.  
  45.     MS-Windows 3.1 enhanced mode
  46.  
  47.     QEMM386 + QDPMI 1.01
  48.  
  49.     386MAX 6.x (better 7.0)
  50.  
  51.     (OS2, 386Unix not tested)
  52.  
  53.   To use the 387-emulator the DPMI-server must provide DPMI 1.0 floating-point
  54.   extensions (most 0.9 server support this).
  55.  
  56. - DOS 3.3+ or DOS box emulation
  57.  
  58. - A GNU-C port for DOS like EMX/GCC 0.8e-h or DJGPP 1.06-1.11
  59.  
  60.   or any EMX program that should run under DPMI (like TeX386).
  61.  
  62.  
  63.  
  64.  
  65. Create more DPMI memory: (needed for older DJGPP)
  66. ------------------------
  67.  
  68. MS-Windows 3.1:
  69.     You can set the value PageOverCommit in the system.ini [386Enh] section
  70.     PageOverCommit=8     (default=4)
  71.     Specifies the multiplier for determining the amount of linear address space.
  72.     The amount of linear address space is computed by rounding up the amount of
  73.     available physical memory to the nearest 4 megabytes and then by multiplying
  74.     that value to the value specified for this setting.
  75.  
  76.     If you use a permanent Swapfile increase this file.
  77.  
  78.     Also you can create a smaller DOS-Box. PIF-settings:
  79.     - 400 KB DOS memory maximum [250 KB without rsx387]
  80.       (if you only want to run small DOS programs in RSX)
  81.         - EMS=0 ; XMS=0 ; no High-Memory-Area
  82.  
  83.  
  84. 386MAX 7.0:
  85.     To increase memory you must have a SWAPFILE line in your 386MAX.PRO file
  86.     SWAPFILE=C:\386MAX\386MAX.swp /S=10240
  87.     This creates a 10MB swapfile. The size of the virtual swapfile is the
  88.     amount of virtual memory available to your applications.
  89.  
  90. QEMM + QDPMI:
  91.     Set the environment QDPMI to something like
  92.     QDPMI=SWAPFILE c:\tmp\qdpmi.swp 8192
  93.     This creates a 8 MB swapfile. The sum of the value of availble memory and
  94.     the size of the virtual swapfile is the amount of virtual memory available
  95.     to your applications.
  96.  
  97. OS/2:
  98.     DPMI_DOS_API must have the value AUTO or ON
  99.     DPMI_MEMORY_LIMIT default value is 64 MB, you don't need to change it
  100.     EMS,XMS is not needed.
  101.  
  102.  
  103.  
  104.  
  105. INSTALL for EMX/GCC:
  106. --------------------
  107.  
  108. 1)  Set the environment RSX387, if a 387-emulation is required
  109.     RSX387=C:\RSX\FPU-EMU\RSX387
  110.     You can disable the FPU-EMU with the '-e' command-line switch.
  111.  
  112. 2)  There are two ways to run RSX from bound exe-files:
  113.  
  114.  a) Use emxl.exe from EMX-0.8H.
  115.     If the emxl.exe detects only DPMI it runs RSX.EXE, otherwise EMX.EXE.
  116.     See also \emx\doc\EMXRT.DOC in EMXRT.ZIP.
  117.  
  118.  b) Set the environment variable EMX to RSX.EXE like
  119.     EMX = C:\RSX\BIN\RSX.EXE .
  120.     Now, bound EXE-files run the RSX-extender instead of EMX. A special PATH
  121.     statement is not necessary.
  122.  
  123.     If you have no coprocessor and you want run the gcc compiler this method
  124.     is recommend. Also you can use the stub emxldpmi.exe (if DPMI, run RSX).
  125.  
  126.  
  127. Notes:
  128.     (a) Older emx versions don't use the EMX environment (emTeX386 b8).
  129.         Use emxbind -u to change the emxl.exe stub.
  130.  
  131.     (b) Note that the default stack is 60 KB. If you need more space, use
  132.     the -s option to grow the stack, or set a environment-var RSXOPT.
  133.     Example: RSXOPT=-s256 sets the stack to 256 Kbytes.
  134.     If you grow the stack, some programs require -as option
  135.     (see rsxcmds.txt).
  136.  
  137.  
  138.  
  139.  
  140. INSTALL for DJGPP:
  141. ------------------
  142.  
  143. 1)  Set environment RSX387, if 387-emulation is required.
  144.     RSX387=C:\RSX\FPU-EMU\RSX387
  145.  
  146. 2)  Bound executable must find RSX.EXE in the PATH or current directory.
  147.     Copy the binary files from \rsx\bin to your \djgpp\bin directory.
  148.     Or change the PATH to \rsx\bin.
  149.  
  150. 3)  Creating bound executable:
  151.     a) For go32 version 1.11 you can use the tools coff2exe, stubedit.
  152.     To create a gcc compiler for RSX.EXE do this:
  153.     c:\gcc\bin> xcopy gcc.exe gccdpmi.exe
  154.     c:\gcc\bin> stubedit gccdpmi.exe extender=rsx
  155.  
  156.     b) for older versions:
  157.     You must use the new stub STUBDJ.EXE to create bound executable. The
  158.     program BINDDJ puts a stub and the a.out program together:
  159.  
  160.     BINDDJ stubdj.exe myfile myfile.exe
  161.  
  162.     Stubdj executes RSX if a DPMI-server is there, and go32.exe if there is no
  163.     DPMI-server. To change the gcc compiler exe-stub, use EXE2AOUT from djgpp
  164.     to get the a.out file and use the BINDDJ command to create the new stub.
  165.  
  166.     Example:
  167.     C:\GCC\BIN> exe2aout gcc.exe
  168.     C:\GCC\BIN> binddj stubdj.exe gcc gccd.exe (copy stubdj+gcc gccd.exe)
  169.  
  170.  
  171. [4] Building library LIBRSX.A
  172.     If you want to use signals(), ptrace(), wait(), etc you must build
  173.     the library 'librsx.a'.
  174.     Read the file 'readme' in the \rsx\source\djlibrsx to install
  175.     this futures.
  176.  
  177.  
  178.  
  179.  
  180. Major BUGS in tested Hosts :
  181. ----------------------------
  182.  
  183.     running MS-Windows 3.1
  184.     (exception 3 is not used, int3 handler must installed)
  185.  
  186.     running QEMM + QDPMI 1.01
  187.     - page faults terminate program
  188.     - QDPMI virtuel memory error after memory resize fails (page fault)
  189.       (can happen in GDB.EXE)
  190.  
  191.     running 386MAX 6.00 (the new version 7.00 is ok)
  192.     - gp-fault in host handler calling spawning() for a real-mode program
  193.     - control-c handler will never called
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200. Patch for next EMX-Update:
  201. --------------------------
  202.  
  203. If you upgrade a new EMX version (maybe emx0.8i ?), you always get a warning
  204. message if you run the rsx.exe file.
  205. Now you can patch the RSX.EXE file:
  206.  
  207.     Take a good Hexdump-editor
  208.     Load RSX.EXE
  209.     Search for reversed version number "h8.0"
  210.     Change this value
  211.     Save RSX.EXE
  212.  
  213.