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.

utsname.zig

File

lib/c/sys/utsname.zig

Code

const builtin = @import("builtin");

const std = @import("std");

const symbol = @import("../../c.zig").symbol;
const errno = @import("../../c.zig").errno;

comptime {
    if (builtin.target.isMuslLibC()) {
        symbol(&unameLinux, "uname");
    }

    if (builtin.target.isWasiLibC()) {
        symbol(&unameWasi, "uname");
    }
}

fn unameLinux(uts: *std.os.linux.utsname) callconv(.c) c_int {
    return errno(std.os.linux.uname(uts));
}

fn unameWasi(uts: *std.c.utsname) callconv(.c) c_int {
    // note the @bitCast's for NUL termination!
    uts.sysname[0..5].* = @bitCast("wasi".*);
    uts.nodename[0..7].* = @bitCast("(none)".*);
    uts.release[0..6].* = @bitCast("0.0.0".*);
    uts.version[0..6].* = @bitCast("0.0.0".*);
    uts.machine[0..7].* = @bitCast(switch (builtin.target.cpu.arch) {
        .wasm32 => "wasm32",
        .wasm64 => "wasm64",
        else => comptime unreachable,
    }.*);
    uts.domainname[0..7].* = @bitCast("(none)".*);
    return 0;
}