跳转到内容
标准库Zig 0.17.1官方原文
源码std/os/plan9.zig

第 1 行

std.os.plan9.AccessMode

容器

第 334 行

字段

RDONLY
WRONLY
RDWR
EXEC

std.os.plan9.AT

命名空间

第 200 行

std.os.plan9.AT.FDCWD

常量

第 201 行

std.os.plan9.bloc

变量

第 366 行

usize

std.os.plan9.bloc_max

变量

第 367 行

usize

std.os.plan9.brk_

函数

第 363 行

Brk 将系统认定的、程序未使用的最低 bss 地址, 即 break,设为 addr 向上舍入到 8 字节整数倍后的地址。不小于 addr 且低于栈指针的位置,访问时可能导致 内存违规。——9front brk(2)

pub fn brk_(addr: usize) i32

参数

addr: usize

std.os.plan9.builtin

常量

第 2 行

std.os.plan9.close

函数

第 329 行

pub fn close(fd: i32) usize

参数

fd: i32

std.os.plan9.create

函数

第 310 行

pub fn create(path: [*:0]const u8, omode: mode_t, perms: usize) usize

参数

path: [*:0]const u8
omode: mode_t
perms: usize

std.os.plan9.E

容器

第 15 行

移植自 /sys/include/ape/errno.h

字段

SUCCESS = 0
DOM = 1000
RANGE = 1001
PLAN9 = 1002
@"2BIG" = 1
ACCES = 2
AGAIN = 3
BADF = 4
BUSY = 5
CHILD = 6
DEADLK = 7
EXIST = 8
FAULT = 9
FBIG = 10
INTR = 11
INVAL = 12
IO = 13
ISDIR = 14
MFILE = 15
MLINK = 16
NAMETOOLONG = 17
NFILE = 18
NODEV = 19
NOENT = 20
NOEXEC = 21
NOLCK = 22
NOMEM = 23
NOSPC = 24
NOSYS = 25
NOTDIR = 26
NOTEMPTY = 27
NOTTY = 28
NXIO = 29
PERM = 30
PIPE = 31
ROFS = 32
SPIPE = 33
SRCH = 34
XDEV = 35
NOTSOCK = 36
PROTONOSUPPORT = 37
CONNREFUSED = 38
AFNOSUPPORT = 39
NOBUFS = 40
OPNOTSUPP = 41
ADDRINUSE = 42
DESTADDRREQ = 43
MSGSIZE = 44
NOPROTOOPT = 45
SOCKTNOSUPPORT = 46
PFNOSUPPORT = 47
ADDRNOTAVAIL = 48
NETDOWN = 49
NETUNREACH = 50
NETRESET = 51
CONNABORTED = 52
ISCONN = 53
NOTCONN = 54
SHUTDOWN = 55
TOOMANYREFS = 56
TIMEDOUT = 57
HOSTDOWN = 58
HOSTUNREACH = 59
GREG = 60
CANCELED = 61
INPROGRESS = 62
DQUOT
CONNRESET
OVERFLOW
LOOP
TXTBSY

std.os.plan9.ERRMAX

常量

第 107 行

std.os.plan9.errno

函数

第 100 行

从系统调用返回值中获取 errno。SUCCESS 表示无错误。

pub fn errno(r: usize) E

参数

r: usize

std.os.plan9.errstr

函数

第 110 行

获取最近一次 errstr 的内容

pub fn errstr() []const u8

std.os.plan9.errstr_buf

变量

第 108 行

[ERRMAX]u8

std.os.plan9.ExecData

命名空间

第 352 行

std.os.plan9.ExecData.edata

常量

第 354 行

anyopaque

std.os.plan9.ExecData.end

常量

第 355 行

anyopaque

std.os.plan9.ExecData.etext

常量

第 353 行

anyopaque

std.os.plan9.exit

函数

第 314 行

pub fn exit(status: u8) noreturn

参数

status: u8

std.os.plan9.exits

函数

第 324 行

pub fn exits(status: ?[*:0]const u8) noreturn

参数

status: ?[*:0]const u8

std.os.plan9.fd_t

类型

第 4 行

std.os.plan9.fd2path

函数

第 306 行

