Skip to content

Commit 50b1901

Browse files
authored
Merge pull request #3069 from MicrosoftDocs/master
10/10 AM Publish
2 parents 71218ff + 2944eff commit 50b1901

37 files changed

+119
-103
lines changed

docs/debugger/error-remote-debugging-monitor-msvsmon-exe-does-not-appear-to-be-running.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,13 +32,13 @@ This error message means that Visual Studio could not find the correct instance
3232
The following sections list some other reasons why you might have gotten this message, and what you can do to fix the issue.
3333

3434
## The remote machine is not reachable
35-
Try to [ping](https://technet.microsoft.com/en-us/library/ee624059\(v=ws.10\).aspx) the remote machine. If it doesn't reply to the ping, the remote tools won't be able to connect either. Try rebooting the remote machine and otherwise making sure that it is correctly configured on the network.
35+
Try to [ping](/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/ee624059(v=ws.10)) the remote machine. If it doesn't reply to the ping, the remote tools won't be able to connect either. Try rebooting the remote machine and otherwise making sure that it is correctly configured on the network.
3636

3737
## The version of the remote debugger doesn't match the version of Visual Studio
3838
The version of Visual Studio that you are running locally needs to match the version of the remote debugging monitor that is running on the remote machine. To fix this, download and install the matching version of the remote debugging monitor. Go to the [Download Center](http://www.microsoft.com/en-us/download) to find the right version of the remote debugger.
3939

4040
## The local and remote machines have different authentication modes
41-
The local and remote machines need to use the same authentication mode. To fix this, make sure that both machines are using the same authentication mode. For more information about authentication modes, see [Windows Authentication Overview](https://technet.microsoft.com/en-us/library/hh831472.aspx).
41+
The local and remote machines need to use the same authentication mode. To fix this, make sure that both machines are using the same authentication mode. For more information about authentication modes, see [Windows Authentication Overview](/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/hh831472(v=ws.11)).
4242

4343
## The remote debugger is running under a different user account
4444
You can solve this in one of the following ways:
@@ -69,4 +69,4 @@ This error message means that Visual Studio could not find the correct instance
6969
res://*\<Visual Studio installation directory>*\Common7\IDE\Remote%20Debugger\x64\msvsmon.exe/help.htm
7070

7171
## See Also
72-
[Remote Debugging Errors and Troubleshooting](../debugger/remote-debugging-errors-and-troubleshooting.md)
72+
[Remote Debugging Errors and Troubleshooting](../debugger/remote-debugging-errors-and-troubleshooting.md)
Lines changed: 62 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
---
22
title: "Set debug and release configurations | Microsoft Docs"
33
ms.custom: ""
4-
ms.date: "04/10/2017"
4+
ms.date: "10/05/2018"
55
ms.technology: "vs-ide-debug"
66
ms.topic: "reference"
7-
f1_keywords:
7+
f1_keywords:
88
- "vs.debug.builds"
9-
dev_langs:
9+
dev_langs:
1010
- "CSharp"
1111
- "VB"
1212
- "FSharp"
1313
- "C++"
1414
- "JScript"
15-
helpviewer_keywords:
15+
helpviewer_keywords:
1616
- "configurations, release"
1717
- "build configurations, release"
1818
- "projects [Visual Studio], release configurations"
@@ -31,85 +31,93 @@ ms.assetid: 57b6bbb7-f2af-48f7-8773-127d75034ed2
3131
author: "mikejo5000"
3232
ms.author: "mikejo"
3333
manager: douge
34-
ms.workload:
34+
ms.workload:
3535
- "multiple"
3636
---
3737
# Set debug and release configurations in Visual Studio
38-
Visual Studio projects have separate release and debug configurations for your program. As the names imply, you build the debug version for debugging and the release version for the final release distribution.
39-
40-
The debug configuration of your program is compiled with full symbolic debug information and no optimization. Optimization complicates debugging, because the relationship between source code and generated instructions is more complex.
41-
42-
The release configuration of your program contains no symbolic debug information and is fully optimized. Debug information can be generated in .pdb files, [depending on the compiler options](#BKMK_symbols_release) that are used. Creating .pdb files can be very useful if you later have to debug your release version.
43-
44-
For more information about build configurations, see [Understanding Build Configurations](../ide/understanding-build-configurations.md).
45-
46-
You can change the build configuration from the **Build** menu, from the toolbar, or in the project's property pages. Project property pages are language-specific. The procedure below shows how to change the build configuration from the menu and the toolbar. For more information about how to change the build configuration in projects in different languages, see the See Also section below.
47-
48-
## Change the build configuration
49-
50-
1. From the **Build** menu, select **Configuration Manager**, then select **Debug** or **Release**.
51-
52-
2. On the toolbar, choose either **Debug** or **Release** from the **Solution Configurations** list box.
53-
54-
![toolbar build configuration](../debugger/media/toolbarbuildconfiguration.png "ToolbarBuildConfiguration")
55-
56-
This toolbar is not available in Express editions. You can use the **Build Solution F6** and **Start Debugging F5** menu items to choose the configuration.
38+
39+
Visual Studio projects have separate release and debug configurations for your program. You build the debug version for debugging and the release version for the final release distribution.
40+
41+
In debug configuration, your program compiles with full symbolic debug information and no optimization. Optimization complicates debugging, because the relationship between source code and generated instructions is more complex.
42+
43+
The release configuration of your program has no symbolic debug information and is fully optimized. Debug information can be generated in .pdb files, [depending on the compiler options](#BKMK_symbols_release) that are used. Creating .pdb files can be useful if you later have to debug your release version.
44+
45+
For more information about build configurations, see [Understand build configurations](../ide/understanding-build-configurations.md).
46+
47+
You can change the build configuration from the **Build** menu, from the toolbar, or in the project's property pages. Project property pages are language-specific. The procedure below shows how to change the build configuration from the menu and the toolbar. For more information about how to change the build configuration in projects in different languages, see the [See also](#see-also) section below.
48+
49+
## Change the build configuration
50+
51+
To change the build configuration, either:
52+
53+
* From the **Build** menu, select **Configuration Manager**, then select **Debug** or **Release**.
54+
55+
or
56+
57+
* On the toolbar, choose either **Debug** or **Release** from the **Solution Configurations** list.
58+
59+
![toolbars build configuration](../debugger/media/toolbarbuildconfiguration.png "ToolbarBuildConfiguration")
5760

5861
## <a name="BKMK_symbols_release"></a>Generate symbol (.pdb) files for a build
5962

60-
For most project types, the .pdb files are generated by default for both debug and release builds, but the default settings are different depending on your specific project type and the version of Visual Studio. You can configure whether the compiler generates .pdb files and what kind of debug information to include.
63+
You can choose to generate symbol (.pdb) files and what debug information to include. For most project types, the compiler generates symbol files by default for debug and release builds, while other default settings differ by project type and Visual Studio version.
6164

62-
> [!IMPORTANT]
63-
> The debugger will load only a .pdb file for an executable file that exactly matches the .pdb file that was created when the executable was built (that is, the .pdb must be the original or a copy of the original .pdb file). For more information see [Why does Visual Studio require debugger symbol files to exactly match the binary files that they were built with?](https://blogs.msdn.microsoft.com/jimgries/2007/07/06/why-does-visual-studio-require-debugger-symbol-files-to-exactly-match-the-binary-files-that-they-were-built-with/)
65+
> [!IMPORTANT]
66+
> The debugger will load only a .pdb file for an executable file that exactly matches the .pdb file that was created when the executable was built (that is, the .pdb must be the original or a copy of the original .pdb file). For more information, see [Why does Visual Studio require debugger symbol files to exactly match the binary files that they were built with?](https://blogs.msdn.microsoft.com/jimgries/2007/07/06/why-does-visual-studio-require-debugger-symbol-files-to-exactly-match-the-binary-files-that-they-were-built-with/)
6467
6568
Each project type may have a different way of setting these options.
6669

6770
### Generate symbol files for a C#, ASP.NET, or Visual Basic project
6871

69-
For detailed information on project settings for debug configurations in C#, see [Project settings for a C# Debug configuration](../debugger/project-settings-for-csharp-debug-configurations.md). For Visual Basic, see [this topic](../debugger/project-settings-for-a-visual-basic-debug-configuration.md).
72+
For detailed information on project settings for debug configurations in C# or Visual Basic, see [Project settings for a C# debug configuration](../debugger/project-settings-for-csharp-debug-configurations.md) or [Project settings for a Visual Basic debug configuration](../debugger/project-settings-for-a-visual-basic-debug-configuration.md).
7073

71-
1. Right-click the project in Solution Explorer and choose **Properties**.
74+
1. In Solution Explorer, select the project.
7275

73-
2. Choose a **Release** or **Debug** build from the **Configuration** list.
76+
2. Select the **Properties** icon (or press **Alt+Enter**).
7477

75-
2. Choose **Build** settings and then click the **Advanced** button.
78+
3. In the side pane, choose **Build** (or **Compile** in Visual Basic).
7679

77-
In Visual Basic, you choose the **Compile** settings and the **Advanced Compile Options** button instead.
80+
4. In the **Configuration** list, choose **Debug** or **Release**.
7881

79-
3. Choose **full**, **portable**, or **pdb_only** in the **Debugging information** list box (**Generate debug info** in Visual Basic).
82+
5. Select the **Advanced** button (or the **Advanced Compile Options** button in Visual Basic).
8083

81-
The portable format is the most recent cross-platform format for .NET Core. For more information on options, see [Advanced Build Settings dialog box (C#)](../ide/reference/advanced-build-settings-dialog-box-csharp.md).
84+
6. In the **Debugging information** list (or the **Generate debug info** list in Visual Basic), choose **Full**, **Pdb-only**, or **Portable**.
8285

83-
![Generate PDBs for builds in C#](../debugger/media/dbg_project_properties_pdb_csharp.png "GeneratePDBsForCSharp")
86+
The portable format is the most recent cross-platform format for .NET Core. For more information on options, see [Advanced Build Settings dialog box (C#)](../ide/reference/advanced-build-settings-dialog-box-csharp.md).
8487

85-
4. Build your project.
88+
![Generate PDBs for builds in C#](../debugger/media/dbg_project_properties_pdb_csharp.png "GeneratePDBsForCSharp")
8689

87-
The symbol file(s) get created in the same folder as the executable or the main output file.
90+
7. Build your project.
91+
92+
The compiler creates the symbol file(s) in the same folder as the executable or the main output file.
8893

8994
### Generate symbol files for a C++ project
9095

91-
1. Right-click the project in Solution Explorer and choose **Properties**.
96+
1. In Solution Explorer, select the project.
97+
98+
2. Select the **Properties** icon (or press **Alt+Enter**).
99+
100+
3. In the **Configuration** list, choose **Debug** or **Release**.
92101

93-
2. Choose a **Release** or **Debug** build from the **Configuration** list.
102+
4. In the side pane, choose **Linker > Debugging**, then select options for **Generate Debug Info**.
94103

95-
2. Under **Linker > Debugging**, select desired options for **Generate Debug Info**.
104+
For detailed information on project settings for debug configurations in C++, see [Project settings for a C++ debug configuration](../debugger/project-settings-for-a-cpp-debug-configuration.md).
96105

97-
For detailed information on project settings for debug configurations in C++, see [Project settings for a C++ Debug configuration](../debugger/project-settings-for-a-cpp-debug-configuration.md).
106+
5. Configure options for **Generate Program Database Files**.
98107

99-
4. Configure options for Generate Program Database Files
108+
In most C++ projects, the default value is `$(OutDir)$(TargetName).pdb`, which generates .pdb files in the output folder.
100109

101-
In most C++ projects, the default value is `$(OutDir)$(TargetName).pdb`, which generates .pdb files in the output folder.
110+
![Generate PDBs for builds in C++](../debugger/media/dbg_project_properties_pdb_cplusplus.png "GeneratePDBsforCPlusPlus")
102111

103-
![Generate PDBs for builds in C++](../debugger/media/dbg_project_properties_pdb_cplusplus.png "GeneratePDBsforCPlusPlus")
112+
6. Build your project.
104113

105-
5. Build your project.
114+
The compiler creates the symbol file(s) in the same folder as the executable or the main output file.
106115

107-
The symbol file(s) get created in the same folder as the executable or the main output file.
108-
109-
## See Also
110-
[Specify symbol (.pdb) files and source files in the Visua Studio debugger](../debugger/debugger-settings-and-preparation.md)
111-
[Debugger Settings and Preparation](../debugger/debugger-settings-and-preparation.md)
112-
[Project Settings for a C++ Debug Configuration](../debugger/project-settings-for-a-cpp-debug-configuration.md)
113-
[Project Settings for C# Debug Configurations](../debugger/project-settings-for-csharp-debug-configurations.md)
114-
[Project Settings for a Visual Basic Debug Configuration](../debugger/project-settings-for-a-visual-basic-debug-configuration.md)
115-
[How to: Create and Edit Configurations](../ide/how-to-create-and-edit-configurations.md)
116+
## <a name="see-also"></a>See also
117+
118+
[Specify symbol (.pdb) files and source files in the Visual Studio debugger](../debugger/specify-symbol-dot-pdb-and-source-files-in-the-visual-studio-debugger.md)<br/>
119+
[Debugger settings and preparation](../debugger/debugger-settings-and-preparation.md)<br/>
120+
[Project settings for a C++ debug configuration](../debugger/project-settings-for-a-cpp-debug-configuration.md)<br/>
121+
[Project settings for a C# debug configuration](../debugger/project-settings-for-csharp-debug-configurations.md)<br/>
122+
[Project settings for a Visual Basic debug configuration](../debugger/project-settings-for-a-visual-basic-debug-configuration.md)<br/>
123+
[How to: Create and edit configurations](../ide/how-to-create-and-edit-configurations.md)
Loading
Loading
Loading

docs/debugger/unable-to-connect-to-the-microsoft-visual-studio-remote-debugging-monitor.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ This may be a legacy issue specific to Windows XP and Windows 7. See this [infor
110110

111111
If you cannot connect using the remote computer name, try using the IP address instead. You can use `ipconfig` in a command line on the remote computer to get the IPv4 address. If you are using a HOSTS file, verify that it is configured correctly.
112112

113-
If that fails, verify that the remote computer is accessible on the network ([ping](https://technet.microsoft.com/en-us/library/cc732509(v=ws.10).aspx) the remote machine). Remote debugging over the Internet is not supported, except in some Microsoft Azure scenarios.
113+
If that fails, verify that the remote computer is accessible on the network ([ping](/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/ee624059(v=ws.10)) the remote machine). Remote debugging over the Internet is not supported, except in some Microsoft Azure scenarios.
114114

115115
### <a name="server_incorrect"></a> The server name is incorrect or third-party software is interfering with the remote debugger
116116

@@ -147,7 +147,7 @@ You can solve this in one of the following ways:
147147
### The local and remote machines have different authentication modes
148148
The local and remote machines need to use the same authentication mode. To fix this, make sure that both machines are using the same authentication mode. You can change the authentication mode. In the remote debugger window, go to the **Tools > Options** dialog box.
149149

150-
For more information about authentication modes, see [Windows Authentication Overview](https://technet.microsoft.com/en-us/library/hh831472.aspx).
150+
For more information about authentication modes, see [Windows Authentication Overview](/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/hh831472(v=ws.11)).
151151

152152
### Anti-virus software is blocking the connections
153153
Windows anti-virus software allows remote debugger connections, but some third-party anti-virus software may block them. Check the documentation for your anti-virus software to find out how to allow these connections.
@@ -162,4 +162,4 @@ You can solve this in one of the following ways:
162162
To get more remote debugger help, open the remote debugger's Help page (**Help > Usage** in the remote debugger).
163163

164164
## See Also
165-
[Remote Debugging](../debugger/remote-debugging.md)
165+
[Remote Debugging](../debugger/remote-debugging.md)

0 commit comments

Comments
 (0)