home *** CD-ROM | disk | FTP | other *** search
/ PC Extra Super CD 1998 January / PCPLUS131.iso / DJGPP / V2 / DJCRX201.ZIP / cross / readme < prev   
Encoding:
INI File  |  1996-10-26  |  3.5 KB  |  95 lines
  1. [This directory provided by James Soutter <J.K.Soutter1@lboro.ac.uk>]
  2.  
  3.                        The DJGPP Cross Compiler
  4.                        ------------------------
  5.  
  6.  
  7. 1. What is DJGPP: [from http://brennan.home.ml.org/djgpp/]
  8.  
  9.    DJGPP is a port of GNU GCC to the DOS environment. (It stands for
  10.    DJ's Gnu Programming Platform, if it has to stand for something, but
  11.    it's best left ambiguous.)
  12.  
  13.  
  14. 2. Who created/worked on DJGPP: [from http://brennan.home.ml.org/djgpp]
  15.  
  16.    DJGPP was done primarily by DJ Delorie. Charles W. Sandmann is another
  17.    major contributor, and there are many others.
  18.                     
  19.                     
  20. 3. Using the cross compiler:
  21.  
  22.    a.  Compile your program as normal but use "dos-gcc" rather than "gcc"
  23.        or your regular compiler.
  24.       
  25.            make clean
  26.            make CC=dos-gcc
  27.            
  28.    b.  If the last stage in the compile was "dos-gcc -o prog ..." then you
  29.        should find a DOS binary "prog.exe" in the current directory.
  30.          
  31.    c.  Copy "prog.exe" to your DOS machine/directory/floppy along with
  32.        CWSDPMI.EXE (stored with this README).  If you are already using a
  33.        DPMI server (like windows) then CWSDPMI.EXE is not required but can
  34.        be included anyway.
  35.        
  36.    d.  Run your program as "prog" under DOS and be amazed.
  37.       
  38.    e.  A few functions are not supported by the DJGPP library.  "dos-gcc"
  39.        defines the symbol "GO32".  Use it to mark regions of code that
  40.        are DJGPP specific.
  41.        
  42.            #if ! defined (GO32)
  43.            newSpace = mmap(0, pagesize, PROT_READ | PROT_WRITE, MAP_PRIVATE,
  44.                               devZeroFile, 0);
  45.            #else
  46.            newSpace = malloc(pagesize);
  47.            #endif
  48.            
  49.  
  50.    f.  By default your program is allocated a fixed 256k stack.  Very
  51.        recursive programs you may require a bigger stack.  Use the tool
  52.        "dos-stubedit" to change the stack size.  Type "dos-stubedit -h"
  53.        for help.
  54.        
  55.        
  56. 4. Reading the documentation:
  57.  
  58.    The libc library used in DJGPP is described in "info/libc.inf".
  59.    To read this file use the "info" program from the "texinfo"
  60.    distribution.  E.g.
  61.  
  62.            info -f info/libc.inf
  63.     
  64.      
  65. 5. How do I get DJGPP: [from DJGPP Mini-FAQ]
  66.  
  67.    FTP:    ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/
  68.            ftp://ftp.ibp.fr/pub/simtelnet/gnu/djgpp/
  69.            ftp://ftp.bhp.com.au/pub/simtelnet/gnu/djgpp/
  70.            (see http://www.delorie.com/djgpp/getting.html for a complete list)
  71.    CDROM:  contact gnu@prep.ai.mit.edu for cd-rom sales information
  72.    USMAIL: Contact dj@delorie.com for information
  73.  
  74.  
  75. 6. More information on DJGPP: [from DGJPP Mini-FAQ]
  76.  
  77.    The full FAQ:  FTP: v2/faq202b.zip in any djgpp distribution (above)
  78.                   WWW: http://www.delorie.com/djgpp/v2faq/
  79.    WWW Home Page: http://www.delorie.com/djgpp/
  80.    Newsgroup:     news:comp.os.msdos.djgpp (preferred over the mailing list)
  81.    Mailing list:  djgpp-announce@ and djgpp@delorie.com
  82.                   (c.o.m.d and djgpp@ are tied together)
  83.                   Digests: djgpp-digest-daily@ and djgpp-digest-weekly@
  84.                   subscription add/drop requests to listserv@
  85.                   mailing list problems to djgpp-request@
  86.    Mail Archives: http://www.delorie.com/djgpp/mail-archives/ (searchable)
  87.    
  88.    To unsubscribe (substitute djgpp-announce for djgpp if desired)
  89.            $ mail listserv@delorie.com
  90.            Subject:
  91.            unsubscribe djgpp
  92.            ^D
  93.  
  94.  
  95.