pub fn fd2path(fd: i32, buf: [*]u8, nbuf: usize) usize

参数

fd: i32
buf: [*]u8
nbuf: usize

std.os.plan9.getpid

函数

第 140 行

pub fn getpid() u32

std.os.plan9.mode_t

类型

第 332 行

std.os.plan9.O

容器

第 341 行

字段

access: AccessMode
_2: u2 = 0
TRUNC: bool = false
CEXEC: bool = false
RCLOSE: bool = false
_7: u5 = 0
EXCL: bool = false
_: u19 = 0

std.os.plan9.open

函数

第 284 行

pub fn open(path: [*:0]const u8, flags: u32) usize

参数

path: [*:0]const u8
flags: u32

std.os.plan9.openat

函数

第 288 行

pub fn openat(dirfd: i32, path: [*:0]const u8, flags: u32, _: mode_t) usize

参数

dirfd: i32
path: [*:0]const u8
flags: u32
_: mode_t

std.os.plan9.PATH_MAX

常量

第 9 行

std.os.plan9.Plink

类型

第 114 行

std.os.plan9.pread

函数

第 280 行

pub fn pread(fd: i32, buf: [*]const u8, count: usize, offset: isize) usize

参数

fd: i32
buf: [*]const u8
count: usize
offset: isize

std.os.plan9.pwrite

函数

第 273 行

pub fn pwrite(fd: i32, buf: [*]const u8, count: usize, offset: isize) usize

参数

fd: i32
buf: [*]const u8
count: usize
offset: isize

std.os.plan9.read

函数

第 277 行

pub fn read(fd: i32, buf: [*]const u8, count: usize) usize

参数

fd: i32
buf: [*]const u8
count: usize

std.os.plan9.sbrk

函数

第 369 行

pub fn sbrk(n: usize) usize

参数

n: usize

std.os.plan9.SIG

命名空间

第 143 行

std.os.plan9.SIG.ABRT

常量

第 153 行

由 abort 使用

std.os.plan9.SIG.ALRM

常量

第 163 行

闹钟

std.os.plan9.SIG.BUS

常量

第 171 行

总线错误

std.os.plan9.SIG.CHLD

常量

第 174 行

子进程已终止或停止

std.os.plan9.SIG.CONT

常量

第 176 行

若已停止则继续

std.os.plan9.SIG.FPE

常量

第 155 行

浮点异常

std.os.plan9.SIG.HUP

常量

第 145 行

挂断

std.os.plan9.SIG.ILL

常量

第 151 行

非法指令(捕获时不重置)

std.os.plan9.SIG.INT

常量

第 147 行

中断

std.os.plan9.SIG.KILL

常量

第 157 行

终止(不可捕获或忽略)

std.os.plan9.SIG.PIPE

常量

第 161 行

向没有读取方的管道写入

std.os.plan9.SIG.QUIT

常量

第 149 行

退出

std.os.plan9.SIG.SEGV

常量

第 159 行

段访问违规

std.os.plan9.SIG.STOP

常量

第 178 行

停止

std.os.plan9.SIG.TERM

常量

第 165 行

由 kill 发出的软件终止信号

std.os.plan9.SIG.TSTP

常量

第 180 行

交互式停止

std.os.plan9.SIG.TTIN

常量

第 182 行

后台进程组成员读取控制终端

std.os.plan9.SIG.TTOU

常量

第 184 行

后台组成员向控制终端写入

std.os.plan9.SIG.USR1

常量

第 167 行

用户自定义信号 1

std.os.plan9.SIG.USR2

常量

第 169 行

用户定义的信号 2

std.os.plan9.sigaction

函数

第 209 行

pub fn sigaction(sig: u6, noalias act: ?*const Sigaction, noalias oact: ?*Sigaction) usize

参数

sig: u6
act: ?*const Sigaction
oact: ?*Sigaction

std.os.plan9.Sigaction

容器

第 189 行

字段

handler: extern union {
    handler: ?handler_fn,
    sigaction: ?sigaction_fn,
}
mask: sigset_t
flags: c_int

std.os.plan9.Sigaction.handler_fn

类型

第 190 行

