Development

Docker

Debugging

To debug docker images using e.g. gdb the docker images has to be started with the following options

 $ docker run --rm -it --cap-add=SYS_PTRACE --security-opt seccomp=unconfined <DOCKER-IMAGE-NAME>                                                

Alpine / musl-libc

There are some known issues concerning the project itself, gRPC and musl-libc. Even though the projects builds and the chord peer boostraps successfully there are several runtime issues described in the sections below.

gRPC Streaming API

Though normal requests work as expected the gRPC streaming API will immediately return false when invoking ClientWriter's Write()-method (broken stream).

Thread stack size

According to the functional differences from glibc the default stack size is ~80k. This will cause a segfault within chord.fs.client.cc during allocating the send-buffer (512*1024 bytes).