home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / gnuish / 00readme.gcc < prev    next >
Text File  |  1994-03-07  |  14KB  |  368 lines

  1.  
  2. This is the README file for DJ's GCC port to DOS ("djgpp")
  3.  
  4. Contents:
  5.     * Overview
  6.     * What's available
  7.     * How to install
  8.     * Deviations and Caveats
  9.     * Copyright information
  10.  
  11. Disclaimer: This software is distributed WITHOUT ANY WARRANTY; without
  12. even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  13. PURPOSE.
  14.  
  15. DJ Delorie
  16. USmail: 24 Kirsten Ave, Rochester, NH 03867-2954, USA
  17. email:  dj@ctron.com
  18.  
  19. mailing list: djgpp@sun.soe.clarkson.edu (listserv@sun.soe.clarkson.edu)
  20.      djgpp-announce@sun.soe.clarkson.edu (listserv@sun.soe.clarkson.edu)
  21.  
  22.  
  23.  
  24.  
  25. Overview:
  26.  
  27. This package contains a 32-bit 80386 DOS extender with symbolic
  28. debugger, a C/C++ compiler with utilities, development libraries, and
  29. source code.  It generates full 32-bit programs and supports full
  30. virtual memory with paging to disk. 
  31.  
  32. Requirements:
  33.  
  34. A 80386-based IBM compatible PC or PS/2, approximately 4-5Mb of hard
  35. drive space, and 512K RAM.  Available extended (or expanded under VCPI)
  36. memory is strongly recommended.
  37.  
  38. Supported Wares:
  39.  
  40. * Up to 128M of extended memory (expanded under VCPI)
  41. * Up to 128M of disk space used for swapping
  42. * SuperVGA 256-color mode up to 1024x768
  43. * 80387
  44. * XMS & VDISK memory allocation strategies
  45. * VCPI programs, such as QEMM, DESQview, and 386MAX
  46. * DPMI programs, such as Windows 3.x, OS/2, and QDPMI
  47.  
  48. Unsupported:
  49.  
  50. * Multiprocessing (fork())
  51.  
  52.  
  53.  
  54.  
  55. File location:
  56.  
  57.     host:      omnigate.clarkson.edu
  58.     login:     ftp
  59.     password:  send your e-mail address
  60.     directory: ~ftp/pub/msdos/djgpp
  61.  
  62. Many thanks to the sysops at Clarkson for providing a home to djgpp!
  63.  
  64. As a convenience to non-FTP users, djgpp is also stored on Clarkson's
  65. archive server.  To access the archive server, do this:
  66.  
  67.    % mail archive-server@omnigate.clarkson.edu
  68.    Subject: <none>
  69.    help
  70.    index msdos/djgpp
  71.    ^D
  72.  
  73. NOTE: In accordance with FSF CopyLeft, you are not allowed to upload
  74. this program to a distribution site unless you upload the source modules
  75. with any binary module you upload.  Please read the file COPYING for
  76. more details. 
  77.  
  78. NOTE: If your application links in object modules that were written by
  79. FSF, your application counts as a "derived work" and must obey the
  80. provisions of the FSF Copyrights.  See the file COPYING for details. 
  81. All FSF source-based libraries are in the file libgpl.a.  The mere act
  82. of compiling does not affect the copyright status of your program. 
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92. INSTALLING:
  93.  
  94. To install, you must do the following:
  95.  
  96. * Create a "temp" directory, like c:\tmp.
  97.  
  98. * Create a directory to install in, like c:\djgpp.
  99.  
  100. * Un-zip the appropriate zipfiles in the install directory.
  101.     C:\DJGPP> pkunzip -d -o djdev110.zip
  102.     C:\DJGPP> pkunzip -d -o gas211bn.zip
  103.     C:\DJGPP> pkunzip -d -o gcc241bn.zip
  104.     C:\DJGPP> pkunzip -d -o bnu22bn.zip
  105.  
  106. * Add the following lines to C:\CONFIG.SYS file (or edit existing
  107.   files= and shell= lines as appropriate).  The files= line prevents "too many
  108.   open files" errors when compiling, and the shell= line prevents "Out of
  109.   environment space" errors when setting lots of environment variables.
  110.  
  111.     files=15
  112.     shell=c:\command.com c:\ /e:600 /p
  113.  
  114. The values 15 and 600 are close to minimal.  You may want to increase them
  115. to provide a little more margin.
  116.  
  117.  
  118. * Add the following lines to C:\AUTOEXEC.BAT:
  119.     set COMPILER_PATH=c:/djgpp/bin
  120.     set C_INCLUDE_PATH=c:/djgpp/include
  121.     set CPLUS_INCLUDE_PATH=c:/djgpp/cplusinc;c:/djgpp/include
  122.           ^^^ only needed if you are compiling c++ programs
  123.     set OBJC_INCLUDE_PATH=c:/djgpp/include
  124.           ^^^ only needed if you are compiling objective-C programs
  125.     set OBJCPLUS_INCLUDE_PATH=c:/djgpp/include
  126.           ^^^ only needed if you are compiling objective-C++ programs
  127.     set LIBRARY_PATH=c:/djgpp/lib
  128.     set TMPDIR=c:/tmp
  129.              ^^^ this is where gcc's temp files go
  130.     set GO32TMP=c:/tmp
  131.                 ^^^ this is where your paging file goes - if not set, the
  132.                     variables TMP and TEMP are checked in that order
  133.     set GO32=ansi driver c:/djgpp/drivers/SOMETHING.grd gw 1024 gh 768
  134.                          ^^^ whatever driver works with your VGA (optional)
  135.     set BISON_SIMPLE=c:/djgpp/lib/bison.simple
  136.           ^^^ only needed if you use bison
  137.     set BISON_HAIRY=c:/djgpp/lib/bison.hairy
  138.           ^^^ only needed if you use bison
  139.     set FLEX_SKELETON=c:/djgpp/lib/flex.skeleton
  140.           ^^^ only needed if you use flex
  141.  
  142.   Remember that unless you manually type these at the command line,
  143.   they won't take effect until you reboot.  Don't include the "ansi"
  144.   keyword in the "go32" variable if you don't have an ANSI.SYS driver
  145.   or equivalent.
  146.  
  147. * Add your binaries directory to your PATH in C:\AUTOEXEC.BAT
  148.     SET PATH= . . . ;C:\DJGPP\BIN
  149.  
  150. That's it! djgpp is now installed on your system.
  151.  
  152.  
  153.  
  154.  
  155.  
  156. The GO32 environment variable:
  157.  
  158.  
  159. This variable controls the options available in go32 or debug32.  The
  160. syntax of this variable is:
  161.  
  162.   SET GO32=[parm [value]] [parm [value]] . . .
  163.  
  164. Parameters:
  165.  
  166.   ansi           Use ANSI commands to control the color in debug32
  167.   mono           Use the Monochrome monitor for debugging - useful when
  168.                    debugging graphics applications
  169.   1rm            Redirect stdout (file #1) to the monochrome monitor
  170.   2rm            Redirect stderr (file #2) to the monochrome monitor
  171.   1r2            Redirect stdout (file #1) to stderr (file #2)
  172.   2r1            Redirect stderr (file #2) to stdout (file #1)
  173.  
  174.   glob           enable globbing (default)
  175.   noglob         disable globbing
  176.  
  177.   emu [path]     Use the specified file as the 80387 emulator
  178.  
  179.   driver [path]  Use the specified file as the graphics driver
  180.   gw [width]     Default graphics width
  181.   gh [height]    Default graphics height
  182.   tw [width]     Default text width
  183.   th [height]    Default text height
  184.   nc [colors]    Number of colors (for new-style drivers only - see cbgrx*.zip)
  185.  
  186.  
  187. These parameters may occur in any order.
  188.  
  189. Note that "1rm" and "2rm" are done before "1r2" and "2r1", so "1rm 2r1" sends
  190. stdout to the mono monitor and stderr to any redirection used.
  191.  
  192. Examples:
  193.  
  194.   C:\> set GO32=mono driver c:\djgpp\drivers\tseng4k.grd gw 1024 gh 768 tw 132 th 43 nc 256
  195.   C:\> set GO32=ansi
  196.   C:\> set GO32=driver c:\djgpp\drivers\tseng4k.grd ansi
  197.   C:\> set GO32=mono 1rm 2rm
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208. Deviations and Caveats:
  209.  
  210. GCC/G++ deviates from the U**x version in a number of ways, mostly to
  211. accomodate deficiencies in the MS-DOS environment, and my own laziness.
  212.  
  213. * An 80387 is required to do floating point.  An emulator is provided.
  214.   cc1 and cc1plus shouldn't use the 387 unless compiling floating point
  215.   code.  The environment variable "387" can override the auto-detection
  216.   routine:
  217.     SET 387=YES   to force 387 handlers to be enabled
  218.     SET 387=NO    to force 387 accesses to fault
  219.     SET 387=QUERY to get a message showing the results of the auto-detection
  220.   If no 80387 is present and the program attempts to use it, a message
  221.   indicating where the instruction is will be displayed.  To use the
  222.   387 emulator, add "emu c:\djgpp\emu387\emu387" to the GO32 environment
  223.   variable.  Specifying use of the emulator overrides the "387"
  224.   environment variable and autodetection code.
  225.  
  226. * The VDISK method of allocating extended memory is supported.  The
  227.   INT 15h method is also.  When the extender runs out of conventional and
  228.   extended memory, it uses a paging file named $(GO32TMP)/pgXXXXXX.386, where
  229.   XXXX is an unspecified hex value.  This file is normally removed on exit.
  230.  
  231. * Up to 128 MB of physical memory and 128 MB of disk swap space are allowed.
  232.   A 512K machine is sufficient, but very slow due to paging.
  233.  
  234. * The utilies support the MS-DOS standard response file method for giving
  235.   more than 128 bytes of command line.  Example: "gcc -o foo @foo.lnk" where
  236.   foo.lnk contains a list of .o files.  Wildcard expansion (globbing) is
  237.   performed on the parameters, unless they are surrounded by single quotes.
  238.   Double quotes can be used to prevent spaces from separating arguments.
  239.   Also supported is the GNUish-DOS method of passing arguments in
  240.   environment variables.
  241.  
  242. * Since MS-DOS does not distinguish case in file names, some .h files
  243.   used for C++ have had underscores prepended to them to avoid conflict
  244.   (ie: String.h conflicts with string.h, so it became _String.h).
  245.  
  246. * The extender can be added to any gcc-compiled program by copying go32.exe
  247.   to be <program>.exe, where <program> is the 32-bit program.  For example,
  248.   if "hello" is a gcc-compiled a.out file, and "hello.exe" is a copy of
  249.   go32.exe, then when "hello.exe" runs, it loads the file called "hello"
  250.   in the same directory, and executes it if present.  Otherwise,
  251.   the first parameter is the executable (ie: go32 cc1plus foo.cc).
  252.  
  253. * The extender can be merged to create one .exe file that is the extender
  254.   and the executable in one file, by using the stub.exe program:
  255.       copy /b stub.exe+myprog myprog.exe
  256.        -or-
  257.       aout2exe myprog
  258.   This will only work if go32.exe is in your search path, because stub.exe
  259.   runs it.  Alternatively, you can prepend go32.exe itself to an a.out file
  260.   to get a single executable (stub.exe is much smaller).  Note that if
  261.   you re-compile go32 or stub, you must strip off the symbol table first. 
  262.   Also note that aout2exe is designed to align the executable image for
  263.   better performance, so aout2exe'd programs will run faster than those
  264.   built with copy /b.
  265.  
  266. * The extender runs programs at logical address 0.  A copy of the first
  267.   1 MB of physical memory (including the AT channel) is mapped to
  268.   0xE0000000 in the program's address space.  The stack grows down from
  269.   0x7FFFFFFC in the program's address space.  Data usually starts at
  270.   0x00400000.  These numbers may be different under DPMI.
  271.  
  272. * The paging mechanism understands how SuperVGA's map their memory onto
  273.   the AT bus and automatically swaps pages as the program tries to
  274.   access them.  The program sees a linear range from 0xD0000000 to
  275.   0xD0100000 that corresponds to each pixel in the 256-color modes
  276.   of SuperVGAs.  To use this feature, you'll have to set the GO32
  277.   environment variable like this:
  278.     C>set go32=driver c:\djgpp\drivers\tseng4k.grd gw 640 gh 480 tw 132 th 43
  279.   These parameter pairs can be omitted or rearranged as needed.  They are
  280.   the "driver" name, default graphics width and height, and default
  281.   text width and height. Libgr.a doesn't have to be recompiled, nor
  282.   do graphics programs, when a different graphics mode is selected
  283.   (the extender handles it).  It is strongly recommended that the program
  284.   use the GR_default_graphics and GR_default_text modes to switch to
  285.   graphics or text.  These modes use the parameters specified by the
  286.   GO32 environment variable, allowing the user to select a favorite
  287.   graphics and text mode.
  288.  
  289. * Symbols are stored in virtual memory, so you won't run out of symbol
  290.   space until both extended memory and the disk are all used up.  For
  291.   large programs, you might notice a slight delay while it looks up
  292.   symbols.  Programs with a lot of lines in a given module may run out
  293.   of memory as the line number table is built in real memory and transferred
  294.   to virtual memory.
  295.  
  296. * Signals are not reported to the program.  However, interrupts do continue
  297.   to get serviced while in protected mode (ie: keypress, timer, etc).
  298.   CTRL-C will get you back to the debugger in debug32, and you can continue
  299.   from where you stopped.  All signals (ie: exceptions) cause debugging
  300.   traps in debug32, or general faults in go32.
  301.  
  302.  
  303.  
  304. Copyright Information:
  305.  
  306. * Source code for the GNU utilities is copyright (c) Free Software Foundation.
  307.   For more information on the FSF copyright, see their source code or write
  308.   Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  309.  
  310.   A copy of their file "COPYING" is included in the docs directory.  Some of
  311.   the FSF source code has been modified to operate properly in the MS-DOS
  312.   environment.
  313.  
  314. * Source code for most of libc.a are copyright (c) Regents of the University
  315.   of California.  These files include copyright information in them.  The
  316.   utilities are compiled against these libraries, and thus contain software
  317.   developed by the University of California, Berkeley, and its contributors.
  318.   Some of the BSD source code has been modified to operate properly in the
  319.   MS-DOS environment.
  320.  
  321. * Any sources not falling under the copyrights of FSF or UCB (as above) are
  322.   Copyright (c) 1991 DJ Delorie, 24 Kirsten Ave, Rochester NH 03867-2954.
  323.   To contact me via E-Mail, sent to "dj@ctron.com".  Cabletron Systems Inc
  324.   is in no way involved with this project; I just happen to work for them
  325.   during the day.
  326.  
  327. Terms and Conditions:
  328.  
  329. * Source code copyright FSF is distributed under the terms of the GNU
  330.   Public General License.  See the file "COPYING" in doc.arc for more
  331.   information.  If your program links in object modules (in libc.a) that
  332.   are compiled from GNU sources, then your entire program must be
  333.   distributed under the terms of the GNU GPL as a "derived work".  These
  334.   modules are the C++ class library (including the streams classes) and
  335.   obstacks, and are restricted to the libgpl.a lbrary.  The sources in
  336.   libsrc have the copyright notices in them for the various modules.
  337.  
  338. * Source code copyright UCB is distributed under the terms listed in the
  339.   UCB source code itself.
  340.  
  341. * Source code copyright DJ Delorie is distributed under the terms of
  342.   the file "copying.dj".
  343.  
  344. * Changes to source code copyright BSD or FSF are copyright DJ Delorie, but
  345.   fall under the terms of the original copyright.
  346.  
  347.  
  348.  
  349.  
  350.  
  351. Donations may be made to any of the following:
  352.  
  353.     DJ Delorie
  354.     24 Kirsten Ave
  355.     Rochester, NH  03867-2954
  356.     USA
  357.  
  358.     Free Software Foundation
  359.     675 Mass Ave
  360.     Cambridge, MA  02139
  361.     USA
  362.  
  363.     Computer Systems Research Group
  364.     Computer Science Division, EECS
  365.     University of California
  366.     Berkeley, California  94720
  367.     USA
  368.