use crate::fd::OwnedFd;
use crate::{backend, io};

pub use backend::event::types::EventfdFlags;

/// `eventfd(initval, flags)`—Creates a file descriptor for event
/// notification.
///
/// # References
///  - [Linux]
///  - [FreeBSD]
///  - [illumos]
///
/// [Linux]: https://man7.org/linux/man-pages/man2/eventfd.2.html
/// [FreeBSD]: https://man.freebsd.org/cgi/man.cgi?eventfd
/// [illumos]: https://illumos.org/man/3C/eventfd
#[inline]
pub fn eventfd(initval: u32, flags: EventfdFlags) -> io::Result<OwnedFd> {
    backend::event::syscalls::eventfd(initval, flags)
}