diff options
author | Graham Bloice <graham.bloice@trihedral.com> | 2016-07-05 16:06:16 +0100 |
---|---|---|
committer | Graham Bloice <graham.bloice@trihedral.com> | 2016-07-05 17:10:08 +0000 |
commit | 7a3e9b1c9ba649b11704d0f4a7132c60dec64eb6 (patch) | |
tree | 4ad6c73b42791e930f4271dc43e599d1a7eafea6 | |
parent | bed9d187baf708889ec6846c59716527b0210d56 (diff) |
Developers Guide updates
Added info about debugging under Visual Studio.
Updated buildbot info.
Change-Id: I9a6a0a2b14e3616a35f652c99b04ee23ea642ba5
Reviewed-on: https://code.wireshark.org/review/16307
Petri-Dish: Graham Bloice <graham.bloice@trihedral.com>
Tested-by: Petri Dish Buildbot <buildbot-no-reply@wireshark.org>
Reviewed-by: Graham Bloice <graham.bloice@trihedral.com>
-rw-r--r-- | docbook/wsdg_src/WSDG_chapter_env_intro.asciidoc | 6 | ||||
-rw-r--r-- | docbook/wsdg_src/WSDG_chapter_tools.asciidoc | 34 |
2 files changed, 31 insertions, 9 deletions
diff --git a/docbook/wsdg_src/WSDG_chapter_env_intro.asciidoc b/docbook/wsdg_src/WSDG_chapter_env_intro.asciidoc index b2a4a5b1af..36a6b0d6cf 100644 --- a/docbook/wsdg_src/WSDG_chapter_env_intro.asciidoc +++ b/docbook/wsdg_src/WSDG_chapter_env_intro.asciidoc @@ -302,14 +302,10 @@ The Buildbot runs on a platform collection that represents the different * Windows 8.1 x86 (Win32, little endian, Visual Studio 2013) -* Windows 7 x86-64 (Win64, little endian, Visual Studio 2013) +* Windows Server 2012 R2 x86-64 (Win64, little endian, Visual Studio 2013) * Ubuntu x86-64 (Linux, little endian, gcc, Clang) -* Solaris SPARC (Solaris, big endian, gcc) - -* OS X x86 (BSD, little endian, Clang) - * OS X x86-64 (BSD, little endian, Clang) and two buildslaves that run static code analysis to help spot coding issues: diff --git a/docbook/wsdg_src/WSDG_chapter_tools.asciidoc b/docbook/wsdg_src/WSDG_chapter_tools.asciidoc index ab4526d46a..d0d18aaea3 100644 --- a/docbook/wsdg_src/WSDG_chapter_tools.asciidoc +++ b/docbook/wsdg_src/WSDG_chapter_tools.asciidoc @@ -23,7 +23,6 @@ tools are available in different "flavours": * UNIX (or Windows Cygwin): the tools should be commonly available on the supported UNIX platforms, and for Windows platforms by using the Cygwin UNIX emulation - * Windows native: some tools are available as native Windows tools, no special emulation is required. Many of these tools can be installed (and updated) using http://chocolatey.org[Chocolatey], a Windows package manager similar @@ -585,8 +584,35 @@ otherwise the debugger will simply fail or you will only see a lot of garbage. ===== Visual Studio integrated debugger You can use the integrated debugger of Visual Studio if your toolchain includes -it. Open the solution in your build directory and build and debug as normal with a -Visual Studio solution. +it. Open the solution in your build directory and build and debug as normal +with a Visual Studio solution. + +To set the correct paths for Visual Studio when running Wireshark under the +debugger, add the build output directory to the path before opening Visual +Studio from the same command prompt, e.g. + +---- +C:\Development\wsbuild32>set PATH="%PATH%;C:\Development\wsbuild32\run\RelwithDebInfo" +C:\Development\wsbuild32>wireshark.sln +---- + +for PowerShell use + +---- +PS C:\Development\wsbuild32>$env:PATH += ";$(Convert-Path run\RelWithDebInfo)" +PS C:\Development\wsbuild32>wireshark.sln +---- + +When Visual Studio has finished loading the solution, set the executable to +be run in the debugger, e.g. Executables\Wireshark, by right clicking it in +the Solution Explorer window and selecting "Set as StartUp Project". Also +set the Solution Configuration (usually RelWithDebInfo) from the droplist on +the toolbar. + +NOTE: Currently Visual Studio regards a command line build as incomplete, so +will report that some items need to be built when starting the debugger. These +can either be rebuilt or ignored as you wish. + The normal build is an optimised release version so debugging can be a bit difficult as variables are optimised out into registers and the execution @@ -621,7 +647,7 @@ press F5. If you require a non-optimised version, then build using a debug configuration, e.g. `msbuild /m /p:Configuration=Debug Wireshark.sln`. The build products will be found -in C:\Development\wsbuild32\run\RelWithDebInfo\. +in C:\Development\wsbuild32\run\Debug\. [[ChToolsBash]] |