std.os.linux: resurrect shm

This reintroduces Linux's shared memory system calls which was in
#7214. It also adds the externs
necessary for C.

Author: RossComputerGuy

lib/std/c/linux.zig

@@ -65,6 +65,7 @@ pub const dl_phdr_info = linux.dl_phdr_info;
 pub const empty_sigset = linux.empty_sigset;
 pub const epoll_event = linux.epoll_event;
 pub const fd_t = linux.fd_t;
+pub const key_t = linux.key_t;
 pub const gid_t = linux.gid_t;
 pub const ifreq = linux.ifreq;
 pub const ino_t = linux.ino_t;
@@ -344,3 +345,8 @@ pub const dirent64 = struct {
     type: u8,
     name: [256]u8,
 };
+
+pub extern "c" fn shmget(key: key_t, size: usize, shmflg: u32) usize;
+pub extern "c" fn shmat(shmid: i32, shmaddr: ?[*]align(std.mem.page_size) u8, shmflg: u32) usize;
+pub extern "c" fn shmctl(shmid: i32, cmd: i32, buf: ?[*]u8) usize;
+pub extern "c" fn shmdt(shmaddr: [*]u8) usize;

lib/std/os/linux.zig

@@ -799,6 +799,89 @@ pub fn munmap(address: [*]const u8, length: usize) usize {
     return syscall2(.munmap, @intFromPtr(address), length);
 }
 
+pub const key_t = i32;
+pub const IPC_PRIVATE = 0;
+
+/// create key if key does not exist
+pub const IPC_CREAT = 0x200;
+
+/// fail if key exists
+pub const IPC_EXCL = 0x400;
+
+/// return error on wait
+pub const IPC_NOWAIT = 0x800;
+
+/// segment will be destroyed on last detach
+pub const SHM_DEST = 0x200;
+
+/// segment will not be swapped
+pub const SHM_LOCKED = 0x400;
+
+/// segment will use huge TLB pages
+pub const SHM_HUGETLB = 0x800;
+
+pub const SHM_HUGE_SHIFT = 26;
+pub const SHM_HUGE_2MB = 21 << SHM_HUGE_SHIFT;
+pub const SHM_HUGE_1GB = 30 << SHM_HUGE_SHIFT;
+
+/// don't check for reservations
+pub const SHM_NORESERVE = 0x1000;
+
+/// attach read-only else read-write
+pub const SHM_RDONLY = 0x1000;
+
+/// round attach address to SHMLBA
+pub const SHM_RND = 0x2000;
+
+/// take-over region on attach
+pub const SHM_REMAP = 0x4000;
+
+/// execution access
+pub const SHM_EXEC = 0x8000;
+
+/// remove identifier
+pub const IPC_RMID = 0;
+
+/// set 'ipc_perm' options
+pub const IPC_SET = 1;
+
+/// get 'ipc_perm' options
+pub const IPC_STAT = 2;
+
+/// get info about shared memory limits and parameters
+pub const IPC_INFO = 3;
+
+/// lock segment
+pub const SHM_LOCK = 11;
+
+/// unlock segment
+pub const SHM_UNLOCK = 12;
+
+/// get 'ipc_perm' options from kernel index
+pub const SHM_STAT = 13;
+
+/// get info about about system resources consumed by shared memory
+pub const SHM_INFO = 14;
+
+/// get 'ipc_perm' options from kernel index without checking read access
+pub const SHM_STAT_ANY = 15;
+
+pub fn shmget(key: key_t, size: usize, shmflg: u32) usize {
+    return syscall3(.shmget, @bitCast(key), size, shmflg);
+}
+
+pub fn shmat(shmid: i32, shmaddr: ?[*]align(std.mem.page_size) u8, shmflg: u32) usize {
+    return syscall3(.shmat, @bitCast(shmid), @intFromPtr(shmaddr), shmflg);
+}
+
+pub fn shmctl(shmid: i32, cmd: i32, buf: ?[*]u8) usize {
+    return syscall3(.shmctl, @bitCast(shmid), @bitCast(cmd), @intFromPtr(buf));
+}
+
+pub fn shmdt(shmaddr: [*]u8) usize {
+    return syscall1(.shmdt, @intFromPtr(shmaddr));
+}
+
 pub fn poll(fds: [*]pollfd, n: nfds_t, timeout: i32) usize {
     if (@hasField(SYS, "poll")) {
         return syscall3(.poll, @intFromPtr(fds), n, @as(u32, @bitCast(timeout)));

lib/std/os/linux/test.zig

@@ -121,6 +121,22 @@ test "fadvise" {
     try expectEqual(@as(usize, 0), ret);
 }
 
+test "shm" {
+    const segment = linux.shmget(linux.IPC_PRIVATE, mem.page_size, linux.IPC_CREAT | 0o666);
+    expect(linux.getErrno(segment) == 0);
+    defer {
+        const r = linux.shmctl(@intCast(segment), linux.IPC_RMID, null);
+        expect(linux.getErrno(r) == 0);
+    }
+
+    const addr = std.os.linux.shmat(@intCast(segment), null, 0);
+    expect(linux.getErrno(addr) == 0);
+    defer {
+        const r = std.os.linux.shmdt(@intFromPtr(addr));
+        expect(linux.getErrno(r) == 0);
+    }
+}
+
 test {
     _ = linux.IoUring;
 }