syscalls
This is a low-level library for listing and invoking raw Linux system calls.
Features
- Provides of all syscalls for multiple architectures (see table below).
- Provides methods for invoking raw syscalls.
- Provides an
Errno
type for Rustic error handling.
Feature Flags
The features that are enabled by default include std
and serde
.
std
By default, std
support is enabled. If you wish to compile in a no_std
environment, use:
syscalls = { version = "0.6", default-features = false }
serde
Various types can be serialized with Serde. This can be enabled with:
syscalls = { version = "0.6", features = ["serde"] }
full
Enables all extra features.
all
Enables syscall tables for all architectures. If you don't need all
architectures, you can enable them individually with features like arm
, x86
,
powerpc
, etc. See the Architecture Support table below for a full list of
available architectures.
Architecture Support
The Enum column means that a Sysno
enum is implemented for this
architecture.
The Invoke column means that syscalls can be invoked for this architecture.
The Stable Rust? column means that syscall invocation only requires stable Rust. Some architectures require nightly Rust because inline assembly is not yet stabilized for all architectures.
Arch | Enum | Invoke | Stable Rust? |
---|---|---|---|
arm |
Yes |
||
aarch64 |
N/A | ||
mips |
No |
||
mips64 |
No |
||
powerpc |
No |
||
powerpc64 |
No |
||
s390x |
No |
||
sparc |
N/A | ||
sparc64 |
N/A | ||
x86 |
Yes |
||
x86_64 |
Yes |
Updating the syscall list
Updates are pulled from the .tbl
files in the Linux source tree.
- Change the Linux version in
syscalls-gen/src/main.rs
to the latest version. Using a release candidate version is OK. - Run
cd syscalls-gen && cargo run
. This will regenerate the syscall tables insrc/arch/
.