{"id":20464583,"url":"https://github.com/bytedance/libtpa","last_synced_at":"2025-04-13T08:37:37.232Z","repository":{"id":211867293,"uuid":"728915672","full_name":"bytedance/libtpa","owner":"bytedance","description":"Libtpa(Transport Protocol Acceleration), a DPDK based userspace TCP stack implementation.","archived":false,"fork":false,"pushed_at":"2024-03-19T05:59:31.000Z","size":3380,"stargazers_count":119,"open_issues_count":7,"forks_count":16,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-03-27T00:13:18.332Z","etag":null,"topics":["dpdk","tcp","userspace-networking"],"latest_commit_sha":null,"homepage":"https://bytedance.github.io/libtpa/","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bytedance.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-12-08T01:24:02.000Z","updated_at":"2025-03-17T13:34:06.000Z","dependencies_parsed_at":"2024-03-19T07:12:16.631Z","dependency_job_id":"3cae311c-1fcf-4c9f-b8d3-f801e2b87fa6","html_url":"https://github.com/bytedance/libtpa","commit_stats":null,"previous_names":["bytedance/libtpa"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytedance%2Flibtpa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytedance%2Flibtpa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytedance%2Flibtpa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytedance%2Flibtpa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bytedance","download_url":"https://codeload.github.com/bytedance/libtpa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248685126,"owners_count":21145210,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dpdk","tcp","userspace-networking"],"created_at":"2024-11-15T13:15:42.342Z","updated_at":"2025-04-13T08:37:37.181Z","avatar_url":"https://github.com/bytedance.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"Libtpa(Transport Protocol Acceleration) is a DPDK based userspace TCP\nstack implementation.\n\nLibtpa is fast. It boosts the [redis benchmark](doc/redis.rst) performance\nmore than 5 times, from 0.21m rps to 1.14m rps. Meanwhile, the p99 latency\nis greatly decreased, from 0.815ms to 0.159ms.\n\nLibtpa is also sort of stable, all kudos to the comprehensive testing.\nLibtpa has more than 200 tests. Together with the testing arguments\nmatrix, it can result in a big variety of test cases. Therefore,\nmost of the bugs are captured before deployment.\n\n:warning: Although libtpa has been tested heavily inside Bytedance **data center**,\nit's still recommended to run as much testing as you can before deployment,\nfor libtpa is still under active development and it's just v1.0-**rc0**\nbeing released. Tons of changes have been made since the last stable release.\n\n# Embedded TCP Stack\n\nThere are two things that might be kind of special about libtpa.\n\nThe first one is that libtpa is an embedded TCP stack implementation that\nsupports run-to-completion mode only. It creates no datapath thread\nby itself. Instead, it's embedded in the application thread.\n\n# Acceleration for Specific TCP Connections\n\nThe other special thing about libtpa is that it's not a standalone\nTCP/IP stack implementation. Instead, it lives together with the host\nTCP/IP stack: libtpa just takes control of the specific TCP connections\nneeded to be accelerated. Taking redis as an example, if redis is\naccelerated by libtpa, then all TCP connections belonging to redis will\ngo to libtpa.  All other connections (TCP or none TCP, such as UDP)\ngo to where it belongs: the host stack.\n\nThere is a huge advantage about that. If libtpa crashes, except the\napplication accelerated by libtpa is affected, none other workloads\nwould be affected.\n\nHaving said that, it requires some special support from NIC. Section\nRequirements gives a bit more information about that.\n\n# Requirements\n\nDue to the novel design described above (to just accelerate some specific\nTCP connections), libtpa requires [flow bifurcation](https://doc.dpdk.org/guides/howto/flow_bifurcation.html) support from NIC.\n\nMost NICs have flow bifurcation support with the help of SR-IOV.\nBut they require some internal DPDK/Linux patches (or even firmwares)\nto satisfy the libtpa needs.\n\nOn the other hand, Mellanox NIC has native flow bifurcation support\nthat doesn't require SR-IOV. More importantly, it doesn't require any\ninternal stuff. Libtpa works well with Mellanox NIC just with the\nupstream DPDK.\n\nTherefore, libtpa currently only supports Mellanox NIC.\n\n# What's Next\n\nYou might want to check below docs for more detailed information:\n\n-  [quick start guide](doc/quick_start.rst)\n-  [user guide](doc/user_guide.rst)\n-  [programming guide](doc/prog_guide.rst)\n-  [contribution guide](CONTRIBUTING.md)\n-  [internals](doc/internals.rst)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbytedance%2Flibtpa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbytedance%2Flibtpa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbytedance%2Flibtpa/lists"}