Using Tools: 4 Esp

GEOS SDK TechDocs

3 File Types

5 Glue

Esp (pronounced "esp") is the GEOS assembler. It creates object files from Esp code--said code using a superset of MASM syntax. These object files may then be linked by means of the Glue tool.

Most users will never call Esp directly, instead going through pmake , which will make the proper calls to Esp for the most common cases.

Esp takes the following options:

-2

Code produced should be DBCS--characters will be two bytes instead of one.

-I directory

Specifies an additional directory in which to look for included files.

-o filename

Name to give to created object file.

-w warntype

- W warntype

Turn warnings off or on

unref

Warn if a symbol that can only be used during this assembly isn't.

field

Warn if structure field used with . operator when lhs isn't of the type that contains the field

shadow

Warn if a local variable or procedure overrides a definition in a larger scope

private

Warn if a private method or instance variable is used outside a method handler or friend function related to the class that defined the thing

unreach Warn about code that cannot be reached. This is very simplistic

unknown Warn if a far call is made to a routine whose segment is unknown

record

Warn if a record initializer doesn't contain all the fields of the record

fall_thru

Warn if a function falls into another one without a .fall_thru directive

inline_data

Warn if a variable is defined where execution can reach

unref_local

Warn if a local label isn't ever referenced

jmp

Warn if out-of-range jumps are transformed into short jumps around near jumps

assume

Warn when override is generated based on segment assumptions

all

Used to turn all warnings on or off.

-M

This assembly is just for the purpose of determining what the source file's dependencies is. Instead of creating an object file, Esp will create a temporary file which the dependencies maker will use to determine the dependencies.

-d

Activate's Esp debugging mode. Useful only when trying to track down a bug in Esp.

GEOS SDK TechDocs

3 File Types

5 Glue