{"id":13389582,"url":"https://github.com/DNS-OARC/drool","last_synced_at":"2025-03-13T14:31:31.659Z","repository":{"id":48638634,"uuid":"76473398","full_name":"DNS-OARC/drool","owner":"DNS-OARC","description":"DNS Replay Tool","archived":false,"fork":false,"pushed_at":"2024-11-12T16:11:29.000Z","size":277,"stargazers_count":80,"open_issues_count":2,"forks_count":10,"subscribers_count":12,"default_branch":"develop","last_synced_at":"2025-03-01T00:46:55.063Z","etag":null,"topics":["dns","dnsjit","lua","testing"],"latest_commit_sha":null,"homepage":"https://www.dns-oarc.net/tools/drool","language":"Lua","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/DNS-OARC.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":"https://www.dns-oarc.net/donate"}},"created_at":"2016-12-14T15:44:37.000Z","updated_at":"2024-11-12T16:11:34.000Z","dependencies_parsed_at":"2024-01-15T02:30:00.171Z","dependency_job_id":"69f273fa-488f-4d01-864c-40a7efb6236a","html_url":"https://github.com/DNS-OARC/drool","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DNS-OARC%2Fdrool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DNS-OARC%2Fdrool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DNS-OARC%2Fdrool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DNS-OARC%2Fdrool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DNS-OARC","download_url":"https://codeload.github.com/DNS-OARC/drool/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243422496,"owners_count":20288468,"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":["dns","dnsjit","lua","testing"],"created_at":"2024-07-30T13:01:20.967Z","updated_at":"2025-03-13T14:31:31.330Z","avatar_url":"https://github.com/DNS-OARC.png","language":"Lua","funding_links":["https://www.dns-oarc.net/donate"],"categories":["Lua","Lua (24)"],"sub_categories":[],"readme":"# DNS Replay Tool (drool)\n\n`drool` can replay DNS traffic from packet capture (PCAP) files and send\nit to a specified server, with options such as to manipulate the timing\nbetween packets, as well as loop packets infinitely or for a set number\nof iterations. This tool's goal is to be able to produce a high amount\nof UDP packets per second and TCP sessions per second on common hardware.\n\nThe purpose can be to simulate Distributed Denial of Service (DDoS) attacks\non the DNS and measure normal DNS querying. For example, the tool could\nenable you to take a snapshot of a DDoS and be able to replay it later\nto test if new code or hardening techniques are useful, safe \u0026 effective.\nAnother example is to be able to replay a packet stream for a\nbug that is sequence- and/or timing-related in order to validate the\nefficacy of subsequent bug fixes.\n\nMore information may be found here:\n- https://www.dns-oarc.net/tools/drool\n\nIssues should be reported here:\n- https://github.com/DNS-OARC/drool/issues\n\nGeneral support and discussion:\n- Mattermost: https://chat.dns-oarc.net/community/channels/oarc-software\n\n## Known Issues\n\n- IP fragments are currently not processed and will be discarded.\n- TCP sessions are not reassembled, each packet is parsed as DNS after\n  discarding the first two bytes.\n\n## Usage example\n\nSend all DNS queries twice as fast as found in the PCAP file to localhost\nusing UDP.\n\n```shell\ndrool replay --timing multiply=0.5 --no-tcp file.pcap 127.0.0.1 53\n```\n\nSend all DNS queries over TCP to localhost as they were recorded.\n\n```shell\ndrool replay --timing keep --no-udp file.pcap 127.0.0.1 53\n```\n\nTake all DNS queries found in the PCAP file and send them as fast as possible\nover UDP to localhost by ignoring both timings, replies and starting 3 threads\nthat will simultaneously send queries.\n\n```shell\ndrool replay --no-tcp --no-responses --threads --udp-threads 3 file.pcap 127.0.0.1 53\n```\n\n## Dependencies\n\n`drool` is built upon [dnsjit](https://github.com/DNS-OARC/dnsjit) and\nrequires it to be installed along with autoconf/automake.\n\n## Build\n\n```\nsh autogen.sh\n./configure\nmake\nmake test\nmake install\n```\n\n## Author(s)\n\nJerry Lundström \u003cjerry@dns-oarc.net\u003e\n\n## Copyright\n\nCopyright (c) 2017-2021, OARC, Inc.\n\nCopyright (c) 2017, Comcast Corporation\n\nAll rights reserved.\n\n```\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n\n1. Redistributions of source code must retain the above copyright\n   notice, this list of conditions and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright\n   notice, this list of conditions and the following disclaimer in\n   the documentation and/or other materials provided with the\n   distribution.\n\n3. Neither the name of the copyright holder nor the names of its\n   contributors may be used to endorse or promote products derived\n   from this software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS\nFOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE\nCOPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,\nINCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,\nBUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\nLOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\nCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\nLIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN\nANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE\nPOSSIBILITY OF SUCH DAMAGE.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDNS-OARC%2Fdrool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDNS-OARC%2Fdrool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDNS-OARC%2Fdrool/lists"}