Keil Logo

RECURSIONS Linker Directive

Abbreviation

RC

Arguments

RECURSIONS (number)

Default

RECURSIONS (10)

µVision

Options — LX51 Misc — Misc Controls.

Description

The RECURSIONS directive specifies the number of recursions that are allowed before the linker aborts the linkage. When too many recursions are detected, the following error is generated:

FATAL ERROR L232: APPLICATION CONTAINS TOO MANY RECURSIONS.

When the linker encounters a recursive function call during overlay analysis, that function is removed from the call tree and overlay analysis must be restarted. This slows the performance of the linker and causes longer link times.

For very complex, recursive applications the RECURSIONS directive may be used to increase the number of acceptable recursions. However, this may significantly increase the execution time of the linker.

If your application contains many tables of function pointers you may wish to rely on the linker to generate a map file to review for overlay analysis. In some cases, you may may receive FATAL ERROR L232 before you have corrected the call tree (using the OVERLAY directive). In such situations, the RECURSIONS directive may be used to ensure program linkage.

See Also

OVERLAY

Example
LX51 MYPROG.OBJ,A.OBJ,B.OBJ RECURSIONS (100)
  Arm logo
Important information

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies.

Change Settings

Privacy Policy Update

Arm’s Privacy Policy has been updated. By continuing to use our site, you consent to Arm’s Privacy Policy. Please review our Privacy Policy to learn more about our collection, use and transfers
of your data.