std.os.plan9.Sigaction.sigaction_fn

类型

第 191 行

std.os.plan9.sigemptyset

函数

第 204 行

pub fn sigemptyset() sigset_t

std.os.plan9.siginfo_t

类型

第 187 行

std.os.plan9.sigset_t

类型

第 186 行

std.os.plan9.std

别名

第 1 行

别名目标 std

std.os.plan9.STDERR_FILENO

常量

第 8 行

std.os.plan9.STDIN_FILENO

常量

第 6 行

std.os.plan9.STDOUT_FILENO

常量

第 7 行

std.os.plan9.SYS

容器

第 215 行

字段

SYSR1 = 0
_ERRSTR = 1
BIND = 2
CHDIR = 3
CLOSE = 4
DUP = 5
ALARM = 6
EXEC = 7
EXITS = 8
_FSESSION = 9
FAUTH = 10
_FSTAT = 11
SEGBRK = 12
_MOUNT = 13
OPEN = 14
_READ = 15
OSEEK = 16
SLEEP = 17
_STAT = 18
RFORK = 19
_WRITE = 20
PIPE = 21
CREATE = 22
FD2PATH = 23
BRK_ = 24
REMOVE = 25
_WSTAT = 26
_FWSTAT = 27
NOTIFY = 28
NOTED = 29
SEGATTACH = 30
SEGDETACH = 31
SEGFREE = 32
SEGFLUSH = 33
RENDEZVOUS = 34
UNMOUNT = 35
_WAIT = 36
SEMACQUIRE = 37
SEMRELEASE = 38
SEEK = 39
FVERSION = 40
ERRSTR = 41
STAT = 42
FSTAT = 43
WSTAT = 44
FWSTAT = 45
MOUNT = 46
AWAIT = 47
PREAD = 50
PWRITE = 51
TSEMACQUIRE = 52
_NSEC = 53

std.os.plan9.syscall_bits

类型

第 10 行

std.os.plan9.tos

变量

第 139 行

*Tos

std.os.plan9.Tos

容器

第 115 行

字段

prof: extern struct {
    /// 已知为 0(ptr)
    pp: *Plink,
    /// 已知为 4(ptr)
    next: *Plink,
    last: *Plink,
    first: *Plink,
    pid: u32,
    what: u32,
}

逐进程性能分析

cyclefreq: u64

若有周期时钟,则为其频率,否则为 0

kcycles: i64

内核中消耗的周期数

pcycles: i64

进程消耗的周期数(内核态 + 用户态)

pid: u32

顺便在此处放置 pid

clock: u32

std.os.plan9.write

函数

第 270 行

pub fn write(fd: i32, buf: [*]const u8, count: usize) usize

参数

fd: i32
buf: [*]const u8
count: usize
源码

std/os/plan9.zig

const std = @import("../std.zig");
const builtin = @import("builtin");

pub const fd_t = i32;

