| .. _handoff_queue_demo_plugin: |
| |
| Handoff queue in a plugin |
| ========================= |
| |
| This plugin provides a simplified example of how to hand off packets |
| between threads. I used it to debug packet-tracer handoff tracing |
| support. |
| |
| Packet generator input script |
| ----------------------------- |
| |
| :: |
| |
| packet-generator new { |
| name x |
| limit 5 |
| size 128-128 |
| interface local0 |
| node handoffdemo-1 |
| data { |
| incrementing 30 |
| } |
| } |
| |
| Start vpp with 2 worker threads |
| ------------------------------- |
| |
| The demo plugin hands packets from worker 1 to worker 2. |
| |
| Enable tracing, and start the packet generator |
| ---------------------------------------------- |
| |
| :: |
| |
| trace add pg-input 100 |
| packet-generator enable |
| |
| Sample Run |
| ---------- |
| |
| :: |
| |
| DBGvpp# ex /tmp/pg_input_script |
| DBGvpp# pa en |
| DBGvpp# sh err |
| Count Node Reason |
| 5 handoffdemo-1 packets handed off processed |
| 5 handoffdemo-2 completed packets |
| DBGvpp# show run |
| Thread 1 vpp_wk_0 (lcore 0) |
| Time 133.9, average vectors/node 5.00, last 128 main loops 0.00 per node 0.00 |
| vector rates in 3.7331e-2, out 0.0000e0, drop 0.0000e0, punt 0.0000e0 |
| Name State Calls Vectors Suspends Clocks Vectors/Call |
| handoffdemo-1 active 1 5 0 4.76e3 5.00 |
| pg-input disabled 2 5 0 5.58e4 2.50 |
| unix-epoll-input polling 22760 0 0 2.14e7 0.00 |
| --------------- |
| Thread 2 vpp_wk_1 (lcore 2) |
| Time 133.9, average vectors/node 5.00, last 128 main loops 0.00 per node 0.00 |
| vector rates in 0.0000e0, out 0.0000e0, drop 3.7331e-2, punt 0.0000e0 |
| Name State Calls Vectors Suspends Clocks Vectors/Call |
| drop active 1 5 0 1.35e4 5.00 |
| error-drop active 1 5 0 2.52e4 5.00 |
| handoffdemo-2 active 1 5 0 2.56e4 5.00 |
| unix-epoll-input polling 22406 0 0 2.18e7 0.00 |
| |
| Enable the packet tracer and run it again… |
| |
| :: |
| |
| DBGvpp# trace add pg-input 100 |
| DBGvpp# pa en |
| DBGvpp# sh trace |
| sh trace |
| ------------------- Start of thread 0 vpp_main ------------------- |
| No packets in trace buffer |
| ------------------- Start of thread 1 vpp_wk_0 ------------------- |
| Packet 1 |
| |
| 00:06:50:520688: pg-input |
| stream x, 128 bytes, 0 sw_if_index |
| current data 0, length 128, buffer-pool 0, ref-count 1, trace handle 0x1000000 |
| 00000000: 000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d0000 |
| 00000020: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00000040: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00000060: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00:06:50:520762: handoffdemo-1 |
| HANDOFFDEMO: current thread 1 |
| |
| Packet 2 |
| |
| 00:06:50:520688: pg-input |
| stream x, 128 bytes, 0 sw_if_index |
| current data 0, length 128, buffer-pool 0, ref-count 1, trace handle 0x1000001 |
| 00000000: 000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d0000 |
| 00000020: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00000040: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00000060: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00:06:50:520762: handoffdemo-1 |
| HANDOFFDEMO: current thread 1 |
| |
| Packet 3 |
| |
| 00:06:50:520688: pg-input |
| stream x, 128 bytes, 0 sw_if_index |
| current data 0, length 128, buffer-pool 0, ref-count 1, trace handle 0x1000002 |
| 00000000: 000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d0000 |
| 00000020: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00000040: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00000060: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00:06:50:520762: handoffdemo-1 |
| HANDOFFDEMO: current thread 1 |
| |
| Packet 4 |
| |
| 00:06:50:520688: pg-input |
| stream x, 128 bytes, 0 sw_if_index |
| current data 0, length 128, buffer-pool 0, ref-count 1, trace handle 0x1000003 |
| 00000000: 000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d0000 |
| 00000020: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00000040: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00000060: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00:06:50:520762: handoffdemo-1 |
| HANDOFFDEMO: current thread 1 |
| |
| Packet 5 |
| |
| 00:06:50:520688: pg-input |
| stream x, 128 bytes, 0 sw_if_index |
| current data 0, length 128, buffer-pool 0, ref-count 1, trace handle 0x1000004 |
| 00000000: 000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d0000 |
| 00000020: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00000040: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00000060: 0000000000000000000000000000000000000000000000000000000000000000 |
| 00:06:50:520762: handoffdemo-1 |
| HANDOFFDEMO: current thread 1 |
| |
| ------------------- Start of thread 2 vpp_wk_1 ------------------- |
| Packet 1 |
| |
| 00:06:50:520796: handoff_trace |
| HANDED-OFF: from thread 1 trace index 0 |
| 00:06:50:520796: handoffdemo-2 |
| HANDOFFDEMO: current thread 2 |
| 00:06:50:520867: error-drop |
| rx:local0 |
| 00:06:50:520914: drop |
| handoffdemo-2: completed packets |
| |
| Packet 2 |
| |
| 00:06:50:520796: handoff_trace |
| HANDED-OFF: from thread 1 trace index 1 |
| 00:06:50:520796: handoffdemo-2 |
| HANDOFFDEMO: current thread 2 |
| 00:06:50:520867: error-drop |
| rx:local0 |
| 00:06:50:520914: drop |
| handoffdemo-2: completed packets |
| |
| Packet 3 |
| |
| 00:06:50:520796: handoff_trace |
| HANDED-OFF: from thread 1 trace index 2 |
| 00:06:50:520796: handoffdemo-2 |
| HANDOFFDEMO: current thread 2 |
| 00:06:50:520867: error-drop |
| rx:local0 |
| 00:06:50:520914: drop |
| handoffdemo-2: completed packets |
| |
| Packet 4 |
| |
| 00:06:50:520796: handoff_trace |
| HANDED-OFF: from thread 1 trace index 3 |
| 00:06:50:520796: handoffdemo-2 |
| HANDOFFDEMO: current thread 2 |
| 00:06:50:520867: error-drop |
| rx:local0 |
| 00:06:50:520914: drop |
| handoffdemo-2: completed packets |
| |
| Packet 5 |
| |
| 00:06:50:520796: handoff_trace |
| HANDED-OFF: from thread 1 trace index 4 |
| 00:06:50:520796: handoffdemo-2 |
| HANDOFFDEMO: current thread 2 |
| 00:06:50:520867: error-drop |
| rx:local0 |
| 00:06:50:520914: drop |
| handoffdemo-2: completed packets |
| DBGvpp# |