resources/tools/trex/trex_stateless_stop.py

   1 #!/usr/bin/python3
   2
   3 # Copyright (c) 2019 Cisco and/or its affiliates.
   4 # Licensed under the Apache License, Version 2.0 (the "License");
   5 # you may not use this file except in compliance with the License.
   6 # You may obtain a copy of the License at:
   7 #
   8 #     http://www.apache.org/licenses/LICENSE-2.0
   9 #
  10 # Unless required by applicable law or agreed to in writing, software
  11 # distributed under the License is distributed on an "AS IS" BASIS,
  12 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 # See the License for the specific language governing permissions and
  14 # limitations under the License.
  15
  16 """This script uses T-REX stateless API to drive t-rex instance.
  17
  18 Requirements:
  19 - T-REX: https://github.com/cisco-system-traffic-generator/trex-core
  20  - compiled and running T-REX process (eg. ./t-rex-64 -i)
  21  - trex.stl.api library
  22 - Script must be executed on a node with T-REX instance
  23
  24 Functionality:
  25 1. Stop any running traffic
  26 """
  27
  28 import sys
  29 import json
  30
  31 sys.path.insert(0, "/opt/trex-core-2.54/scripts/automation/"+\
  32                    "trex_control_plane/interactive/")
  33 from trex.stl.api import *
  34
  35
  36 def main():
  37     """Stop traffic if any is running. Report xstats."""
  38     client = STLClient()
  39     try:
  40         # connect to server
  41         client.connect()
  42
  43         client.acquire(force=True)
  44         # TODO: Support unidirection.
  45         client.stop(ports=[0, 1])
  46
  47         # read the stats after the test
  48         xstats0 = client.get_xstats(0)
  49         xstats1 = client.get_xstats(1)
  50
  51     # If STLError happens, let the script fail with stack trace.
  52     finally:
  53         client.disconnect()
  54
  55     print("##### statistics port 0 #####")
  56     print(json.dumps(xstats0, indent=4, separators=(',', ': ')))
  57     print("##### statistics port 1 #####")
  58     print(json.dumps(xstats1, indent=4, separators=(',', ': ')))
  59
  60     tx_0, rx_0 = xstats0["tx_good_packets"], xstats0["rx_good_packets"]
  61     tx_1, rx_1 = xstats1["tx_good_packets"], xstats1["rx_good_packets"]
  62     lost_a, lost_b = tx_0 - rx_1, tx_1 - rx_0
  63
  64     print("\npackets lost from 0 --> 1:   {0} pkts".format(lost_a))
  65     print("packets lost from 1 --> 0:   {0} pkts".format(lost_b))
  66
  67     total_rcvd, total_sent = rx_0 + rx_1, tx_0 + tx_1
  68     total_lost = total_sent - total_rcvd
  69     # TODO: Add latency.
  70     print(
  71         "rate='unknown', totalReceived={rec}, totalSent={sen}, frameLoss={los},"
  72         " latencyStream0(usec)=-1/-1/-1, latencyStream1(usec)=-1/-1/-1,"
  73         " targetDuration='manual'".format(
  74             rec=total_rcvd, sen=total_sent, los=total_lost))
  75
  76 if __name__ == "__main__":
  77     main()