tools.hsc

CC386 is a general-purpose 32-bit C compiler. It is not an optimizing compiler but given that the co

\par NST\tab NOSTatistics      \tab Yes    \tab Linker will not give performance statistics
\par N32\tab NOUse32           \tab Yes    \tab Linker will not allow 32-bit segments
\par \tab OBjchecksum       \tab No     \tab Test checksum in .OBJ records               
\par \tab ORder:(text)      \tab none   \tab Segment ordering expression (see below)
\par NPE\tab NoPE              \tab Yes    \tab Linker will not produce a PE executable
\par OA\tab ObjectAlign       \tab 64K    \tab Object alignment for PE images
\par \tab PAuse             \tab No     \tab Pause before writing executable image
\par PAS\tab padSegments\tab No     \tab Pad PE sections
\par PE\tab PE\tab No     \tab Produce a PE executable
\par PH\tab peHeapSize\tab 65536  \tab Heap size for PE files
\par PHC\tab peHeapCommit\tab 0      \tab Amont of heap to commit for PE files
\par PIB\tab peImageBase\tab 4M     \tab Image base for PE files
\par PSC\tab peStackCommit\tab 8K     \tab Amount of heap to commit for PE files
\par PS\tab peStackSize\tab 1M  \tab Stack size for PE and LX files
\par PHS\tab PUblichashsize:n\tab 525    \tab Hash size for public symbols (1 - 1023)
\par \tab SYsfile\tab No     \tab Produce a .SYS file (e.g., device driver)
\par SHS\tab SEgmenthashsize:n\tab 25     \tab Hash size for segment (1 - 1023)
\par STD\tab STACk:n\tab none   \tab Ensure there is a stack of at least n bytes
\par STS\tab STATistics\tab No     \tab Produce performance statistics for linker
\par TMP\tab TEmpfile:(text)\tab val.tmp \tab Specifies name of linker temporary file
\par WIN\tab winSubSys\tab No     \tab PE files will use WIN32 subsystem
\par 32\tab Use32\tab No     \tab Linker will allow 32-bit segments
\par \pard 
\par }
160
Scribble160
XLIB Command Line




Writing



FALSE
35
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;}
\viewkind4\uc1\pard\ri1460\cf1\b\fs32 XLIB Command Line\cf0\b0\f1\fs20 
\par 
\par \f0 The general format of the XLIB command line is as follows:
\par 
\par XLIB [options] library [+,-,*] filename ...
\par 
\par XLIB can work with response files by preceding the name of the response file with '@':
\par 
\par XLIB @resp.rsp
\par 
\par Note that each physical line of a response file should end in '&'.
\par 
\par XLIB has the following operation specifiers:
\par 
\par \pard\ri1440\tx680\tx2780\tab + \tab add a file to a lib
\par \tab -\tab delete a file from a lib
\par \tab *\tab extract a file from a lib
\par \tab -+\tab replace a file in a lib
\par 
\par \pard\ri1460 Each file on the command line must have a specifier; however specifiers are in scope from the time they are specified until the time a next specifier is specified.  Therefore one doesn't need to repeat specifiers that are being reused.  For example:
\par 
\par XLIB xlib.lib + file1.obj file2.obj file3.obj - file4.obj
\par 
\par adds three files and deletes one.
\par 
\par XLIB has the following options:
\par 
\par \pard\ri1440\tx2220\b\fs22 /u \tab create case-insensitive dictionary for library searches
\par 
\par /pnn\tab set page size
\par \tab\b0\fs20 page size can be any multiple of 16 bytes
\par \pard\f1 
\par }
170
Scribble170
MKLIBLST Command Line




Writing



FALSE
14
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;}
\viewkind4\uc1\pard\ri1480\cf1\b\fs32 MKLIBLST Command Line\cf0\b0\f1\fs20 
\par 
\par \f0 The general format of a MKLIBLST command line is:
\par 
\par mkliblst respfile [.obj] list of files
\par 
\par Use the .obj option for CC386 XLIB librarian, or omit if for use with Borland's TLIB.
\par 
\par mkliblst will attempt to append the file list to the response file; it will create the response file if it doesn't already exist.
\par 
\par \f1 
\par }
172
Scribble172
IMPORT Command Line




Writing



FALSE
20
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;}
\viewkind4\uc1\pard\ri1460\cf1\b\fs32 IMPORT Command Line\cf0\b0\f1\fs20 
\par 
\par \f0 The general format of the command line for the IMPORT program is as follows:
\par 
\par import [options] target [source list]
\par 
\par The source list can be a response file, which starts with the @ character.
\par 
\par The target can be either a LIB file or a DEF file.  If the target is a LIB file the source must be a DEF or DLL file or combination of them.  If the target is a DEF file the source must be a DLL file and there can only be one source.
\par 
\par IMPORT has the following options:
\par \pard\ri1440\tx2240 
\par \b\fs22 /u \tab create case-insensitive dictionary for library searches
\par 
\par /pnn\tab set page size
\par \tab\b0\fs20 page size can be any multiple of 16 bytes
\par \b\fs22 
\par }
175
Scribble175
Using the created definition file




Writing



