PI LIBRARY REPOSITORY

This repository has submodules; after cloning it you should run git submodule update --init --recursive.

Dependencies

Base dependencies

• Judy

Dependencies based on configure flags

Based on the command-line flags you intend on providing to configure, you need to install different dependencies.

Configure flag	Default (yes / no)	Dependencies	Remarks
--with-bmv2	no	bmv2 and its deps	Implies --with-fe-cpp
--with-proto	no	protobuf, grpc	-
--with-fe-cpp	no	-	-
--with-internal-rpc	yes	nanomsg	-
--with-cli	yes	readline	-
--with-sysrepo	no	same as --with-proto + sysrepo and its deps	-

Additional CI tests dependencies

• libtool binary; we use libtool as part of the build system, libtool binary is required to run some of the generated binaries uner valgrind
• valgrind, as some tests use it to check for memory errors
• Boost library, for some of the C++ tests: we currently require boost/optional.hpp and boost/functional/hash.hpp

Installing dependencies from package repositories

Dependency	Name of Debian package
Judy	libjudy-dev
readline	libreadline-dev
valgrind	valgrind
libtool binary	libtool-bin
Boost library	libboost-dev libboost-system-dev

Installing other dependencies from source

Some dependencies are not available as Debian packages or the available version is not the right one.

• bmv2 and all its dependencies: follow instructions in the bmv2 README
• nanomsg 1.0.0
• protobuf v3.2.0:

git clone https://github.com/google/protobuf.git
cd protobuf/
git checkout tags/v3.2.0
./autogen.sh
./configure
make
[sudo] make install
[sudo] ldconfig

• grpc v1.3.2:

git clone https://github.com/google/grpc.git
cd grpc/
git checkout tags/v1.3.2
git submodule update --init --recursive
make
[sudo] make install
[sudo] ldconfig

• sysrepo and all its dependencies: see instructions in proto/README.md

You may be able to use more recent versions of nanomsg, protobuf or grpc, but the versions above are the ones we use for development and testing.

Building p4runtime.proto

To include p4runtime.proto in the build, please run configure with --with-proto.

./autogen.sh
./configure --with-proto --without-internal-rpc [--without-cli]
make
make check
[sudo] make install

PI CLI

For now the PI CLI supports an experimental version of table_add and table_delete. Because these two functions have been implemented in the bmv2 PI implementation, you can test the PI CLI with the bmv2 simple_switch. Assuming bmv2 is installed on your system, build the PI and the CLI with ./configure --with-bmv2 && make. You can then experiment with the following commands:

simple_switch tests/testdata/simple_router.json  // to start the switch
./CLI/pi_CLI_bmv2 -c tests/testdata/simple_router.json  // to start the CLI
PI CLI> assign_device 0 0 -- port=9090  // 0 0 : device id + config id
PI CLI> table_add ipv4_lpm 10.0.0.1/24 => set_nhop 10.0.0.1 1
PI CLI> table_dump ipv4_lpm
PI CLI> table_delete ipv4_lpm <handle returned by table_add>

Contributing

All contributed code must pass the style checker, which can be run with ./tools/check_style.sh. If the style checker fails because of a C file, you can format this C file with ./tools/clang_format_check.py -s Google -i <file>.