Age | Commit message (Collapse) | Author |
|
|
|
Some of the tests are currently unrunnable, but the basic library is at least
buildable.
|
|
|
|
Two problems were fixed:
1. All of the comments for the module were prefixed with `///!` instead
of just `//!`
2. There was no newline before lists which is required in markdown, so
they were not rendering correctly.
|
|
The ioctl interface expected by most external parties is that of
an unsigned long (c_ulong). The libc crate expects as an int. This
change exposes c_ulong (via ioctl_op_t) to external users and
casts to c_int before calling the libc function.
The only documentation in SUSv3 for ioctl has to do with stream
devices. The support documented there is not widely supported (it
is not supported by the Linux kernel)[1].
[1] The Linux Programming Interface, Page 86.
|
|
This commit provides a new implementation for ioctl that is much
more generic, allowing for clients to use send any manner of ioctl
requests at special files. The implementation provides two main features
that help to raise the level of abstraction over that provided by libc.
1. The module now provides functions that provide the same functionality
as the linux kernel _IO* macros. These are used frequently in the
linux kernel for building ops for ioctls. The use of these helper
functions are not required.
2. Functions are provided for the 3 main types of ioctl usage patterns
(read, write, and execute). For many subystems, the read() call
which returns a Result<T> and the write calls taking a &T provide
a nice interface.
All of the methods wrapping ioctl are unsafe and will probably need to
remain that way unless knowledge of the semantics of every possible
ioctl call are added to the nix library. The best that exists for
ioctls are some conventions around the op, but even these conventions
are really only used for newer devices added to the kernel.
This change resolves #108
|
|
|
|
|
|
|
|
|
|
|
|
|