Difference between revisions of "Bug Reporting"

(suggest to include version number)
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
If you discover a bug please follow the instructions provided here: https://www.samba.org/~asn/reporting_samba_bugs.txt
+
== Samba ==
  
If you are running a version of Samba provided by SUSE or Novell, please report the bug directly to SUSE.
+
* Report all suspected [https://www.samba.org/samba/security/ Security issues] to '''security@samba.org''' to allow us to follow our [[Samba_Security_Process|Security Process]].
  
If you are running a version of Samba provided by Apple, please report the bug directly to Apple, following the instructions here: http://developer.apple.com/bugreporter/
+
* Read the instructions: https://www.samba.org/~asn/reporting_samba_bugs.txt
 +
 
 +
* Report the problem in the Samba bug tracking system: https://bugzilla.samba.org/
 +
 
 +
* Always include the Samba version number in your bug reports!
 +
 
 +
{{Imbox
 +
| type = note
 +
| text = Before you report a bug, verify that you are running a [[Samba_Release_Planning|maintained version]] of Samba and [[Updating_Samba|update]], if necessary.<br />
 +
}}
 +
 
 +
== cifs.ko ==
 +
 
 +
If you run into problems with the SMB client in the Linux kernel (cifs.ko, mount.cifs) don't hesitate to report it.
 +
 
 +
For the kernel client things are a bit more complex. There are 2 bug tracking systems which you should look at to see if your problem has already been reported:
 +
 
 +
* [https://bugzilla.samba.org/buglist.cgi?component=kernel%20fs&list_id=14383&product=CifsVFS&resolution=--- Samba bugzilla kernel section]
 +
* [https://bugzilla.kernel.org/buglist.cgi?component=CIFS&product=File%20System&resolution=--- Linux bugzilla cifs section]
 +
 
 +
You can also ask questions on the [http://vger.kernel.org/vger-lists.html#linux-cifs linux-cifs mailing-list] (linux-cifs@vger.kernel.org ) ([https://marc.info/?l=linux-cifs&r=1&w=3 web archive here]).
 +
 
 +
If you report a bug, a network capture and a kernel console log output is always helpful.
 +
 
 +
    # make the kernel as verbose as possible
 +
    echo 'module cifs +p' > /sys/kernel/debug/dynamic_debug/control
 +
    echo 'file fs/cifs/* +p' > /sys/kernel/debug/dynamic_debug/control
 +
    echo 1 > /proc/fs/cifs/cifsFYI
 +
    echo 1 > /sys/module/dns_resolver/parameters/debug
 +
   
 +
    # get kernel output + network trace
 +
    dmesg --clear
 +
    tcpdump -s 0 -w trace.pcap & pid=$!
 +
    sleep 3
 +
    mount.cifs ....cd ... ls.. etc.. (the thing that fails)
 +
    sleep 3
 +
    kill $pid
 +
    dmesg > trace.log
 +
 
 +
This should produce a '''trace.pcap''' and a '''trace.log''' file.
 +
 
 +
Be sure to mention your '''kernel version''', '''server software and version'''.
 +
 
 +
Additional information on debugging the CIFS/SMB3 kernel client can be found at:
 +
https://wiki.samba.org/index.php/LinuxCIFS_troubleshooting

Revision as of 22:47, 25 February 2020

Samba

  • Always include the Samba version number in your bug reports!

cifs.ko

If you run into problems with the SMB client in the Linux kernel (cifs.ko, mount.cifs) don't hesitate to report it.

For the kernel client things are a bit more complex. There are 2 bug tracking systems which you should look at to see if your problem has already been reported:

You can also ask questions on the linux-cifs mailing-list (linux-cifs@vger.kernel.org ) (web archive here).

If you report a bug, a network capture and a kernel console log output is always helpful.

    # make the kernel as verbose as possible
    echo 'module cifs +p' > /sys/kernel/debug/dynamic_debug/control
    echo 'file fs/cifs/* +p' > /sys/kernel/debug/dynamic_debug/control
    echo 1 > /proc/fs/cifs/cifsFYI
    echo 1 > /sys/module/dns_resolver/parameters/debug
    
    # get kernel output + network trace
    dmesg --clear
    tcpdump -s 0 -w trace.pcap & pid=$!
    sleep 3
    mount.cifs ....cd ... ls.. etc.. (the thing that fails)
    sleep 3
    kill $pid
    dmesg > trace.log

This should produce a trace.pcap and a trace.log file.

Be sure to mention your kernel version, server software and version.

Additional information on debugging the CIFS/SMB3 kernel client can be found at: https://wiki.samba.org/index.php/LinuxCIFS_troubleshooting