pub const STDIN_FILENO = 0;
pub const STDOUT_FILENO = 1;
pub const STDERR_FILENO = 2;
pub const PATH_MAX = 1023;
pub const syscall_bits = switch (builtin.cpu.arch) {
    .x86_64 => @import("plan9/x86_64.zig"),
    else => @compileError("more plan9 syscall implementations (needs more inline asm in stage2"),
};
/// 移植自 /sys/include/ape/errno.h
pub const E = enum(u16) {
    SUCCESS = 0,
    DOM = 1000,
    RANGE = 1001,
    PLAN9 = 1002,

    @"2BIG" = 1,
    ACCES = 2,
    AGAIN = 3,
    // WOULDBLOCK = 3, // TODO: errno.h 对 3 定义了 2 个名称。
    BADF = 4,
    BUSY = 5,
    CHILD = 6,
    DEADLK = 7,
    EXIST = 8,
    FAULT = 9,
    FBIG = 10,
    INTR = 11,
    INVAL = 12,
    IO = 13,
    ISDIR = 14,
    MFILE = 15,
    MLINK = 16,
    NAMETOOLONG = 17,
    NFILE = 18,
    NODEV = 19,
    NOENT = 20,
    NOEXEC = 21,
    NOLCK = 22,
    NOMEM = 23,
    NOSPC = 24,
    NOSYS = 25,
    NOTDIR = 26,
    NOTEMPTY = 27,
    NOTTY = 28,
    NXIO = 29,
    PERM = 30,
    PIPE = 31,
    ROFS = 32,
    SPIPE = 33,
    SRCH = 34,
    XDEV = 35,

    // bsd 网络软件
    NOTSOCK = 36,
    PROTONOSUPPORT = 37,
    // PROTOTYPE = 37, // TODO errno.h 对 37 有两个名称
    CONNREFUSED = 38,
    AFNOSUPPORT = 39,
    NOBUFS = 40,
    OPNOTSUPP = 41,
    ADDRINUSE = 42,
    DESTADDRREQ = 43,
    MSGSIZE = 44,
    NOPROTOOPT = 45,
    SOCKTNOSUPPORT = 46,
    PFNOSUPPORT = 47,
    ADDRNOTAVAIL = 48,
    NETDOWN = 49,
    NETUNREACH = 50,
    NETRESET = 51,
    CONNABORTED = 52,
    ISCONN = 53,
    NOTCONN = 54,
    SHUTDOWN = 55,
    TOOMANYREFS = 56,
    TIMEDOUT = 57,
    HOSTDOWN = 58,
    HOSTUNREACH = 59,
    GREG = 60,

    // 这些条目在 1003.1b-1993 中加入
    CANCELED = 61,
    INPROGRESS = 62,

    // 仅为兼容使用这些内容的 std.os 而添加,
    // 它们绝不应被实际使用。
    DQUOT,
    CONNRESET,
    OVERFLOW,
    LOOP,
    TXTBSY,
};

/// 从系统调用返回值中获取 errno。SUCCESS 表示无错误。
pub fn errno(r: usize) E {
    const signed_r: isize = @bitCast(r);
    const int = if (signed_r > -4096 and signed_r < 0) -signed_r else 0;
    return @fromBackingInt(@intCast(int));
}

// errstr 缓冲区可容纳的最大字节数
pub const ERRMAX = 128;
var errstr_buf: [ERRMAX]u8 = undefined;
/// 获取最近一次 errstr 的内容
pub fn errstr() []const u8 {
    _ = syscall_bits.syscall2(.ERRSTR, @intFromPtr(&errstr_buf), ERRMAX);
    return std.mem.span(@as([*:0]u8, @ptrCast(&errstr_buf)));
}
pub const Plink = anyopaque;
pub const Tos = extern struct {
    /// 逐进程性能分析
    prof: extern struct {
        /// 已知为 0(ptr)
        pp: *Plink,
        /// 已知为 4(ptr)
        next: *Plink,
        last: *Plink,
        first: *Plink,
        pid: u32,
        what: u32,
    },
    /// 若有周期时钟,则为其频率,否则为 0
    cyclefreq: u64,
    /// 内核中消耗的周期数
    kcycles: i64,
    /// 进程消耗的周期数(内核态 + 用户态)
    pcycles: i64,
    /// 顺便在此处放置 pid
    pid: u32,
    clock: u32,
    // 栈顶位于此处
};

