[[eupf_setup]]
== eupf setup

[[eupf_install]]
=== eupf install

Install eupf dependencies:
----
$ sudo apt install wget git clang llvm gcc-multilib libbpf-dev
----

Download eupf:
----
$ mkdir $HOME/git
$ cd $HOME/git
$ git clone https://github.com/edgecomllc/eupf.git
----

Install swag:
----
$ cd $HOME
$ go install github.com/swaggo/swag/cmd/swag@v1.8.12
----

Add to .bashrc:
----
$ export PATH="${HOME}/go/bin:/usr/local/go/bin:${PATH}"
----

Build & install eupf:
----
$ cd ~/git/eupf
$ go generate -v ./cmd/...
$ go build -v -o bin/eupf ./cmd/
$ sudo cp bin/eupf /usr/local/bin/eupf
----

[[eupf_debug]]
=== eupf debug

To enable XDP tracing, recompile like this:
----
$ cd ~/git/eupf
$ BPF_CFLAGS="-DENABLE_LOG" go generate -v ./cmd/...
$ go build -v -o bin/eupf ./cmd/
$ sudo cp bin/eupf /usr/local/bin/eupf
----

Then start eupf, run the test, cat will keep reading until killed, and you'll get output generated by the xdp code:
----
$ cat /sys/kernel/debug/tracing/trace_pipe
----