docs/developer/build-run-debug/running_vpp.rst

   1 .. _running_vpp:
   2
   3 .. toctree::
   4
   5 Running VPP
   6 ===========
   7
   8 After building the VPP binaries, you now have several images built.
   9 These images are useful when you need to run VPP without installing the packages.
  10 For instance if you want to run VPP with GDB.
  11
  12 Running Without GDB
  13 _________________________
  14
  15 To run the VPP images that you've built without GDB, run the following commands:
  16
  17 Running the release image:
  18
  19 .. code-block:: console
  20
  21    # make run-release
  22    #
  23
  24 Running the debug image:
  25
  26 .. code-block:: console
  27
  28    # make run
  29    #
  30
  31 Running With GDB
  32 _________________________
  33
  34 With the following commands you can run VPP and then be dropped into the GDB prompt.
  35
  36 Before running either command, please make sure that the 'gdb' package is installed.
  37 If it's not installed, run the following command first:
  38
  39 .. code-block:: console
  40
  41    $ sudo apt install gdb
  42
  43 Running the release image:
  44
  45 .. code-block:: console
  46
  47    # make debug-release
  48    (gdb)
  49
  50 Running the debug image:
  51
  52 .. code-block:: console
  53
  54    # make debug
  55    (gdb)
  56