Zig 0.17.0-dev (Split by item)

This is an example of documentation generated by ZigDoc, an alternative to Zig's built-in Auto Doc feature. See also examples in other modes/formats. The project being documented here (as the example) is the Zig library itself.

register_files_update

Updates registered file descriptors.

Updates are applied starting at the provided offset in the original file descriptors slice. There are three kind of updates:

turning a sparse entry (where the fd is -1) into a real one
removing an existing entry (set the fd to -1)
replacing an existing entry with a new fd Adding new file descriptors must be done with register_files.

IoUring.register_files_update

pub fn register_files_update(self: *IoUring, offset: u32, fds: []const linux.fd_t) !void

File

lib/std/os/linux/IoUring.zig:1173

Code

pub fn register_files_update(self: *IoUring, offset: u32, fds: []const linux.fd_t) !void {
    assert(self.fd >= 0);

    const FilesUpdate = extern struct {
        offset: u32,
        resv: u32,
        fds: u64 align(8),
    };
    var update = FilesUpdate{
        .offset = offset,
        .resv = @as(u32, 0),
        .fds = @as(u64, @intFromPtr(fds.ptr)),
    };

    const res = linux.io_uring_register(
        self.fd,
        .REGISTER_FILES_UPDATE,
        @as(*const anyopaque, @ptrCast(&update)),
        @as(u32, @intCast(fds.len)),
    );
    try handle_registration_result(res);
}