Return to readme.doc CVS log

Up to [OS/2 SDKs] / os2sdk / startup

Annotation of os2sdk/startup/readme.doc, revision 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 ---

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