Updated Wiki: How to enhance debugging experience with SshNet

Note: This is primarily a Visual Studio oriented page.

You may also find Troubleshooting SSH.NET useful.

Going from Renci.SshNet.dll to the latest Source Code

If you have downloaded the Renci.SshNet.dll file, either from CodePlex or via NuGet, follow these steps:

1. Go to "Source Code" here on CodePlex
2. Click "Download" (it's on the right side of the page)
3. Unzip the downloaded file, it's best to put it in a sub directory of your project.
4. In your project, "Add Existing Project", and find the project file "Renci.SshNet.csproj".
5. Remove the old reference in your project to "Renci.SshNet".
6. Add a reference to the project you just added. (In the "Project" tab of the "Add Reference" dialog, select "Renci.SshNet", click "OK").
7. Run your code.

Breaking on exception - even the catched ones

This trick can be used to make Visual Studio break whenever an exception occurs of a certain type. This will work even if the exception is catched. This should work for both native, managed and CLR.

In the Debug file menu, click "Exceptions...".

If you know what the name of the exception is, and it's a .NET Framework exception do this:

1. Click "Find..."
2. enter the name of the exception (It doesn't need the full type, just the name, like InvalidOperationException)
3. Under the "Thrown" column, make sure it's checked.
4. Click OK

If it's an SshException or or any other exception, do this:

1. Click "Add..."
2. Select "Common Language Runtime Exceptions"
3. Enter the exception name (example: SshException)
4. Click "OK"

When an exception is thrown, Visual Studio should break on the location it was thrown from.