home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / oxcc1433.zip / DOC / SKEL.TXT < prev   
Text File  |  1995-11-06  |  3KB  |  57 lines
  1. SKEL.TXT
  2.  
  3.     The skeleton is a framework program which incorporates a
  4.     dynamic linker and a dos extender. The programs `oxcc.exe',
  5.     `oxccb.exe', `oxccl.exe' and `bterp.exe' are all skeleton
  6.     programs stored under different names. The native skeleton
  7.     name is `cfrun.exe'. The action of the skeleton is to load
  8.     and dynamically link the real program from a .cff archive.
  9.     The complete c library is automatically loaded when the
  10.     skeleton runs. The linker can handle a.out and coff formats.
  11.  
  12.     In addition to loading the program, the skeleton loads
  13.     some basic support modules from the file `oxbow.a'. Early
  14.     detection is used to pull in the proper support modules
  15.     depending upon the host system.
  16.  
  17.     To get a new skeleton program, just copy an old one and give
  18.     it a new name, or if under a unix system, just symbolic link
  19.     a new name to an old existing file. Or to conserve space you
  20.     could write a batch file which contains something like:
  21.         cfrun myprog
  22.      or 
  23.          cfrun myprog.o
  24.  
  25.     The skeleton searches for files in `.' and `c:\oxbow' unless the
  26.     environment variable OXPATH or the -PATH switch is set. If it doesn't
  27.     find anything, it then searches through the directories in the PATH
  28.     environment variable.
  29.  
  30.     If the name of an application is supplied to cfrun, e.g. cfrun myapp
  31.       Then if myapp.cff is found on the path it is searched for myapp.o and
  32.       symbols _main and _myapp. If myapp.cff is not found then if oxlib.cff
  33.       is found on the path it is searched for myapp.o, and finally for the
  34.       symbols _main and _myapp. If myapp.o is not found in oxlib.cff then
  35.       the path is searched for myapp.o.
  36.  
  37.     If the object file name is supplied to cfrun, e.g. cfrun myapp.o
  38.      Then the path is searched for myapp.o before searching for myapp.cff
  39.      and oxlib.cff. This facilitates debugging modules not yet entered into
  40.      archives.
  41.  
  42. Usage: cfrun appname [-APP=][-LIB=][-PATH=][-TRACE=][-LBUFS=][appargs]
  43.    or: appname [-APP=][-LIB=][-PATH=][-TRACE=][-LBUFS=][appargs]
  44.  
  45.    Switch -------- Meaning
  46.    -APP=filename   Permanent object file/archive for the application.
  47.    -LIB=filename   Additonal library or archive file.
  48.    -PATH=p1;p2;... Lookup path for files.
  49.    -LBUFS=n        Allocate n kilobytes of database buffering.
  50.    -TRACE=n        Set trace bits (hex,octal,decimal ok).
  51.    appargs         Application args.
  52.  
  53.     Trace bits cause verbose output from the dynamic linker and
  54.     multiple inheritance engine. Try 1,2,4,8,15 etc.
  55.     Output is to stdout.
  56.  
  57.