stdbuiltinfd_tSTDIN_FILENOSTDOUT_FILENOSTDERR_FILENOPATH_MAXsyscall_bitsEerrnoERRMAXerrstr_buferrstrPlinkTostosgetpidSIGsigset_tsiginfo_tSigactionATsigemptysetsigactionSYSwritepwritereadpreadopenopenatfd2pathcreateexitexitsclosemode_tAccessModeOExecDatabrk_blocbloc_maxsbrk
std.os.plan9.AccessMode
容器
字段
RDONLY
WRONLY
RDWR
EXEC
std.os.plan9.AT
命名空间
std.os.plan9.AT.FDCWD
常量
std.os.plan9.bloc
变量
usize
std.os.plan9.bloc_max
变量
usize
std.os.plan9.brk_
函数
Brk 将系统认定的、程序未使用的最低 bss 地址, 即 break,设为 addr 向上舍入到 8 字节整数倍后的地址。不小于 addr 且低于栈指针的位置,访问时可能导致 内存违规。——9front brk(2)
pub fn brk_(addr: usize) i32
参数
addr: usize
std.os.plan9.builtin
常量
std.os.plan9.close
函数
pub fn close(fd: i32) usize
参数
fd: i32
std.os.plan9.create
函数
pub fn create(path: [*:0]const u8, omode: mode_t, perms: usize) usize
参数
std.os.plan9.E
容器
移植自 /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
常量
std.os.plan9.errno
函数
从系统调用返回值中获取 errno。SUCCESS 表示无错误。
pub fn errno(r: usize) E
参数
r: usize
std.os.plan9.errstr
函数
获取最近一次 errstr 的内容
pub fn errstr() []const u8
std.os.plan9.errstr_buf
变量
[ERRMAX]u8
std.os.plan9.ExecData
命名空间
std.os.plan9.ExecData.edata
常量
anyopaque
std.os.plan9.ExecData.end
常量
anyopaque
std.os.plan9.ExecData.etext
常量
anyopaque
std.os.plan9.exit
函数
pub fn exit(status: u8) noreturn
参数
status: u8
std.os.plan9.exits
函数
pub fn exits(status: ?[*:0]const u8) noreturn
参数
status: ?[*:0]const u8
std.os.plan9.fd_t
类型
std.os.plan9.fd2path
函数
pub fn fd2path(fd: i32, buf: [*]u8, nbuf: usize) usize
参数
fd: i32
buf: [*]u8
nbuf: usize
std.os.plan9.getpid
函数
pub fn getpid() u32
std.os.plan9.mode_t
类型
std.os.plan9.O
容器
字段
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
函数
pub fn open(path: [*:0]const u8, flags: u32) usize
参数
path: [*:0]const u8
flags: u32
std.os.plan9.openat
函数
pub fn openat(dirfd: i32, path: [*:0]const u8, flags: u32, _: mode_t) usize
参数
std.os.plan9.PATH_MAX
常量
std.os.plan9.Plink
类型
std.os.plan9.pread
函数
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
函数
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
函数
pub fn read(fd: i32, buf: [*]const u8, count: usize) usize
参数
fd: i32
buf: [*]const u8
count: usize
std.os.plan9.sbrk
函数
pub fn sbrk(n: usize) usize
参数
n: usize
std.os.plan9.SIG
命名空间
std.os.plan9.SIG.ABRT
常量
由 abort 使用
std.os.plan9.SIG.ALRM
常量
闹钟
std.os.plan9.SIG.BUS
常量
总线错误
std.os.plan9.SIG.CHLD
常量
子进程已终止或停止
std.os.plan9.SIG.CONT
常量
若已停止则继续
std.os.plan9.SIG.FPE
常量
浮点异常
std.os.plan9.SIG.HUP
常量
挂断
std.os.plan9.SIG.ILL
常量
非法指令(捕获时不重置)
std.os.plan9.SIG.INT
常量
中断
std.os.plan9.SIG.KILL
常量
终止(不可捕获或忽略)
std.os.plan9.SIG.PIPE
常量
向没有读取方的管道写入
std.os.plan9.SIG.QUIT
常量
退出
std.os.plan9.SIG.SEGV
常量
段访问违规
std.os.plan9.SIG.STOP
常量
停止
std.os.plan9.SIG.TERM
常量
由 kill 发出的软件终止信号
std.os.plan9.SIG.TSTP
常量
交互式停止
std.os.plan9.SIG.TTIN
常量
后台进程组成员读取控制终端
std.os.plan9.SIG.TTOU
常量
后台组成员向控制终端写入
std.os.plan9.SIG.USR1
常量
用户自定义信号 1
std.os.plan9.SIG.USR2
常量
用户定义的信号 2
std.os.plan9.sigaction
函数
pub fn sigaction(sig: u6, noalias act: ?*const Sigaction, noalias oact: ?*Sigaction) usize
参数
std.os.plan9.Sigaction
容器
字段
handler: extern union {
handler: ?handler_fn,
sigaction: ?sigaction_fn,
}
mask: sigset_t
flags: c_int
std.os.plan9.Sigaction.handler_fn
类型
std.os.plan9.Sigaction.sigaction_fn
类型
std.os.plan9.sigemptyset
函数
pub fn sigemptyset() sigset_t
std.os.plan9.siginfo_t
类型
std.os.plan9.sigset_t
类型
std.os.plan9.std
别名
别名目标 std
std.os.plan9.STDERR_FILENO
常量
std.os.plan9.STDIN_FILENO
常量
std.os.plan9.STDOUT_FILENO
常量
std.os.plan9.SYS
容器
字段
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
类型
std.os.plan9.tos
变量
*Tos
std.os.plan9.Tos
容器
字段
std.os.plan9.write
函数
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;
}