mptcp-pm: A work in progress Multipath TCP path manager

[ gpl, network, program ] [ Propose Tags ]

Multipath TCP ( starting from version 0.95 provides a netlink path manager module. This package implements the userspace part to allow userspace daemons to control MPTCP behavior.

[Skip to Readme]
Versions [faq] 0.0.1, 0.0.2
Change log CHANGELOG
Dependencies aeson, base (>=4.12 && <4.20), bytestring, bytestring-conversion, c2hsc, cereal, containers, fast-logger, ip, netlink (>=, optparse-applicative, process [details]
License GPL-3.0-only
Maintainer teto
Category Network
Home page
Source repo head: git clone
Uploaded by teto at Wed Jul 3 07:18:28 UTC 2019
Distributions NixOS:0.0.2
Executables short, monitor, daemon
Downloads 440 total (104 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs not available [build log]
All reported builds failed as of 2019-07-03 [all 2 reports]



Develop with a local netlink library


Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info


Maintainer's Corner

For package maintainers and hackage trustees

Readme for mptcp-pm-0.0.1

[back to package description]

This is a rewrite in haskell of the python netlink module. nix-shell -p 'haskellPackages.ghcWithHoogle(p: with p; [netlink optparse-applicative ])'

The netlink module asks for GENL_ADMIN_PERM => The operation requires the CAP_NET_ADMIN privilege

sudo setcap cap_net_admin+ep hs/dist-newstyle/build/x86_64-linux/ghc-8.6.3/netlink-pm-1.0.0/x/daemon/build/daemon/daemon

Netlink explanation

To fetch TCP diagnostics: Creates a socket with family eNETLINK_INET_DIAG (really NETLINK_SOCK_DIAG) with value 4 AF_INET => netlink family 2


With a custom netlink and kernel Compile the custom netlink library with

$ cabal configure --enable-library-profiling
kernel $ make headers_install
$ cabal configure --package-db /home/teto/netlink-hs/dist/package.conf.inplace --extra-include-dirs=/home/teto/mptcp2/build/usr/include -v3 --enable-profiling


Enter the nix-shell shell-test.nix and start the daemon:

$ cabal run daemon

or $ buildNRun To print a stacktrace cabal run daemon toto -- +RTS -xc

In a shell: $ nix run nixpkgs.iperf -c iperf -s

In another: $ nix run nixpkgs.iperf -c iperf -c localhost -b 1KiB -t 4 --cport 5500 -4

TODO: ss package sends by default

-- #define SS_ALL ((1 << SS_MAX) - 1)
-- #define SS_CONN (SS_ALL & ~((1<<SS_LISTEN)|(1<<SS_CLOSE)|(1<<SS_TIME_WAIT)|(1<<SS_SYN_RECV)))
  • [ ] write wordToEnums function, especially to fix getSockDiagRequestHeader (with bitset package once it's fixed)



  • conversion of IDiagExt is bad everywhere ? req.r.idiag_ext |= (1<<(INET_DIAG_INFO-1));
  • we need to request more states


  • pass local/server IPs as commands to the PM ?
  • generate completion scripts via --zsh-completion-script
  • to get kernel ifindex: cat /sys/class/net/lo/ifindex