{"full_name":"Gallopsled/pwntools","owner":"Gallopsled","name":"pwntools","shard":"1","url":"https://github.com/Gallopsled/pwntools","description":"CTF framework and exploit development library","homepage":"http://pwntools.com","topics":["ctf","exploit","python","pwntools","assembly","ctf-framework","shellcode","rop","pwnable","defcon","capture-the-flag","wargame","python2","python3","linux"],"tag_pages":["assembly","ctf","exploit","linux","python","python3"],"language":"Python","license":"NOASSERTION","avatar":"https://avatars.githubusercontent.com/u/4292577?v=4","created_at":"2013-04-29T14:43:03Z","pushed_at":"2026-11-08T07:49:08Z","metrics":{"stars":13864,"forks":1877,"watchers":272,"issues":1138,"prs":1639,"releases":80,"issues_open":89,"issues_closed":1049,"prs_open":32,"prs_closed":301,"prs_merged":1306,"discussions":9},"growth":{"day":{"stars":4,"forks":1,"base_day":"2026-11-15"},"week":{"stars":43,"forks":4,"base_day":"2026-11-04"},"month":{"stars":93,"forks":13,"base_day":"2026-10-17"}},"history":{"dates":["2026-09-06","2026-09-07","2026-09-08","2026-09-09","2026-09-10","2026-09-11","2026-09-12","2026-09-13","2026-09-14","2026-09-15","2026-09-16","2026-09-17","2026-09-18","2026-09-19","2026-09-20","2026-09-21","2026-09-22","2026-09-23","2026-09-24","2026-09-25","2026-09-26","2026-09-27","2026-09-28","2026-09-29","2026-09-30","2026-10-01","2026-10-02","2026-10-03","2026-10-04","2026-10-05","2026-10-06","2026-10-07","2026-10-08","2026-10-09","2026-10-10","2026-10-11","2026-10-12","2026-10-13","2026-10-14","2026-10-15","2026-10-16","2026-10-17","2026-10-18","2026-10-19","2026-10-20","2026-10-21","2026-10-22","2026-10-23","2026-10-24","2026-10-25","2026-10-26","2026-10-27","2026-10-28","2026-10-29","2026-10-30","2026-10-31","2026-11-01","2026-11-02","2026-11-03","2026-11-04","2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[13675,13676,13677,13680,13684,13686,13689,13694,13692,13694,13699,13701,13703,13704,13707,13711,13711,13715,13716,13717,13720,13722,13723,13725,13728,13732,13735,13737,13739,13743,13745,13744,13745,13747,13747,13751,13754,13757,13761,13766,13768,13771,13776,13777,13786,13787,13790,13790,13789,13790,13790,13789,13789,13795,13798,13802,13802,13804,13805,13821,13845,13849,13856,13857,13857,13860,13864],"forks":[1853,1854,1854,1853,1854,1855,1855,1854,1854,1854,1854,1854,1854,1854,1855,1855,1857,1858,1859,1859,1859,1859,1858,1858,1858,1858,1858,1858,1858,1858,1857,1857,1857,1857,1858,1862,1862,1862,1862,1863,1864,1864,1864,1865,1866,1866,1865,1865,1867,1869,1869,1869,1869,1868,1870,1869,1869,1871,1872,1873,1875,1874,1874,1874,1875,1876,1877],"watchers":[274,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,275,274,274,274,274,274,274,274,274,274,274,274,274,272,272,272,272,272,272,272,272,272,272,272,null,272,272,272,272,272,272],"issues_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,87,87,87,88,89,89],"prs_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,32,32,32,32,32,32]},"boards":{},"same_owner":[],"issues":[{"number":2731,"title":"GDB is stuck in kitty","comments":12,"created_at":"2026-05-08T13:25:16Z"},{"number":2705,"title":"cannot Ctrl-C remote connection when network is flaky","comments":11,"created_at":"2026-03-24T14:59:32Z"},{"number":1628,"title":"add dockerized tube for better pwning","comments":10,"created_at":"2020-07-04T04:38:32Z"},{"number":932,"title":"Automatic finding one-gadget","comments":10,"created_at":"2017-03-24T06:51:33Z"},{"number":2002,"title":"Switch tests to use pytest","comments":9,"created_at":"2021-11-25T01:11:54Z"},{"number":1236,"title":"Feature: Async IO?","comments":9,"created_at":"2018-12-18T03:54:30Z"},{"number":1976,"title":"UDP recv works in Python console, does not work when executed as python3 exploit.py","comments":6,"created_at":"2021-10-05T10:36:14Z"},{"number":2433,"title":"gdb.debug stops at every breakpoint, running slow","comments":5,"created_at":"2024-08-02T10:58:02Z"}],"discussions":[{"number":2779,"title":"Show prompt or recentoutut in clli stream","comments":1,"category":"General","created_at":"2026-09-15T06:06:57Z"},{"number":2412,"title":"syscall execve ignores the -c parameter","comments":0,"category":"Q&A","created_at":"2024-05-25T03:50:05Z"},{"number":2404,"title":"Switch to different zstandard library?","comments":1,"category":"General","created_at":"2024-05-11T21:56:48Z"},{"number":2340,"title":"pwntools cannot handle SIGSEGV in my Archlinux","comments":2,"category":"Q&A","created_at":"2024-01-28T19:01:41Z"},{"number":2292,"title":"debug with tmux","comments":2,"category":"Q&A","created_at":"2023-11-01T14:08:32Z"},{"number":2138,"title":"How do I exit interactive mode gracefully?","comments":1,"category":"Q&A","created_at":"2022-11-19T21:52:53Z"},{"number":2109,"title":"Is it possible to log to `context.log_file` with a different log level than used with stdout?","comments":1,"category":"Q&A","created_at":"2022-09-18T05:50:44Z"},{"number":2099,"title":"Welcome to pwntools Discussions!","comments":0,"category":"General","created_at":"2022-08-22T08:40:20Z"}],"latest_release":{"name":"Release 4.15.0","tag":"4.15.0","published_at":"2025-10-12T15:16:44Z","body":"# This is the last release supporting Python 2 and Python <3.10. See #2495\r\n\r\nThis release comes with a bunch of fixes, some new features, and a few deprecations. Thank you to every contributing their features and fixes!\r\n\r\n## Highlights\r\n- Added `context.gdb_binary` to specify which `gdb` command to use. Useful to specify e.g. `pwndbg`. Checkout the [`pwn.conf` config file](https://docs.pwntools.com/en/latest/config.html) to set it globally. (@Ninja3047)\r\n- Added [`tube.upload_manually`](https://docs.pwntools.com/en/latest/tubes.html#pwnlib.tubes.tube.tube.upload_manually) to upload data to a shell using shell commands. Quickly upload your exploit into that kernel pwn challenge without manually typing the `echo {chunk} | base64 -d >> exploit` loop.\r\n- Improved [libcdb handling of a local libc-database](https://docs.pwntools.com/en/latest/commandline.html#pwn-libcdb-fetch) without relying on external services. (@the-soloist)\r\n- Cache the output of `asm()` to speed up subsequent exploit runs. (Disable the cache using `context.cache_dir = None`)\r\n- Improve documentation regarding which `ELF` functions run the binary internally. (Thanks to @Hackrrr who made a CTF challenge for it at Compete With Team Europe CTF 2025)\r\n\r\n## Deprecations\r\n### Removal of some CLI command scripts\r\nMany of the CLI utilities coming with pwntools had ambiguous names and caused problems while packaging in different distributions. Most of the commands are deprecated now and print a warning suggesting to use `pwn <thecommand>` instead.\r\n\r\nOnly `checksec`, `constgrep`, `libcdb`, `phd`, `pwnstrip`, and `shellcraft` stay as standalone CLI scripts. The rest will be removed and only accessible through the `pwn` wrapper in the future.\r\n\r\n```\r\n$ debug\r\n/home/user/.local/bin/debug:8: DeprecationWarning: The 'debug' command is deprecated and will be removed in a future version. Please use 'pwn debug' instead.\r\n  sys.exit(deprecated_main())\r\nusage: pwn debug [-h] [-x GDBSCRIPT] [--pid PID] [-c context] [--exec EXECUTABLE] [--process PROCESS_NAME] [--sysroot SYSROOT]\r\n```\r\n\r\n### Deprecate 'keepends' argument in favor of 'drop' in `tube.recvline*`\r\n`tube.recvline` used the `keepends` argument to specify whether to include the trailing newline in the return value while `tube.recvuntil` uses `drop` to specify inclusion of the delimiter. The semantics are inversed for both functions causing confusion:\r\n\r\n```python\r\nio.recvuntil(b'pwn', drop=True) # Don't include `pwn` at the end.\r\nio.recvline(keepends=False) # Don't include `\\n` at the end.\r\n```\r\n\r\nSince `drop` is a more generic name (and shorter to type), `tube.recvline*` accepts a `drop` parameter now and usage of `keepends` is deprecated.\r\n\r\nThe detailed changelog is as follows:\r\n\r\n* Allow setting debugger path via context.gdb_binary by @Ninja3047 in https://github.com/Gallopsled/pwntools/pull/2602\r\n* Cache output of `asm()` by @peace-maker in https://github.com/Gallopsled/pwntools/pull/2358\r\n* docs: warn that .libs/.libc/.maps are dangerous by @Arusekk in https://github.com/Gallopsled/pwntools/pull/2626\r\n* Add `tube.upload_manually` to upload files in chunks by @peace-maker in https://github.com/Gallopsled/pwntools/pull/2410\r\n* Deprecate direct commandline scripts invocation and exclude nonsense ones by @tkmikan in https://github.com/Gallopsled/pwntools/pull/2364\r\n* Extract libraries from Docker image by @lcian in https://github.com/Gallopsled/pwntools/pull/2479\r\n* libcdb-cli: add `--offline-only`, refactor unstrip and add fetch parser for download libc-database by @the-soloist in https://github.com/Gallopsled/pwntools/pull/2478\r\n* darwin: Bump syscalls from sdk 15.1 by @patryk4815 in https://github.com/Gallopsled/pwntools/pull/2448\r\n* Support longer function names in Windows `getexport` shellcode by @peace-maker in https://github.com/Gallopsled/pwntools/pull/2587\r\n* Fix attaching to a gdbserver with tuple `gdb.attach(('0.0.0.0',12345))` by @ckxckx in https://github.com/Gallopsled/pwntools/pull/2291\r\n* regsort: respe","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}