aboutsummaryrefslogtreecommitdiffstats
path: root/Makefile
AgeCommit message (Collapse)AuthorFilesLines
2016-09-07VPP-221 CLI auto-documentation infrastructureChris Luke1-20/+18
[Note: This is an amalgamation of several patches cherry-picked from master all related to introducing auto-CLI documentation. See commits d4024f58 ee4743ad 16bcf7d8 e0d802bc 54ccf226] As a step before Doxygen, extract CLI-related struct initializers from the code and parse that into a summary of the CLI commands available with the provided help text, such as it is. At the moment this only renders this into an indexed Markdown file that Doxygen then picks up but later we can use this information to enrich the existing VLIB_CLI_COMMAND macro documentor as well as provide runtime documentation to VPP that is stored on disk outside the binary image. Additionally support a comment block immediately prior to VLIB_CLI_COMMAND CLI command definitions in the form /*? ... ?*/ that can be used to include long-form documentation without having it compiled into VPP. Examples of documenting CLI commands can be found in vlib/vlib/unix/cli.c which, whilst not perfect, should provide a starting point. Screen captures of sample output can be seen at https://chrisy.flirble.org/vpp/doxy-cli-example.png and https://chrisy.flirble.org/vpp/doxy-cli-index.png . Next, shift the Doxygen root makefile targets to their own Makefile. The primary reason for this is that the siphon targets do dependency tracking which means it needs to generate those dependencies whenever make is run; that is pointless if we're not going to generate any documentation. This includes the package dependencies since they since they sometimes unnecessarily interfere with the code build in some cases at the moment; later we will look to building a Python venv to host the Python modules we use. One final remark: In future we may consider deprecating .long_help in the VLIB_CLI_COMMAND structure entirely but add perhaps .usage_help. .short_help would be reserved for a summary of the command function and .usage_help provide the syntax of that command. These changes would provide great semantic value to the automaticly generated CLI documentation. I could also see having .long_help replaced by a mechanism that reads it from disk at runtime with a rudimentary Markdown/Doxygen filter so that we can use the same text that is used in the published documentation. Change-Id: I8afccfd7fe2096411d8064ac954ca5a2cbca9ae7 Signed-off-by: Chris Luke <chrisy@flirble.org>
2016-07-26Fix missing include dirs in doxygenChris Luke1-1/+1
Also allow a developer to alter the directories scanned at runtime to facilitate shorter run-times when writing documentation. Change-Id: I2a09519661a3abe1fbc0cfc294000934852af951 Signed-off-by: Chris Luke <chrisy@flirble.org>
2016-07-08Multiple changes in the plugin build infraDamjan Marion1-3/+3
- configure.ac - some plugins are enabled by default - Plugin .so files are placed into corresponding subdirs - WITH_PLUGIN_TOOLKIT macro is retired - not needed anymore - plugins/build-data is removed - plugin makefiles are not building static libs anymore - plugin makefiles are not installing header files to /usr/include anymore Change-Id: I55681bd9ce34811f7eb1b2b24d9f0ca42df1cf04 Signed-off-by: Damjan Marion <damarion@cisco.com>
2016-07-08Set plugin path properly when using toplevel makefile to run/debug vppDamjan Marion1-8/+11
Change-Id: Ib6f7dd9d7e1d9f2f2108a8b89421149e4435d5ec Signed-off-by: Damjan Marion <damarion@cisco.com>
2016-07-02Add gtags option to use ctags. Hidden option in MakefileKeith Burns (alagalah)1-0/+3
Change-Id: I6b01c1f2beec37d7aaad1ab9dab303835a9feb49 Signed-off-by: Keith Burns (alagalah) <alagalah@gmail.com>
2016-06-17Updated Makefile so install-dep doesn't promptKeith Burns (alagalah)1-3/+4
Change-Id: I8e5f4d120c9add636054e740f2a8aa3a0f8bb7d1 Signed-off-by: Keith Burns (alagalah) <alagalah@gmail.com>
2016-06-156rd: Move to pluginOle Troan1-3/+3
- Change toplevel plugins make target. Now builds all plugins under plugins/. (Apart from sample-plugin). - Move sixrd code to plugins directory and make necessary changes to make it a plugin - Remove 6rd hooks from IP lookup code Change-Id: I447e92e3bee240cd8de01d0abac2e1708e8c27d1 Signed-off-by: Ole Troan <ot@cisco.com>
2016-06-14Cleanup /dev/shm before starting VPP from top-level MakefileDamjan Marion1-0/+2
Change-Id: I3a8b85ad033707552b9df7d0d08548517a8571ce Signed-off-by: Damjan Marion <damarion@cisco.com>
2016-06-05VPP-94: Add build-data directory for plugins and Makefile targetPierre Pfister1-1/+7
Commit e36af5f3153 moved sample-plugin a dedicated directory. The build system could not find sources for sample-plugin-* targets. This commit adds a dedicated build-data/packages directory for plugins and moves sample-plugin.mk there. Change-Id: I9e3ee8858580e86ff6d4f7317300df0a5e239a01 Signed-off-by: Pierre Pfister <ppfister@cisco.com>
2016-05-16VPP-65: Fix top-level "make install-dep" to work behind a firewall /Dave Wallace1-4/+4
proxy-server on Ubuntu. Change-Id: I3f662455728adb81ca5a079540d8a9c615a5b977 Signed-off-by: Dave Wallace <dwallacelf@gmail.com>
2016-05-13VPP-57 Add doxygen build dependenciesChris Luke1-4/+9
Change-Id: I764d8a440c050d753e0380e139f489d3085f17f4 Signed-off-by: Chris Luke <chrisy@flirble.org>
2016-05-13VPP-57 Add Doxygen to VPPChris Luke1-0/+25
- Configures Doxygen. - Adds a source filter to do magic on our use of the preprocessor to do constructor stuff to make Doxygen grok it better. - Adds a convenience helper to the root Makefile. - Adds a README.md to the root directory (and which Doxygem uses as its "mainpage". - Add several other documentative files. - Currently using SVG for call graphs, though this may have a load-time performance impact in browsers. Change-Id: I25fc6fb5bf634319dcb36a7f0e32031921c125ac Signed-off-by: Chris Luke <chrisy@flirble.org>
2016-05-07Switch to using -headless JDKEd Warnicke1-1/+6
By default, jdks bring a bunch of UI related things we don't need, so switch to headeless. Also, use default-jdk-headless for Ubuntu after 14.04. Use openjdk-8-jdk-headless for Ubuntu 14.04. Change-Id: I3cf14c39c9f59dc2f1beba8dfb19971f4b67f5a6 Signed-off-by: Ed Warnicke <eaw@cisco.com>
2016-05-04Fix for unattended in MakefileEd Warnicke1-1/+1
Also works around verify Change-Id: I79ac470ec3fa9943c3a0913ebfaaf91176eb9a81 Signed-off-by: Ed Warnicke <eaw@cisco.com>
2016-05-02Re-do java-8 handling, add unattended switch to toplevel MakefileDamjan Marion1-18/+21
Change-Id: Ifaea353be5b42bb6edbcfa0506d02b721c00e392 Signed-off-by: Damjan Marion <damarion@cisco.com>
2016-05-02VPP-33 Removing javah from Makefile. Merged as fix for Gerrit 884Keith Burns (alagalah)1-6/+0
Change-Id: I2d9d6a607ffa1a8788c1ce79770db8b2b9bae6fb Signed-off-by: Keith Burns (alagalah) <alagalah@gmail.com>
2016-05-02HONEYCOMB-10: jVpp - the new java API. Java code generationMaros Marsalek1-0/+6
The old japi has two main drawbacks: * it is not fully generated (requres manual coding for every new api call that returns data other thanstatus code) * it is not asynchronous from Java perspective (requires active wait loops - big overhead due to JNI boundary being crossed lots of times). The new api is lightweight (fully generated except for connect, disconenct and ping) and truly asynchronous (uses callbacks, utilities that offer java.util.concurrent.Future interface are also provided). Change-Id: I531080ef651e8a74f19210490c71d161221ab600 Signed-off-by: Marek Gradzki <mgradzki@cisco.com> Signed-off-by: Maros Marsalek <mmarsale@cisco.com> Signed-off-by: Ed Warnicke <eaw@cisco.com>
2016-04-28Fix for java8 releated breakage in make install-depEd Warnicke1-2/+2
Change-Id: I17ae3c7031a820746a3785a35b440e17430d0ac5 Signed-off-by: Ed Warnicke <eaw@cisco.com>
2016-04-28VPP-8: Set java-8 for JNIMarek Gradzki1-1/+14
Change-Id: Ia81713a72e3c48b1d97bbf3f20a908bbc4ebd3b1 Signed-off-by: Maros Marsalek <mmarsale@cisco.com> Signed-off-by: Marek Gradzki <mgradzki@cisco.com>
2016-04-28Update Makefile to add debuginfo RPMs for gdbThomas F Herbert1-1/+2
Change-Id: I29d8cc839565999e2fabe09d29c40e09aa1ea784 Signed-off-by: Thomas F Herbert <therbert@redhat.com>
2016-04-26Make automake silent rules defaultDamjan Marion1-2/+1
Change-Id: Ia504ccdac1deac20f20cf7fb76f78b2d8c505474 Signed-off-by: Damjan Marion <damarion@cisco.com>
2016-04-20ubuntu 16.04 build support. Supporting systemd with vpp.service files.Srivatsa Sangli1-1/+1
Incorporating review comments : modified debian/control dependencies Change-Id: Ib2fe85d81eb7f1803ef8f54294c7c18cd07c61ba Signed-off-by: Srivatsa Sangli <srivrama@cisco.com>
2016-04-20Python-API: Inital commit of Python bindings for the VPP API.Ole Troan1-1/+1
See: https://wiki.fd.io/view/VPP/Python_API Change-Id: If135fc32208c7031787e1935b399d930e0e1ea1f Signed-off-by: Ole Troan <ot@cisco.com>
2016-04-17dpdk socket-mem handling optimizationsDamjan Marion1-1/+1
- introduces default socket-mem size of 512 MB per socket - default socket-mem value is applied to all discovered CPU sockets - fixes bug when < 1024 socket-mem parameter is specified - for socket-mem < 1024 code prefers 2 MB pages - improves handling of manualy specified socket-mem values Change-Id: I9ef848108d7dd1228fbd82a5be49eb5277a93683 Signed-off-by: Damjan Marion <damarion@cisco.com>
2016-04-14Fix dependency install on Ubuntu 16.04Damjan Marion1-1/+1
Change-Id: I2a915a64c65ee78658ee782c0f16963024b8b2eb Signed-off-by: Damjan Marion <damarion@cisco.com>
2016-03-29Add DPDK 16.04-rc2 supportDamjan Marion1-1/+2
Can be used by specifying DPDK_VERSION=16.04-rc2 in the make command line Change-Id: I657b44d7ca22f1ef57756e7703088020fab12bc6 Signed-off-by: Damjan Marion <damarion@cisco.com>
2016-03-29Fix epl-release in make install-dep for rpmEd Warnicke1-1/+1
Change-Id: I01a7421dc58ee6683eb84482bb92dd6a519a21e8 Signed-off-by: Ed Warnicke <eaw@cisco.com>
2016-03-25Add build-root/*.rpm to .gitignoreEd Warnicke1-1/+10
Change-Id: I88398b5e538271efa4657851bf53c9b76a56b432 Signed-off-by: Ed Warnicke <eaw@cisco.com>
2016-03-18Add -y to apt-get install for install-dep targetEd Warnicke1-1/+1
This allows install-dep to be run non-interactively Change-Id: I5c3e55958ed16dd3d128bbad9f317d9f2428d41a Signed-off-by: Ed Warnicke <eaw@cisco.com>
2016-03-17Few additions to top-level MakefileDamjan Marion1-14/+34
* Added option to specify target platform (e.g. export PLATFORM=vpp_lite) * Added ctags targed to (re)build ctags database * Added cscope targed to (re)build cscope database Change-Id: I93feb7b458abe9fbd93000f75b7be24e3865f089 Signed-off-by: Damjan Marion <damarion@cisco.com>
2016-02-25add install-dep target to toplevel MakefileDamjan Marion1-0/+9
Change-Id: I9dbe6676086ef083729bec1774f544498d1ec3e5 Signed-off-by: Damjan Marion <damarion@cisco.com>
2016-02-23Few improvements in toplevel MakefileDamjan Marion1-4/+14
Change-Id: I896aed32499cd7159c4b6f3b165cab4e579f6153 Signed-off-by: Damjan Marion <damarion@cisco.com>
2016-02-10Add Top-Level Wrapper MakefileDamjan Marion1-0/+141
Change-Id: Ie3431986ddb42db8d331fcb3d34250a6ec9d9a02 Signed-off-by: Damjan Marion <damarion@cisco.com>