upload all-in-1 doc
[hband-tools.git] / doc / kill-rogue.1
blob6b1ab6cd04034eec5d7b17f5688236989cc94a55
1 .TH kill-rogue 1
2 .SH NAME
3 kill-rogue \- a tool to kill processes went rogue
4 .SH SYNOPSIS
5 .B kill-rogue
6 .I <rogue-uid> <reaper-uid>
7 .SH DESCRIPTION
8 .B kill-rogue
9 lets you kill a process which continuously forks a new one and terminates itself.
10 Conventional
11 .IR kill (1) 
12 can not reliably kill such a chain of processes.
13 It uses ticks described in this article 
14 .IR <https://lwn.net/Articles/754980/> .
15 .SH ARGUMENTS
16 .TP
17 .BR rogue-uid
18 UID of the rougue process
19 .TP
20 .BR reaper-uid
21 An other arbitrary UID (not 0) used to avoid getting killed. Let's say 1.
22 .SH AUTHOR
23 George Dunlap (gwd)
24 .SH SOURCE
25 .IR <https://github.com/gwd/runner-reaper/blob/master/reaper.c>