3 unstable releases

0.2.1 Jun 18, 2023
0.2.0 Oct 24, 2021
0.1.0 Sep 16, 2018

#665 in Unix APIs

Download history 8/week @ 2024-07-24 14/week @ 2024-07-31 56/week @ 2024-08-07 12/week @ 2024-08-14 64/week @ 2024-08-21 5/week @ 2024-08-28 35/week @ 2024-09-04 26/week @ 2024-09-11 9/week @ 2024-09-18 23/week @ 2024-09-25 22/week @ 2024-10-02 32/week @ 2024-10-09 12/week @ 2024-10-16 24/week @ 2024-10-23 19/week @ 2024-10-30 5/week @ 2024-11-06

64 downloads per month

MIT license

26KB
394 lines

hinix

High level *nix functionality in Rust.

This sits atop the Rust nix crate and provides higher-order functionality for systems programming on a *nix (Linux, Posix, Unix, etc) operating system.

Initial versions of this library are mostly concerned with interprocess communications on a single host, with objects that wrap various communicaton and synchronization mechanisms such as event objects, message querues, etc.

New Features in v0.2.1

  • Posix Message Queues - MsgQueue
  • Message queue utility apps, mqsend & mqrecv

Minimum Supported Rust Version

The MSRV is Rust Edition 2021, v1.63.0

Interprocess Communications

There are a number of objects to wrap interprocess communications mechanisms on *nix systems. These are primarily high-performance communications and synchronization subsystems in the kernel for passing data and signals between different programs.

Posix Message Queues: MsgQueue

Efficient, prioritized, messaging system for multiple producers and consumers.

A process can create a named queue in the directory pathname space, regulating access through normal file permissions. Each queue is creted with a maximum number of messages and a maximum size for each message. Individual messages can be variable size, with the system properly delimiting each. Queues can be queried for size and the number of available messages, etc, and all I/O operations can be non-blocking.

See mq_overview man page.

This is all available via the MsqQueue struct. Use like:

let mq = MsgQueue::create("/myque", 4, 512)?;
mq.send(b"Hello, world!")?;

This creates a queue, named "/myque", with 4 slots that can contain messages up to 512 bytes each, and then writes the bytes "Hello, world!" as a message to the queue.

Note that in Linux, queue names must start with a forward slash and must not contain any other slashes.

Event Notification: EventFd

A system for event notifications via the file system. This is a wait and notify system that can send events between user-space applications absed around a 64-bit integer counter. Depending on the flags used to create the object, it can act to pass values between the apps, or it can act like a semaphore where a write increments the value, a read decrements it, and the reader blocks when the value is zero.

See eventfd man page.

A useful aspect of the event notification system is that it is based around file descriptors and thus can be inserted into I/O polling loops that use select/poll/epoll semantics to provide aditional signaling, such as when to quit or pause, or perform some other operation.

let evt = EventFd::new(0)?;
evt.write(42)?;

Dependencies

~2MB
~38K SLoC