Report a Bug

From Linux-VServer

Revision as of 02:51, 14 April 2009 by (Talk)

Jump to: navigation, search

There is a large number of Linux-VServer users. There is a much small number of people who actually develop Linux-VServer and fix bugs.

What does this mean for you, an aspiring bug reporter? In order to catch the eye of one of these few volunteers, you'll need to take to heart a few tips on how to report a bug so that they can and will help you.

By following these guidelines, you can help ensure that your bugs stay at the top of the developers' heap, and get fixed.

How to report bugs

The people who are going to help you with a bug report are volunteers. Not only are you not paying them to help you, but nobody else is either. So, be nice to them.

Beyond that golden rule, what follows are some additional tips on ways to make your bug report better so that someone will be able to help you.

Basics: what you did, what you wanted to happen, and what actually happened.

Those are the three basic elements of a bug report. You need to tell us exactly what you did (for example, "I right-clicked on "make happy meal"), what you expected to have happened (to continue the example, "I expected the kernel to serve me a happy meal with a hamburger and onion rings"), and what actually happened ("It gave me a happy meal with french fries.").

Yes, the example is silly. But if your bug report simply said "The make_happy_meal function doesn't work," you will very likely get a reply saying "It works fine for me", because we can't guess what you were expecting to happen. By giving all the information you might get a reply like "That's because you can't have onion rings in a happy meal, you can only have french fries or curly fries." By telling us what you asked for, what you expected to get, and what you actually got, we don't have to guess what you mean.

Useful information

The following list gives an overview of information useful in bug reports. Note that you don't have to submit all information listed below, but you should do as long as it helps to discover the root of all evil.

  • One line summary of the problem
  • Full description of the problem
  • Kernel version (from /proc/version)
  • Output of test scripts (see below)
  • Output of the Oops.. message (if applicable) with symbolic information resolved (see Documentation/oops-tracing.txt in the kernel source)
  • A small shell script or example program which triggers the problem (if possible)
  • Processor information (from /proc/cpuinfo)
  • Module information (from /proc/modules)
  • Other information that might be relevant to the problem
  • Other notes, patches, fixes, workarounds

Where to send bug reports?

Bug reports should be submitted to the mailing list or directly to one of our developers in IRC.

See the Communicate page to learn how to use the mailing list and/or IRC.

Personal tools