diff options
| author | Gabriel Schneider <[email protected]> | 2026-11-10 15:15:21 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-11-10 15:16:02 -0300 |
| commit | be80d248f88137af29d32e36b9bbba6557f00100 (patch) | |
| tree | d083791aa3c1fa69aba6e8fa1d3d82f094896162 /src/trace | |
| parent | 1d54a3d3220706acfe704a0c1d6cda47cc0df43d (diff) | |
| download | computeranim-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/trace')
| -rw-r--r-- | src/trace/syscalls.zig | 70 |
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); +} |