pub var tos: *Tos = undefined; // 在 start.zig 中设置
pub fn getpid() u32 {
    return tos.pid;
}
pub const SIG = struct {
    /// 挂断
    pub const HUP = 1;
    /// 中断
    pub const INT = 2;
    /// 退出
    pub const QUIT = 3;
    /// 非法指令(捕获时不重置)
    pub const ILL = 4;
    /// 由 abort 使用
    pub const ABRT = 5;
    /// 浮点异常
    pub const FPE = 6;
    /// 终止(不可捕获或忽略)
    pub const KILL = 7;
    /// 段访问违规
    pub const SEGV = 8;
    /// 向没有读取方的管道写入
    pub const PIPE = 9;
    /// 闹钟
    pub const ALRM = 10;
    /// 由 kill 发出的软件终止信号
    pub const TERM = 11;
    /// 用户自定义信号 1
    pub const USR1 = 12;
    /// 用户定义的信号 2
    pub const USR2 = 13;
    /// 总线错误
    pub const BUS = 14;
    // 必须定义下列符号,但不必支持这些信号
    /// 子进程已终止或停止
    pub const CHLD = 15;
    /// 若已停止则继续
    pub const CONT = 16;
    /// 停止
    pub const STOP = 17;
    /// 交互式停止
    pub const TSTP = 18;
    /// 后台进程组成员读取控制终端
    pub const TTIN = 19;
    /// 后台组成员向控制终端写入
    pub const TTOU = 20;
};
pub const sigset_t = c_long;
pub const siginfo_t = c_long;
// TODO plan9 没有 sigaction_fn。Sigaction 不是联合体,但为兼容起见仍在此包含它。
pub const Sigaction = extern struct {
    pub const handler_fn = *const fn (i32) callconv(.c) void;
    pub const sigaction_fn = *const fn (i32, *const siginfo_t, ?*anyopaque) callconv(.c) void;

    handler: extern union {
        handler: ?handler_fn,
        sigaction: ?sigaction_fn,
    },
    mask: sigset_t,
    flags: c_int,
};
pub const AT = struct {
    pub const FDCWD = -100; // 这里只是人为定义一个常量;Plan 9 实际上不存在 FDCWD 和 openat
};
// Plan 9 不支持信号。此内容仅用于使 start.zig 通过。
pub fn sigemptyset() sigset_t {
    return 0;
}
// TODO 实现 sigaction
// 目前只是允许使用 start.zig 代码的兼容实现
pub fn sigaction(sig: u6, noalias act: ?*const Sigaction, noalias oact: ?*Sigaction) usize {
    _ = oact;
    _ = act;
    _ = sig;
    return 0;
}
pub const SYS = enum(usize) {
    SYSR1 = 0,
    _ERRSTR = 1,
    BIND = 2,
    CHDIR = 3,
    CLOSE = 4,
    DUP = 5,
    ALARM = 6,
    EXEC = 7,
    EXITS = 8,
    _FSESSION = 9,
    FAUTH = 10,
    _FSTAT = 11,
    SEGBRK = 12,
    _MOUNT = 13,
    OPEN = 14,
    _READ = 15,
    OSEEK = 16,
    SLEEP = 17,
    _STAT = 18,
    RFORK = 19,
    _WRITE = 20,
    PIPE = 21,
    CREATE = 22,
    FD2PATH = 23,
    BRK_ = 24,
    REMOVE = 25,
    _WSTAT = 26,
    _FWSTAT = 27,
    NOTIFY = 28,
    NOTED = 29,
    SEGATTACH = 30,
    SEGDETACH = 31,
    SEGFREE = 32,
    SEGFLUSH = 33,
    RENDEZVOUS = 34,
    UNMOUNT = 35,
    _WAIT = 36,
    SEMACQUIRE = 37,
    SEMRELEASE = 38,
    SEEK = 39,
    FVERSION = 40,
    ERRSTR = 41,
    STAT = 42,
    FSTAT = 43,
    WSTAT = 44,
    FWSTAT = 45,
    MOUNT = 46,
    AWAIT = 47,
    PREAD = 50,
    PWRITE = 51,
    TSEMACQUIRE = 52,
    _NSEC = 53,
};

pub fn write(fd: i32, buf: [*]const u8, count: usize) usize {
    return syscall_bits.syscall4(.PWRITE, @bitCast(@as(isize, fd)), @intFromPtr(buf), count, @bitCast(@as(isize, -1)));
}
pub fn pwrite(fd: i32, buf: [*]const u8, count: usize, offset: isize) usize {
    return syscall_bits.syscall4(.PWRITE, @bitCast(@as(isize, fd)), @intFromPtr(buf), count, @bitCast(offset));
}

pub fn read(fd: i32, buf: [*]const u8, count: usize) usize {
    return syscall_bits.syscall4(.PREAD, @bitCast(@as(isize, fd)), @intFromPtr(buf), count, @bitCast(@as(isize, -1)));
}
pub fn pread(fd: i32, buf: [*]const u8, count: usize, offset: isize) usize {
    return syscall_bits.syscall4(.PREAD, @bitCast(@as(isize, fd)), @intFromPtr(buf), count, @bitCast(offset));
}

