summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-10 15:15:21 -0300
committerGabriel Schneider <[email protected]>2026-11-10 15:16:02 -0300
commitbe80d248f88137af29d32e36b9bbba6557f00100 (patch)
treed083791aa3c1fa69aba6e8fa1d3d82f094896162 /src
parent1d54a3d3220706acfe704a0c1d6cda47cc0df43d (diff)
downloadcomputeranim-be80d248f88137af29d32e36b9bbba6557f00100.tar.gz
computeranim-be80d248f88137af29d32e36b9bbba6557f00100.zip
syscalls: an argument's name, by call
names(nr) gives fd, buf, count for read and its like: what a viewer of a syscall labels an argument with, where it had only the argument's kind.
Diffstat (limited to 'src')
-rw-r--r--src/trace/syscalls.zig70
1 files changed, 70 insertions, 0 deletions
diff --git a/src/trace/syscalls.zig b/src/trace/syscalls.zig
index 7e276bb..75810a0 100644
--- a/src/trace/syscalls.zig
+++ b/src/trace/syscalls.zig
@@ -61,6 +61,66 @@ pub fn signature(nr: u64) []const u8 {
};
}
+/// What each argument of a syscall is called, in order, for the ones a
+/// reader meets most: the names its manual page uses. Empty for a syscall
+/// not listed; a viewer then has `signature` and the argument's number.
+pub fn names(nr: u64) []const []const u8 {
+ return switch (std.enums.fromInt(linux.SYS, nr) orelse return &.{}) {
+ .read, .pread64 => &.{ "fd", "buf", "count", "offset" },
+ .write, .pwrite64 => &.{ "fd", "buf", "count", "offset" },
+ .readv, .writev, .pwritev, .pwritev2 => &.{ "fd", "iov", "iovcnt", "offset" },
+ .open => &.{ "path", "flags", "mode" },
+ .openat => &.{ "dirfd", "path", "flags", "mode" },
+ .close, .fsync, .dup => &.{"fd"},
+ .dup2 => &.{ "oldfd", "newfd" },
+ .stat, .lstat => &.{ "path", "statbuf" },
+ .fstat => &.{ "fd", "statbuf" },
+ .newfstatat => &.{ "dirfd", "path", "statbuf", "flags" },
+ .statx => &.{ "dirfd", "path", "flags", "mask", "statxbuf" },
+ .access => &.{ "path", "mode" },
+ .faccessat, .faccessat2 => &.{ "dirfd", "path", "mode", "flags" },
+ .lseek => &.{ "fd", "offset", "whence" },
+ .mmap => &.{ "addr", "length", "prot", "flags", "fd", "offset" },
+ .mprotect => &.{ "addr", "length", "prot" },
+ .munmap => &.{ "addr", "length" },
+ .mremap => &.{ "old_addr", "old_size", "new_size", "flags", "new_addr" },
+ .madvise => &.{ "addr", "length", "advice" },
+ .brk => &.{"addr"},
+ .ioctl => &.{ "fd", "request", "arg" },
+ .fcntl => &.{ "fd", "cmd", "arg" },
+ .execve => &.{ "path", "argv", "envp" },
+ .exit, .exit_group => &.{"status"},
+ .kill => &.{ "pid", "sig" },
+ .tgkill => &.{ "tgid", "tid", "sig" },
+ .wait4 => &.{ "pid", "wstatus", "options", "rusage" },
+ .rt_sigaction => &.{ "signum", "act", "oldact", "sigsetsize" },
+ .rt_sigprocmask => &.{ "how", "set", "oldset", "sigsetsize" },
+ .futex => &.{ "uaddr", "op", "val", "timeout", "uaddr2", "val3" },
+ .clock_gettime, .clock_getres => &.{ "clockid", "tp" },
+ .nanosleep => &.{ "req", "rem" },
+ .getrandom => &.{ "buf", "buflen", "flags" },
+ .getdents64 => &.{ "fd", "dirp", "count" },
+ .getcwd => &.{ "buf", "size" },
+ .chdir, .rmdir, .unlink => &.{"path"},
+ .unlinkat, .mkdirat => &.{ "dirfd", "path", "flags" },
+ .mkdir, .chmod => &.{ "path", "mode" },
+ .rename => &.{ "oldpath", "newpath" },
+ .readlink => &.{ "path", "buf", "bufsiz" },
+ .readlinkat => &.{ "dirfd", "path", "buf", "bufsiz" },
+ .arch_prctl => &.{ "op", "addr" },
+ .set_tid_address => &.{"tidptr"},
+ .set_robust_list => &.{ "head", "len" },
+ .prlimit64 => &.{ "pid", "resource", "new_limit", "old_limit" },
+ .rseq => &.{ "rseq", "rseq_len", "flags", "sig" },
+ .clone => &.{ "flags", "stack", "parent_tid", "child_tid", "tls" },
+ .clone3 => &.{ "cl_args", "size" },
+ .pipe => &.{"pipefd"},
+ .uname => &.{"buf"},
+ .sched_getaffinity => &.{ "pid", "cpusetsize", "mask" },
+ else => &.{},
+ };
+}
+
/// A call the way strace prints it, from a `syscall_enter` event and its
/// payload: `openat(-100, "/etc/passwd", 0x80000, 0x0)`.
pub fn formatEnter(w: *std.Io.Writer, ev: *const Event, payload: []const u8) !void {
@@ -142,3 +202,13 @@ test "a call prints the way strace prints it" {
try std.testing.expectEqualStrings("exit_group", name(231).?);
try std.testing.expect(name(100_000) == null);
}
+
+test "an argument has the name its manual page gives it" {
+ try std.testing.expectEqualStrings("fd", names(@backingInt(linux.SYS.close))[0]);
+ try std.testing.expectEqualStrings("flags", names(@backingInt(linux.SYS.openat))[2]);
+ // Every name has an argument to be the name of.
+ inline for (.{ linux.SYS.read, linux.SYS.mmap, linux.SYS.openat, linux.SYS.futex, linux.SYS.close }) |nr| {
+ try std.testing.expect(names(@backingInt(nr)).len >= signature(@backingInt(nr)).len);
+ }
+ try std.testing.expectEqual(@as(usize, 0), names(100000).len);
+}