Metadata-Version: 2.1
Name: pktperf
Version: 0.3.0
Summary: pktgen python scripts
Author: junka
Author-email: wan.junjie@fixmail.com
Project-URL: Bug Tracker, https://github.com/junka/pktperf/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: BSD License
Requires-Python: >=3.5
Description-Content-Type: text/markdown
License-File: LICENSE

# pktperf
pktgen is very useful for network performance test, especially when we don't have 
multiple nics for dpdk. And for ```vm2vm``` test, it would be easy to use for end-user.

Pktperf is a very thin layer for pktgen (the kernel version).

It makes use of the sample scripts in linux kernel [https://github.com/torvalds/linux/tree/master/samples/pktgen]

All ```cmds``` in [https://www.kernel.org/doc/Documentation/networking/pktgen.txt]

## install
```pip3 install pktperf```

## usage
A simple sample command would be 
```
pktperf -i eth0 -s 64 -m 00:78:0a:fa:34:12 -t 12 -c 1200 -d 192.168.10.100 -n 0
```


It keeps parameters the same with sample scripts.
```
usage: pktperf.py [-h] -i INTERFACE [-s SIZE] [-d DEST] [-m MAC]
                  [-p PORTRANGE] [-k] [-t THREADS] [-f FIRSTTHREAD] [-c CLONE]
                  [-n NUM] [-b BURST] [-v] [-x] [--ipv6] [-z FLOWS]
                  [-l FLOWPKT] [-w DELAY] [-a] [-q] [-o TOS] [-r BPS] [-y PPS]
                  [-e FRAGS]

pktgen python scripts

optional arguments:
  -h, --help            show this help message and exit
  -i INTERFACE, --interface INTERFACE
                        output interface/device
  -s SIZE, --size SIZE  packet size
  -d DEST, --dest DEST  destination IP. CIDR is also allowed
  -m MAC, --mac MAC     destination MAC-addr
  -p PORTRANGE, --portrange PORTRANGE
                        destination PORT range is also allowed
  -k, --txcsum          enable UDP tx checksum
  -t THREADS, --threads THREADS
                        threads to start
  -f FIRSTTHREAD, --firstthread FIRSTTHREAD
                        index of first thread
  -c CLONE, --clone CLONE
                        SKB clones send before alloc new SKB
  -n NUM, --num NUM     num messages to send per thread, 0 means indefinitely
  -b BURST, --burst BURST
                        HW level bursting of SKBs
  -v, --verbose         verbose
  -x, --debug           debug
  --ipv6                IPv6
  -z FLOWS, --flows FLOWS
                        Limit number of flows
  -l FLOWPKT, --flowpkt FLOWPKT
                        packets number a flow will send
  -w DELAY, --delay DELAY
                        Tx Delay value (ns)
  -a, --append          Script will not reset generator's state, but will
                        append its config
  -q, --queuemap        queue mapping with irq affinity
  -o TOS, --tos TOS     tos for IPv4 or traffic class for IPv6 traffic
  -r BPS, --bps BPS     bps rate limit per thread
  -y PPS, --pps PPS     pps rate limit per thread
  -e FRAGS, --frags FRAGS
                        frags number in skb_shared_info
```



During pktgen running, all stats will be display with 1 sec interval
```
Core  0 send                 10894413 pkts: 904722 pps 463217664 bps 0 errors
Core  1 send                 10865308 pkts: 902305 pps 461980160 bps 0 errors
Core  2 send                 10859822 pkts: 901849 pps 461746688 bps 0 errors
Core  3 send                 10778662 pkts: 896297 pps 458904064 bps 0 errors
Core  4 send                 10894414 pkts: 904721 pps 463217152 bps 0 errors
Core  5 send                 10872270 pkts: 902882 pps 462275584 bps 0 errors
Core  6 send                 10859791 pkts: 901846 pps 461745152 bps 0 errors
Core  7 send                 10906863 pkts: 905754 pps 463746048 bps 0 errors
Core  8 send                 10868798 pkts: 902594 pps 462128128 bps 0 errors
Core  9 send                 10872302 pkts: 902885 pps 462277120 bps 0 errors
Core 10 send                 10859437 pkts: 901817 pps 461730304 bps 0 errors
Core 11 send                 10907599 pkts: 905816 pps 463777792 bps 0 errors
Total   send                130439679 pkts: 10833488 pps 5546745856 bps  0 errors
```


```pkts``` are exactly the number sent out the each queue, if you see any of them less than
the others, there could be a rate limit for the port or the queue.


By default, the flows contain packets with udp src port 9 to 1009. It means sending
1k flows. With ```-p``` you can specify udp dst port range. So if you want send 100k
flows, put ```-p 200-300``` into the parameters.


```-d``` specifies the destination ip address, with ```192.168.0.100/31```, the pktgen will
send packets to both 192.168.0.100 and 192.168.0.101. Or you can use range like port range 
above ```192.168.0.100-192.168.0.101``` instead.


the limit options ```-y``` and ```-r``` seems not working for pktgen now.


I don't see any verbose print with ```-x``` or ```-v```, maybe remove them later.


With ```-b``` the pktgen could get more performance gain.
