A Multipath TCP Python library. We encourage users to activate notifications since the library is still in it's early stages and the API may change. Certain functions are available starting from a specific kernel releases, we encourage the user's to check the MPTCP kernel implementation changelog.
For a deeper read about Multipath TCP, please consult this webpage.
- Example Usage
- Description
- License
To be able to use the library we encourage to install using PyPi. Run the following command:
pip install mptcplib
Below you can find an example of a typical socket script :
import mptcplib
import socket
sock = mptcplib.create_mptcp_socket(socket.AF_INET, socket.SOCK_STREAM):
# Do things ...
if mptcplib.is_socket_mptcp(sock):
# Do things in case of an MPTCP socket ...
used_subflows = mptcplib.get_nb_used_subflows(sock)
else:
# Handle fallback to standard TCP ...
sock.close()There are other useful functions i.e : Check if the os supports MPTCP and that it is enabled. We intend to add more functions that are supported by the kernel implementation.
The library is currently supported on Linux kernels but the goal will be to extend it to MacOS. Below is a table containing operating systems that supports Multipath TCP and their support in mptcplib.
| Operating System | mptcplib support |
|---|---|
| Linux based (kernel >= 5.6) | Yes |
| MacOS (Big Sur, Ventura) | Not yet |
Pull requests are more than welcome. For major changes, please open an issue discussing what you would like to change.
To install the library in developper mode run the following command in the root directory:
make dev-install
In order to run the tests, you have to first install the library in developper mode then you can follow up with:
make test
The repository is under the MIT License, welcoming anybody to play with the codebase.