Ticket Submission Guidelines

Please read this page carefully before you go on!

It contains important information you should know when filing a new ticket. The outlined rules help to avoid common errors that cause a lot of additional work for us.

Thanks for your understanding and your cooperation.

  1. General Rules
  2. How to…
    1. ... submit a bug report
    2. ... submit a patch
    3. ... submit a feature request

General Rules

  1. Please direct any support request to our regular support channels! Things like "how do I install MadWifi?" or "how do I configure my WLAN card?" should go there. If you are not sure whether your request should go to a ticket or not, please ask our support first.

  2. Please enter a working e-mail address in the first field of the form.
    Otherwise the ticket engine can't keep you informed about any comments or changes regarding your ticket(s). Please don't obfuscate the address, the ticket engine isn't able to handle this. In other words: use rather than user domain tld or .
    Anyway, if you're concerned about getting spam and don't want to enter a working e-mail address, check your ticket(s) regularly. Chances are that we ask for missing information, and we'll close tickets where missing information isn't supplied in time.

  3. One topic per ticket. For example, if you've found three distinct bugs, you'll open three tickets (one per bug).

  4. Give a meaningful summary.

  5. Provide as much information as necessary to understand what your ticket is about. For example, give a step-by-step description of how to reproduce the bug that you have found (remember that others might have a totally different environment).

  6. Preformatted content, such as an extract from your system logs, should go between {{{ and }}} (details)

  7. In the ticket properties box you should choose at least select correct values for:
    • Component: which component of the project your ticket is refering to
    • Version: only necessary for bug reports or patches; if you choose trunk here you should add the output of svn info to the ticket description.

  8. Don't change the default values of ticket properties if you're not sure what they mean, excepts for the properties mentioned in 7. In particular, don't bother changing the milestone entry unless you're a developer, or are certain you know the correct value.

  9. Use the Preview button before you submit your ticket. Make sure that your ticket/comment is displayed correctly.

Click here to create a new ticket or read on for further instructions.

How to…

... submit a bug report

We welcome any bug report, without your feedback it's hard (if not impossible) to provide you a high-quality driver. Please help us helping you:

  1. Make sure that the problem you've found really is a bug. The best way to do so is by discussing the problem on the appropriate mailing list.

  2. If you're not using a recent version of the driver, please try that before you continue. Chances are that the bug already has been fixed. Refer to GettingMadwifi to learn how you can get an up-to-date version of MadWifi.

  3. See if someone else already has filed a bug report for the same problem and, if you find a matching ticket, append missing information to this ticket rather than opening a new one. You can also use the search box on the top right of the site to search the whole site.

  4. Open a new ticket (see link below). Choose defect as ticket type. Give a detailed description on the bug:
    • What did you do when the bug showed up?
    • What did you expect the driver to do instead?
    • Could you reproduce this bug? If so, describe the procedure step by step.
    • Do you have any idea what the bug might have caused?
    • What driver version are you using, what kernel, what WLAN hardware, ...?
    • If your kernel crashed due to the bug, please include a full and decoded dump of the resulting oops message (refer to DevDocs/KernelOops for detailed instructions).

  5. Keep an eye on the ticket. We might need additional information.

  6. Keep your report up-to-date. Let us know if you found additional bits that might be interesting or helpful.

Click here to create a new ticket.

... submit a patch

Bugfixed and new functionality are best submitted as patches to the current code. The PreparePatches page describes how to prepare your patches for submission. The next steps depend on what you patch does:

  1. Your patch fixes a bug that has been reported before:
    1. Click on the Attach File button in the Attachments section of the appropriate ticket. Click on Browse and locate the patch file. Enter your e-mail address and a short comment on your patch, then click on Add Attachment.
    2. Verify that your patch is now listed in the Attachments section.
    3. Write a comment to this ticket to describe your patch. Sign off your patch. Click the "Patch is attached" checkbox. When done, click on the Submit Changes button at the bottom of the form to send your comment.

  2. Your patch fixes a bug that has not yet been reported:
    1. Open a new ticket (see link below), start the ticket summary with [patch] and select defect as ticket type. Fill the form as described above - but don't paste your patch in the ticket description! Sign off your patch. Click the "Patch is attached" checkbox. When done click on the Submit Changes button at the bottom of the form.
    2. The newly created ticket will be displayed. Now click on the Attach File button in the Attachments section. Click on Browse and locate the patch file. Enter your e-mail address and a short comment on your patch, then click on Add Attachment.
    3. Verify that your patch is now listed in the Attachments section of your ticket.

  3. Your patch adds a new feature:
    1. Open a new ticket, start the ticket summary with [patch] and select enhancement as ticket type. Fill the form as described above - but don't paste your patch in the ticket description! Sign off your patch. Click the "Patch is attached" checkbox. When done click on the Submit Changes button at the bottom of the form.
    2. The newly created ticket will be displayed. Now click on the Attach File button in the Attachments section. Click on Browse and locate the patch file. Enter your e-mail address and a short comment on your patch, then click on Add Attachment.
    3. Verify that your patch is now listed in the Attachments section of your ticket.

That's it. Now you should keep eye on the ticket. Chances are that questions arise or additional information is needed. Thanks for your support.

Click here to create a new ticket.

... submit a feature request

We're open for any suggestions of new features. Let us know what you would like to see in future versions of MadWifi, by submitting a feature request:

  1. If you're using an old version of MadWifi, check if the feature is already available in the current version. Refer to GettingMadwifi to learn how you can get an up-to-date version of MadWifi.

  2. See if someone else already filed a ticket with a similar request. If so you probably might want to comment on the request and add your own ideas to it.

  3. Open a new ticket (see link below) and select enhancement as ticket type. Fill the form as described above. Be as verbose as possible when describing your idea. The click on the Submit Changes button at the bottom of the form.

That's it. Now you should keep an eye on the ticket. It's likely that a discussion will be started about your idea, and you might want to add your oppinion on it.

Click here to create a new ticket.