[U-Boot,v4,2/3] doc: pcap: add pcap cmd documentation
diff mbox series

Message ID 20190718184333.27927-2-rfried.dev@gmail.com
State Accepted
Commit dc625d04d251f7cb5d51daa513f002a83787a58f
Delegated to: Joe Hershberger
Headers show
Series
  • [U-Boot,v4,1/3] net: introduce packet capture support
Related show

Commit Message

Ramon Fried July 18, 2019, 6:43 p.m. UTC
Add documentation for new "pcap" command.

Signed-off-by: Ramon Fried <rfried.dev@gmail.com>

---

Changes in v4:
* Document the new $pcapsize environment variable.
* update doc regarding error message when there's not
  enough memory left.

Changes in v3: None
Changes in v2: None

 doc/README.pcap | 62 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 doc/README.pcap

Comments

Joe Hershberger Sept. 3, 2019, 10:03 p.m. UTC | #1
On Thu, Jul 18, 2019 at 1:44 PM Ramon Fried <rfried.dev@gmail.com> wrote:
>
> Add documentation for new "pcap" command.
>
> Signed-off-by: Ramon Fried <rfried.dev@gmail.com>
>
> ---
>
> Changes in v4:
> * Document the new $pcapsize environment variable.
> * update doc regarding error message when there's not
>   enough memory left.
>
> Changes in v3: None
> Changes in v2: None

I guess we can figure out the sandbox testing later.

Acked-by: Joe Hershberger <joe.hershberger@ni.com>
Joe Hershberger Sept. 4, 2019, 4:40 p.m. UTC | #2
Hi Ramon,

https://patchwork.ozlabs.org/patch/1133815/ was applied to http://git.denx.de/?p=u-boot/u-boot-net.git

Thanks!
-Joe

Patch
diff mbox series

diff --git a/doc/README.pcap b/doc/README.pcap
new file mode 100644
index 0000000000..97b3e55fd8
--- /dev/null
+++ b/doc/README.pcap
@@ -0,0 +1,62 @@ 
+PCAP:
+
+U-boot supports live Ethernet packet capture in PCAP(2.4) format.
+This is enabled by CONFIG_CMD_PCAP.
+
+The capture is stored on physical memory, and should be copied to
+a machine capable of parsing and displaying PCAP files (IE. wireshark)
+If networking works properly one can copy the capture file from physical memory
+using tftpput, or save it to local storage with (sf write, mmc write, fatwrite, etc)
+
+the pcap capturing requires maximum buffer size.
+when the buffer is full an error message will be displayed and then packets
+will silently drop.
+the actual capture file size is populate in the environment variable "pcapsize".
+
+Usage example:
+
+# Initialize pcap capture to physical address (0x100000) with maximum size of
+# 100000 bytes.
+
+# Start capture
+pcap start
+
+# Initialize network activity
+env set ipaddr 10.0.2.15; env set serverip 10.0.2.2; tftp uImage64
+
+# Stop capture
+pcap stop
+
+# pcap init 0x100000 100000
+PCAP capture initialized: addr: 0xffffffff80100000 max length: 100000
+
+# pcap start
+# env set ipaddr 10.0.2.15; env set serverip 10.0.2.2; tftp uImage64
+eth0@10000000: PHY present at 0
+eth0@10000000: link up, 1000Mbps full-duplex (lpa: 0x7c00)
+Using eth0@10000000 device
+TFTP from server 10.0.2.2; our IP address is 10.0.2.15
+Filename 'uImage64'.
+Load address: 0xffffffff88000000
+Loading: #################################################################
+         #################################################################
+         #################################################################
+         #################################################################
+!!! Buffer is full, consider increasing buffer size !!!
+         #################################################################
+         #################################################################
+         #################################################################
+         #################################################################
+         #################################################################
+         #
+         18.2 MiB/s
+done
+Bytes transferred = 8359376 (7f8dd0 hex)
+PCAP status:
+        Initialized addr: 0xffffffff80100000    max length: 100000
+        Status: Active.  file size: 99991
+        Incoming packets: 66 Outgoing packets: 67
+
+# pcap stop
+# tftpput 0xffffffff80100000 $pcapsize 10.0.2.2:capture.pcap
+