.. _clicmd_src_vnet_pg:

===============================================================
Pg cli reference
===============================================================

create packet-generator interface
-------------------------------------------------------------------------

.. code-block:: console

    create packet-generator interface <interface name> [hw-addr <addr>] [gso-enabled gso-size <size> [coalesce-enabled]] [csum-offload-enabled] [mode <ethernet | ip4 | ip6>]


Declaration: ``create_pg_if_cmd`` `src/vnet/pg/cli.c line 696 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L696>`_

Implementation: ``create_pg_if_cmd_fn``


delete packet-generator interface
-------------------------------------------------------------------------

.. code-block:: console

    delete packet-generator interface {<interface name> | sw_if_index <sw_idx>}


Declaration: ``delete_pg_if_cmd`` `src/vnet/pg/cli.c line 745 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L745>`_

Implementation: ``delete_pg_if_cmd_fn``


packet-generator
-------------------------------------------------------------------------

.. code-block:: console

    Packet generator commands


Declaration: ``vlib_cli_pg_command`` `src/vnet/pg/cli.c line 19 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L19>`_


packet-generator capture
-------------------------------------------------------------------------

.. code-block:: console

    packet-generator capture <interface name> pcap <filename> [count <n>]


Declaration: ``pg_capture_cmd`` `src/vnet/pg/cli.c line 629 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L629>`_

Implementation: ``pg_capture_cmd_fn``


packet-generator configure
-------------------------------------------------------------------------

.. code-block:: console

    Change packet generator stream parameters


Declaration: ``change_stream_parameters_cli`` `src/vnet/pg/cli.c line 548 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L548>`_

Implementation: ``change_stream_parameters``


packet-generator delete
-------------------------------------------------------------------------

.. code-block:: console

    Delete stream with given name


Declaration: ``del_stream_cli`` `src/vnet/pg/cli.c line 503 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L503>`_

Implementation: ``del_stream``


packet-generator disable-stream
-------------------------------------------------------------------------

.. code-block:: console

    Disable packet generator streams


Declaration: ``disable_streams_cli`` `src/vnet/pg/cli.c line 113 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L113>`_

Implementation: ``enable_disable_stream``


packet-generator mac-filter
-------------------------------------------------------------------------

.. code-block:: console

    packet-generator mac-filter <INTERFACE> <on|off>


Declaration: ``enable_streams_cli`` `src/vnet/pg/input.c line 1964 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/input.c#L1964>`_

Implementation: ``pg_input_mac_filter_cfg``


packet-generator new
-------------------------------------------------------------------------

.. code-block:: console

    Create packet generator stream

.. code-block:: console

    Create packet generator stream
    
    Arguments:
    
    name STRING          sets stream name
    interface STRING     interface for stream output 
    node NODE-NAME       node for stream output
    data STRING          specifies packet data
    pcap FILENAME        read packet data from pcap file
    rate PPS             rate to transfer packet data
    maxframe NPKTS       maximum number of packets per frame
    


Declaration: ``new_stream_cli`` `src/vnet/pg/cli.c line 469 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L469>`_

Implementation: ``new_stream``


show packet-generator 
-------------------------------------------------------------------------

.. code-block:: console

    show packet-generator [verbose]


Declaration: ``show_streams_cli`` `src/vnet/pg/cli.c line 214 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L214>`_

Implementation: ``show_streams``


show packet-generator interface
-------------------------------------------------------------------------

.. code-block:: console

    show packet-generator interface {<interface name> | sw_if_index <sw_idx>}


Declaration: ``show_pg_if_cmd`` `src/vnet/pg/cli.c line 813 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L813>`_

Implementation: ``show_pg_if_cmd_fn``