Edit

Share via

/ALIGN (Section alignment)

  • Article

Specify the alignment of each section within the executable image.

Syntax

/ALIGN[:number]

Arguments

number
The alignment value in bytes.

Remarks

The /ALIGN linker option specifies the alignment of each section within the linear address space of the program. The number argument is in bytes and must be a power of two. The default is 4K (4096). The linker issues a warning if the alignment produces an invalid image.

Unless you're writing an application such as a device driver, you shouldn't need to modify the alignment.

It's possible to modify the alignment of a particular section with the align parameter to the /SECTION option.

The alignment value that you specify can't be smaller than the largest section alignment.

To set this linker option in the Visual Studio development environment

  1. Open the project's Property Pages dialog box. For details, see Set C++ compiler and build properties in Visual Studio.

  2. Choose the Configuration Properties > Linker > Command Line property page.

  3. Enter the option in the Additional Options box. Choose OK or Apply to apply the change.

To set this linker option programmatically

See also

MSVC linker reference
MSVC linker options