src/libstd/sys/unix/mod.rs

   1 #![allow(missing_docs, nonstandard_style)]
   2
   3 use crate::io::ErrorKind;
   4
   5 #[cfg(any(doc, target_os = "linux"))]
   6 pub use crate::os::linux as platform;
   7
   8 #[cfg(all(not(doc), target_os = "android"))]
   9 pub use crate::os::android as platform;
  10 #[cfg(all(not(doc), target_os = "dragonfly"))]
  11 pub use crate::os::dragonfly as platform;
  12 #[cfg(all(not(doc), target_os = "emscripten"))]
  13 pub use crate::os::emscripten as platform;
  14 #[cfg(all(not(doc), target_os = "freebsd"))]
  15 pub use crate::os::freebsd as platform;
  16 #[cfg(all(not(doc), target_os = "fuchsia"))]
  17 pub use crate::os::fuchsia as platform;
  18 #[cfg(all(not(doc), target_os = "haiku"))]
  19 pub use crate::os::haiku as platform;
  20 #[cfg(all(not(doc), target_os = "ios"))]
  21 pub use crate::os::ios as platform;
  22 #[cfg(all(not(doc), target_os = "l4re"))]
  23 pub use crate::os::linux as platform;
  24 #[cfg(all(not(doc), target_os = "macos"))]
  25 pub use crate::os::macos as platform;
  26 #[cfg(all(not(doc), target_os = "netbsd"))]
  27 pub use crate::os::netbsd as platform;
  28 #[cfg(all(not(doc), target_os = "openbsd"))]
  29 pub use crate::os::openbsd as platform;
  30 #[cfg(all(not(doc), target_os = "redox"))]
  31 pub use crate::os::redox as platform;
  32 #[cfg(all(not(doc), target_os = "solaris"))]
  33 pub use crate::os::solaris as platform;
  34
  35 pub use self::rand::hashmap_random_keys;
  36 pub use libc::strlen;
  37
  38 #[macro_use]
  39 pub mod weak;
  40
  41 pub mod alloc;
  42 pub mod android;
  43 pub mod args;
  44 pub mod cmath;
  45 pub mod condvar;
  46 pub mod env;
  47 pub mod ext;
  48 pub mod fast_thread_local;
  49 pub mod fd;
  50 pub mod fs;
  51 pub mod io;
  52 #[cfg(target_os = "l4re")]
  53 mod l4re;
  54 pub mod memchr;
  55 pub mod mutex;
  56 #[cfg(not(target_os = "l4re"))]
  57 pub mod net;
  58 #[cfg(target_os = "l4re")]
  59 pub use self::l4re::net;
  60 pub mod os;
  61 pub mod path;
  62 pub mod pipe;
  63 pub mod process;
  64 pub mod rand;
  65 pub mod rwlock;
  66 pub mod stack_overflow;
  67 pub mod stdio;
  68 pub mod thread;
  69 pub mod thread_local;
  70 pub mod time;
  71
  72 pub use crate::sys_common::os_str_bytes as os_str;
  73
  74 #[cfg(not(test))]
  75 pub fn init() {
  76     // By default, some platforms will send a *signal* when an EPIPE error
  77     // would otherwise be delivered. This runtime doesn't install a SIGPIPE
  78     // handler, causing it to kill the program, which isn't exactly what we
  79     // want!
  80     //
  81     // Hence, we set SIGPIPE to ignore when the program starts up in order
  82     // to prevent this problem.
  83     unsafe {
  84         reset_sigpipe();
  85     }
  86
  87     #[cfg(not(any(target_os = "emscripten", target_os = "fuchsia")))]
  88     unsafe fn reset_sigpipe() {
  89         assert!(signal(libc::SIGPIPE, libc::SIG_IGN) != libc::SIG_ERR);
  90     }
  91     #[cfg(any(target_os = "emscripten", target_os = "fuchsia"))]
  92     unsafe fn reset_sigpipe() {}
  93 }
  94
  95 #[cfg(target_os = "android")]
  96 pub use crate::sys::android::signal;
  97 #[cfg(not(target_os = "android"))]
  98 pub use libc::signal;
  99
 100 pub fn decode_error_kind(errno: i32) -> ErrorKind {
 101     match errno as libc::c_int {
 102         libc::ECONNREFUSED => ErrorKind::ConnectionRefused,
 103         libc::ECONNRESET => ErrorKind::ConnectionReset,
 104         libc::EPERM | libc::EACCES => ErrorKind::PermissionDenied,
 105         libc::EPIPE => ErrorKind::BrokenPipe,
 106         libc::ENOTCONN => ErrorKind::NotConnected,
 107         libc::ECONNABORTED => ErrorKind::ConnectionAborted,
 108         libc::EADDRNOTAVAIL => ErrorKind::AddrNotAvailable,
 109         libc::EADDRINUSE => ErrorKind::AddrInUse,
 110         libc::ENOENT => ErrorKind::NotFound,
 111         libc::EINTR => ErrorKind::Interrupted,
 112         libc::EINVAL => ErrorKind::InvalidInput,
 113         libc::ETIMEDOUT => ErrorKind::TimedOut,
 114         libc::EEXIST => ErrorKind::AlreadyExists,
 115
 116         // These two constants can have the same value on some systems,
 117         // but different values on others, so we can't use a match
 118         // clause
 119         x if x == libc::EAGAIN || x == libc::EWOULDBLOCK => ErrorKind::WouldBlock,
 120
 121         _ => ErrorKind::Other,
 122     }
 123 }
 124
 125 #[doc(hidden)]
 126 pub trait IsMinusOne {
 127     fn is_minus_one(&self) -> bool;
 128 }
 129
 130 macro_rules! impl_is_minus_one {
 131     ($($t:ident)*) => ($(impl IsMinusOne for $t {
 132         fn is_minus_one(&self) -> bool {
 133             *self == -1
 134         }
 135     })*)
 136 }
 137
 138 impl_is_minus_one! { i8 i16 i32 i64 isize }
 139
 140 pub fn cvt<T: IsMinusOne>(t: T) -> crate::io::Result<T> {
 141     if t.is_minus_one() { Err(crate::io::Error::last_os_error()) } else { Ok(t) }
 142 }
 143
 144 pub fn cvt_r<T, F>(mut f: F) -> crate::io::Result<T>
 145 where
 146     T: IsMinusOne,
 147     F: FnMut() -> T,
 148 {
 149     loop {
 150         match cvt(f()) {
 151             Err(ref e) if e.kind() == ErrorKind::Interrupted => {}
 152             other => return other,
 153         }
 154     }
 155 }
 156
 157 // On Unix-like platforms, libc::abort will unregister signal handlers
 158 // including the SIGABRT handler, preventing the abort from being blocked, and
 159 // fclose streams, with the side effect of flushing them so libc buffered
 160 // output will be printed.  Additionally the shell will generally print a more
 161 // understandable error message like "Abort trap" rather than "Illegal
 162 // instruction" that intrinsics::abort would cause, as intrinsics::abort is
 163 // implemented as an illegal instruction.
 164 pub unsafe fn abort_internal() -> ! {
 165     libc::abort()
 166 }