FALSE
11
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;}
\viewkind4\uc1\pard\ri1460\cf1\b\fs32 Using the created definition file\cf0\b0\f1\fs20 
\par 
\par \f0 The definition file is used as the response file on the XLIB command line.  For example:
\par 
\par mkliblst xlib.rsp .obj file1.obj file2.obj file3.obj
\par xlib aa.lib @xlib.rsp
\par 
\par will result in a library holding the three files listed on the mkliblst command line.\f1 
\par }
180
Scribble180
XRC Command Line




Writing



FALSE
18
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;}
\viewkind4\uc1\pard\ri1480\cf1\b\fs32 XRC Command Line\cf0\b0\f1\fs20 
\par 
\par \f0 The general format for the XRC command line is as follows:
\par 
\par XRC [parameters] source file
\par 
\par By default a target file having the same name as the source but with the extension RES will be generated.
\par 
\par XRC has the following options:
\par 
\par \pard\ri1460\tx2240\b\fs22 /Dname\tab define something
\par /Ipath\tab set include path
\par /foname\tab set name of output file
\par 
\par \f1 
\par }
190
Scribble190
CL386 Command Line




Writing



FALSE
41
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;}
\viewkind4\uc1\pard\ri1500\cf1\b\fs32 CL386 Command line
\par 
\par \cf0\b0\fs20 The general format for the CL386 command line is as follows:
\par 
\par CL386 [options] files
\par 
\par CL386 will allow response files, for example:
\par 
\par CL386 @resp.rsp
\par 
\par CL386 has the following options.  Note that unless otherwise specified options can be turned on or off by prefixing '+' or '-' after the option.
\par For example:
\par 
\par CL386 /A- myfile.c
\par 
\par compiles without extensions to ANSI
\par \pard\ri1500\tx2240 
\par \b\fs22 /A\tab Enable or disable extensions to ANSI
\par /Dxxx\tab Define something
\par /Ipath\tab Specify include path
\par /Oxxx\tab optimize parameters
\par /q\tab Enable or disable quiet mode
\par /K\tab keep response file
\par /e\tab put errors in file
\par /l\tab make listing file
\par /w-xxx\tab disable a warning
\par /e=name \tab set name of EXE file
\par /a\tab generate .asm file
\par /Ennn\tab max number of errors
\par /Lpath\tab specify lib directory
\par /Cxxx\tab codegen parameters
\par /k\tab keep generated files
\par /m\tab generate a map file
\par /i\tab dump preprocessed file
\par /n\tab ignore default lib and OBJ files
\par /v\tab debug info
\par /c\tab generate obj file
\par \pard\b0\f1\fs20 
\par }
200
Scribble200
IMAKE Command Line




Writing



FALSE
52
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;}
\viewkind4\uc1\pard\ri1480\cf1\b\fs32 IMAKE Command Line\cf0\b0\f1\fs20 
\par 
\par \f0 The general format for the IMAKE command line is:
\par 
\par imake [options] <target-list>
\par 
\par By default Imake will attempt to open a file MAKEFILE or MAKEFILE.MAK and process the instructions for building the project.  If target-list is omitted the first explicit target found will be evaluated; otherwise IMAKE will attempt to evaluate all targets found on the command line.
\par 
\par IMAKE has the following options:
\par \pard\fi-2200\li2200\ri1460\tx2220 
\par \b\fs22 -e\tab macros derived from environment variables cannot be overridden
\par \tab\b0\fs20 prevents changing values that are derived from the environment
\par \b\fs22 
\par -fname\tab specify the name of a makefile.
\par \tab\b0\fs20 Will attempt to open the specified file name for a list of instructions.  If the file does not exist then appends the extension MAK to the name and attempts to open it\b\fs22 
\par 
\par -h\tab command line help
\par 
\par -i\tab ignore return status of executed programs
\par \tab\b0\fs20 imake will keep going even if something fails with an error
\par \b\fs22 
\par -m\tab display time stamps
\par \tab\tab 
\par -n\tab test mode
\par \tab\b0\fs20 imake will evaluate the targets, without actually executing any programs listed for execution
\par \b\fs22 
\par -p\tab dump database of definitions and targets
\par \tab\b0\fs20 imake will dump all the information it has gathered after processing the file\b\fs22 
\par 
\par -r\tab don't run builtins.mak
\par \b0\fs20\tab by default, IMAKE will run a file 'builtins.mak' prior to loading the primary make file.  This specifies some convenient default values.  Use this option to ignore builtins.mak.
\par \b 
\par \fs22 -s\tab suppress display of commands being executed
\par \tab\b0\fs20 quiet mode\b\fs22 
\par 
\par -B\tab full build
\par \b0\fs20\tab ignore time stamps and fully evaluate every node which is a dependency of the listed targets
\par 
\par \b\fs22 -Dxxx\tab define something
\par \b0\fs20\tab make a macro definition
\par 
\par \b\fs22 -I\tab set include directory
\par \tab\b0\fs20 set directory for files included in the makefile
\par 
\par \b\fs22 -K\tab keep intermediate files
\par 
\par -Uxxx\tab prevent XXX from being defined
\par \tab\b0\fs20 When this option is used, IMAKE will prevent definitions of the corresponding macros\b\fs22 
\par \f1 
\par }
220
Scribble220
ITOUCH Command Line




Writing



FALSE
15
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;}
\viewkind4\uc1\pard\cf1\b\fs32 ITOUCH Command Line\cf0\b0\f1\fs20 
\par 
\par \f0 The general format for the ITOUCH command is:
\par 
\par ITOUCH [options] files