epsh 0.0.2

embeddable posix shell
Documentation 
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

//! Thin wrappers around libc for the syscalls we use.
//! Provides safe-ish Rust signatures and waitpid status helpers.

pub use libc::{close, dup2, execvp, fork, getuid, isatty, pipe, read, umask, waitpid, write};

use std::os::unix::io::RawFd;

pub fn fcntl_dupfd_cloexec(fd: RawFd, min_fd: RawFd) -> i32 {
    // SAFETY: Thin wrapper around libc fcntl; fd validity is caller's responsibility.
    unsafe { libc::fcntl(fd, libc::F_DUPFD_CLOEXEC, min_fd) }
}

pub fn wifexited(status: i32) -> bool {
    libc::WIFEXITED(status)
}

pub fn wexitstatus(status: i32) -> i32 {
    libc::WEXITSTATUS(status)
}

pub fn wtermsig(status: i32) -> i32 {
    libc::WTERMSIG(status)
}

/// Exit the process, flushing Rust's stdout first.
/// Raw `_exit()` skips Rust's BufWriter flush, which loses buffered output
/// when fd 1 is a pipe (e.g. in command substitution or pipelines).
pub fn exit_child(status: crate::error::ExitStatus) -> ! {
    {
        let mut out = std::io::stdout().lock();
        let _ = std::io::Write::flush(&mut out);
    }
    // SAFETY: _exit is always safe to call; it terminates the process immediately.
    unsafe { libc::_exit(status.code()) }
}