windows-server-2003/sdktools/masm

						MASM 5.NT Version Information



5.NT.01, 12/5/90 - Jeff Spencer. Initial release, same functionality as the

		  released product Masm 5.10A.



5.NT.02, 3/5/91 - Bugs fixed:

		- The xchg operator given two undefined symbols rather than

		  registers would GP fault. The problem was caused by referencing

		  an invalid pointer after having detected the error. The solution

		  was to stop processing the xchg instruction when this error

		  is detected.

		- Some symbols defined by equates were not being found by

		  the symsrch routine. The assembler was incorrectly attempting

		  to scope equates. This code just happend to work on 16

		  bit environments because of the memory alignment. It failed

		  on NT/386. The code was removed.







========================================================================



			MASM 5.NT.01



		Written 12/5/90, by Jeff Spencer.









Current state of MASM:



Masm 5.NT.01 is a portable version of MASM 5.10A. It works exactly like

MASM 5.10A with the following exceptions:



    - Masm 5.NT.01 does not support floating point initializers. This is

      because the strtod and _strtold C runtime functions are unavailable

      at this time. Future versions will support this capability

      (the code to support this has been ifdef'd out). Attempting to

      initialize a variable with a floating point number will result in a

      divide by zero error at assembly time.



    - Support for the MS floating point data format, and .MSFLOAT directive

      have been removed. Once floating point initializers are supported they

      will use the IEEE formats.



    - The time/date stamp in listing files has changed to the format

      provided by the standard C runtime libraries.





The code has been built and tested on NT/386 and NT/MIPS using the OS2

subsystem C runtime libraries. As of 12/5/90 there are no known bugs in

MASM.









General description of MASM 5.NT.01 code:



The code contained in this directory can produce an assembler to run on

OS2 1.2, OS2 2.0, and any version of NT. NT portability was achieved by

removing all assembly language and replacing all operating system

calls with C runtime calls.









Conditional Compilation Switches:



NOFLOAT 	- This constant is a binary switch. If it is absent the

		  code for floating point initializers is compiled. If it is

		  present then the floating point initializer code isn't

		  compiled. Currently the sources file does define this

		  constant. This allows MASM to be built despite the fact

		  that the strtod and _strtold functions don't exist

		  in the NT C runtime libraries. When these functions are

		  available the definition of NOFLOAT should be removed from

		  the sources file and masm rebuilt.



FIXCOMPILERBUG	- When defined allows some ifdef's to go around

		  some known compiler bugs. This include both CL386 and

		  MIPS compiler bugs. (These have been reported but not

		  fixed as of 12/5/90.)



<others>	- See asmconf.h.









General Info on building MASM for NT:



MASM 5.NT has been set up to use the standard NT build mechanism without

the requirement of the source actually being in the NT source tree. What

follows is a quick synopsis of my experiences with the NT build environment.



Building for the NT environment is not done through the standard

nmake mechanism. Instead the NT group uses a standard set of tools

that assume that the NT file tree starts at <current drive>\NT.

The best documentation I've found on how to set up to build files to run

on NT is in a file called newcomer.txt on \\ntos2\ntrel\release. KyleSh wrote

this document and can be quite helpful. Note that this document describes

both the development projects and the release project. It is only necessary

to enlist in one of these two projects. The advantage of enlisting in the

developer project is that you have the latest version of everything, and

with the right hardware, can build for MIPS. The disadvantage is

that this tree occupies over 100Mb of disk space. Although you can ghost

some of this I'm not sure which portions of the tree aren't needed. You also

have to build your own version of the NT kernel, OS2 subsystem, ect. The

advantage to enlisting in the release project is that you only have to build

your own code. And it requires only 21Mb of disk space. I found that for

building masm for NT/386 the release project was adequate. However, getting

the environment configuration files in the developr directory set up for

yourself can be a hassle. Also, be forewarned that sometimes the build tools

on the released project don't get updated as quickly as they should.

Note that the MASM tree must reside on the same logical drive (drive letter)

as the NT stuff. This is a limitation of how the NT tools work.



The masm project can be enlisted in from almost anywhere on the disk.

I suggest placing it in \MASM. Just make sure it is on the same drive

as the NT tree.



To use the developer projects rather than the released project you will

need to enlist in the projects: public, private, developr and os2.









Building MASM for NT/386:



    Released project method:

	- cd \NT (from \\os2nt\ntrel)

	- ssync -r

	- cd \MASM\510nt

	- build -esi -386 masm

	    Note: I've been having trouble with this hanging up at the link

	    step. Simply executing nmake at that point will finish the build,

	    assuming your environment variables are set up for 386 builds.



    Develeoper projects method:

	- cd \NT

	- ntsync

	- build -esi -386 os2 os2ss cmd cmd32

	    Note: This to build the necessary libraries to link with

		  and a version of NT to run on.

	- cd \MASM\510nt

	- build -esi -386 masm









Building MASM for NT/MIPS:



    As of this writing to build for the MIPS processor requires an Etherlink

    II network card and TCP/IP software. MarkL has this software and

    directions on how to install it. This is required because the

    actual MIPS compilation is done on a DEC server. The makefile.def

    file automatically ships the file to the server compiles it and ships

    it back.



    To build for the MIPS processor use the same procedure as for the 386

    except replace the -386 switch with the -mips switch.









Building MASM for OS2 1.2:



    The environment necessary:

	MASMOS = <nothing, i.e. not set>

	    - This causes the OS2 1.2 version to be built by makefile.os2

	      rather  than the OS2 2.0 version.

	PATH = <os2>;<LanMan>;<slm>;c:\tools\binb;c:\tools\binp

	LIB = c:\tools\lib

	INCLUDE = c:\tools\include

	Note: Tools directory comes from \\slug\tools\src\tools <pswd: vorga>



    The command line:

	- cd \MASM\510nt

	- md obj\os2.12 <if this hasn't been done yet>

	- nmake -f makefile.os2

	- The object and executable files will be in obj\os2.12









Building MASM for OS2 2.0:



    The environment necessary:

	MASMOS = OS2_2

		- This causes makefile.os2 to build the OS2 2.0 version when

		  it nmake is involked.

	PATH = <os2>;<LanMan>;<slm>;c:\c6_386\binb;c:\c6_386\binp

		- The release point for c6_386 is \\slproduct\current\c6_386

		  however the compiler code on \\sl\users\hanss\larch is

		  generally more current, and more bug free. The password

		  for \\slproduct\current is rikwrast, the password for

		  \\sl\users is soonhely.

	LIB = c:\c6_386\lib

		- this comes from \\slproduct\current\c6_386\lib

		  <pswd: rikwrast>

	INCLUDE = c:\c6_386\include

		- this comes from \\slproduct\current\c6_386\include



    The command line:

	- cd \MASM\510nt

	- md obj\os2.20 <if this hasn't been done yet>

	- nmake -f makefile.os2

	- The objects and executables will be in obj\os2.20







MASM execution speed:



In order to speed up the port from MASM to NT we decided to replace all

occurences of integer variables with either signed or unsigned short

variables. This was done at the expense of execution speed and size.

Therefore, this is one area that could be visited if execution speed

becomes an issue.









Testing MASM:



There are two different mechanisms available to test MASM on NT. The normal

mechanism uses the testing tool td. Although td is the preferred way to do

the testing it currently doesn't work on NT because of various subsystem bugs.

Because of this a set of very simple command files has been developed to run

the tests.









Testing MASM using TD:



    - Read the readme file on \\slog\slm\src\nt

    - Enlist in the NT project on \\slop\slm <pswd:ungepamm>

	- The directory you enlist must be on the same drive as the NT tree.

    - Build all the tools in the project (see readme)

    - Put the exe's built in a directory in the path on the NT test machine.

    - Put masm.exe in the same directory.

    - Tree copy \\loki\test\masmqa to \masmqa on the NT test machine.

    - Boot NT.

    - Start the OS2 cmd processor (cmd32).

    - cd to the masmqa directory.

    - Run the command "td masm=masm"

    - Within the masmqa directory will be a file called masm.log. This file

      contains the summary of the test results. Within each of the

      subdirectories below masmqa will be a log file with the same name as

      the subdirectory that contains the test results for that directory.









Testing MASM using command files:

    - Tree copy \\loki\test\masmqa to \masmqa on the NT test machine.

    - Over the top of this tree copy the masmqa tree contained under the

      masm 510nt project (this directory). This adds the necessary command

      files to the standard test tree.

    - Put masm.exe somewhere in the NT file execution path.

    - Boot NT

    - Start the OS2 command processor (cmd32).

    - cd to the masmqa directory.

    - Run the command file "testnt.cmd".

	- This will assemble all the test files and leave the resulting objects

	  on the hard disk.

    - Boot OS2 1.2.

    - cd to the masmqa directory and run the command file "checknt.cmd".

	- This will compare each of the object files with the pattern in

	  the results subdirectory. Note that a binary comparison is not

	  done. This is because the command line that td and the command

	  files use to invoke masm are slightly different. This results in

	  the file name stored in masm.obj having a slightly different mix

	  of upper and lower case. Rather than doing a binary compare a diff

	  is done of the decoded object files. Then expected differences are

	  thrown out.

    - Note: The command files currently skip any tests that would

      involve redirecting the error output to a file. This is because the

      NT command processor can't do redirection at the moment. Hopefully

      by the time a working command processor is running these command files

      can be abandoned completely in favor of td.

    - NT/386 status:

	Currently the top level command file must be cut in half and executed

	separately for the tests to run through. Otherwise NT gets tired and

	dies.

    - NT/MIPS status:

	Currently files can't be found unless they are in the root directory

	or a full path to the file is specified. This appears to be

	an NT problem and not related to MASM, therefore I've simply been

	working around this limitation. This should be fixed after the windows

	subsystem command processor is available. To work around the problem

	move the assembly file and all include files to the root directory.









Expected failures:



    - Some of the test files generate warnings. These can be safely ignored.

      Most of these warnings occur in the win386 subdirectories.

    - There is a test that checks the error output from code that has too

      long of a line in it. The error output will not match for this test.

      This is actually an improvement on MASM 5.NT. The MASM 5.10A assembler

      used to literally cut the line in half and try to process the second

      half of the line as a separate line. This would then generate more errors

      than actually existed in the file. MASM 5.NT doesn't do this but instead

      logs the line too long error and goes on to the next line.