// Portions of this file are Copyright 2014 The Rust Project Developers. // See http://rust-lang.org/COPYRIGHT. use libc; use errno::{Errno, Result}; use std::mem; use std::ptr; pub use libc::{ SIGHUP, SIGINT, SIGQUIT, SIGILL, SIGABRT, SIGFPE, SIGKILL, SIGSEGV, SIGPIPE, SIGALRM, SIGTERM, SIGTRAP, SIGIOT, SIGBUS, SIGSYS, SIGURG, SIGSTOP, SIGTSTP, SIGCONT, SIGCHLD, SIGTTIN, SIGTTOU, SIGIO, SIGXCPU, SIGXFSZ, SIGVTALRM, SIGPROF, SIGWINCH, SIGUSR1, SIGUSR2, }; // This doesn't always exist, but when it does, it's 7 pub const SIGEMT: libc::c_int = 7; pub const NSIG: libc::c_int = 32; pub use self::signal::{ SockFlag, SA_NOCLDSTOP, SA_NOCLDWAIT, SA_NODEFER, SA_ONSTACK, SA_RESETHAND, SA_RESTART, SA_SIGINFO, }; pub use self::signal::{HowFlag, SIG_BLOCK, SIG_UNBLOCK, SIG_SETMASK}; pub use self::signal::sigset_t; #[cfg(any(all(target_os = "linux", any(target_arch = "x86", target_arch = "x86_64", target_arch = "aarch64", target_arch = "arm")), target_os = "android"))] pub mod signal { use libc; bitflags!( flags SockFlag: libc::c_ulong { const SA_NOCLDSTOP = 0x00000001, const SA_NOCLDWAIT = 0x00000002, const SA_NODEFER = 0x40000000, const SA_ONSTACK = 0x08000000, const SA_RESETHAND = 0x80000000, const SA_RESTART = 0x10000000, const SA_SIGINFO = 0x00000004, } ); bitflags!{ flags HowFlag: libc::c_int { const SIG_BLOCK = 0, const SIG_UNBLOCK = 1, const SIG_SETMASK = 2, } } // This definition is not as accurate as it could be, {pid, uid, status} is // actually a giant union. Currently we're only interested in these fields, // however. #[repr(C)] #[derive(Clone, Copy)] pub struct siginfo { pub si_signo: libc::c_int, pub si_errno: libc::c_int, pub si_code: libc::c_int, pub pid: libc::pid_t, pub uid: libc::uid_t, pub status: libc::c_int, } #[repr(C)] #[allow(missing_copy_implementations)] pub struct sigaction { pub sa_handler: extern fn(libc::c_int), pub sa_mask: sigset_t, pub sa_flags: SockFlag, sa_restorer: *mut libc::c_void, } #[repr(C)] #[cfg(target_pointer_width = "32")] #[derive(Clone, Copy)] pub struct sigset_t { __val: [libc::c_ulong; 32], } #[repr(C)] #[cfg(target_pointer_width = "64")] #[derive(Clone, Copy)] pub struct sigset_t { __val: [libc::c_ulong; 16], } } #[cfg(all(target_os = "linux", any(target_arch = "mips", target_arch = "mipsel")))] pub mod signal { use libc; bitflags!( flags SockFlag: libc::c_uint { const SA_NOCLDSTOP = 0x00000001, const SA_NOCLDWAIT = 0x00001000, const SA_NODEFER = 0x40000000, const SA_ONSTACK = 0x08000000, const SA_RESETHAND = 0x80000000, const SA_RESTART = 0x10000000, const SA_SIGINFO = 0x00000008, } ); bitflags!{ flags HowFlag: libc::c_int { const SIG_BLOCK = 1, const SIG_UNBLOCK = 2, const SIG_SETMASK = 3, } } // This definition is not as accurate as it could be, {pid, uid, status} is // actually a giant union. Currently we're only interested in these fields, // however. #[repr(C)] pub struct siginfo { pub si_signo: libc::c_int, pub si_code: libc::c_int, pub si_errno: libc::c_int, pub pid: libc::pid_t, pub uid: libc::uid_t, pub status: libc::c_int, } #[repr(C)] pub struct sigaction { pub sa_flags: SockFlag, pub sa_handler: extern fn(libc::c_int), pub sa_mask: sigset_t, sa_restorer: *mut libc::c_void, sa_resv: [libc::c_int; 1], } #[repr(C)] pub struct sigset_t { __val: [libc::c_ulong; 32], } } #[cfg(any(target_os = "macos", target_os = "ios", target_os = "freebsd", target_os = "openbsd", target_os = "dragonfly", target_os = "netbsd"))] pub mod signal { use libc; bitflags!( flags SockFlag: libc::c_int { const SA_NOCLDSTOP = 0x0008, const SA_NOCLDWAIT = 0x0020, const SA_NODEFER = 0x0010, const SA_ONSTACK = 0x0001, const SA_RESETHAND = 0x0004, const SA_RESTART = 0x0002, const SA_SIGINFO = 0x0040, } ); bitflags!{ flags HowFlag: libc::c_int { const SIG_BLOCK = 1, const SIG_UNBLOCK = 2, const SIG_SETMASK = 3, } } #[cfg(any(target_os = "macos", target_os = "ios", target_os = "openbsd"))] pub type sigset_t = u32; #[cfg(target_os = "freebsd")] #[repr(C)] #[derive(Clone, Copy)] pub struct sigset_t { bits: [u32; 4], } #[cfg(any(target_os = "dragonfly", target_os = "netbsd"))] #[repr(C)] #[derive(Clone, Copy)] pub struct sigset_t { bits: [libc::c_uint; 4], } // This structure has more fields, but we're not all that interested in // them. #[cfg(not(target_os = "dragonfly"))] #[repr(C)] #[derive(Clone, Copy)] pub struct siginfo { pub si_signo: libc::c_int, pub si_errno: libc::c_int, pub si_code: libc::c_int, pub pid: libc::pid_t, pub uid: libc::uid_t, pub status: libc::c_int, } #[cfg(target_os = "dragonfly")] #[repr(C)] #[derive(Clone, Copy)] pub struct siginfo { pub si_signo: libc::c_int, pub si_errno: libc::c_int, pub si_code: libc::c_int, pub pid: libc::c_int, pub uid: libc::c_uint, pub status: libc::c_int, } #[cfg(any(target_os = "macos", target_os = "ios"))] #[repr(C)] #[allow(missing_copy_implementations)] pub struct sigaction { pub sa_handler: extern fn(libc::c_int), pub sa_mask: sigset_t, pub sa_flags: SockFlag, } #[cfg(any(target_os = "freebsd", target_os = "dragonfly"))] #[repr(C)] pub struct sigaction { pub sa_handler: extern fn(libc::c_int), pub sa_flags: SockFlag, pub sa_mask: sigset_t, } #[cfg(any(target_os = "openbsd", target_os = "netbsd"))] #[repr(C)] pub struct sigaction { pub sa_handler: extern fn(libc::c_int), pub sa_mask: sigset_t, pub sa_flags: SockFlag, } } mod ffi { use libc::{c_int, pid_t}; use super::signal::{sigaction, sigset_t}; #[allow(improper_ctypes)] extern { pub fn sigaction(signum: c_int, act: *const sigaction, oldact: *mut sigaction) -> c_int; pub fn sigaddset(set: *mut sigset_t, signum: c_int) -> c_int; pub fn sigdelset(set: *mut sigset_t, signum: c_int) -> c_int; pub fn sigemptyset(set: *mut sigset_t) -> c_int; pub fn sigfillset(set: *mut sigset_t) -> c_int; pub fn sigismember(set: *const sigset_t, signum: c_int) -> c_int; pub fn pthread_sigmask(how: c_int, set: *const sigset_t, oldset: *mut sigset_t) -> c_int; pub fn kill(pid: pid_t, signum: c_int) -> c_int; pub fn raise(signum: c_int) -> c_int; } } #[derive(Clone, Copy)] pub struct SigSet { sigset: sigset_t } pub type SigNum = libc::c_int; impl SigSet { pub fn all() -> SigSet { let mut sigset: sigset_t = unsafe { mem::uninitialized() }; let _ = unsafe { ffi::sigfillset(&mut sigset as *mut sigset_t) }; SigSet { sigset: sigset } } pub fn empty() -> SigSet { let mut sigset: sigset_t = unsafe { mem::uninitialized() }; let _ = unsafe { ffi::sigemptyset(&mut sigset as *mut sigset_t) }; SigSet { sigset: sigset } } pub fn add(&mut self, signum: SigNum) -> Result<()> { let res = unsafe { ffi::sigaddset(&mut self.sigset as *mut sigset_t, signum) }; Errno::result(res).map(drop) } pub fn remove(&mut self, signum: SigNum) -> Result<()> { let res = unsafe { ffi::sigdelset(&mut self.sigset as *mut sigset_t, signum) }; Errno::result(res).map(drop) } pub fn contains(&self, signum: SigNum) -> Result { let res = unsafe { ffi::sigismember(&self.sigset as *const sigset_t, signum) }; match try!(Errno::result(res)) { 1 => Ok(true), 0 => Ok(false), _ => unreachable!("unexpected value from sigismember"), } } /// Gets the currently blocked (masked) set of signals for the calling thread. pub fn thread_get_mask() -> Result { let mut oldmask: SigSet = unsafe { mem::uninitialized() }; try!(pthread_sigmask(HowFlag::empty(), None, Some(&mut oldmask))); Ok(oldmask) } /// Sets the set of signals as the signal mask for the calling thread. pub fn thread_set_mask(&self) -> Result<()> { pthread_sigmask(SIG_SETMASK, Some(self), None) } /// Adds the set of signals to the signal mask for the calling thread. pub fn thread_block(&self) -> Result<()> { pthread_sigmask(SIG_BLOCK, Some(self), None) } /// Removes the set of signals from the signal mask for the calling thread. pub fn thread_unblock(&self) -> Result<()> { pthread_sigmask(SIG_UNBLOCK, Some(self), None) } /// Sets the set of signals as the signal mask, and returns the old mask. pub fn thread_swap_mask(&self, how: HowFlag) -> Result { let mut oldmask: SigSet = unsafe { mem::uninitialized() }; try!(pthread_sigmask(how, Some(self), Some(&mut oldmask))); Ok(oldmask) } } impl AsRef for SigSet { fn as_ref(&self) -> &sigset_t { &self.sigset } } type sigaction_t = self::signal::sigaction; pub struct SigAction { sigaction: sigaction_t } impl SigAction { pub fn new(handler: extern fn(libc::c_int), flags: SockFlag, mask: SigSet) -> SigAction { let mut s = unsafe { mem::uninitialized::() }; s.sa_handler = handler; s.sa_flags = flags; s.sa_mask = mask.sigset; SigAction { sigaction: s } } } pub unsafe fn sigaction(signum: SigNum, sigaction: &SigAction) -> Result { let mut oldact = mem::uninitialized::(); let res = ffi::sigaction(signum, &sigaction.sigaction as *const sigaction_t, &mut oldact as *mut sigaction_t); Errno::result(res).map(|_| SigAction { sigaction: oldact }) } /// Manages the signal mask (set of blocked signals) for the calling thread. /// /// If the `set` parameter is `Some(..)`, then the signal mask will be updated with the signal set. /// The `how` flag decides the type of update. If `set` is `None`, `how` will be ignored, /// and no modification will take place. /// /// If the 'oldset' parameter is `Some(..)` then the current signal mask will be written into it. /// /// If both `set` and `oldset` is `Some(..)`, the current signal mask will be written into oldset, /// and then it will be updated with `set`. /// /// If both `set` and `oldset` is None, this function is a no-op. /// /// For more information, visit the [pthread_sigmask](http://man7.org/linux/man-pages/man3/pthread_sigmask.3.html), /// or [sigprocmask](http://man7.org/linux/man-pages/man2/sigprocmask.2.html) man pages. pub fn pthread_sigmask(how: HowFlag, set: Option<&SigSet>, oldset: Option<&mut SigSet>) -> Result<()> { if set.is_none() && oldset.is_none() { return Ok(()) } let res = unsafe { // if set or oldset is None, pass in null pointers instead ffi::pthread_sigmask(how.bits(), set.map_or_else(|| ptr::null::(), |s| &s.sigset as *const sigset_t), oldset.map_or_else(|| ptr::null_mut::(), |os| &mut os.sigset as *mut sigset_t)) }; Errno::result(res).map(drop) } pub fn kill(pid: libc::pid_t, signum: SigNum) -> Result<()> { let res = unsafe { ffi::kill(pid, signum) }; Errno::result(res).map(drop) } pub fn raise(signum: SigNum) -> Result<()> { let res = unsafe { ffi::raise(signum) }; Errno::result(res).map(drop) } #[cfg(test)] mod tests { use super::*; #[test] fn test_contains() { let mut mask = SigSet::empty(); mask.add(SIGUSR1).unwrap(); assert_eq!(mask.contains(SIGUSR1), Ok(true)); assert_eq!(mask.contains(SIGUSR2), Ok(false)); let all = SigSet::all(); assert_eq!(all.contains(SIGUSR1), Ok(true)); assert_eq!(all.contains(SIGUSR2), Ok(true)); } #[test] fn test_thread_signal_block() { let mut mask = SigSet::empty(); mask.add(SIGUSR1).unwrap(); assert!(mask.thread_block().is_ok()); } #[test] fn test_thread_signal_swap() { let mut mask = SigSet::empty(); mask.add(SIGUSR1).unwrap(); mask.thread_block().unwrap(); assert!(SigSet::thread_get_mask().unwrap().contains(SIGUSR1).unwrap()); let mask2 = SigSet::empty(); mask.add(SIGUSR2).unwrap(); let oldmask = mask2.thread_swap_mask(signal::SIG_SETMASK).unwrap(); assert!(oldmask.contains(SIGUSR1).unwrap()); assert!(!oldmask.contains(SIGUSR2).unwrap()); } }