Please provide as much information as possible when reporting a bug or filing an issue on the Windows Subsystem for Linux.

Do not open Github issues for Windows crashes (BSODs) or security issues.. Instead, send Windows crashes or other security-related issues to secure@microsoft.com.

Note that WSL distro's launch in the Windows Console (unless you have taken steps to launch a 3rd party console/terminal). Therefore, please file UI/UX related issues in the Windows Console issue tracker.

A well written bug will follow the following template:

A title succinctly describing the issue.

Traceroute not working.

Your Windows build number. This can be gathered from the CMD prompt using the ver command.

C:\> ver
Microsoft Windows [Version 10.0.14385]

Note: The Windows Insider builds contain many updates and fixes. If you are running on the Creators Update (10.0.15063) please check to see if your issue has been resolved in a later build. If you are running on the Anniversary Update (10.0.14393), please try updating to the Creators Update.

Microsoft Windows [Version 10.0.16170]

Should include all packages and environmental variables as well as other required configuration.

$ sudo apt-get install traceroute && traceroute www.microsoft.com

$ traceroute www.microsoft.com
traceroute to www.microsoft.com (23.75.239.28), 30 hops max, 60 byte packets
setsockopt IP_MTU_DISCOVER: Invalid argument

What was the expected result of the command? Include examples / documentation if possible.

Run the failing command under strace. Normal command structure is:

$ strace -ff <command>

Note: strace can produce lengthy output. If the generated trace is more than about 20 lines please paste this into a Gist or another paste service and link in the bug.

$ strace traceroute www.microsoft.com
execve("/usr/bin/traceroute", ["traceroute", "www.microsoft.com"], [/* 22 vars */]) = 0
brk(0)                                  = 0x7fffdd3bc000
access("/etc/ld.so.nohwcap", F_OK)      = -1 ENOENT (No such file or directory)
mmap(NULL, 8192, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f1f4e820000
access("/etc/ld.so.preload", R_OK)      = -1 ENOENT (No such file or directory)
...
...
...

Some bugs require additional information such as scripts to reproduce. Please add to this section.

If there are files required, email the files to InsiderSupport@microsoft.com with:

• Subject: Forward to WSL Team - RE: github issue <issue #>
• Body: "Please forward to WSL Team" and include your attachment.

Common files are:

• Memory dumps found under C:\Windows\MEMORY.DMP
• Additional strace logs if the error occurs within a fork. The following command generates an output file for every fork created:

$ strace -ff -o <outputfile> <command>

To collect WSL logs follow these steps:

• Open Feedback hub and create a new issue by pressing Windows Key + F on your keyboard.
• Enter in the details of your issue:
  • In Summarize your feedback copy and paste in the title of your Github Issue
  • In Explain in more detail copy and paste a link to your Github Issue

• Select that your issue is a Problem
• Choose the Developer Platform category and the Windows Subsystem for Linux subcategory

• Select 'Other' under 'Which of the following best describes your problem'
• Click 'Recreate My Problem' under 'Attachments
• Ensure that Include Data About: is checked to 'Windows Subsystem for Linux'
• 'Click Start Recording' to start collecting logs
• Recreate your problem
• Click 'Stop Recording'

• Verify your recording is attached and whether you would like to send the screenshot that is automatically attached
• Hit Submit
• Get a link to your feedback item by clicking on 'Share my Feedback' and post that link to the Github thread so we can easily get to your feedback!