| hasso | 3b56403 | 2004-02-20 20:33:43 +0000 | [diff] [blame] | 1 | This file describes the procedure for reporting Quagga bugs. You are not |
| 2 | obliged to follow this format, but it would be great help for Quagga developers |
| 3 | if you report a bug as described below. |
| paul | 718e374 | 2002-12-13 20:15:29 +0000 | [diff] [blame] | 4 | |
| Greg Troxel | cfe1174 | 2010-05-05 07:51:26 -0400 | [diff] [blame^] | 5 | Bugs submitted with woefully incomplete information may be summarily |
| 6 | closed. Submitters of bugs against old versions may be asked to |
| 7 | retest against the latest release. Submitters may be asked for |
| 8 | additional information. Bugs may be closed after 30 days of |
| 9 | non-response to requests to reconfirm or supply additional |
| 10 | information. |
| 11 | |
| hasso | 3b56403 | 2004-02-20 20:33:43 +0000 | [diff] [blame] | 12 | Report bugs http://bugzilla.quagga.net |
| paul | 718e374 | 2002-12-13 20:15:29 +0000 | [diff] [blame] | 13 | |
| 14 | Please supply the following information: |
| Greg Troxel | cfe1174 | 2010-05-05 07:51:26 -0400 | [diff] [blame^] | 15 | 1. Your Quagga version or if it is from git then the commit reference. |
| 16 | Please try to report bugs against git master or the latest release. |
| hasso | 3b56403 | 2004-02-20 20:33:43 +0000 | [diff] [blame] | 17 | 2. Quagga daemons you run e.g. bgpd or ripd and full name of your OS. Any |
| 18 | specific options you compiled Quagga with. |
| 19 | 3. Problem description. Copy and paste relative commands and their output to |
| 20 | describe your network setup e.g. "zebra>show ip route". |
| 21 | Please, also give your simple network layout and output of relative OS |
| Greg Troxel | cfe1174 | 2010-05-05 07:51:26 -0400 | [diff] [blame^] | 22 | commands (e.g., ifconfig (BSD) or ip (Linux)). |
| hasso | 3b56403 | 2004-02-20 20:33:43 +0000 | [diff] [blame] | 23 | 4. All Quagga configuration files you use. If you don't want to publish your |
| 24 | network numbers change 2 middle bytes in IPv4 address to be XXX (e.g. |
| 25 | 192.XXX.XXX.32/24). Similar could be done with IPv6. |
| 26 | 5. If any Quagga daemon core dumped, please, supply stack trace using the |
| 27 | following commands: host> gdb exec_file core_file , (gdb) bt . |
| 28 | 6. Run all Quagga daemons with full debugging on (see documentation on |
| 29 | debugging) and send _only_ part of logs which are relative to your problem. |
| paul | 718e374 | 2002-12-13 20:15:29 +0000 | [diff] [blame] | 30 | 7. If the problem is difficult to reproduce please send a shell script to |
| hasso | 3b56403 | 2004-02-20 20:33:43 +0000 | [diff] [blame] | 31 | reproduce it. |
| paul | 718e374 | 2002-12-13 20:15:29 +0000 | [diff] [blame] | 32 | 8. Patches, workarounds, fixes are always welcome. |
| 33 | |
| 34 | Thank You. |