broken-pipe-kills 0.2.0

Get rid of `failed printing to stdout: Broken pipe (os error 32)` panics by setting `SIGPIPE` to `SIG_DFL` before your `fn main()` runs.
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

# broken-pipe-kills

## What is the problem?

Normally the Rust standard library code sets `SIGPIPE` to `SIG_IGN` before your `fn main()` runs. This makes you see an error if you pipe your output to something like `head`:

```rs
fn main() {
    loop {
        println!("hello world");
    }
}
```

```console
$ ./main | head
hello world
thread 'main' panicked at 'failed printing to stdout: Broken pipe (os error 32)', library/std/src/io/stdio.rs:1016:9
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrac
```

## How do I solve it?

Add the following to your `Cargo.toml` to set `SIGPIPE` to `SIG_DFL` instead so your program is nicely killed instead of panicking:

```toml
[dependencies]
broken-pipe-kills = "0.2.0"
```

```console
$ ./main | head
hello world
```

## When Can I Use It?

Follow [Tracking Issue for Externally Implementable Item `#[std::io::on_broken_pipe]` #150588](https://github.com/rust-lang/rust/issues/150588) for updates.