DebuggingNetworkManager

Differences between revisions 1 and 51 (spanning 50 versions)
Revision 1 as of 2007-09-06 10:07:14
Size: 2474
Editor: d112207
Comment:
Revision 51 as of 2015-03-13 23:19:12
Size: 4126
Editor: 5e00a246
Comment: Simplify instructions for running debug-helper.py, which is now installed with NetworkManager
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
=== A Testcase === Available languages: [[https://wiki.ubuntu.com/DebuggingNetworkManager_it| Italiano]],
<<Include(Debugging/Header)>>
||<tablestyle="float:right; font-size: 0.9em; width:30%; background:#F1F1ED; background-image: url('https://librarian.launchpad.net/1812570/bugsquad.png'); background-repeat: no-repeat; background-position: 98% 0.5ex; margin: 0 0 1em 1em; padding: 0.5em;"><<TableOfContents>>||
== Bug Summary ==
Line 3: Line 6:
A good testcase is a step by step instruction to reproduce your bug starting with driver unloaded and NetworkManager stopped. If a network-manager bug report is about not being able to connect the title or summary should be in the format:
Line 5: Line 8:
Kill NetworkManager "[CHIPSET] cannot connect to (ENCRYPT_METHOD)"

where the CHIPSET is the wireless driver used and ENCRYPT_METHOD is the encryption method used by your wireless network.

== Understanding your bug and getting more information ==

 * There is a lot of debugging information available on the GNOME Live wiki: [[https://wiki.gnome.org/Projects/NetworkManager/Debugging|NetworkManager/Debugging]].
 * You can also take a look at [[http://live.gnome.org/DarrenAlbers/NetworkManagerFAQ|Darren Albers' FAQ]].
 * There is additional information on DebuggingNetworkManager/ReasonCodes for disconnection and network changes available.
 * The similar reason/status code data for wpasupplicant is available here: [[http://hostap.epitest.fi/gitweb/gitweb.cgi?p=hostap.git;a=blob;f=src/common/ieee802_11_defs.h|ieee802_11_defs.h]]


== Getting debug logs ==

You can then follow developers' intructions on a bug report for the exact command line to use; or run it directly as such:

=== Getting NetworkManager debug logs ===
Line 7: Line 27:
  sudo killall NetworkManager sudo /usr/lib/NetworkManager/debug-helper.py --nm debug
Line 10: Line 30:
To unload your driver {{{ rmmod -r DRIVER }}}. Then get the logs which will be written to /var/log/syslog. To disable it, pass '''info''' instead of '''debug''' in the above command, or reboot.
Line 12: Line 32:
Then load the driver and start NetworkManager: === Getting ModemManager debug logs ===
Line 14: Line 35:
  sudo NetworkManager sudo /usr/lib/NetworkManager/debug-helper.py --mm debug
Line 17: Line 38:
=== Capture Log === Then get the logs which will be written to /var/log/syslog. To disable it, pass '''info''' instead of '''debug''' in the above command, or reboot.

See also [[DebuggingModemmanager]].

=== Getting wpasupplicant debug logs ===

{{{
sudo /usr/lib/NetworkManager/debug-helper.py --wpa msgdump
}}}

Then get the logs which will be written to /var/log/syslog. To disable it, pass '''info''' instead of '''debug''' in the above command, or reboot.

=== Getting a capture of syslog ===

Mixing and mashing the above is perfectly acceptable as well if you want to see how NetworkManager and other parts of the stack interact together.
Line 23: Line 58:
 tail -n0 /var/log/syslog > /tmp/syslog
}}}
 tail -n0 -f /var/log/syslog > /tmp/syslog
}}} and to stop capturing do Ctrl-C (you will have to type your other commands in an other window or tab)
Line 26: Line 61:
Adding markers is just like adding new lines with an editor that show the triager what happened at what point of time. Adding markers is just like adding new lines with an editor that show the triager what happened at what point of time. You can also do this on the fly as you test with the command {{{logger "[ clicked on wireless network 'ubuntu']" }}}.
Line 33: Line 68:
Line 37: Line 73:
=== Handling 3G / modem issues ===
Line 38: Line 75:
=== Driver Logs === An few extra things that are very helpful to add in case of issues with 3G:
Line 40: Line 77:
When a bug appears to be driver related or you are asked by a bug triager to submit a driver enabled
log, you need to enable driver logging right before you start to capture your testcase. How to do that depends
on the driver you use and whether it has been with compiled with debug support.
The output of udevadm for tty devices, and output of lsusb:
Line 44: Line 79:

== Driver Specific Info ==
=== IPW (2100,2200, 3945) ===
==== Logging ====
Line 49: Line 80:
# either durint module load:
 modprobe ipw{2100,2200,3945} debug=1 debug_level=65535

# or when already loaded you can change the debug_level through /sys/bus/.../drivers/
 echo 65535 > /sys/bus/pci/drivers/ipw{2100,2200,3945}/debug_level
$ udevadm info --query=all --path=/sys/class/tty/... --attribute-walk
Line 56: Line 83:
==== Compiling Module Sources ====
For debugging purpose or to verify a fix, a developer might ask you to build your driver module from source. for ipwXXXX you can do that by:
Line 59: Line 84:
# install required headers and build tools
sudo apt-get install module-assistant
sudo module assistant update
sudo module assistant prepare
$ lsusb
}}}
Line 64: Line 87:
# build the driver
cd /path/to/ipw-XXXX
make IEEE80211_IGNORE_DUPLICATE=y SHELL=/bin/bash
== A Testcase ==
Line 68: Line 89:
# backup your old ipw driver:
sudo cp /lib/modules/$(uname -r)/kernel/drivers/net/wireless/ipw3945/ipw3945.ko $HOME
A good testcase is a step by step instruction to reproduce your bug starting with driver unloaded and NetworkManager stopped.
Line 71: Line 91:
# install the new driver
cp ipw3945.ko /lib/modules/$(uname -r)/kernel/drivers/net/wireless/ipw3945/
depmod -a
Stop NetworkManager
Line 75: Line 93:
# kill regulatory daemon
ipw3945d-$(uname -r) --kill
{{{
  sudo stop network-manager
}}}
Line 78: Line 97:
#load new module
modprobe ipw3945
To unload your driver {{{ sudo modprobe -r DRIVER }}}.

