ILINK 3306 README


INSTALLATION AND USE

Here in snap/bin, there are 3 linkers
	link.exe  (link.err)	the incremental linker, debug build
	rlink.exe (link.err)	the incremental linker, release build
	olink.exe (olink.err)	the non-incremental linker, release build

To use ilink, just sync.  Incremental linking is the default.

Ilink will create exe/dlls whose associated debug
info is stored in a program database (.pdb), in the so-called "NB10"
exe format.  (In contrast, the old link produced the "NB09" format.)
The shn0[d].dll here in snap/bin can debug any combination of
exes/dlls in either NB09 or NB10 format.

Ilink will automatically try to incremental-link, provided

* you aren't creating a map file
* you aren't specifying -debugtype:both or -debugtype:coff
* you aren't specifying -pdb:none
* you aren't specifying -incremental:no

To produce a Cuda compatible "NB09" .exe, link -pdb:none.


CVPACK R.I.P.!

Since ilink transports debug information without cvpack, we expect some
minor problems with the CodeView expression evaluator.  Please be on the
look out for any changes in EE behaviour, small or large and report them!


MIXING CUDA PDBS AND ILINK PDBS

Note that ilink can link objs created by the Dolphin and Cuda compilers,
e.g. both /Z7 and /Zi.  However, for now, please do not specify the
same .pdb for the compiler and the linker.

That is, do not specify
	cl -Zi -FdXYZ.pdb
when you are linking
	link -pdb:XYZ:pdb (or)
	link -out:XYZ.exe (which defaults to -pdb:XYZ.pdb).

Rather, change your "cl" line to use (for instance)
	cl -Zi -Fdmsvc.pdb (or)
	cl -Zi             (which defaults to -Fdmsvc.pdb)

Otherwise you will get this diagnostic when you link:
LNK1206: cannot (yet) overwrite Visual C++ 1.0 program database "%s"


PROBLEMS/COMMENTS

Please direct any comments/questions to JanGr or phinperf
as appropriate, and be sure to RAID and/or report any problems
you may have!