{"id":13547286,"url":"https://github.com/microsoft/ntttcp-for-linux","last_synced_at":"2025-05-15T17:03:23.718Z","repository":{"id":46499231,"uuid":"43908982","full_name":"microsoft/ntttcp-for-linux","owner":"microsoft","description":"A Linux network throughput multiple-thread benchmark tool.","archived":false,"fork":false,"pushed_at":"2025-02-04T22:26:19.000Z","size":392,"stargazers_count":408,"open_issues_count":24,"forks_count":94,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-05-15T00:08:28.933Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/Microsoft/ntttcp-for-linux","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microsoft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-10-08T18:36:46.000Z","updated_at":"2025-04-28T10:55:57.000Z","dependencies_parsed_at":"2024-01-14T16:13:50.127Z","dependency_job_id":"eb51e754-e4ec-4701-8b4a-173059ba4e3d","html_url":"https://github.com/microsoft/ntttcp-for-linux","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fntttcp-for-linux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fntttcp-for-linux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fntttcp-for-linux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fntttcp-for-linux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsoft","download_url":"https://codeload.github.com/microsoft/ntttcp-for-linux/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254384937,"owners_count":22062421,"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":[],"created_at":"2024-08-01T12:00:53.430Z","updated_at":"2025-05-15T17:03:23.699Z","avatar_url":"https://github.com/microsoft.png","language":"C","readme":"# NTTTCP-for-Linux\n\n## Summary\n\nA multiple-threaded Linux network throughput benchmark tool.\n\n## Features\n\n* Multiple threads to send/receive data ('-P', '-n', and '-l'). By default, Receiver ('-r') uses 16 threads and Sender ('-s') uses 64 threads to exchange data.\n\n* Support cpu affinity ('-m').\n\n* Support running in background (daemon, '-D').\n\n* Support Sender and Receiver sync mode by default. Use \"-N\" (no_sync) to disable the sync.\n\n* Support testing with multiple clients mode (use '-M' on Receiver, and '-L' on the last Sender).\n\n* Support select() by default, and epoll() (use '-e' on Receiver).\n\n* Support both TCP (by default), and UDP ('-u') tests.\n\n* Support pin TCP server or client port (use '-p' on Receiver or '-f' on Sender).\n\n* Support test Warmup ('-W') and Cooldown ('-C').\n\n* Support reporting TCP retransmit ('--show-tcp-retrans').\n\n* Support reporting number of packets ('--show-nic-packets') and number of interrupts ('--show-dev-interrupts').\n\n* Support bandwidth limit ('-B' or '--fq-rate-limit').\n\n* Support capturing console log to file ('-O').\n\n* Support writing log into XML file ('-x').\n\n* Support writing log into JSON file ('-j').\n\n\n## Getting Started\n\n\n### Building NTTTCP-for-Linux ###\n\n- Using `make`:\n```\n\tmake; make install\n```\n\n- Using `CMake`:\n```\n\tcd src\n\tmkdir build \u0026\u0026 cd build\n\tcmake ..\n\tmake \u0026\u0026 make install\n```\n\n### Usage\n\t\n\tntttcp -h\n\n### Known issues\n\n \n\n### Example run\n\nTo measure the network performance between two multi-core serves running SLES 12, NODE1 (192.168.4.1) and NODE2 (192.168.4.2), connected via a 40 GigE connection. \n\nOn NODE1 (the receiver), run:\n```\n./ntttcp -r\n```\n(Translation: Run ntttcp as a receiver with default setting. The default setting includes: with 16 threads created and run across all CPUs, allocating 64K receiver buffer, and run for 60 seconds.)\n\nAnd on NODE2 (the sender), run:\n```\n./ntttcp -s192.168.4.1\n```\n(Translation: Run ntttcp as a sender, with default setting. The default setting includes: with 64 threads created and run across all CPUs, allocating 128KB sender buffer, and run for 60 seconds.)\n\nUsing the above parameters, the program returns results on both the sender and receiver nodes, correlating network communication to CPU utilization.  \n\nExample receiver-side output from a given run (which showcases 37.66 Gbps throughput):\n\n```\nNODE1:/home/simonxiaoss/ntttcp-for-linux/src # ./ntttcp -s 10.0.0.1 -W 1 -t 10 -C 1\nNTTTCP for Linux 1.3.4\n---------------------------------------------------------\n22:36:30 INFO: Network activity progressing...\n22:36:30 INFO: 64 threads created\n22:36:31 INFO: Test warmup completed.\n22:36:42 INFO: Test run completed.\n22:36:42 INFO: 64 connections tested\n22:36:42 INFO: #####  Totals:  #####\n22:36:42 INFO: test duration    :10.36 seconds\n22:36:42 INFO: total bytes      :30629953536\n22:36:42 INFO:   throughput     :23.65Gbps\n22:36:42 INFO: cpu cores        :20\n22:36:42 INFO:   cpu speed      :2394.455MHz\n22:36:42 INFO:   user           :3.60%\n22:36:42 INFO:   system         :3.44%\n22:36:42 INFO:   idle           :91.57%\n22:36:42 INFO:   iowait         :0.00%\n22:36:42 INFO:   softirq        :1.38%\n22:36:42 INFO:   cycles/byte    :1.37\n22:36:42 INFO: cpu busy (all)   :159.81%\n---------------------------------------------------------\n22:40:52 INFO: Test cooldown is in progress...\n22:40:52 INFO: Test cycle finished.\n```\n\n# Related topics\n\n1. [Windows ntttcp.exe](https://github.com/microsoft/ntttcp)\n\n2. [Use ntttcp to test network throughput](https://docs.microsoft.com/en-us/azure/virtual-network/virtual-network-bandwidth-testing)\n\n3. [Linux Integration Services Automation, LISA](https://github.com/microsoft/lisa)\n\n\n## Terms of Use\n\nBy downloading and running this project, you agree to the license terms of the third party application software, Microsoft products, and components to be installed. \n\nThe third party software and products are provided to you by third parties. You are responsible for reading and accepting the relevant license terms for all software that will be installed. Microsoft grants you no rights to third party software.\n\n\n## License\n\n```\nThe MIT License (MIT)\n\nCopyright (c) 2015 Microsoft Corporation\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n","funding_links":[],"categories":["C","Network Tools","others","Network Dev\u0026Ops工具与服务"],"sub_categories":["Performance Testing \u0026 Benchmarking"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fntttcp-for-linux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosoft%2Fntttcp-for-linux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fntttcp-for-linux/lists"}