pub unsafe fn ioctl<F: AsFd, I: Ioctl>(fd: F, ioctl: I) -> Result<I::Output>
Expand description
Perform an ioctl
call.
ioctl
was originally intended to act as a way of modifying the behavior
of files, but has since been adopted as a general purpose system call for
making calls into the kernel. In addition to the default calls exposed by
generic file descriptors, many drivers expose their own ioctl
calls for
controlling their behavior, some of which are proprietary.
This crate exposes many other ioctl
interfaces with safe and idiomatic
wrappers, like ioctl_fionbio
and ioctl_fionread
. It is recommended
to use those instead of this function, as they are safer and more
idiomatic. For other cases, implement the Ioctl
API and pass it to this
function.
See documentation for Ioctl
for more information.
§Safety
While Ioctl
takes much of the unsafety out of ioctl
calls, it is
still unsafe to call this code with arbitrary device drivers, as it is up
to the device driver to implement the ioctl
call correctly. It is on the
onus of the protocol between the user and the driver to ensure that the
ioctl
call is safe to make.