After you performed due diligence to make sure that your configuration is correct and you are confident that you have discovered a bug in , please follow these steps to report a bug to the core development team via JIRA.
While writing this page refer to the outline created by bkw
The core developers require that you can reproduce the bug on the latest Master source code. If you report a bug on an older build, it is possible that it has already been corrected. The project volunteers have limited time available so it is only fair that we not burden them with false bug reports.
Instructions on building from the latest code can be found under the Installation wiki tree.
It is absolutely essential that you include specific, detailed instructions on how to reproduce the issue that you are reporting. Attach copies of any config files, dialplan entries, scripts, etc. that are necessary to replicate the issue. Failing to include this necessary information will result in the JIRA being closed.
update from
<map name="all" value="debug,info,notice,warning,err,crit,alert"/> |
to
<map name="all" value="console,debug,info,notice,warning,err,crit,alert"/> |
reloadxml
To make life easier for the developers, please gather this information prior to posting questions to the mailing list or submitting bug reports to jira.
sed '/^$/!H;/^$/x;$!d' /proc/cpuinfo uname -a |
All of these examples are from community member John Wehle, who does a great job of submitting bug reports and patches. All of his submissions can be viewed here.
If one of the developers requests that you submit a bug report then you will need to log on to JIRA with your username and password, then open a JIRA ticket.
Click the Create button at the top of the page. This will bring up the "Create Issue" form dialog to be completed as directed below.
It is absolutely essential that you include specific, detailed instructions on how to reproduce the issue that you are reporting. Attach copies of any config files, dialplan entries, scripts, etc. that are necessary to replicate the issue. Failing to include this necessary information will result in the JIRA being closed. |
Select the overall category under which your ticket falls by typing a few characters or opening the dropdown listbox. Here are some popular projects:
Specify the type of ticket you are opening:
Type in a brief but descriptive summary here. This text appears in various places in the JIRA system to identify this ticket.
The JIRA issue tracking system is laid out in sections called "projects." FreeSWITCH is modular in nature, which means that it is broken down into various sub-projects. When you see "Component" in JIRA, think "sub-project." Related projects are grouped together in components. There are quite a few components listed in JIRA so you will have to make an educated guess as to where your issue should be assigned. If you are really at a loss then ask one of the developers or power users for some guidance.
Type the first few characters to search incrementally or use the dropdown listbox to see all components. Here is a brief look at the most commonly used components in JIRA:
Select all versions on which you have reproduced this issue. Note that the developers will ask you to test on the latest Master to see if the issue still exists.
Specify the environment as it affects this issue. Is there any special hardware? Are you using special drivers or kernel options?
NOTE: Those in a Linux/Unix environment will need to specify additional information. (See the items below after "Platform")
Provide a detailed description of how to reproduce the symptoms you are experiencing or a description of the new feature or improvement that you are suggesting. When reporting a bug, please describe the symptoms and not a diagnosis. Please note what is actually happening versus what you believe should be happening.
Please do not paste more than 30 lines of text into the description box.
Attach logs, config files, debug traces, and backtraces as separate files. (See below.)
Use the Browse... button to attach text files to this issue. Please attach logs, configuration files, screen captures of CLI debug output, backtraces, etc. here. Do not use pastebin for JIRA tickets as pastebin entries expire after a time.
Select the CPU family running .
Linux/Unix users please supply the output of this command:
sed '/^$/!H;/^$/x;$!d' /proc/cpuinfo
Windows users please put "N/A"
Select the kernel(s) on which you tested this issue.
Linux/Unix users please supply the output of this command:
uname -a
Windows users please put "N/A"
Select the userland(s) on which you're testing this issue.
Select the operating system distribution on which you are testing this issue.
Select the version(s) of operating system on which you are testing this issue.
Paste the output of "lsb_release -a" into this textbox.
Select the compiler that you used to create the build with this issue.
Paste the output of "gcc --version" or your compiler of choice into the textbox.
The exact git commit hash that exhibits this issue. Paste the output of the fs_cli "version" command into this textbox.
Paste here the exact version hash of the latest GIT HEAD (MASTER) version as of this second that reproduces your issue.
Please verify that the issue is occurring with the latest Git revision. The simplest way to do this is to do a "make current" in the FreeSWITCH source directory.
Windows users please use your Git client (e.g. TortoiseGit) and update to the latest Git revision and then rebuild the project.
If you are able to reproduce the issue on the latest revision then please go ahead and file your bug report.
https://freeswitch.org/jira - JIRA trouble ticket tracking system