| andrew | a38d001 | 2018-08-06 00:25:33 -0400 | [diff] [blame] | 1 | .. _running_vpp: |
| 2 | |
| 3 | .. toctree:: |
| 4 | |
| 5 | Running VPP |
| 6 | =========== |
| 7 | |
| John DeNisco | 2ba9dcf | 2018-08-23 14:04:22 -0400 | [diff] [blame] | 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. |
| John DeNisco | ce96dda | 2018-08-14 16:04:09 -0400 | [diff] [blame] | 10 | For instance if you want to run VPP with GDB. |
| andrew | a38d001 | 2018-08-06 00:25:33 -0400 | [diff] [blame] | 11 | |
| John DeNisco | ce96dda | 2018-08-14 16:04:09 -0400 | [diff] [blame] | 12 | Running Without GDB |
| andrew | a38d001 | 2018-08-06 00:25:33 -0400 | [diff] [blame] | 13 | _________________________ |
| 14 | |
| John DeNisco | ce96dda | 2018-08-14 16:04:09 -0400 | [diff] [blame] | 15 | To run the VPP images that you've built without GDB, run the following commands: |
| andrew | a38d001 | 2018-08-06 00:25:33 -0400 | [diff] [blame] | 16 | |
| 17 | Running the release image: |
| 18 | |
| 19 | .. code-block:: console |
| 20 | |
| 21 | # make run-release |
| 22 | # |
| 23 | |
| John DeNisco | 758dc46 | 2018-08-13 17:00:06 -0400 | [diff] [blame] | 24 | Running the debug image: |
| 25 | |
| 26 | .. code-block:: console |
| 27 | |
| 28 | # make run |
| 29 | # |
| 30 | |
| John DeNisco | ce96dda | 2018-08-14 16:04:09 -0400 | [diff] [blame] | 31 | Running With GDB |
| andrew | a38d001 | 2018-08-06 00:25:33 -0400 | [diff] [blame] | 32 | _________________________ |
| 33 | |
| 34 | With the following commands you can run VPP and then be dropped into the GDB prompt. |
| 35 | |
| Saima Yunus | 5f6422d | 2022-05-19 11:48:59 -0700 | [diff] [blame] | 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 | |
| andrew | a38d001 | 2018-08-06 00:25:33 -0400 | [diff] [blame] | 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) |
| Saima Yunus | 5f6422d | 2022-05-19 11:48:59 -0700 | [diff] [blame] | 56 | |