feature. See also
. The project being documented here (as the example) is the Zig library itself.
Uring.fileMemoryMapCreate
fn fileMemoryMapCreate(
userdata: ?*anyopaque,
file: File,
options: File.MemoryMap.CreateOptions,
) File.MemoryMap.CreateError!File.MemoryMap
File
Code
fn fileMemoryMapCreate(
userdata: ?*anyopaque,
file: File,
options: File.MemoryMap.CreateOptions,
) File.MemoryMap.CreateError!File.MemoryMap {
const ev: *Evented = @ptrCast(@alignCast(userdata));
const prot: linux.PROT = .{
.READ = options.protection.read,
.WRITE = options.protection.write,
.EXEC = options.protection.execute,
};
const flags: linux.MAP = .{
.TYPE = .SHARED_VALIDATE,
.POPULATE = options.populate,
};
const page_align = std.heap.page_size_min;
var sync: CancelRegion.Sync = try .init(ev);
defer sync.deinit(ev);
const contents = while (true) {
try sync.cancel_region.await(.nothing);
const casted_offset = std.math.cast(i64, options.offset) orelse return error.Unseekable;
const rc = linux.mmap(null, options.len, prot, flags, file.handle, casted_offset);
switch (linux.errno(rc)) {
.SUCCESS => break @as([*]align(page_align) u8, @ptrFromInt(rc))[0..options.len],
.INTR => {},
.ACCES => return error.AccessDenied,
.AGAIN => return error.LockedMemoryLimitExceeded,
.MFILE => return error.ProcessFdQuotaExceeded,
.NFILE => return error.SystemFdQuotaExceeded,
.NOMEM => return error.OutOfMemory,
.PERM => return error.PermissionDenied,
.OVERFLOW => return error.Unseekable,
.BADF => |err| return errnoBug(err),
.INVAL => |err| return errnoBug(err),
.OPNOTSUPP => |err| return errnoBug(err),
else => |err| return unexpectedErrno(err),
}
};
return .{
.file = file,
.offset = options.offset,
.memory = contents,
.section = {},
};
}