Annotation of os2sdk/startup/readme.doc, revision 1.1.1.1

1.1       root        1: C Runtime Library Startup Sources
                      2: ---------------------------------
                      3: The directory \startup and its subdirectories contain the files
                      4: necessary for building the startup portion of the C runtime library.
                      5: The \startup directory contains the startup source files, the include
                      6: include files, the batch file and the make file used to build the startup 
                      7: object files.  The subdirectories of \startup contain OS specific sources.
                      8: 
                      9: The startup object files can be built by invoking startup.bat from within
                     10: the \startup directory.  This batch file assumes the following:
                     11: 
                     12:        (1) make.exe, link.exec, the C compiler, and the assembler must be i
                     13:        in the execution path.  MASM 4.0 and C 5.0 or later are required to
                     14:        build the startup sources.
                     15:        (2) doscalls.lib must be in the directory specified by the LIB 
                     16:        environment variable.
                     17: 
                     18: Startup will created four memory model specific subdirectories (i.e., S, M, C,
                     19: and L) and place the appropriate object files there.  Under each memory model
                     20: subdirectory, startup creates two addition subdirectories OS2 and DOS where
                     21: OS specific objects reside.
                     22: 
                     23: The include files stdio.h and ctype.h are required for building the
                     24: startup source file wild.c but are not included on the \startup directory
                     25: because they exist on the directory containing the standard include files.
                     26: A make variable called CINC controls where the makefile looks for these
                     27: include files. STARTUP.BAT sets CINC to the current value of the INCLUDE
                     28: environment variable.  This variable should be set to the location of
                     29: the C include files.  CINC can also be set in the makefile if you wish
                     30: to run the makefile seperately.
                     31: 
                     32: The message "<cEnd - nogen>" is generated when some of the assembly language 
                     33: source files are assembled.  This message is expected and is totally benign.
                     34: 
                     35: The startup batch file requires as arguments a list of capital letters
                     36: describing the memory models you wish to build.  For example,
                     37: "startup S L" will build the small and large model startup objects.
                     38: Startup will then link the objects with a sample C program called nulbody.c
                     39: (consisting of a null main functions) to produce nulbody.exe.
                     40: [Invoking startup.bat with no arguments will give usage information.]
                     41: 
                     42: Note:  startup sources written in assembly language have been edited with
                     43: tabstops set to 8.  Startup sources written in C have been edited with
                     44: tabstops set to 4.  
                     45: 
                     46: The following files are contained in the \startup directory:
                     47: 
                     48: Startup source files (OS independent):
                     49: 
                     50:        chkstk.asm
                     51:        chksum.asm
                     52:        crt0fp.asm
                     53:        setargv.asm
                     54:        wild.c
                     55: 
                     56: Startup source files (OS specific):
                     57:        crt0.asm
                     58:        crt0dat.asm
                     59:        crt0msg.asm
                     60:        execmsg.asm
                     61:        nmsghdr.asm
                     62:        stdalloc.asm
                     63:        stdenvp.asm
                     64:        stdargv.asm
                     65: 
                     66: Startup include files:
                     67:        brkctl.inc
                     68:        cmacros.inc
                     69:        msdos.inc
                     70:        register.h
                     71:        msdos.h
                     72:        version.inc
                     73:        
                     74: Tools:
                     75:        dosseg.exe
                     76:     
                     77: Make and batch files:
                     78:        startup.bat:    invokes make file to build objs and link to null program
                     79:        makefile:       contains rules for building startup sources
                     80:        nulbody.c:      null c program
                     81:        nulbody.lnk:    link script for linking null program
                     82: 
                     83: Documentation:
                     84:        readme.doc:     information about \startup directory structure
                     85:                        and contents
                     86: 
                     87:                                --- End ---

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.