.. _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]] [mode <ethernet | ip4 | ip6>]


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

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 769 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L769>`_

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 51 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L51>`_


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 655 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L655>`_

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 574 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L574>`_

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 529 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L529>`_

Implementation: ``del_stream``


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

.. code-block:: console

    Disable packet generator streams


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

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 1975 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/input.c#L1975>`_

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 495 <https://github.com/FDio/vpp/blob/master//src/vnet/pg/cli.c#L495>`_

Implementation: ``new_stream``


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

.. code-block:: console

    show packet-generator [verbose]


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

Implementation: ``show_streams``