Skip to content

largeaddressaware:no is not recommended for 64-bit apps #4658

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Feb 13, 2024
Merged

largeaddressaware:no is not recommended for 64-bit apps #4658

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
9e0875b
largeaddressaware:no is not recommended for 64-bit apps
mspll Jul 27, 2023
322d380
Update largeaddressaware-handle-large-addresses.md
TylerMSFT Feb 12, 2024
5f75e0d
Update largeaddressaware-handle-large-addresses.md
TylerMSFT Feb 13, 2024
a0921a7
Update largeaddressaware-handle-large-addresses.md
TylerMSFT Feb 13, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions docs/build/reference/largeaddressaware-handle-large-addresses.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
---
description: "Learn more about: /LARGEADDRESSAWARE (Handle Large Addresses)"
title: "/LARGEADDRESSAWARE (Handle Large Addresses)"
ms.date: "11/04/2016"
ms.date: "02/12/2024"
f1_keywords: ["VC.Project.VCLinkerTool.LargeAddressAware", "/largeaddressaware"]
helpviewer_keywords: ["LARGEADDRESSAWARE linker option", "-LARGEADDRESSAWARE linker option", "/LARGEADDRESSAWARE linker option"]
ms.assetid: a29756c8-e893-47a9-9750-1f0d25359385
---
# /LARGEADDRESSAWARE (Handle Large Addresses)

Expand All @@ -14,9 +13,11 @@ ms.assetid: a29756c8-e893-47a9-9750-1f0d25359385

## Remarks

The /LARGEADDRESSAWARE option tells the linker that the application can handle addresses larger than 2 gigabytes. In the 64-bit compilers, this option is enabled by default. In the 32-bit compilers, /LARGEADDRESSAWARE:NO is enabled if /LARGEADDRESSAWARE is not otherwise specified on the linker line.
The /LARGEADDRESSAWARE option tells the linker that the application can handle addresses larger than 2 gigabytes. In the 64-bit compilers, this option is enabled by default. In the 32-bit compilers, `/LARGEADDRESSAWARE:NO` is enabled if `/LARGEADDRESSAWARE` is not otherwise specified on the linker line.

If an application was linked with /LARGEADDRESSAWARE, DUMPBIN [/HEADERS](headers.md) will display information to that effect.
If an application was linked with `/LARGEADDRESSAWARE`, `DUMPBIN` [/HEADERS](headers.md) will display information to that effect.

Linking 64-bit applications with **`/LARGEADDRESSAWARE:NO`** is not recommended because it restricts the available address space, which can result in runtime failures if the app exhausts memory. It may also prevent x64 apps from running on ARM64 systems because the emulation runtime will try to reserve 4GB of virtual address space. If the app was linked with `/LARGEADRESSAWARE:NO`, the app won't launch because it can't allocate that much address space.

### To set this linker option in the Visual Studio development environment

Expand Down