{"id":13650834,"url":"https://github.com/scapy-unroot/scapy_unroot","last_synced_at":"2025-04-22T18:32:52.945Z","repository":{"id":57464224,"uuid":"261143271","full_name":"scapy-unroot/scapy_unroot","owner":"scapy-unroot","description":"Daemon and tooling to enable using scapy without root permissions.","archived":false,"fork":false,"pushed_at":"2020-05-04T10:50:21.000Z","size":212,"stargazers_count":7,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-11T09:19:00.141Z","etag":null,"topics":["pypi","scapy","scapywithoutroot"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/scapy-unroot/","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/scapy-unroot.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}},"created_at":"2020-05-04T10:27:24.000Z","updated_at":"2024-09-01T09:21:24.000Z","dependencies_parsed_at":"2022-09-26T17:51:42.058Z","dependency_job_id":null,"html_url":"https://github.com/scapy-unroot/scapy_unroot","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/scapy-unroot%2Fscapy_unroot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scapy-unroot%2Fscapy_unroot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scapy-unroot%2Fscapy_unroot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scapy-unroot%2Fscapy_unroot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/scapy-unroot","download_url":"https://codeload.github.com/scapy-unroot/scapy_unroot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223903214,"owners_count":17222497,"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":["pypi","scapy","scapywithoutroot"],"created_at":"2024-08-02T02:00:41.457Z","updated_at":"2024-11-10T01:31:13.893Z","avatar_url":"https://github.com/scapy-unroot.png","language":"Python","readme":"[![Supported Python versions]](https://pypi.org/project/scapy-unroot)\n[![PyPI version]](https://badge.fury.io/py/scapy-unroot)\n[![Build Status]](https://travis-ci.com/scapy-unroot/scapy_unroot)\n[![codecov]](https://codecov.io/gh/scapy-unroot/scapy_unroot)\n\n[PyPI version]: https://badge.fury.io/py/scapy-unroot.svg\n[Supported Python versions]: https://img.shields.io/pypi/pyversions/scapy-unroot.svg\n[Build Status]: https://travis-ci.com/scapy-unroot/scapy_unroot.svg?branch=master\n[codecov]: https://codecov.io/gh/scapy-unroot/scapy_unroot/branch/master/graph/badge.svg\n\n# scapy-unroot\nDaemon and tooling to enable using [scapy] without root permissions.\n\n## Installation\n`scapy_unroot` can be installed by just running\n\n```sh\npip install scapy_unroot\n```\n\nThe requirements also installed by this are listed in\n[`requirements.txt`](./requirements.txt).\n\n## Usage\n### The `scapy-unroot` daemon\nThe daemon to allow usage of scapy without root permissions requires root\nitself. You can start it with the following command:\n\n```sh\nsudo scapy-unroot scapy\n```\n\nThe provided argument `scapy` should be a permission group, users who are\nallowed to use scapy without root permissions should be in.\n\nBy default, all files related to `scapy_unroot` are managed in the directory\n`/var/run/scapy-unroot`. You can change that directory using the `-r` /\n`--run-dir` argument:\n\n```sh\nsudo scapy-unroot --run-dir /tmp scapy\n```\n\nThe UNIX domain socket to communicate with the daemon will be created under the\nname `server-socket` in that directory.\n\nNetwork interfaces that users of `scapy_unroot` should not be able to send over\nor sniff on can be blacklisted using the `-b` / `--interface-blacklist`\nargument. Multiple interfaces can be provided:\n\n```sh\nsudo scapy-unroot scapy --interface-blacklist wlan0 eth0 lo\n```\n\nTo run the daemon in background, use the `-d` / `--daemonize` parameter:\n\n```sh\nsudo scapy-unroot -d scapy\n```\n\nTo get more information on the arguments of the `scapy-unroot` daemon, run\n\n```sh\nsudo scapy-unroot -h\n```\n\nAll arguments described above can be combined.\n\n### Configuring scapy to communicate with the daemon\nBefore sending or sniffing with scapy, just do\n\n```py\nfrom scapy_unroot import configure_sockets\n\nconfigure_sockets()\n```\n\nYou can provide a different server address by the _server_addr_ argument. The\ndefault is `/var/run/scapy_unroot/server-socket`.\n\nYou can also configure the timeout for waiting for a reply from the server using\nthe _connection_timeout_ argument.\n\n[scapy]: https://scapy.net/\n","funding_links":[],"categories":["Tools"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscapy-unroot%2Fscapy_unroot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscapy-unroot%2Fscapy_unroot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscapy-unroot%2Fscapy_unroot/lists"}