.. _clicmd_src_vnet_pg:

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

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

.. code-block:: console

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


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

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

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

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

Implementation: ``del_stream``


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

.. code-block:: console

    Disable packet generator streams


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

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

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

Implementation: ``new_stream``


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

.. code-block:: console

    show packet-generator [verbose]


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

Implementation: ``show_streams``