Change Log

All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.

[Unreleased] - ReleaseDate

Added

Add MntFlags and unmount on all of the BSDs. (#1849)
Added a 'Statfs::flags' method. (#1849)
Added NSFS_MAGIC FsType on Linux and Android. (#1829)
Added sched_getcpu on platforms that support it. (#1825)
Added sched_getaffinity and sched_setaffinity on FreeBSD. (#1804)
Added line_discipline field to Termios on Linux, Android and Haiku (#1805)
Expose the memfd module on FreeBSD (memfd was added in FreeBSD 13) (#1808)
Added domainname field of UtsName on Android and Linux (#1817)
Re-export RLIM_INFINITY from libc (#1831)
Added syncfs(2) on Linux (#1833)
Added faccessat(2) on illumos (#1841)
Added eaccess() on FreeBSD, DragonFly and Linux (glibc and musl). (#1842)

Changed

The MSRV is now 1.56.1 (#1792)

Fixed

Fix microsecond calculation for TimeSpec. (#1801)
Fix User::from_name and Group::from_name panicking when given a name containing a nul. (#1815)
Fix User::from_uid and User::from_name crash on Android platform. (#1824)

Removed

Removed deprecated error constants and conversions. (#1860)

[0.25.0] - 2022-08-13

Added

Added faccessat (#1780)
Added memfd on Android. (#1773)
Added ETH_P_ALL to SockProtocol enum (#1768)
Added four non-standard Linux SysconfVar variants (#1761)
Added const constructors for TimeSpec and TimeVal (#1760)
Added chflags. (#1758)
Added aio_writev and aio_readv. (#1713)
impl From<uid_t> for Uid and From<gid_t> for Gid (#1727)
impl From<SockaddrIn> for std::net::SocketAddrV4 and impl From<SockaddrIn6> for std::net::SocketAddrV6. (#1711)
Added support for the x86_64-unknown-haiku target. (#1703)
Added ptrace::read_user and ptrace::write_user for Linux. (#1697)
Added getrusage and helper types UsageWho and Usage (#1747)
Added the DontRoute SockOpt (#1752)
Added signal::SigSet::from_sigset_t_unchecked(). (#1741)
Added the Ipv4OrigDstAddr sockopt and control message. (#1772)
Added the Ipv6OrigDstAddr sockopt and control message. (#1772)
Added the Ipv4SendSrcAddr control message. (#1776)

Changed

Reimplemented sendmmsg/recvmmsg to avoid allocations and with better API (#1744)
Rewrote the aio module. The new module:
- Does more type checking at compile time rather than runtime.
- Gives the caller control over whether and when to Box an aio operation.
- Changes the type of the priority arguments to i32.
- Changes the return type of aio_return to usize. (#1713)
nix::poll::ppoll: sigmask parameter is now optional. (#1739)
Changed gethostname to return an owned OsString. (#1745)
signal:SigSet is now marked as repr(transparent). (#1741)

Removed

Removed support for resubmitting partially complete lio_listio operations. It was too complicated, and didn't fit Nix's theme of zero-cost abstractions. Instead, it can be reimplemented downstream. (#1713)

[0.24.2] - 2022-07-17

Fixed

Fixed buffer overflow in nix::sys::socket::recvfrom. (#1763)
Enabled SockaddrStorage::{as_link_addr, as_link_addr_mut} for Linux-like operating systems. (#1729)
Fixed SockaddrLike::from_raw implementations for VsockAddr and SysControlAddr. (#1736)

[0.24.1] - 2022-04-22

Fixed

Fixed UnixAddr::size on Linux-based OSes. (#1702)

[0.24.0] - 2022-04-21

Added

Added fine-grained features flags. Most Nix functionality can now be conditionally enabled. By default, all features are enabled. (#1611)
Added statfs FS type magic constants for target_os = "android" and synced constants with libc v0.2.121. (#1690)
Added fexecve on DragonFly. (#1577)
sys::uio::IoVec is now Send and Sync (#1582)
Added EPOLLEXCLUSIVE on Android. (#1567)
Added fdatasync for FreeBSD, Fuchsia, NetBSD, and OpenBSD. (#1581)
Added sched_setaffinity and sched_getaffinity on DragonFly. (#1537)
Added posix_fallocate on DragonFly. (#1621)
Added SO_TIMESTAMPING support (#1547)
Added getter methods to MqAttr struct (#1619)
Added the TxTime sockopt and control message. (#1564)
Added POSIX per-process timer support (#1622)
Added sendfile on DragonFly. (#1615)
Added UMOUNT_NOFOLLOW, FUSE_SUPER_MAGIC on Linux. (#1634)
Added getresuid, setresuid, getresgid, and setresgid on DragonFly, FreeBSD, and OpenBSD. (#1628)
Added MAP_FIXED_NOREPLACE on Linux. (#1636)
Added fspacectl on FreeBSD (#1640)
Added accept4 on DragonFly, Emscripten, Fuchsia, Illumos, and NetBSD. (#1654)
Added AsRawFd implementation on OwningIter. (#1563)
Added process_vm_readv and process_vm_writev on Android. (#1557)
Added nix::uncontext module on s390x. (#1662)
Implemented Extend, FromIterator, and IntoIterator for SigSet and added SigSet::iter and SigSetIter. (#1553)
Added ENOTRECOVERABLE and EOWNERDEAD error codes on DragonFly. (#1665)
Implemented Read and Write for &PtyMaster (#1664)
Added MSG_NOSIGNAL for Android, Dragonfly, FreeBSD, Fuchsia, Haiku, Illumos, Linux, NetBSD, OpenBSD and Solaris. (#1670)
Added waitid. (#1584)
Added Ipv6DontFrag for android, iOS, linux and macOS.
Added IpDontFrag for iOS, macOS. (#1692)

Changed

mqueue functions now operate on a distinct type, nix::mqueue::MqdT. Accessors take this type by reference, not by value. (#1639)
Removed SigSet::extend in favor of <SigSet as Extend<Signal>>::extend. Because of this change, you now need use std::iter::Extend to call extend on a SigSet. (#1553)
Removed the the PATH_MAX restriction from APIs accepting paths. Paths will now be allocated on the heap if they are too long. In addition, large instruction count improvements (~30x) were made to path handling. (#1656)
Changed getrlimit and setrlimit to use rlim_t directly instead of Option<rlim_t>. (#1668)
Deprecated InetAddr and SockAddr in favor of SockaddrIn, SockaddrIn6, and SockaddrStorage. (#1684)
Deprecated IpAddr, Ipv4Addr, and Ipv6Addr in favor of their equivalents from the standard library. (#1685)
uname now returns a Result<UtsName> instead of just a UtsName and ignoring failures from libc. And getters on the UtsName struct now return an &OsStr instead of &str. (#1672)
Replaced IoVec with IoSlice and IoSliceMut, and replaced IoVec::from_slice with IoSlice::new. (#1643)

Fixed

InetAddr::from_std now sets the sin_len/sin6_len fields on the BSDs. (#1642)
Fixed a panic in LinkAddr::addr. That function now returns an Option. (#1675) (#1677)

Removed

Removed public access to the inner fields of NetlinkAddr, AlgAddr, SysControlAddr, LinkAddr, and VsockAddr. (#1614)
Removed EventFlag::EV_SYSFLAG. (#1635)

[0.23.1] - 2021-12-16

Changed

Relaxed the bitflags requirement from 1.3.1 to 1.1. This partially reverts #1492. From now on, the MSRV is not guaranteed to work with all versions of all dependencies, just with some version of all dependencies. (#1607)

Fixed

Fixed soundness issues in FdSet::insert, FdSet::remove, and FdSet::contains involving file descriptors outside of the range 0..FD_SETSIZE. (#1575)

[0.23.0] - 2021-09-28

Added

Added the LocalPeerCred sockopt. (#1482)
Added TimeSpec::from_duration and TimeSpec::from_timespec (#1465)
Added IPV6_V6ONLY sockopt. (#1470)
Added impl From<User> for libc::passwd trait implementation to convert a User into a libc::passwd. Consumes the User struct to give ownership over the member pointers. (#1471)
Added pthread_kill. (#1472)
Added mknodat. (#1473)
Added setrlimit and getrlimit. (#1302)
Added ptrace::interrupt method for platforms that support PTRACE_INTERRUPT (#1422)
Added IP6T_SO_ORIGINAL_DST sockopt. (#1490)
Added the PTRACE_EVENT_STOP variant to the sys::ptrace::Event enum (#1335)
Exposed SockAddr::from_raw_sockaddr (#1447)
Added TcpRepair (#1503)
Enabled pwritev and preadv for more operating systems. (#1511)
Added support for TCP_MAXSEG TCP Maximum Segment Size socket options (#1292)
Added Ipv4RecvErr and Ipv6RecvErr sockopts and associated control messages. (#1514)
Added AsRawFd implementation on PollFd. (#1516)
Added Ipv4Ttl and Ipv6Ttl sockopts. (#1515)
Added MAP_EXCL, MAP_ALIGNED_SUPER, and MAP_CONCEAL mmap flags, and exposed MAP_ANONYMOUS for all operating systems. (#1522) (#1525) (#1531) (#1534)
Added read/write accessors for 'events' on PollFd. (#1517)

Changed

FdSet::{contains, highest, fds} no longer require a mutable reference. (#1464)
User::gecos and corresponding libc::passwd::pw_gecos are supported on 64-bit Android, change conditional compilation to include the field in 64-bit Android builds (#1471)
eventfds are supported on Android, change conditional compilation to include sys::eventfd::eventfd and sys::eventfd::EfdFlagsfor Android builds. (#1481)
Most enums that come from C, for example Errno, are now marked as #[non_exhaustive]. (#1474)
Many more functions, mostly contructors, are now const. (#1476) (#1492)
sys::event::KEvent::filter now returns a Result instead of being infalliable. The only cases where it will now return an error are cases where it previously would've had undefined behavior. (#1484)
Minimum supported Rust version is now 1.46.0. (#1492)
Rework UnixAddr to encapsulate internals better in order to fix soundness issues. No longer allows creating a UnixAddr from a raw sockaddr_un. (#1496)
Raised bitflags to 1.3.0 and the MSRV to 1.46.0. (#1492)

Fixed

posix_fadvise now returns errors in the conventional way, rather than as a non-zero value in Ok(). (#1538)
Added more errno definitions for better backwards compatibility with Nix 0.21.0. (#1467)
Fixed potential undefined behavior in Signal::try_from on some platforms. (#1484)
Fixed buffer overflow in unistd::getgrouplist. (#1545)

Removed

Removed a couple of termios constants on redox that were never actually supported. (#1483)
Removed nix::sys::signal::NSIG. It was of dubious utility, and not correct for all platforms. (#1484)
Removed support for 32-bit Apple targets, since they've been dropped by both Rustc and Xcode. (#1492)
Deprecated SockAddr/InetAddr::to_str in favor of ToString::to_string (#1495)
Removed SigevNotify on OpenBSD and Redox. (#1511)

[0.22.0] - 9 July 2021

Added

Added if_nameindex (#1445)
Added nmount for FreeBSD. (#1453)
Added IpFreebind socket option (sockopt) on Linux, Fuchsia and Android. (#1456)
Added TcpUserTimeout socket option (sockopt) on Linux and Fuchsia. (#1457)
Added renameat2 for Linux (#1458)
Added RxqOvfl support on Linux, Fuchsia and Android. (#1455)

Changed

ptsname_r now returns a lossily-converted string in the event of bad UTF, just like ptsname. (#1446)
Nix's error type is now a simple wrapper around the platform's Errno. This means it is now Into<std::io::Error>. It's also Clone, Copy, Eq, and has a small fixed size. It also requires less typing. For example, the old enum variant nix::Error::Sys(nix::errno::Errno::EINVAL) is now simply nix::Error::EINVAL. (#1446)

Fixed

Removed

[0.21.0] - 31 May 2021

Added

Added getresuid and getresgid (#1430)
Added TIMESTAMPNS support for linux (#1402)
Added sendfile64 (#1439)
Added MS_LAZYTIME to MsFlags (#1437)

Changed

Made forkpty unsafe, like fork (#1390)
Made Uid, Gid and Pid methods from_raw and as_raw a const fn (#1429)
Made Uid::is_root a const fn (#1429)
AioCb is now always pinned. Once a libc::aiocb gets sent to the kernel, its address in memory must not change. Nix now enforces that by using std::pin. Most users won't need to change anything, except when using aio_suspend. See that method's documentation for the new usage. (#1440)
LioCb is now constructed using a distinct LioCbBuilder struct. This avoids a soundness issue with the old LioCb. Usage is similar but construction now uses the builder pattern. See the documentation for details. (#1440)
Minimum supported Rust version is now 1.41.0. (#1440)
Errno aliases are now associated consts on Errno, instead of consts in the errno module. (#1452)

Fixed

Allow sockaddr_ll size, as reported by the Linux kernel, to be smaller then it's definition (#1395)
Fix spurious errors using sendmmsg with multiple cmsgs (#1414)
Added Errno::EOPNOTSUPP to FreeBSD, where it was missing. (#1452)

Removed

Removed sys::socket::accept4 from Android arm because libc removed it in version 0.2.87. (#1399)
AioCb::from_boxed_slice and AioCb::from_boxed_mut_slice have been removed. They were useful with earlier versions of Rust, but should no longer be needed now that async/await are available. AioCbs now work exclusively with borrowed buffers, not owned ones. (#1440)
Removed some Errno values from platforms where they aren't actually defined. (#1452)

[0.20.0] - 20 February 2021

Added

Added a passwd field to Group (#1338)
Added mremap (#1306)
Added personality (#1331)
Added limited Fuchsia support (#1285)
Added getpeereid (#1342)
Implemented IntoIterator for Dir (#1333).

Changed

Minimum supported Rust version is now 1.40.0. (#1356)
i686-apple-darwin has been demoted to Tier 2 support, because it's deprecated by Xcode. (#1350)
Fixed calling recvfrom on an AddrFamily::Packet socket (#1344)

Fixed

TimerFd now closes the underlying fd on drop. (#1381)
Define *_MAGIC filesystem constants on Linux s390x (#1372)
mqueue, sysinfo, timespec, statfs, test_ptrace_syscall() on x32 (#1366)

Removed

Dir, SignalFd, and PtyMaster are no longer Clone. (#1382)
Removed SockLevel, which hasn't been used for a few years (#1362)
Removed both Copy and Clone from TimerFd. (#1381)

[0.19.1] - 28 November 2020

Fixed

Fixed bugs in recvmmsg. (#1341)

[0.19.0] - 6 October 2020

Added

Added Netlink protocol families to the SockProtocol enum (#1289)
Added clock_gettime, clock_settime, clock_getres, clock_getcpuclockid functions and ClockId struct. (#1281)
Added wrapper functions for PTRACE_SYSEMU and PTRACE_SYSEMU_SINGLESTEP. (#1300)
Add support for Vsock on Android rather than just Linux. (#1301)
Added TCP_KEEPCNT and TCP_KEEPINTVL TCP keepalive options. (#1283)

Changed

Expose SeekData and SeekHole on all Linux targets (#1284)
Changed unistd::{execv,execve,execvp,execvpe,fexecve,execveat} to take both &[&CStr] and &[CString] as its list argument(s). (#1278)
Made unistd::fork an unsafe funtion, bringing it in line with libstd's decision. (#1293)

Fixed

Removed

[0.18.0] - 26 July 2020

Added

Added fchown(2) wrapper. (#1257)
Added support on linux systems for MAP_HUGE_SIZE family of flags. (#1211)
Added support for F_OFD_* fcntl commands on Linux and Android. (#1195)
Added env::clearenv(): calls libc::clearenv on platforms where it's available, and clears the environment of all variables via std::env::vars and std::env::remove_var on others. (#1185)
FsType inner value made public. (#1187)
Added unistd::setfsuid and unistd::setfsgid to set the user or group identity for filesystem checks per-thread. (#1163)
Derived Ord, PartialOrd for unistd::Pid (#1189)
Added select::FdSet::fds method to iterate over file descriptors in a set. (#1207)
Added support for UDP generic segmentation offload (GSO) and generic receive offload (GRO) (#1209)
Added support for sendmmsg and recvmmsg calls (#1208)
Added support for SCM_CREDS messages (UnixCredentials) on FreeBSD/DragonFly (#1216)
Added BindToDevice socket option (sockopt) on Linux (#1233)
Added EventFilter bitflags for EV_DISPATCH and EV_RECEIPT on OpenBSD. (#1252)
Added support for Ipv4PacketInfo and Ipv6PacketInfo to ControlMessage. (#1222)
CpuSet and UnixCredentials now implement Default. (#1244)
Added unistd::ttyname (#1259)
Added support for Ipv4PacketInfo and Ipv6PacketInfo to ControlMessage for iOS and Android. (#1265)
Added support for TimerFd. (#1261)

Changed

Changed fallocate return type from c_int to () (#1201)
Enabled sys::ptrace::setregs and sys::ptrace::getregs on x86_64-unknown-linux-musl target (#1198)
On Linux, ptrace::write is now an unsafe function. Caveat programmer. (#1245)
execv, execve, execvp and execveat in ::nix::unistd and reboot in ::nix::sys::reboot now return Result<Infallible> instead of Result<Void> (#1239)
sys::socket::sockaddr_storage_to_addr is no longer unsafe. So is offset_of!.
sys::socket::sockaddr_storage_to_addr, offset_of!, and Errno::clear are no longer unsafe.
SockAddr::as_ffi_pair,sys::socket::sockaddr_storage_to_addr, offset_of!, and Errno::clear are no longer unsafe. (#1244)
Several Inotify methods now take self by value instead of by reference (#1244)
nix::poll::ppoll: timeout parameter is now optional, None is equivalent for infinite timeout.

Fixed

Fixed getsockopt. The old code produced UB which triggers a panic with Rust 1.44.0. (#1214)
Fixed a bug in nix::unistd that would result in an infinite loop when a group or user lookup required a buffer larger than 16KB. (#1198)
Fixed unaligned casting of cmsg_data to af_alg_iv (#1206)
Fixed readlink/readlinkat when reading symlinks longer than PATH_MAX (#1231)
PollFd, EpollEvent, IpMembershipRequest, Ipv6MembershipRequest, TimeVal, and IoVec are now repr(transparent). This is required for correctness's sake across all architectures and compilers, though now bugs have been reported so far. (#1243)
Fixed unaligned pointer read in Inotify::read_events. (#1244)

Removed

Removed sys::socket::addr::from_libc_sockaddr from the public API. (#1215)
Removed sys::termios::{get_libc_termios, get_libc_termios_mut, update_wrapper from the public API. These were previously hidden in the docs but still usable by downstream. (#1235)
Nix no longer implements NixPath for Option<P> where P: NixPath. Most Nix functions that accept NixPath arguments can't do anything useful with None. The exceptions (mount and quotactl_sync) already take explicitly optional arguments. (#1242)
Removed unistd::daemon and unistd::pipe2 on OSX and ios (#1255)
Removed sys::event::FilterFlag::NOTE_EXIT_REPARENTED and sys::event::FilterFlag::NOTE_REAP on OSX and ios. (#1255)
Removed sys::ptrace::ptrace on Android and Linux. (#1255)
Dropped support for powerpc64-unknown-linux-gnu (#1266)

[0.17.0] - 3 February 2020

Added

Add CLK_TCK to SysconfVar (#1177)

Changed

Fixed

Removed

Removed deprecated Error::description from error types (#1175)

[0.16.1] - 23 December 2019

Added

Changed

Fixed

Fixed the build for OpenBSD (#1168)

Removed

[0.16.0] - 1 December 2019

Added

Added ptrace::seize(): similar to attach() on Linux but with better-defined semantics. (#1154)
Added Signal::as_str(): returns signal name as &'static str (#1138)
Added posix_fallocate. (#1105)
Implemented Default for FdSet (#1107)
Added NixPath::is_empty. (#1107)
Added mkfifoat (#1133)
Added User::from_uid, User::from_name, User::from_gid and Group::from_name, (#1139)
Added linkat (#1101)
Added sched_getaffinity. (#1148)
Added optional Signal argument to ptrace::{detach, syscall} for signal injection. (#1083)

Changed

sys::termios::BaudRate now implements TryFrom<speed_t> instead of From<speed_t>. The old From implementation would panic on failure. (#1159)
sys::socket::ControlMessage::ScmCredentials and sys::socket::ControlMessageOwned::ScmCredentials now wrap UnixCredentials rather than libc::ucred. (#1160)
sys::socket::recvmsg now takes a plain Vec instead of a CmsgBuffer implementor. If you were already using cmsg_space!, then you needn't worry. (#1156)
sys::socket::recvfrom now returns Result<(usize, Option<SockAddr>)> instead of Result<(usize, SockAddr)>. (#1145)
Signal::from_c_int has been replaced by Signal::try_from (#1113)

Changed readlink and readlinkat to return OsString (#1109)

# use nix::fcntl::{readlink, readlinkat};
// the buffer argument of `readlink` and `readlinkat` has been removed,
// and the return value is now an owned type (`OsString`).
// Existing code can be updated by removing the buffer argument
// and removing any clone or similar operation on the output

// old code `readlink(&path, &mut buf)` can be replaced with the following
let _: OsString = readlink(&path);

// old code `readlinkat(dirfd, &path, &mut buf)` can be replaced with the following
let _: OsString = readlinkat(dirfd, &path);

Minimum supported Rust version is now 1.36.0. (#1108)
Ipv4Addr::octets, Ipv4Addr::to_std, Error::as_errno, ForkResult::is_child, ForkResult::is_parent, Gid::as_raw, Uid::is_root, Uid::as_raw, Pid::as_raw, and PollFd::revents now take self by value. (#1107)
Type &CString for parameters of exec(v|ve|vp|vpe|veat) are changed to &CStr. (#1121)

Fixed

Fix length of abstract socket addresses (#1120)
Fix initialization of msghdr in recvmsg/sendmsg when built with musl (#1136)

Removed

Remove the deprecated CmsgSpace. (#1156)

[0.15.0] - 10 August 2019

Added

Added MSG_WAITALL to MsgFlags in sys::socket. (#1079)
Implemented Clone, Copy, Debug, Eq, Hash, and PartialEq for most types that support them. (#1035)
Added copy_file_range wrapper (#1069)
Add mkdirat. (#1084)
Add posix_fadvise. (#1089)
Added AF_VSOCK to AddressFamily. (#1091)
Add unlinkat (#1058)
Add renameat. (#1097)

Changed

Support for ifaddrs now present when building for Android. (#1077)
Minimum supported Rust version is now 1.31.0 (#1035) (#1095)
Now functions statfs() and fstatfs() return result with Statfs wrapper (#928)

Fixed

Enabled sched_yield for all nix hosts. (#1090)

Removed

[0.14.1] - 2019-06-06

Added

Macros exported by nix may now be imported via use on the Rust 2018 edition without importing helper macros on Linux targets. (#1066)

For example, in Rust 2018, the ioctl_read_bad! macro can now be imported without importing the convert_ioctl_res! macro.
```
use nix::ioctl_read_bad;

ioctl_read_bad!(tcgets, libc::TCGETS, libc::termios);
```

Changed

Changed some public types from reexports of libc types like uint32_t to the native equivalents like u32. (#1072)

Fixed

Fix the build on Android and Linux/mips with recent versions of libc. (#1072)

Removed

[0.14.0] - 2019-05-21

Added

Add IP_RECVIF & IP_RECVDSTADDR. Enable IP_PKTINFO and IP6_PKTINFO on netbsd/openbsd. (#1002)
Added inotify_init1, inotify_add_watch and inotify_rm_watch wrappers for Android and Linux. (#1016)
Add ALG_SET_IV, ALG_SET_OP and ALG_SET_AEAD_ASSOCLEN control messages and AF_ALG socket types on Linux and Android (#1031)
Add killpg (#1034)
Added ENOTSUP errno support for Linux and Android. (#969)
Add several errno constants from OpenBSD 6.2 (#1036)
Added from_std and to_std methods for sys::socket::IpAddr (#1043)
Added nix::unistd:seteuid and nix::unistd::setegid for those platforms that do not support setresuid nor setresgid respectively. (#1044)
Added a access wrapper (#1045)
Add forkpty (#1042)
Add sched_yield (#1050)

Changed

PollFd event flags renamed to PollFlags (#1024)
recvmsg now returns an Iterator over ControlMessageOwned objects rather than ControlMessage objects. This is sadly not backwards-compatible. Fix code like this:
```
if let ControlMessage::ScmRights(&fds) = cmsg {
```
By replacing it with code like this:
```
if let ControlMessageOwned::ScmRights(fds) = cmsg {
```
(#1020)
Replaced CmsgSpace with the cmsg_space macro. (#1020)

Fixed

Fixed multiple bugs when using sendmsg and recvmsg with ancillary control messages (#1020)
Macros exported by nix may now be imported via use on the Rust 2018 edition without importing helper macros for BSD targets. (#1041)

For example, in Rust 2018, the ioctl_read_bad! macro can now be imported without importing the convert_ioctl_res! macro.
```
use nix::ioctl_read_bad;

ioctl_read_bad!(tcgets, libc::TCGETS, libc::termios);
```

Removed

Daemon, NOTE_REAP, and NOTE_EXIT_REPARENTED are now deprecated on OSX and iOS. (#1033)
PTRACE_GETREGS, PTRACE_SETREGS, PTRACE_GETFPREGS, and PTRACE_SETFPREGS have been removed from some platforms where they never should've been defined in the first place. (#1055)

[0.13.0] - 2019-01-15

Added

Added PKTINFO(V4) & V6PKTINFO cmsg support - Android/FreeBSD/iOS/Linux/MacOS. (#990)
Added support of CString type in setsockopt. (#972)
Added option TCP_CONGESTION in setsockopt. (#972)
Added symlinkat wrapper. (#997)
Added ptrace::{getregs, setregs}. (#1010)
Added nix::sys::signal::signal. (#817)
Added an mprotect wrapper. (#991)

Changed

Fixed

lutimes never worked on OpenBSD as it is not implemented on OpenBSD. It has been removed. (#1000)
fexecve never worked on NetBSD or on OpenBSD as it is not implemented on either OS. It has been removed. (#1000)

Removed

[0.12.0] 2018-11-28

Added

Added FromStr and Display impls for nix::sys::Signal (#884)
Added a sync wrapper. (#961)
Added a sysinfo wrapper. (#922)
Support the SO_PEERCRED socket option and the UnixCredentials type on all Linux and Android targets. (#921)
Added support for SCM_CREDENTIALS, allowing to send process credentials over Unix sockets. (#923)
Added a dir module for reading directories (wraps fdopendir, readdir, and rewinddir). (#916)
Added kmod module that allows loading and unloading kernel modules on Linux. (#930)
Added futimens and utimesat wrappers (#944), an lutimes wrapper (#967), and a utimes wrapper (#946).
Added AF_UNSPEC wrapper to AddressFamily (#948)
Added the mode_t public alias within sys::stat. (#954)
Added a truncate wrapper. (#956)
Added a fchownat wrapper. (#955)
Added support for ptrace on BSD operating systems (#949)
Added ptrace functions for reads and writes to tracee memory and ptrace kill (#949) (#958)
Added a acct wrapper module for enabling and disabling process accounting (#952)
Added the time_t and suseconds_t public aliases within sys::time. (#968)
Added unistd::execvpe for Haiku, Linux and OpenBSD (#975)
Added Error::as_errno. (#977)

Changed

Increased required Rust version to 1.24.1 (#900) (#966)

Fixed

Made preadv take immutable slice of IoVec. (#914)
Fixed passing multiple file descriptors over Unix Sockets. (#918)

Removed

[0.11.0] 2018-06-01

Added

Added sendfile on FreeBSD and Darwin. (#901)
Added pselect (#894)
Exposed preadv and pwritev on the BSDs. (#883)
Added mlockall and munlockall (#876)
Added SO_MARK on Linux. (#873)
Added safe support for nearly any buffer type in the sys::aio module. (#872)
Added sys::aio::LioCb as a wrapper for libc::lio_listio. (#872)
Added unistd::getsid (#850)
Added alarm. (#830)
Added interface flags IFF_NO_PI, IFF_TUN, IFF_TAP on linux-like systems. (#853)
Added statvfs module to all MacOS and Linux architectures. (#832)
Added EVFILT_EMPTY, EVFILT_PROCDESC, and EVFILT_SENDFILE on FreeBSD. (#825)
Exposed termios::cfmakesane on FreeBSD. (#825)
Exposed MSG_CMSG_CLOEXEC on *BSD. (#825)
Added fchmod, fchmodat. (#857)
Added request_code_write_int! on FreeBSD/DragonFlyBSD (#833)

Changed

Display and Debug for SysControlAddr now includes all fields. (#837)
ioctl! has been replaced with a family of ioctl_*! macros. (#833)
io!, ior!, iow!, and iorw! has been renamed to request_code_none!, request_code_read!, request_code_write!, and request_code_readwrite! respectively. These have also now been exposed in the documentation. (#833)
Enabled more ptrace::Request definitions for uncommon Linux platforms (#892)
Emulation of FD_CLOEXEC and O_NONBLOCK was removed from socket(), accept4(), and socketpair(). (#907)

Fixed

Fixed possible panics when using SigAction::flags on Linux (#869)
Properly exposed 460800 and 921600 baud rates on NetBSD (#837)
Fixed ioctl_write_int! on FreeBSD/DragonFlyBSD (#833)
ioctl_write_int! now properly supports passing a c_ulong as the parameter on Linux non-musl targets (#833)

Removed

Removed explicit support for the bytes crate from the sys::aio module. See sys::aio::AioCb::from_boxed_slice examples for alternatives. (#872)
Removed sys::aio::lio_listio. Use sys::aio::LioCb::listio instead. (#872)
Removed emulated accept4() from macos, ios, and netbsd targets (#907)
Removed IFF_NOTRAILERS on OpenBSD, as it has been removed in OpenBSD 6.3 (#893)

[0.10.0] 2018-01-26

Added

Added specialized wrapper: sys::ptrace::step (#852)
Added AioCb::from_ptr and AioCb::from_mut_ptr (#820)
Added specialized wrappers: sys::ptrace::{traceme, syscall, cont, attach}. Using the matching routines with sys::ptrace::ptrace is now deprecated.
Added nix::poll module for all platforms (#672)
Added nix::ppoll function for FreeBSD and DragonFly (#672)
Added protocol families in AddressFamily enum. (#647)
Added the pid() method to WaitStatus for extracting the PID. (#722)
Added nix::unistd:fexecve. (#727)
Expose uname() on all platforms. (#739)
Expose signalfd module on Android as well. (#739)
Added nix::sys::ptrace::detach. (#749)
Added timestamp socket control message variant: nix::sys::socket::ControlMessage::ScmTimestamp (#663)
Added socket option variant that enables the timestamp socket control message: nix::sys::socket::sockopt::ReceiveTimestamp (#663)
Added more accessor methods for AioCb (#773)
Add nix::sys::fallocate (#768)
Added nix::unistd::mkfifo. (#602)
Added ptrace::Options::PTRACE_O_EXITKILL on Linux and Android. (#771)
Added nix::sys::uio::{process_vm_readv, process_vm_writev} on Linux (#568)
Added nix::unistd::{getgroups, setgroups, getgrouplist, initgroups}. (#733)
Added nix::sys::socket::UnixAddr::as_abstract on Linux and Android. (#785)
Added nix::unistd::execveat on Linux and Android. (#800)
Added the from_raw() method to WaitStatus for converting raw status values to WaitStatus independent of syscalls. (#741)
Added more standard trait implementations for various types. (#814)
Added sigprocmask to the signal module. (#826)
Added nix::sys::socket::LinkAddr on Linux and all bsdlike system. (#813)
Add socket options for IP_TRANSPARENT / BIND_ANY. (#835)

Changed

Exposed the mqueue module for all supported operating systems. (#834)
Use native pipe2 on all BSD targets. Users should notice no difference. (#777)
Renamed existing ptrace wrappers to encourage namespacing (#692)
Marked sys::ptrace::ptrace as unsafe.
Changed function signature of socket() and socketpair(). The protocol argument has changed type from c_int to SockProtocol. It accepts a None value for default protocol that was specified with zero using c_int. (#647)
Made select easier to use, adding the ability to automatically calculate the nfds parameter using the new FdSet::highest (#701)
Exposed unistd::setresuid and unistd::setresgid on FreeBSD and OpenBSD (#721)
Refactored the statvfs module removing extraneous API functions and the statvfs::vfs module. Additionally (f)statvfs() now return the struct directly. And the returned Statvfs struct now exposes its data through accessor methods. (#729)
The addr argument to madvise and msync is now *mut to better match the libc API. (#731)
shm_open and shm_unlink are no longer exposed on Android targets, where they are not officially supported. (#731)
MapFlags, MmapAdvise, and MsFlags expose some more variants and only officially-supported variants are provided for each target. (#731)
Marked pty::ptsname function as unsafe (#744)
Moved constants ptrace request, event and options to enums and updated ptrace functions and argument types accordingly. (#749)
AioCb::Drop will now panic if the AioCb is still in-progress (#715)
Restricted nix::sys::socket::UnixAddr::new_abstract to Linux and Android only. (#785)
The ucred struct has been removed in favor of a UserCredentials struct that contains only getters for its fields. (#814)
Both ip_mreq and ipv6_mreq have been replaced with IpMembershipRequest and Ipv6MembershipRequest. (#814)
Removed return type from pause. (#829)
Changed the termios APIs to allow for using a u32 instead of the BaudRate enum on BSD platforms to support arbitrary baud rates. See the module docs for nix::sys::termios for more details. (#843)

Fixed

Fix compilation and tests for OpenBSD targets (#688)
Fixed error handling in AioCb::fsync, AioCb::read, and AioCb::write. It is no longer an error to drop an AioCb that failed to enqueue in the OS. (#715)
Fix potential memory corruption on non-Linux platforms when using sendmsg/recvmsg, caused by mismatched msghdr definition. (#648)

Removed

AioCb::from_boxed_slice has been removed. It was never actually safe. Use from_bytes or from_bytes_mut instead. (#820)
The syscall module has been removed. This only exposed enough functionality for memfd_create() and pivot_root(), which are still exposed as separate functions. (#747)
The Errno variants are no longer reexported from the errno module. Errno itself is no longer reexported from the crate root and instead must be accessed using the errno module. (#696)
Removed MS_VERBOSE, MS_NOSEC, and MS_BORN from MsFlags. These are internal kernel flags and should never have been exposed. (#814)

[0.9.0] 2017-07-23

Added

Added sysconf, pathconf, and fpathconf (#630
Added sys::signal::SigAction::{ flags, mask, handler} (#611
Added nix::sys::pthread::pthread_self (#591
Added AioCb::from_boxed_slice (#582
Added nix::unistd::{openat, fstatat, readlink, readlinkat} (#551)
Added nix::pty::{grantpt, posix_openpt, ptsname/ptsname_r, unlockpt} (#556
Added nix::ptr::openpty (#456)
Added nix::ptrace::{ptrace_get_data, ptrace_getsiginfo, ptrace_setsiginfo and nix::Error::UnsupportedOperation} (#614)
Added cfmakeraw, cfsetspeed, and tcgetsid. (#527)
Added "bad none", "bad write_ptr", "bad write_int", and "bad readwrite" variants to the ioctl! macro. (#670)
On Linux and Android, added support for receiving PTRACE_O_TRACESYSGOOD events from wait and waitpid using WaitStatus::PtraceSyscall (#566).

Changed

The ioctl! macro and its variants now allow the generated functions to have doccomments. (#661)
Changed ioctl!(write ...) into ioctl!(write_ptr ...) and ioctl!(write_int ..) variants to more clearly separate those use cases. (#670)
Marked sys::mman::{ mmap, munmap, madvise, munlock, msync } as unsafe. (#559)
Minimum supported Rust version is now 1.13.
Removed revents argument from PollFd::new() as it's an output argument and will be overwritten regardless of value. (#542)
Changed type signature of sys::select::FdSet::contains to make self immutable (#564)
Introduced wrapper types for gid_t, pid_t, and uid_t as Gid, Pid, and Uid respectively. Various functions have been changed to use these new types as arguments. (#629)
Fixed compilation on all Android and iOS targets (#527) and promoted them to Tier 2 support.
nix::sys::statfs::{statfs,fstatfs} uses statfs definition from libc::statfs instead of own linux specific type nix::sys::Statfs. Also file system type constants like nix::sys::statfs::ADFS_SUPER_MAGIC were removed in favor of the libc equivalent. (#561)
Revised the termios API including additional tests and documentation and exposed it on iOS. (#527)
eventfd, signalfd, and pwritev/preadv functionality is now included by default for all supported platforms. (#681)
The ioctl! macro's plain variants has been replaced with "bad read" to be consistent with other variants. The generated functions also have more strict types for their arguments. The "*_buf" variants also now calculate total array size and take slice references for improved type safety. The documentation has also been dramatically improved. (#670)

Removed

Removed io::Error from nix::Error and the conversion from nix::Error to Errno (#614)
All feature flags have been removed in favor of conditional compilation on supported platforms. execvpe is no longer supported, but this was already broken and will be added back in the next release. (#681)
Removed ioc_* functions and many helper constants and macros within the ioctl module. These should always have been private and only the ioctl! should be used in public code. (#670)

Fixed

Fixed multiple issues compiling under different archetectures and OSes. Now compiles on Linux/MIPS (#538), Linux/PPC (#553), MacOS/x86_64,i686 (#553), NetBSD/x64_64 (#538), FreeBSD/x86_64,i686 (#536), and Android (#631).
bind and errno_location now work correctly on Android (#631)
Added nix::ptrace on all Linux-kernel-based platforms #624. Previously it was only available on x86, x86-64, and ARM, and also not on Android.
Fixed sys::socket::sendmsg with zero entry cmsgs parameter. (#623)
Multiple constants related to the termios API have now been properly defined for all supported platforms. (#527)
ioctl! macro now supports working with non-int datatypes and properly supports all platforms. (#670)

[0.8.1] 2017-04-16

Fixed

Fixed build on FreeBSD. (Cherry-picked a859ee3c)

[0.8.0] 2017-03-02

Added

Added ::nix::sys::termios::BaudRate enum to provide portable baudrate values. (#518)
Added a new WaitStatus::PtraceEvent to support ptrace events on Linux and Android (#438)
Added support for POSIX AIO (#483) (#506)
Added support for XNU system control sockets (#478)
Added support for ioctl calls on BSD platforms (#478)
Added struct TimeSpec (#475) (#483)
Added complete definitions for all kqueue-related constants on all supported OSes (#415)
Added function epoll_create1 and bitflags EpollCreateFlags in ::nix::sys::epoll in order to support ::libc::epoll_create1. (#410)
Added setresuid and setresgid for Linux in ::nix::unistd (#448)
Added getpgid in ::nix::unistd (#433)
Added tcgetpgrp and tcsetpgrp in ::nix::unistd (#451)
Added CLONE_NEWCGROUP in ::nix::sched (#457)
Added getpgrp in ::nix::unistd (#491)
Added fchdir in ::nix::unistd (#497)
Added major and minor in ::nix::sys::stat for decomposing dev_t (#508)
Fixed the style of many bitflags and use libc in more places. (#503)
Added ppoll in ::nix::poll (#520)
Added support for getting and setting pipe size with fcntl(2) on Linux (#540)

Changed

::nix::sys::termios::{cfgetispeed, cfsetispeed, cfgetospeed, cfsetospeed} switched to use BaudRate enum from speed_t. (#518)
epoll_ctl now could accept None as argument event when op is EpollOp::EpollCtlDel. (#480)
Removed the bad keyword from the ioctl! macro (#478)
Changed TimeVal into an opaque Newtype (#475)
kill's signature, defined in ::nix::sys::signal, changed, so that the signal parameter has type T: Into<Option<Signal>>. None as an argument for that parameter will result in a 0 passed to libc's kill, while a Some-argument will result in the previous behavior for the contained Signal. (#445)
The minimum supported version of rustc is now 1.7.0. (#444)
Changed KEvent to an opaque structure that may only be modified by its constructor and the ev_set method. (#415) (#442) (#463)
pipe2 now calls libc::pipe2 where available. Previously it was emulated using pipe, which meant that setting O_CLOEXEC was not atomic. (#427)
Renamed EpollEventKind to EpollFlags in ::nix::sys::epoll in order for it to conform with our conventions. (#410)
EpollEvent in ::nix::sys::epoll is now an opaque proxy for ::libc::epoll_event. The formerly public field events is now be read-only accessible with the new method events() of EpollEvent. Instances of EpollEvent can be constructed using the new method new() of EpollEvent. (#410)
SigFlags in ::nix::sys::signal has be renamed to SigmaskHow and its type has changed from bitflags to enum in order to conform to our conventions. (#460)
sethostname now takes a &str instead of a &[u8] as this provides an API that makes more sense in normal, correct usage of the API.
gethostname previously did not expose the actual length of the hostname written from the underlying system call at all. This has been updated to return a &CStr within the provided buffer that is always properly NUL-terminated (this is not guaranteed by the call with all platforms/libc implementations).
Exposed all fcntl(2) operations at the module level, so they can be imported direclty instead of via FcntlArg enum. (#541)

Fixed

Fixed multiple issues with Unix domain sockets on non-Linux OSes (#474)
Fixed using kqueue with EVFILT_USER on FreeBSD (#415)
Fixed the build on FreeBSD, and fixed the getsockopt, sendmsg, and recvmsg functions on that same OS. (#397)
Fixed an off-by-one bug in UnixAddr::new_abstract in ::nix::sys::socket. (#429)
Fixed clone passing a potentially unaligned stack. (#490)
Fixed mkdev not creating a dev_t the same way as libc. (#508)

[0.7.0] 2016-09-09

Added

Added lseek and lseek64 in ::nix::unistd (#377)
Added mkdir and getcwd in ::nix::unistd (#416)
Added accessors sigmask_mut and sigmask to UContext in ::nix::ucontext. (#370)
Added WUNTRACED to WaitPidFlag in ::nix::sys::wait for non-linux targets. (#379)
Added new module ::nix::sys::reboot with enumeration RebootMode and functions reboot and set_cad_enabled. Currently for linux only. (#386)
FdSet in ::nix::sys::select now also implements Clone. (#405)
Added F_FULLFSYNC to FcntlArg in ::nix::fcntl for apple targets. (#407)
Added CpuSet::unset in ::nix::sched. (#402)
Added constructor method new() to PollFd in ::nix::poll, in order to allow creation of objects, after removing public access to members. (#399)
Added method revents() to PollFd in ::nix::poll, in order to provide read access to formerly public member revents. (#399)
Added MSG_CMSG_CLOEXEC to MsgFlags in ::nix::sys::socket for linux only. (#422)

Changed

Replaced the reexported integer constants for signals by the enumeration Signal in ::nix::sys::signal. (#362)
Renamed EventFdFlag to EfdFlags in ::nix::sys::eventfd. (#383)
Changed the result types of CpuSet::is_set and CpuSet::set in ::nix::sched to Result<bool> and Result<()>, respectively. They now return EINVAL, if an invalid argument for the field parameter is passed. (#402)
MqAttr in ::nix::mqueue is now an opaque proxy for ::libc::mq_attr, which has the same structure as the old MqAttr. The field mq_flags of ::libc::mq_attr is readable using the new method flags() of MqAttr. MqAttr also no longer implements Debug. (#392)
The parameter msq_prio of mq_receive with type u32 in ::nix::mqueue was replaced by a parameter named msg_prio with type &mut u32, so that the message priority can be obtained by the caller. (#392)
The type alias MQd in ::nix::queue was replaced by the type alias libc::mqd_t, both of which are aliases for the same type. (#392)

Removed

Type alias SigNum from ::nix::sys::signal. (#362)
Type alias CpuMask from ::nix::shed. (#402)
Removed public fields from PollFd in ::nix::poll. (See also added method revents(). (#399)

Fixed

Fixed the build problem for NetBSD (Note, that we currently do not support it, so it might already be broken again). (#389)
Fixed the build on FreeBSD, and fixed the getsockopt, sendmsg, and recvmsg functions on that same OS. (#397)

[0.6.0] 2016-06-10

Added

Added gettid in ::nix::unistd for linux and android. (#293)
Some mips support in ::nix::sched and ::nix::sys::syscall. (#301)
Added SIGNALFD_SIGINFO_SIZE in ::nix::sys::signalfd. (#309)
Added new module ::nix::ucontext with struct UContext. Currently for linux only. (#311)
Added EPOLLEXCLUSIVE to EpollEventKind in ::nix::sys::epoll. (#330)
Added pause to ::nix::unistd. (#336)
Added sleep to ::nix::unistd. (#351)
Added S_IFDIR, S_IFLNK, S_IFMT to SFlag in ::nix::sys::stat. (#359)
Added clear and extend functions to SigSet's implementation in ::nix::sys::signal. (#347)
sockaddr_storage_to_addr in ::nix::sys::socket now supports sockaddr_nl on linux and android. (#366)
Added support for SO_ORIGINAL_DST in ::nix::sys::socket on linux. (#367)
Added SIGINFO in ::nix::sys::signal for the macos target as well as SIGPWR and SIGSTKFLT in ::nix::sys::signal for non-macos targets. (#361)

Changed

Changed the structure IoVec in ::nix::sys::uio. (#304)
Replaced CREATE_NEW_FD by SIGNALFD_NEW in ::nix::sys::signalfd. (#309)
Renamed SaFlag to SaFlags and SigFlag to SigFlags in ::nix::sys::signal. (#314)
Renamed Fork to ForkResult and changed its fields in ::nix::unistd. (#332)
Added the signal parameter to clone's signature in ::nix::sched. (#344)
execv, execve, and execvp now return Result<Void> instead of Result<()> in ::nix::unistd. (#357)

Fixed

Improved the conversion from std::net::SocketAddr to InetAddr in ::nix::sys::socket::addr. (#335)

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Change Log

[Unreleased] - ReleaseDate

Added

Changed

Fixed

Removed

[0.25.0] - 2022-08-13

Added

Changed

Removed

[0.24.2] - 2022-07-17

Fixed

[0.24.1] - 2022-04-22

Fixed

[0.24.0] - 2022-04-21

Added

Changed

Fixed

Removed

[0.23.1] - 2021-12-16

Changed

Fixed

[0.23.0] - 2021-09-28

Added

Changed

Fixed

Removed

[0.22.0] - 9 July 2021

Added

Changed

Fixed

Removed

[0.21.0] - 31 May 2021

Added

Changed

Fixed

Removed

[0.20.0] - 20 February 2021

Added

Changed

Fixed

Removed

[0.19.1] - 28 November 2020

Fixed

[0.19.0] - 6 October 2020

Added

Changed

Fixed

Removed

[0.18.0] - 26 July 2020

Added

Changed

Fixed

Removed

[0.17.0] - 3 February 2020

Added

Changed

Fixed

Removed

[0.16.1] - 23 December 2019

Added

Changed

Fixed

Removed

[0.16.0] - 1 December 2019

Added

Changed

Fixed

Removed

[0.15.0] - 10 August 2019

Added

Changed

Fixed

Removed