Then load the driver {{{ sudo modprobe DRIVER }}} and start NetworkManager:

{{{
  sudo start network-manager

Available languages: Italiano,

Debugging Central

This page is part of the debugging series — pages with debugging details for a variety of Ubuntu packages.

Bug Summary

If a network-manager bug report is about not being able to connect the title or summary should be in the format:

"[CHIPSET] cannot connect to (ENCRYPT_METHOD)"

where the CHIPSET is the wireless driver used and ENCRYPT_METHOD is the encryption method used by your wireless network.

Understanding your bug and getting more information

Getting debug logs

You can then follow developers' intructions on a bug report for the exact command line to use; or run it directly as such:

Getting NetworkManager debug logs

sudo /usr/lib/NetworkManager/debug-helper.py --nm debug

Then get the logs which will be written to /var/log/syslog. To disable it, pass info instead of debug in the above command, or reboot.

Getting ModemManager debug logs

sudo /usr/lib/NetworkManager/debug-helper.py --mm debug

Then get the logs which will be written to /var/log/syslog. To disable it, pass info instead of debug in the above command, or reboot.

See also DebuggingModemmanager.

Getting wpasupplicant debug logs

sudo /usr/lib/NetworkManager/debug-helper.py --wpa msgdump

Then get the logs which will be written to /var/log/syslog. To disable it, pass info instead of debug in the above command, or reboot.

Getting a capture of syslog

Mixing and mashing the above is perfectly acceptable as well if you want to see how NetworkManager and other parts of the stack interact together.

In order to understand whats going on and track down issues, its good to have a full log. To do so, capture the complete test case and submit the whole file (don't cut out what you think is important). Please add markers in the log file so the bug triager can easily see what actions the user takes at what point of time (this isn't essential, but helps a lot).

To capture the syslog, do:

 tail -n0 -f /var/log/syslog > /tmp/syslog

and to stop capturing do Ctrl-C (you will have to type your other commands in an other window or tab)

Adding markers is just like adding new lines with an editor that show the triager what happened at what point of time. You can also do this on the fly as you test with the command logger "[ clicked on wireless network 'ubuntu']" .

Example marker:

Sep  6 08:12:30 ...

[ clicked on wireless network 'ubuntu']

Sep  6 08:12:31 ...
...

Handling 3G / modem issues

An few extra things that are very helpful to add in case of issues with 3G:

The output of udevadm for tty devices, and output of lsusb:

$ udevadm info --query=all --path=/sys/class/tty/... --attribute-walk

$ lsusb

A Testcase

A good testcase is a step by step instruction to reproduce your bug starting with driver unloaded and NetworkManager stopped.

Stop NetworkManager

  sudo stop network-manager

To unload your driver  sudo modprobe -r DRIVER .

Then load the driver  sudo modprobe DRIVER  and start NetworkManager:

  sudo start network-manager

DebuggingNetworkManager (last edited 2023-06-27 20:21:45 by hellsworth)