# dieyoung
Find / kill very long running processes by name, args and age
## Installation
recommended way:
`pipx install dieyoung`
or (better if inside python virtualenv):
`pip install dieyoung`
your system may have `pip3` instead of `pip`.
## Find processes by name / arguments, three different modes
See all my ssh sessions:
~~~shell
$ dieyoung ssh
732333 8h ssh alv
742297 7h ssh jul
745335 6h ssh mx
875490 38m ssh -i /home/xenon/.ssh/id_ed25519 mx
880910 25m ssh mx -i /home/xenon/.ssh/id_ed25519
~~~
Format is simple: pid, age, cmdline
Now, lets suppose we want to find only ssh to mx:
~~~shell
$ dieyoung ssh mx
745335 6h ssh mx
875490 39m ssh -i /home/xenon/.ssh/id_ed25519 mx
880910 25m ssh mx -i /home/xenon/.ssh/id_ed25519
~~~
Three sessions are found, because each of them has "ssh" and "mx" in cmdline (in any order). This is how `--mode any` works (default mode), processes matches our pattern if all words from pattern are found *anywhere* in process cmdline, even if there are other arguments.
`--mode start`: First words of cmdline must match pattern, e.g.
~~~shell
$ dieyoung -m start -- ssh -i
875490 39m ssh -i /home/xenon/.ssh/id_ed25519 mx
~~~
But this filter will not find process `ssh mx -i /home/xenon/.ssh/id_ed25519` (because `ssh mx` is not `ssh -i`).
Note, we used `--` to separate PATTERN (`ssh -i`) from dieyoung arguments.
`--mode full`: process cmdline must fully match pattern, e.g.
~~~shell
$ dieyoung -m full -- ssh -i /home/xenon/.ssh/id_ed25519 mx
875490 40m ssh -i /home/xenon/.ssh/id_ed25519 mx
~~~
## Filter by age, user and executable
To find processes older then some age use `-a` / `--age` option, like `-a 1h30m` (to find processes older then 1 hour and 30minutes)
`--exe PATH` to find only processes with this executable, e.g. if you want to find `/usr/bin/php` but not `/opt/php/7.4/bin/php`.
`--user USERNAME` to find only processes of this user.
## Kill / Terminate processes
After you found processes, you may kill it manually with `kill` command, or use built-in feature. Add `--terminate` option to gracefully send SIGTERM to each matching process or `--kill` to send `SIGKILL` (like `kill -9 <pid>`).
## Inspect more details of processes
Add `-j` / `--json` to show more info about processes
Raw data
{
"_id": null,
"home_page": null,
"name": "dieyoung",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "filter, find, inspect, kill, long time, monitoring, old, process, ps, slow, smart",
"author": null,
"author_email": "Yaroslav Polyakov <yaroslaff@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/5b/44/41ee9e037794af6493cc0c14584686421a6a4e8593aad555de7f80086fa5/dieyoung-0.0.5.tar.gz",
"platform": null,
"description": "# dieyoung\nFind / kill very long running processes by name, args and age\n\n## Installation\nrecommended way:\n`pipx install dieyoung`\n\nor (better if inside python virtualenv):\n`pip install dieyoung`\nyour system may have `pip3` instead of `pip`.\n\n## Find processes by name / arguments, three different modes\nSee all my ssh sessions:\n~~~shell\n$ dieyoung ssh\n732333 8h ssh alv\n742297 7h ssh jul\n745335 6h ssh mx\n875490 38m ssh -i /home/xenon/.ssh/id_ed25519 mx\n880910 25m ssh mx -i /home/xenon/.ssh/id_ed25519\n~~~\nFormat is simple: pid, age, cmdline\n\nNow, lets suppose we want to find only ssh to mx:\n~~~shell\n$ dieyoung ssh mx\n745335 6h ssh mx\n875490 39m ssh -i /home/xenon/.ssh/id_ed25519 mx\n880910 25m ssh mx -i /home/xenon/.ssh/id_ed25519\n~~~\nThree sessions are found, because each of them has \"ssh\" and \"mx\" in cmdline (in any order). This is how `--mode any` works (default mode), processes matches our pattern if all words from pattern are found *anywhere* in process cmdline, even if there are other arguments.\n\n`--mode start`: First words of cmdline must match pattern, e.g. \n~~~shell\n$ dieyoung -m start -- ssh -i \n875490 39m ssh -i /home/xenon/.ssh/id_ed25519 mx\n~~~\nBut this filter will not find process `ssh mx -i /home/xenon/.ssh/id_ed25519` (because `ssh mx` is not `ssh -i`). \nNote, we used `--` to separate PATTERN (`ssh -i`) from dieyoung arguments.\n\n`--mode full`: process cmdline must fully match pattern, e.g.\n~~~shell\n$ dieyoung -m full -- ssh -i /home/xenon/.ssh/id_ed25519 mx\n875490 40m ssh -i /home/xenon/.ssh/id_ed25519 mx\n~~~\n\n## Filter by age, user and executable\nTo find processes older then some age use `-a` / `--age` option, like `-a 1h30m` (to find processes older then 1 hour and 30minutes)\n\n`--exe PATH` to find only processes with this executable, e.g. if you want to find `/usr/bin/php` but not `/opt/php/7.4/bin/php`.\n\n`--user USERNAME` to find only processes of this user. \n\n\n## Kill / Terminate processes\nAfter you found processes, you may kill it manually with `kill` command, or use built-in feature. Add `--terminate` option to gracefully send SIGTERM to each matching process or `--kill` to send `SIGKILL` (like `kill -9 <pid>`).\n\n## Inspect more details of processes\nAdd `-j` / `--json` to show more info about processes\n\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Find (and kill) long running processes by name and arguments",
"version": "0.0.5",
"project_urls": {
"Homepage": "https://github.com/yaroslaff/dieyoung",
"Issues": "https://github.com/yaroslaff/dieyoung/issues"
},
"split_keywords": [
"filter",
" find",
" inspect",
" kill",
" long time",
" monitoring",
" old",
" process",
" ps",
" slow",
" smart"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ec02b8ef6e66fd77d532e737037a9b5577beb881091b241aa264c43ea68ca6d1",
"md5": "ce171b2e4148ed4d13207f42efde5c10",
"sha256": "5ed0c68a9c8a5cbe6127102e27807cdb6da23b45379f5d9725e94908f9e1e27f"
},
"downloads": -1,
"filename": "dieyoung-0.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ce171b2e4148ed4d13207f42efde5c10",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 5234,
"upload_time": "2024-11-13T14:58:13",
"upload_time_iso_8601": "2024-11-13T14:58:13.985103Z",
"url": "https://files.pythonhosted.org/packages/ec/02/b8ef6e66fd77d532e737037a9b5577beb881091b241aa264c43ea68ca6d1/dieyoung-0.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5b4441ee9e037794af6493cc0c14584686421a6a4e8593aad555de7f80086fa5",
"md5": "5755676446314a0e8deb6f1432085fac",
"sha256": "34420ede5178165140967f632a055c330e4b6d8de223261efefa24a3a0f49a23"
},
"downloads": -1,
"filename": "dieyoung-0.0.5.tar.gz",
"has_sig": false,
"md5_digest": "5755676446314a0e8deb6f1432085fac",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 5893,
"upload_time": "2024-11-13T14:58:12",
"upload_time_iso_8601": "2024-11-13T14:58:12.192747Z",
"url": "https://files.pythonhosted.org/packages/5b/44/41ee9e037794af6493cc0c14584686421a6a4e8593aad555de7f80086fa5/dieyoung-0.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-13 14:58:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yaroslaff",
"github_project": "dieyoung",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "dieyoung"
}
JSON
