Bug Reporting: Difference between revisions

From SambaWiki
(Moved info about how to report a doc bug to a separate page.)
(add cifs.ko instructions)
Line 1: Line 1:
== Samba ==
To report a bug in Samba:


* Read the instructions: https://www.samba.org/~asn/reporting_samba_bugs.txt
* Read the instructions: https://www.samba.org/~asn/reporting_samba_bugs.txt
Line 9: Line 9:
| 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 />
| 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 -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'''.

Revision as of 12:51, 18 October 2017

Samba

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 -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.