LINK /SECTION

Syntax

/section:name,[attributes][,align=number]

The name consists of all characters, if any, from immediately after the colon up to but not including the first comma. It is a fatal error (LNK1117) if there is no comma. It is a fatal error (LNK1184) if the name contains a dollar sign or space.

The remainder of the option is not parsed until LINK encounters a section with the given name. If no section with this name is ever found, warning LNK4039 is issued and the remainder of the option is irrelevant.

The attributes consist of all characters, if any, from immediately after the first comma up to but not including a second comma, else to the end of the option. The attributes are single-character keywords, one after another without separation. The permitted values are !, C, D, E, I, K, L, N, P, R, S, W and X. Anything else is a fatal error (LNK1137).

If the second comma is not followed immediately by the keyword align and an equals sign, then all characters after the second comma are irrelevant and are ignored without complaint.

The number may be decimal, or in C-language hexadecimal or octal notation, with a sign prefix permitted, and is evaluated as an unsigned integer truncated to 32 bits. It may be preceded by any amount of white space. It is a fatal error (LNK1137) if there is no number or if the number is followed by any non-numerical characters (including a comma, as if to introduce excess arguments) or if number is not a power of two or is less than the section alignment (such as may have been set with a /align option) or is greater than 64K. A warning (LNK4226) is raised if number is greater than the page size for the target machine (as may have been set with a /machine option).