pub fn open(path: [*:0]const u8, flags: u32) usize {
    return syscall_bits.syscall2(.OPEN, @intFromPtr(path), @bitCast(@as(isize, flags)));
}

pub fn openat(dirfd: i32, path: [*:0]const u8, flags: u32, _: mode_t) usize {
    // 跳过 perms,因为仅 create 支持 perms。
    if (dirfd == AT.FDCWD) { // openat(AT_FDCWD, ...) == open(...)
        return open(path, flags);
    }
    var dir_path_buf: [std.fs.max_path_bytes]u8 = undefined;
    var total_path_buf: [std.fs.max_path_bytes + 1]u8 = undefined;
    const rc = fd2path(dirfd, &dir_path_buf, std.fs.max_path_bytes);
    if (rc != 0) return rc;
    var fba = std.heap.FixedBufferAllocator.init(&total_path_buf);
    var alloc = fba.allocator();
    const dir_path = std.mem.span(@as([*:0]u8, @ptrCast(&dir_path_buf)));
    const total_path = std.fs.path.join(alloc, &.{ dir_path, std.mem.span(path) }) catch unreachable; // 此次分配不应失败,因为大小不应超过 max_path_bytes。
    fba.reset();
    const total_path_z = alloc.dupeSentinel(u8, total_path, 0) catch unreachable; // 不应超过 max_path_bytes + 1
    return open(total_path_z.ptr, flags);
}

pub fn fd2path(fd: i32, buf: [*]u8, nbuf: usize) usize {
    return syscall_bits.syscall3(.FD2PATH, @bitCast(@as(isize, fd)), @intFromPtr(buf), nbuf);
}

pub fn create(path: [*:0]const u8, omode: mode_t, perms: usize) usize {
    return syscall_bits.syscall3(.CREATE, @intFromPtr(path), @bitCast(@as(isize, omode)), perms);
}

pub fn exit(status: u8) noreturn {
    if (status == 0) {
        exits(null);
    } else {
        // TODO: Plan 9 没有退出码。只能以 0 或字符串退出
        const arr: [1:0]u8 = .{status};
        exits(&arr);
    }
}

pub fn exits(status: ?[*:0]const u8) noreturn {
    _ = syscall_bits.syscall1(.EXITS, if (status) |s| @intFromPtr(s) else 0);
    unreachable;
}

pub fn close(fd: i32) usize {
    return syscall_bits.syscall1(.CLOSE, @bitCast(@as(isize, fd)));
}
pub const mode_t = i32;

pub const AccessMode = enum(u2) {
    RDONLY,
    WRONLY,
    RDWR,
    EXEC,
};

pub const O = packed struct(u32) {
    access: AccessMode,
    _2: u2 = 0,
    TRUNC: bool = false,
    CEXEC: bool = false,
    RCLOSE: bool = false,
    _7: u5 = 0,
    EXCL: bool = false,
    _: u19 = 0,
};

pub const ExecData = struct {
    pub extern const etext: anyopaque;
    pub extern const edata: anyopaque;
    pub extern const end: anyopaque;
};

/// Brk 将系统认定的、程序未使用的最低 bss 地址,
/// 即 break,设为 addr 向上舍入到
/// 8 字节整数倍后的地址。不小于 addr
/// 且低于栈指针的位置,访问时可能导致
/// 内存违规。——9front brk(2)
pub fn brk_(addr: usize) i32 {
    return @intCast(syscall_bits.syscall1(.BRK_, addr));
}
var bloc: usize = 0;
var bloc_max: usize = 0;

pub fn sbrk(n: usize) usize {
    if (bloc == 0) {
        // 我们位于起始位置
        bloc = @intFromPtr(&ExecData.end);
        bloc_max = @intFromPtr(&ExecData.end);
    }
    const bl = std.mem.alignForward(usize, bloc, std.heap.pageSize());
    const n_aligned = std.mem.alignForward(usize, n, std.heap.pageSize());
    if (bl + n_aligned > bloc_max) {
        // 需要分配
        if (brk_(bl + n_aligned) < 0) return 0;
        bloc_max = bl + n_aligned;
    }
    bloc = bloc + n_aligned;
    return bl;
}