# Debug

Tab QCS6490/QCS5430
Tab QCS9100/QCS9075

- *class* tabincludedirective

    - You can use the following log types to log and debug issues related to
Ethernet.

| Log type | Purpose |
| --- | --- |
| `dmesg` | Debug issues related to the kernel driver |
| `tcpdump` | Verify the packet transfer |

To debug the issues that may occur during Ethernet bringup, do the
following:

1. To collect `dmesg` logs and debug issues related to kernel driver, run
the following command.

dmesg > /var/log/dmesg_logs.txt
        Copy to clipboard
2. To collect `tcpdump` logs and verify the packet transfer, run the
following command.

tcpdump -i any -s 0 -w /var/log/tcpdump.pcap
        Copy to clipboard
3. To pull the file after the test, run the following commands.

scp  root@<device_ip_address>:/var/log/tcpdump.pcap .
        Copy to clipboard

scp  root@<device_ip_address>:/var/log/dmesg_logs.txt .
        Copy to clipboard

Note

When prompted for a password, enter `oelinux123` to authenticate the file transfer via SCP.
4. Collect the output from ethtool, ifconfig, netstat, and IP route
tables for debugging.

    For more information on these tools, see [Tools](https://docs.qualcomm.com/doc/80-70017-26/topic/tools.html#tools).

- *class* tabincludedirective

    - You can use the following log types to log and debug issues related to
Ethernet.

| Log type | Purpose |
| --- | --- |
| `dmesg` | Debug issues related to the kernel driver |
| `tcpdump` | Verify the packet transfer |

To debug the issues that may occur during Ethernet bringup, do the
following:

1. To collect `dmesg` logs and debug issues related to kernel driver, run
the following command.

dmesg > /var/log/dmesg_logs.txt
        Copy to clipboard
2. To collect `tcpdump` logs and verify the packet transfer, run the
following command.

tcpdump -i any -s 0 -w /var/log/tcpdump.pcap
        Copy to clipboard
3. To pull the file after the test, run the following commands.

scp  root@<device_ip_address>:/var/log/tcpdump.pcap .
        Copy to clipboard

scp  root@<device_ip_address>:/var/log/dmesg_logs.txt .
        Copy to clipboard

Note

When prompted for a password, enter `oelinux123` to authenticate the file transfer via SCP.
4. Collect the output from ethtool, ifconfig, netstat, and IP route
tables for debugging.

    For more information on these tools, see [Tools](https://docs.qualcomm.com/doc/80-70017-26/topic/tools.html#tools).

## DPDK logging and debugging

You can use the following tools to log and debug issues related to DPDK.

| Tool | Description | Reference |
| --- | --- | --- |
| `dpdk-dumpcap` | <ul class="simple"><br><li><p>A network traffic dump tool.</p></li><br><li><p>Captures packet data from a live network and writes the packets to a file.</p></li><br></ul> | [dpdk-dumpcap Application](https://doc.dpdk.org/guides/tools/dumpcap.html) |
| `ethtool` | <ul class="simple"><br><li><p>Displays the network interface controller (NIC) parameters.</p></li><br><li><p>Configures the NIC settings such as speed, port, auto-negotiation, and so on.</p></li><br></ul> | [Ethtool Shell](https://doc.dpdk.org/guides/sample_app_ug/ethtool.html#ethtool-shell) |

For information on collecting the logs for testpmd application, see [Testpmd Application User Guide](https://doc.dpdk.org/guides/testpmd_app_ug/index.html).

Before debugging, ensure that the following parameters mentioned in [Enable DPDK on IQ-9 Beta EVK](https://docs.qualcomm.com/doc/80-70017-26/topic/enable-dpdk-on-iq9-beta-evk.html#enable-dpdk-on-iq-9-beta-evk) are properly set.

> 
> 
> cat /sys/module/vfio_iommu_type1/parameters/allow_unsafe_interrupts
>     Y
>     Copy to clipboard
> 
> 
> cat /sys/module/vfio_pci/parameters/enable_sriov
>     Y
>     Copy to clipboard
> 
> 
> cat /sys/bus/pci/devices/0000\:01\:00.1/sriov_numvfs
>     1
>     Copy to clipboard
> 
> 
> cat /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages
>     512
>     Copy to clipboard

Related information:

> 
> 
> - [DPDK](https://docs.qualcomm.com/doc/80-70017-26/topic/features.html#dpdk)
> - [Enable DPDK on IQ-9 Beta EVK](https://docs.qualcomm.com/doc/80-70017-26/topic/enable-dpdk-on-iq9-beta-evk.html#enable-dpdk-on-iq-9-beta-evk)
> - [Run DPDK testpmd](https://docs.qualcomm.com/doc/80-70017-26/topic/tools-qcs9075.html#run-dpdk-testpmd)

Last Published: Dec 24, 2024

[Previous Topic
Configure](https://docs.qualcomm.com/bundle/publicresource/80-70017-26/topics/configure.md) [Next Topic
References](https://docs.qualcomm.com/bundle/publicresource/80-70017-26/topics/references.md)