30 releases

new 0.6.9 Mar 23, 2023
0.6.7 Oct 12, 2022
0.6.5 Jul 14, 2022
0.5.0 Oct 18, 2021
0.1.4 Oct 1, 2019

#30 in Unix APIs

Download history 973/week @ 2022-12-02 1161/week @ 2022-12-09 749/week @ 2022-12-16 408/week @ 2022-12-23 444/week @ 2022-12-30 705/week @ 2023-01-06 672/week @ 2023-01-13 898/week @ 2023-01-20 1363/week @ 2023-01-27 1241/week @ 2023-02-03 1449/week @ 2023-02-10 1107/week @ 2023-02-17 1011/week @ 2023-02-24 1006/week @ 2023-03-03 864/week @ 2023-03-10 1050/week @ 2023-03-17

4,039 downloads per month
Used in 4 crates (3 directly)

BSD-2-Clause

745KB
7.5K SLoC

syscalls

Crates.io docs.rs License

This is a low-level library for listing and invoking raw Linux system calls.

Features

  • Provides a syscall enum for multiple architectures (see table below).
  • Provides methods for invoking raw syscalls.
  • Provides an Errno type for Rustic error handling.
  • Provides O(1) array-backed SysnoSet and SysnoMap types.

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 Yes ✅
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.

  1. Change the Linux version in syscalls-gen/src/main.rs to the latest version. Only updated to the latest stable version (not release candidates).
  2. Run cd syscalls-gen && cargo run. This will regenerate the syscall tables in src/arch/.

Dependencies

~0.8–1.4MB
~34K SLoC