gracekill 0.1.2

A minimal utility to gracefully terminate processes with graceful escalation of SIGTERM to SIGKILL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

gracekill(1)
============

NAME
----
gracekill - send signals to processes with grace period

SYNOPSIS
--------
gracekill [options] <pid>[,pid...]

DESCRIPTION
-----------
gracekill sends SIGTERM to the specified process(es) and waits for a configurable
grace period before sending SIGKILL to any remaining processes.

The grace period defaults to 25 seconds if not specified.

Multiple PIDs may be specified either space-separated or comma-separated.

ARGUMENTS
---------
pid
    Process ID to signal. Multiple PIDs can be specified.

OPTIONS
-------
-g, --grace-seconds
    Time in seconds to wait between SIGTERM and SIGKILL. Default: 25

--exit-non-zero-if-sigkill-required
    Exit with code 3 if SIGKILL was required. By default, exits with 0
    even if SIGKILL was used.

EXAMPLES
--------
Send SIGTERM to processes 1234 and 5678, wait 10 seconds before SIGKILL:

    gracekill -g 10 1234 5678

Send signals to comma-separated PIDs with 25 second grace period:

    gracekill --grace-seconds 25 1234,5678,9012

Use default 25 second grace period:

    gracekill 1234

Alternative syntax with equals sign:

    gracekill --grace-seconds=15 1234

SIGNALS
-------
The program sends the following signals in order:

1. SIGTERM - Allows the process to perform cleanup before exiting
2. SIGKILL - Forces immediate termination (only if process still running)

During the grace period, processes are checked every 100ms.

EXIT STATUS
-----------
0
    All processes were terminated (either gracefully or via SIGKILL)

1
    Invalid arguments or usage error

2
    No processes could be signaled (all were already dead or inaccessible)

3
    Some processes required SIGKILL and --exit-non-zero-if-sigkill-required
    was specified

DIAGNOSTICS
-----------
All diagnostic output is written to stderr with "[gracekill]" prefix.

Error messages include:
- Process not found
- Permission denied
- Invalid PID

SEE ALSO
--------
[kill(1)](https://man7.org/linux/man-pages/man1/kill.1.html), [signal(7)](https://man7.org/linux/man-pages/man7/signal.7.html)

INSTALLATION
------------
Install from [crates.io](https://crates.io/crates/gracekill):

```shell
cargo install gracekill
```

BUILD FROM SOURCE
-----------------
```shell
cargo build --release
```

Binary will be at target/release/gracekill

NOTES
-----
Requires appropriate permissions to signal target processes.
Only available on Unix-like systems.