{"id":27268753,"url":"https://github.com/shadow/tgen","last_synced_at":"2025-06-12T04:15:53.231Z","repository":{"id":40363930,"uuid":"170371063","full_name":"shadow/tgen","owner":"shadow","description":"A powerful traffic generator that can model complex behaviors using Markov models and an action-dependency graph.","archived":false,"fork":false,"pushed_at":"2023-12-31T00:04:05.000Z","size":1119,"stargazers_count":37,"open_issues_count":4,"forks_count":24,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-12T02:48:47.472Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shadow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2019-02-12T18:40:19.000Z","updated_at":"2025-03-08T10:49:01.000Z","dependencies_parsed_at":"2023-12-30T15:25:59.375Z","dependency_job_id":"4feee8a7-5f6f-4b41-b973-ba2a894e9f48","html_url":"https://github.com/shadow/tgen","commit_stats":{"total_commits":396,"total_committers":13,"mean_commits":30.46153846153846,"dds":0.25,"last_synced_commit":"77a0d12eb09b89816b8b8141e930a7c759cd3cac"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadow%2Ftgen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadow%2Ftgen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadow%2Ftgen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadow%2Ftgen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shadow","download_url":"https://codeload.github.com/shadow/tgen/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248384012,"owners_count":21094657,"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":"2025-04-11T11:31:56.778Z","updated_at":"2025-04-11T11:32:17.785Z","avatar_url":"https://github.com/shadow.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"## TGen\n\n![](https://github.com/shadow/tgen/workflows/Tests/badge.svg)\n\nTGen is a C application that generates traffic flows between other\nTGen instances. The characteristics of the traffic (e.g., size, timing,\nnumber of parallel flows, etc.) can be configured by the user.\n\nTGen can generate complex traffic patterns. Users write relatively simple\npython3 scripts to generate `graphml` files that are then used as TGen\nconfiguration files that instruct TGen how to generate traffic. TGen also\nsupports the use of Markov models in order to generate TCP flows and packet\nstreams according to common probability distributions.\n\nTGen is used to simulate traffic flows in [Shadow](https://github.com/shadow/shadow),\nand to monitor Tor performance in [OnionPerf](https://gitweb.torproject.org/onionperf.git).\n\n## Setup\n\nDependencies:\n\n- CMake\n- GLib 2.0\n- IGraph\n\nDependencies in Fedora/RedHat:\n\n    sudo yum install cmake glib2-devel igraph-devel\n\nDependencies in Ubuntu/Debian:\n\n    sudo apt-get install cmake libglib2.0-dev libigraph-dev\n\nBuild with a custom install prefix:\n\n    mkdir build \u0026\u0026 cd build\n    cmake .. -DCMAKE_INSTALL_PREFIX=$HOME/.local\n    make\n\nOptionally install to the prefix:\n\n    make install\n\n## Usage\n\nRun TGen with a single argument (the path to a config file). For example,\nfirst run a server:\n\n    tgen resource/server.tgenrc.graphml \u003e tgen.server.log\n\nand then run a client that connects to the server:\n\n    tgen resource/client.tgenrc.graphml \u003e tgen.client.log\n\nSee the [resource/](resource) directory for example config files.\n\n## More documentation\n\nSee [tools/README.md](tools/README.md) for setup instructions for\nthe TGenTools toolkit that can be used to parse and plot `tgen` log output.\n\nSee [doc/TGen-Overview.md](doc/TGen-Overview.md) for an overview of how to use\na graph to instruct TGen how it should generate traffic, and then see\n[doc/TGen-Options.md](doc/TGen-Options.md) for a description of all options\nsupported by TGen.\n\nSee [doc/TGen-Markov-Models.md](doc/TGen-Markov-Models.md) for a description\nof how to create and use Markov models to instruct TGen how to generate\nstreams in a traffic flow and packets in a stream.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshadow%2Ftgen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshadow%2Ftgen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshadow%2Ftgen/lists"}