12.5.12 The /INCR Option

Option

/INC[[REMENTAL]]

The /INCR option must be used to prepare for subsequent linking with ILINK. This option produces a .SYM file and an .ILK file, each containing additional information needed by ILINK.

When /INCR is specified, LINK creates the main output file as a segmented executable file. If the main output is a DOS application, LINK adds a stub loader so that the program can run under DOS. The file is slightly larger than it would be without /INCR.

The /PADC and /PADD options are often used with the /INCR option to increase buffer size and thereby increase the likelihood that incremental linking will be successful. The /TINY and /EXEPACK options are not compatible with /INCR.

You should not use /INCR or ILINK for the release version of a product. ILINK is intended to speed linking during development and debugging. In rare cases, linking with /INCR causes warning L4001 to be generated. If this occurs, do not use this option or ILINK.