{"id":15655459,"url":"https://github.com/torxed/dumper","last_synced_at":"2025-03-24T01:44:23.539Z","repository":{"id":150500711,"uuid":"171894745","full_name":"Torxed/dumper","owner":"Torxed","description":"tcpdump monitor that rotates pcap's upon low disk space.","archived":false,"fork":false,"pushed_at":"2019-06-09T22:04:21.000Z","size":50,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-25T17:16:00.362Z","etag":null,"topics":["rotate","tcpdump"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Torxed.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":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-02-21T15:16:19.000Z","updated_at":"2019-06-09T22:04:23.000Z","dependencies_parsed_at":"2023-04-10T01:47:49.475Z","dependency_job_id":null,"html_url":"https://github.com/Torxed/dumper","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Torxed%2Fdumper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Torxed%2Fdumper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Torxed%2Fdumper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Torxed%2Fdumper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Torxed","download_url":"https://codeload.github.com/Torxed/dumper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245195908,"owners_count":20575936,"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":["rotate","tcpdump"],"created_at":"2024-10-03T12:59:21.000Z","updated_at":"2025-03-24T01:44:23.521Z","avatar_url":"https://github.com/Torxed.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dumper\n\n`tcpdump` monitor that rotates pcap's upon low disk space.\n\n# Installation\n\n## Dependencies\n\n * python3\n * python-systemd [lib]\n * python-psutil [lib] - (optional, but strongly recommended)\n\n## Manual installation\n\n    # mkdir -p /etc/dumper\n    # cp config.json /etc/dumper/\n    # chmod 440 /etc/dumper/*\n\n    # cp dumper.py /usr/bin/dumper.py\n    # chmod 440 /usr/bin/dumper.py\n    # chmod +x /usr/bin/dumper.py\n\n    # cp systemd/* /etc/systemd/system/\n\n# Running dumper\n\n    # systemctl enable dumper@eno1.service\n    # systemctl start dumper@eno1.service\n\nOr simply via any command line:\n\n    # python dumper.py --output=./capture_eno1_%Y-%m-%d_%H:%M:%S.pcap --interface=eno1 --partition=/ --reserved=10 --flushlimit=5 --config=/etc/config.json\n\n# Configuration\n\nMost tcpdump related configuration *(filters, parameters etc)* is done in `config.json`.\u003cbr\u003e\nBut dumper also takes parameters from the command-line/service scripts. For instance, a per-interface service script can be found under `systemd/` which uses the default config + sends in a interface to dump on.\n\nAny settings done in `config.json` after startup **will override any command line arguments**.\u003cbr\u003e\nBut command-line arguments will override `config.json` the launch.\n\n# Parameters\n\n    --interface=\u003cname\u003e - Which NIC to get network traffic from\n    --output=\u003cfilename\u003e - Outputs all traffic capture to this filename\n    --config=\u003cfilename\u003e - Load a config file and monitor for changes, reloads automatically.\n    --monitor_config=True - Monitor for configuration changes or not (Default True/Yes)\n    --partition=/ - Monitor for free space, pauses capture when we go below --reserved\n    --reserved=10 - Will pause capture when disk-space is below 10% (default)\n    --flushlimit=5 - Will delete old pcap's when disk space is below 5% (default)\n    --profile=\u003cprofile name\u003e - Which profile to run in the config\n                              (This option overrides \"profile\" in the config)\n    --instances=1 - How many threads should we run? (Default is 1)\n\n# Features\n\n * Reloads `config.json` in runtime upon changes to it. (Useful for swapping capturing profile)\n * Multiple `tcpdump` instances can be managed\n * Monitors disk usage, pauses all packet captures at `--reserved` space left.\n * Rotates `.pcap`'s when disk space falls below `--flushlimit`\n \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftorxed%2Fdumper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftorxed%2Fdumper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftorxed%2Fdumper/lists"}