Initial vendor packages

Signed-off-by: Valentin Popov <valentin@popov.link>

1 files changed, 220 insertions, 0 deletions

diff --git a/vendor/rustix/src/system.rs b/vendor/rustix/src/system.rs
new file mode 100644
index 0000000..cebf29e
--- /dev/null
+++ b/vendor/rustix/src/system.rs
@@ -0,0 +1,220 @@
+//! Uname and other system-level functions.
+//!
+//! # Safety
+//!
+//! This function converts from `struct utsname` fields provided from the
+//! kernel into `&str` references, which assumes that they're NUL-terminated.
+#![allow(unsafe_code)]
+
+use crate::backend;
+#[cfg(target_os = "linux")]
+use crate::backend::c;
+use crate::ffi::CStr;
+#[cfg(not(any(target_os = "espidf", target_os = "emscripten", target_os = "vita")))]
+use crate::io;
+use core::fmt;
+
+#[cfg(linux_kernel)]
+pub use backend::system::types::Sysinfo;
+
+/// `uname()`—Returns high-level information about the runtime OS and
+/// hardware.
+///
+/// For `gethostname()`, use [`Uname::nodename`] on the result.
+///
+/// # References
+///  - [POSIX]
+///  - [Linux]
+///  - [Apple]
+///  - [NetBSD]
+///  - [FreeBSD]
+///  - [OpenBSD]
+///  - [DragonFly BSD]
+///  - [illumos]
+///  - [glibc]
+///
+/// [POSIX]: https://pubs.opengroup.org/onlinepubs/9699919799/functions/uname.html
+/// [Linux]: https://man7.org/linux/man-pages/man2/uname.2.html
+/// [Apple]: https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man3/uname.3.html
+/// [NetBSD]: https://man.netbsd.org/uname.3
+/// [FreeBSD]: https://man.freebsd.org/cgi/man.cgi?query=uname&sektion=3
+/// [OpenBSD]: https://man.openbsd.org/uname.3
+/// [DragonFly BSD]: https://man.dragonflybsd.org/?command=uname&section=3
+/// [illumos]: https://illumos.org/man/2/uname
+/// [glibc]: https://www.gnu.org/software/libc/manual/html_node/Platform-Type.html
+#[doc(alias = "gethostname")]
+#[inline]
+pub fn uname() -> Uname {
+    Uname(backend::system::syscalls::uname())
+}
+
+/// `struct utsname`—Return type for [`uname`].
+#[doc(alias = "utsname")]
+pub struct Uname(backend::system::types::RawUname);
+
+impl Uname {
+    /// `sysname`—Operating system release name
+    #[inline]
+    pub fn sysname(&self) -> &CStr {
+        Self::to_cstr(self.0.sysname.as_ptr().cast())
+    }
+
+    /// `nodename`—Name with vague meaning
+    ///
+    /// This is intended to be a network name, however it's unable to convey
+    /// information about hosts that have multiple names, or any information
+    /// about where the names are visible.
+    ///
+    /// This corresponds to the `gethostname` value.
+    #[inline]
+    pub fn nodename(&self) -> &CStr {
+        Self::to_cstr(self.0.nodename.as_ptr().cast())
+    }
+
+    /// `release`—Operating system release version string
+    #[inline]
+    pub fn release(&self) -> &CStr {
+        Self::to_cstr(self.0.release.as_ptr().cast())
+    }
+
+    /// `version`—Operating system build identifiers
+    #[inline]
+    pub fn version(&self) -> &CStr {
+        Self::to_cstr(self.0.version.as_ptr().cast())
+    }
+
+    /// `machine`—Hardware architecture identifier
+    #[inline]
+    pub fn machine(&self) -> &CStr {
+        Self::to_cstr(self.0.machine.as_ptr().cast())
+    }
+
+    /// `domainname`—NIS or YP domain identifier
+    #[cfg(linux_kernel)]
+    #[inline]
+    pub fn domainname(&self) -> &CStr {
+        Self::to_cstr(self.0.domainname.as_ptr().cast())
+    }
+
+    #[inline]
+    fn to_cstr<'a>(ptr: *const u8) -> &'a CStr {
+        // SAFETY: Strings returned from the kernel are always NUL-terminated.
+        unsafe { CStr::from_ptr(ptr.cast()) }
+    }
+}
+
+impl fmt::Debug for Uname {
+    fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
+        #[cfg(not(linux_kernel))]
+        {
+            write!(
+                fmt,
+                "{:?} {:?} {:?} {:?} {:?}",
+                self.sysname(),
+                self.nodename(),
+                self.release(),
+                self.version(),
+                self.machine(),
+            )
+        }
+        #[cfg(linux_kernel)]
+        {
+            write!(
+                fmt,
+                "{:?} {:?} {:?} {:?} {:?} {:?}",
+                self.sysname(),
+                self.nodename(),
+                self.release(),
+                self.version(),
+                self.machine(),
+                self.domainname(),
+            )
+        }
+    }
+}
+
+/// `sysinfo()`—Returns status information about the runtime OS.
+///
+/// # References
+///  - [Linux]
+///
+/// [Linux]: https://man7.org/linux/man-pages/man2/uname.2.html
+#[cfg(linux_kernel)]
+#[inline]
+pub fn sysinfo() -> Sysinfo {
+    backend::system::syscalls::sysinfo()
+}
+
+/// `sethostname(name)`—Sets the system host name.
+///
+/// # References
+///  - [Linux]
+///
+/// [Linux]: https://man7.org/linux/man-pages/man2/sethostname.2.html
+#[cfg(not(any(
+    target_os = "emscripten",
+    target_os = "espidf",
+    target_os = "redox",
+    target_os = "vita",
+    target_os = "wasi"
+)))]
+#[inline]
+pub fn sethostname(name: &[u8]) -> io::Result<()> {
+    backend::system::syscalls::sethostname(name)
+}
+
+/// Reboot command for use with [`reboot`].
+#[cfg(target_os = "linux")]
+#[derive(Copy, Clone, Debug, Eq, PartialEq)]
+#[repr(i32)]
+#[non_exhaustive]
+pub enum RebootCommand {
+    /// Disables the Ctrl-Alt-Del keystroke.
+    ///
+    /// When disabled, the keystroke will send a [`Signal::Int`] to pid 1.
+    ///
+    /// [`Signal::Int`]: crate::process::Signal::Int
+    CadOff = c::LINUX_REBOOT_CMD_CAD_OFF,
+    /// Enables the Ctrl-Alt-Del keystroke.
+    ///
+    /// When enabled, the keystroke will trigger a [`Restart`].
+    ///
+    /// [`Restart`]: Self::Restart
+    CadOn = c::LINUX_REBOOT_CMD_CAD_ON,
+    /// Prints the message "System halted" and halts the system
+    Halt = c::LINUX_REBOOT_CMD_HALT,
+    /// Execute a kernel that has been loaded earlier with [`kexec_load`].
+    ///
+    /// [`kexec_load`]: https://man7.org/linux/man-pages/man2/kexec_load.2.html
+    Kexec = c::LINUX_REBOOT_CMD_KEXEC,
+    /// Prints the message "Power down.", stops the system, and tries to remove
+    /// all power
+    PowerOff = c::LINUX_REBOOT_CMD_POWER_OFF,
+    /// Prints the message "Restarting system." and triggers a restart
+    Restart = c::LINUX_REBOOT_CMD_RESTART,
+    /// Hibernate the system by suspending to disk
+    SwSuspend = c::LINUX_REBOOT_CMD_SW_SUSPEND,
+}
+
+/// `reboot`—Reboot the system or enable/disable Ctrl-Alt-Del
+///
+/// The reboot syscall, despite the name, can actually do much more than
+/// reboot.
+///
+/// Among other things, it can:
+/// - Restart, Halt, Power Off, and Suspend the system
+/// - Enable and disable the Ctrl-Alt-Del keystroke
+/// - Execute other kernels
+/// - Terminate init inside PID namespaces
+///
+/// It is highly recommended to carefully read the kernel documentation before
+/// calling this function.
+///
+/// # References
+/// - [Linux]
+///
+/// [Linux]: https://man7.org/linux/man-pages/man2/reboot.2.html
+#[cfg(target_os = "linux")]
+pub fn reboot(cmd: RebootCommand) -> io::Result<()> {
+    backend::system::syscalls::reboot(cmd)
+}