// This file is entirely based on Zig's std.os // The differences are in error handling const std = @import("std"); const os = std.os; const builtin = @import("builtin"); const Syscall = @This(); const Environment = @import("root").bun.Environment; const default_allocator = @import("root").bun.default_allocator; const JSC = @import("root").bun.JSC; const SystemError = JSC.SystemError; const bun = @import("root").bun; const MAX_PATH_BYTES = bun.MAX_PATH_BYTES; const fd_t = bun.FileDescriptor; const C = @import("root").bun.C; const linux = os.linux; const Maybe = JSC.Maybe; const kernel32 = bun.windows; const log = bun.Output.scoped(.SYS, false); pub const syslog = log; // On Linux AARCh64, zig is missing stat & lstat syscalls const use_libc = !(Environment.isLinux and Environment.isX64); pub const system = if (Environment.isLinux) linux else @import("root").bun.AsyncIO.system; pub const S = struct { pub usingnamespace if (Environment.isLinux) linux.S else if (Environment.isPosix) std.os.S else struct {}; }; const sys = std.os.system; const statSym = if (use_libc) C.stat else if (Environment.isLinux) linux.stat else @compileError("STAT"); const fstatSym = if (use_libc) C.fstat else if (Environment.isLinux) linux.fstat else @compileError("STAT"); const lstat64 = if (use_libc) C.lstat else if (Environment.isLinux) linux.lstat else @compileError("STAT"); const windows = bun.windows; pub const Tag = enum(u8) { TODO, dup, access, chmod, chown, clonefile, close, copy_file_range, copyfile, fchmod, fchown, fcntl, fdatasync, fstat, fsync, ftruncate, futimens, getdents64, getdirentries64, lchmod, lchown, link, lseek, lstat, lutimes, mkdir, mkdtemp, fnctl, mmap, munmap, open, pread, pwrite, read, readlink, rename, stat, symlink, unlink, utimes, write, getcwd, chdir, fcopyfile, recv, send, sendfile, splice, rmdir, kevent, kqueue, epoll_ctl, kill, waitpid, posix_spawn, getaddrinfo, writev, pwritev, readv, preadv, NtQueryDirectoryFile, pub var strings = std.EnumMap(Tag, JSC.C.JSStringRef).initFull(null); }; const PathString = @import("root").bun.PathString; const mode_t = os.mode_t; const open_sym = system.open; const mem = std.mem; pub fn getcwd(buf: *[bun.MAX_PATH_BYTES]u8) Maybe([]const u8) { const Result = Maybe([]const u8); buf[0] = 0; const rc = std.c.getcwd(buf, bun.MAX_PATH_BYTES); return if (rc != null) Result{ .result = std.mem.sliceTo(rc.?[0..bun.MAX_PATH_BYTES], 0) } else Result.errnoSys(0, .getcwd).?; } pub fn fchmod(fd_: bun.FileDescriptor, mode: bun.Mode) Maybe(void) { const fd = bun.fdcast(fd_); return Maybe(void).errnoSys(C.fchmod(fd, mode), .fchmod) orelse Maybe(void).success; } pub fn chdirOSPath(destination: bun.OSPathSlice) Maybe(void) { if (comptime Environment.isPosix) { const rc = sys.chdir(destination); return Maybe(void).errnoSys(rc, .chdir) orelse Maybe(void).success; } if (comptime Environment.isWindows) { if (kernel32.SetCurrentDirectory(destination) != 0) { return Maybe(void).errnoSys(0, .chdir) orelse Maybe(void).success; } return Maybe(void).success; } @compileError("Not implemented yet"); } pub fn chdir(destination: anytype) Maybe(void) { const Type = @TypeOf(destination); if (comptime Environment.isPosix) { if (comptime Type == []u8 or Type == []const u8) { return chdirOSPath( &(std.os.toPosixPath(destination) catch return .{ .err = .{ .errno = @intFromEnum(bun.C.SystemErrno.EINVAL), .syscall = .chdir, } }), ); } return chdirOSPath(destination); } if (comptime Environment.isWindows) { if (comptime Type == bun.OSPathSlice or Type == [:0]u16) { return chdirOSPath(@as(bun.OSPathSlice, destination)); } if (comptime Type == *[*:0]u16) { if (kernel32.SetCurrentDirectory(destination) != 0) { return Maybe(void).errnoSys(0, .chdir) orelse Maybe(void).success; } return Maybe(void).success; } var wbuf: bun.MAX_WPATH = undefined; return chdirOSPath(bun.strings.toWPath(&wbuf, destination)); } return Maybe(void).todo; } pub fn stat(path: [:0]const u8) Maybe(bun.Stat) { var stat_ = mem.zeroes(bun.Stat); const rc = statSym(path, &stat_); if (comptime Environment.allow_assert) log("stat({s}) = {d}", .{ bun.asByteSlice(path), rc }); if (Maybe(bun.Stat).errnoSys(rc, .stat)) |err| return err; return Maybe(bun.Stat){ .result = stat_ }; } pub fn lstat(path: [:0]const u8) Maybe(bun.Stat) { var stat_ = mem.zeroes(bun.Stat); if (Maybe(bun.Stat).errnoSys(lstat64(path, &stat_), .lstat)) |err| return err; return Maybe(bun.Stat){ .result = stat_ }; } pub fn fstat(fd: bun.FileDescriptor) Maybe(bun.Stat) { var stat_ = mem.zeroes(bun.Stat); const rc = fstatSym(fd, &stat_); if (comptime Environment.allow_assert) log("fstat({d}) = {d}", .{ fd, rc }); if (Maybe(bun.Stat).errnoSys(rc, .fstat)) |err| return err; return Maybe(bun.Stat){ .result = stat_ }; } pub fn mkdir(file_path: [:0]const u8, flags: bun.Mode) Maybe(void) { if (comptime Environment.isMac) { return Maybe(void).errnoSysP(system.mkdir(file_path, flags), .mkdir, file_path) orelse Maybe(void).success; } if (comptime Environment.isLinux) { return Maybe(void).errnoSysP(linux.mkdir(file_path, flags), .mkdir, file_path) orelse Maybe(void).success; } var wbuf: bun.MAX_WPATH = undefined; _ = kernel32.CreateDirectoryW(bun.strings.toWPath(&wbuf, file_path).ptr, null); return Maybe(void).errnoSysP(0, .mkdir, file_path) orelse Maybe(void).success; } pub fn fcntl(fd_: bun.FileDescriptor, cmd: i32, arg: usize) Maybe(usize) { const fd = bun.fdcast(fd_); const result = fcntl_symbol(fd, cmd, arg); if (Maybe(usize).errnoSys(result, .fcntl)) |err| return err; return .{ .result = @as(usize, @intCast(result)) }; } pub fn getErrno(rc: anytype) bun.C.E { if (comptime Environment.isWindows) { if (bun.windows.Win32Error.get().toSystemErrno()) |e| { return e.toE(); } return bun.C.E.UNKNOWN; } if (comptime use_libc) return std.os.errno(rc); const Type = @TypeOf(rc); return switch (Type) { comptime_int, usize => std.os.linux.getErrno(@as(usize, rc)), i32, c_int, isize => std.os.errno(rc), else => @compileError("Not implemented yet for type " ++ @typeName(Type)), }; } // pub fn openOptionsFromFlagsWindows(flags: u32) windows.OpenFileOptions { // const w = windows; // const O = std.os.O; // var access_mask: w.ULONG = w.READ_CONTROL | w.FILE_WRITE_ATTRIBUTES | w.SYNCHRONIZE; // if (flags & O.RDWR != 0) { // access_mask |= w.GENERIC_READ | w.GENERIC_WRITE; // } else if (flags & O.WRONLY != 0) { // access_mask |= w.GENERIC_WRITE; // } else { // access_mask |= w.GENERIC_READ | w.GENERIC_WRITE; // } // const filter: windows.OpenFileOptions.Filter = if (flags & O.DIRECTORY != 0) .dir_only else .file_only; // const follow_symlinks: bool = flags & O.NOFOLLOW == 0; // const creation: w.ULONG = blk: { // if (flags & O.CREAT != 0) { // if (flags & O.EXCL != 0) { // break :blk w.FILE_CREATE; // } // } // break :blk w.FILE_OPEN; // }; // return .{ // .access_mask = access_mask, // .io_mode = .blocking, // .creation = creation, // .filter = filter, // .follow_symlinks = follow_symlinks, // }; // } const O = std.os.O; const w = std.os.windows; pub fn openatWindows(dirfD: bun.FileDescriptor, path: []const u16, flags: bun.Mode) Maybe(bun.FileDescriptor) { const nonblock = flags & O.NONBLOCK != 0; var access_mask: w.ULONG = w.READ_CONTROL | w.FILE_WRITE_ATTRIBUTES | w.SYNCHRONIZE; if (flags & O.RDWR != 0) { access_mask |= w.GENERIC_READ | w.GENERIC_WRITE; } else if (flags & O.WRONLY != 0) { access_mask |= w.GENERIC_WRITE; } else if (flags & O.APPEND != 0) { access_mask |= w.FILE_APPEND_DATA; } else { access_mask |= w.GENERIC_READ; } var result: windows.HANDLE = undefined; const path_len_bytes = std.math.cast(u16, path.len * 2) orelse return .{ .err = .{ .errno = @intFromEnum(bun.C.E.NOMEM), .syscall = .open, }, }; var nt_name = windows.UNICODE_STRING{ .Length = path_len_bytes, .MaximumLength = path_len_bytes, .Buffer = @constCast(path.ptr), }; var attr = windows.OBJECT_ATTRIBUTES{ .Length = @sizeOf(windows.OBJECT_ATTRIBUTES), .RootDirectory = if (dirfD == bun.invalid_fd or std.fs.path.isAbsoluteWindowsWTF16(path)) null else bun.fdcast(dirfD), .Attributes = 0, // Note we do not use OBJ_CASE_INSENSITIVE here. .ObjectName = &nt_name, .SecurityDescriptor = null, .SecurityQualityOfService = null, }; var io: windows.IO_STATUS_BLOCK = undefined; const blocking_flag: windows.ULONG = if (!nonblock) windows.FILE_SYNCHRONOUS_IO_NONALERT else 0; const file_or_dir_flag: windows.ULONG = switch (flags & O.DIRECTORY != 0) { // .file_only => windows.FILE_NON_DIRECTORY_FILE, true => windows.FILE_DIRECTORY_FILE, false => 0, }; const follow_symlinks = flags & O.NOFOLLOW == 0; const creation: w.ULONG = blk: { if (flags & O.CREAT != 0) { if (flags & O.EXCL != 0) { break :blk w.FILE_CREATE; } } break :blk w.FILE_OPEN; }; const wflags: windows.ULONG = if (follow_symlinks) file_or_dir_flag | blocking_flag else file_or_dir_flag | windows.FILE_OPEN_REPARSE_POINT; while (true) { const rc = windows.ntdll.NtCreateFile( &result, access_mask, &attr, &io, null, w.FILE_ATTRIBUTE_NORMAL, w.FILE_SHARE_WRITE | w.FILE_SHARE_READ | w.FILE_SHARE_DELETE, creation, wflags, null, 0, ); switch (windows.Win32Error.fromNTStatus(rc)) { .SUCCESS => { return JSC.Maybe(bun.FileDescriptor){ .result = bun.toFD(result), }; }, else => |code| { if (code.toSystemErrno()) |sys_err| { return .{ .err = .{ .errno = @truncate(@intFromEnum(sys_err)), .syscall = .open, }, }; } return .{ .err = .{ .errno = @intFromEnum(bun.C.E.UNKNOWN), .syscall = .open, }, }; }, } } } pub fn openatOSPath(dirfd: bun.FileDescriptor, file_path: bun.OSPathSlice, flags: bun.Mode, perm: bun.Mode) Maybe(bun.FileDescriptor) { if (comptime Environment.isMac) { // https://opensource.apple.com/source/xnu/xnu-7195.81.3/libsyscall/wrappers/open-base.c const rc = bun.AsyncIO.darwin.@"openat$NOCANCEL"(dirfd, file_path.ptr, @as(c_uint, @intCast(flags)), @as(c_int, @intCast(perm))); log("openat({d}, {s}) = {d}", .{ dirfd, file_path, rc }); return switch (Syscall.getErrno(rc)) { .SUCCESS => .{ .result = @as(bun.FileDescriptor, @intCast(rc)) }, else => |err| .{ .err = .{ .errno = @as(Syscall.Error.Int, @truncate(@intFromEnum(err))), .syscall = .open, }, }, }; } if (comptime Environment.isWindows) { return openatWindows(dirfd, file_path, flags); } while (true) { const rc = Syscall.system.openat(@as(Syscall.system.fd_t, @intCast(dirfd)), file_path, flags, perm); log("openat({d}, {s}) = {d}", .{ dirfd, file_path, rc }); return switch (Syscall.getErrno(rc)) { .SUCCESS => .{ .result = @as(bun.FileDescriptor, @intCast(rc)) }, .INTR => continue, else => |err| { return Maybe(std.os.fd_t){ .err = .{ .errno = @as(Syscall.Error.Int, @truncate(@intFromEnum(err))), .syscall = .open, }, }; }, }; } unreachable; } pub fn openat(dirfd: bun.FileDescriptor, file_path: [:0]const u8, flags: bun.Mode, perm: bun.Mode) Maybe(bun.FileDescriptor) { if (comptime Environment.isWindows) { var wbuf: bun.MAX_WPATH = undefined; return openatWindows(dirfd, bun.strings.toWPath(&wbuf, file_path), flags); } return openatOSPath(dirfd, file_path, flags, perm); } pub fn open(file_path: [:0]const u8, flags: bun.Mode, perm: bun.Mode) Maybe(bun.FileDescriptor) { // this is what open() does anyway. return openat(bun.toFD((std.fs.cwd().fd)), file_path, flags, perm); } /// This function will prevent stdout and stderr from being closed. pub fn close(fd: bun.FileDescriptor) ?Syscall.Error { if (fd == bun.STDOUT_FD or fd == bun.STDERR_FD) { log("close({d}) SKIPPED", .{fd}); return null; } return closeAllowingStdoutAndStderr(fd); } pub fn closeAllowingStdoutAndStderr(fd: bun.FileDescriptor) ?Syscall.Error { log("close({d})", .{fd}); std.debug.assert(fd != bun.invalid_fd); if (comptime std.meta.trait.isSignedInt(@TypeOf(fd))) std.debug.assert(fd > -1); if (comptime Environment.isMac) { // This avoids the EINTR problem. return switch (system.getErrno(system.@"close$NOCANCEL"(fd))) { .BADF => Syscall.Error{ .errno = @intFromEnum(os.E.BADF), .syscall = .close }, else => null, }; } if (comptime Environment.isLinux) { return switch (linux.getErrno(linux.close(fd))) { .BADF => Syscall.Error{ .errno = @intFromEnum(os.E.BADF), .syscall = .close }, else => null, }; } if (comptime Environment.isWindows) { if (kernel32.CloseHandle(bun.fdcast(fd)) == 0) { return Syscall.Error{ .errno = @intFromEnum(os.E.BADF), .syscall = .close }; } return null; } @compileError("Not implemented yet"); } const max_count = switch (builtin.os.tag) { .linux => 0x7ffff000, .macos, .ios, .watchos, .tvos => std.math.maxInt(i32), else => std.math.maxInt(isize), }; pub fn write(fd_: bun.FileDescriptor, bytes: []const u8) Maybe(usize) { const fd = bun.fdcast(fd_); const adjusted_len = @min(max_count, bytes.len); if (comptime Environment.isMac) { const rc = system.@"write$NOCANCEL"(fd, bytes.ptr, adjusted_len); log("write({d}, {d}) = {d}", .{ fd, adjusted_len, rc }); if (Maybe(usize).errnoSysFd(rc, .write, fd)) |err| { return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } else { while (true) { const rc = sys.write(fd, bytes.ptr, adjusted_len); log("write({d}, {d}) = {d}", .{ fd, adjusted_len, rc }); if (Maybe(usize).errnoSysFd(rc, .write, fd)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } unreachable; } } fn veclen(buffers: anytype) usize { var len: usize = 0; for (buffers) |buffer| { len += buffer.iov_len; } return len; } pub fn writev(fd_: bun.FileDescriptor, buffers: []std.os.iovec) Maybe(usize) { const fd = bun.fdcast(fd_); if (comptime Environment.isMac) { const rc = writev_sym(fd, @as([*]std.os.iovec_const, @ptrCast(buffers.ptr)), @as(i32, @intCast(buffers.len))); if (comptime Environment.allow_assert) log("writev({d}, {d}) = {d}", .{ fd, veclen(buffers), rc }); if (Maybe(usize).errnoSysFd(rc, .writev, fd)) |err| { return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } else { while (true) { const rc = writev_sym(fd, @as([*]std.os.iovec_const, @ptrCast(buffers.ptr)), buffers.len); if (comptime Environment.allow_assert) log("writev({d}, {d}) = {d}", .{ fd, veclen(buffers), rc }); if (Maybe(usize).errnoSysFd(rc, .writev, fd)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } unreachable; } } pub fn pwritev(fd_: bun.FileDescriptor, buffers: []std.os.iovec, position: isize) Maybe(usize) { const fd = bun.fdcast(fd_); if (comptime Environment.isMac) { const rc = pwritev_sym(fd, @as([*]std.os.iovec_const, @ptrCast(buffers.ptr)), @as(i32, @intCast(buffers.len)), position); if (comptime Environment.allow_assert) log("pwritev({d}, {d}) = {d}", .{ fd, veclen(buffers), rc }); if (Maybe(usize).errnoSysFd(rc, .pwritev, fd)) |err| { return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } else { while (true) { const rc = pwritev_sym(fd, @as([*]std.os.iovec_const, @ptrCast(buffers.ptr)), buffers.len, position); if (comptime Environment.allow_assert) log("pwritev({d}, {d}) = {d}", .{ fd, veclen(buffers), rc }); if (Maybe(usize).errnoSysFd(rc, .pwritev, fd)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } unreachable; } } pub fn readv(fd_: bun.FileDescriptor, buffers: []std.os.iovec) Maybe(usize) { const fd = bun.fdcast(fd_); if (comptime Environment.isMac) { const rc = readv_sym(fd, buffers.ptr, @as(i32, @intCast(buffers.len))); if (comptime Environment.allow_assert) log("readv({d}, {d}) = {d}", .{ fd, veclen(buffers), rc }); if (Maybe(usize).errnoSysFd(rc, .readv, fd)) |err| { return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } else { while (true) { const rc = readv_sym(fd, buffers.ptr, buffers.len); if (comptime Environment.allow_assert) log("readv({d}, {d}) = {d}", .{ fd, veclen(buffers), rc }); if (Maybe(usize).errnoSysFd(rc, .readv, fd)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } unreachable; } } pub fn preadv(fd_: bun.FileDescriptor, buffers: []std.os.iovec, position: isize) Maybe(usize) { const fd = bun.fdcast(fd_); if (comptime Environment.isMac) { const rc = preadv_sym(fd, buffers.ptr, @as(i32, @intCast(buffers.len)), position); if (comptime Environment.allow_assert) log("preadv({d}, {d}) = {d}", .{ fd, veclen(buffers), rc }); if (Maybe(usize).errnoSysFd(rc, .preadv, fd)) |err| { return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } else { while (true) { const rc = preadv_sym(fd, buffers.ptr, buffers.len, position); if (comptime Environment.allow_assert) log("preadv({d}, {d}) = {d}", .{ fd, veclen(buffers), rc }); if (Maybe(usize).errnoSysFd(rc, .preadv, fd)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } unreachable; } } const preadv_sym = if (builtin.os.tag == .linux and builtin.link_libc) std.os.linux.preadv else if (builtin.os.tag.isDarwin()) system.@"preadv$NOCANCEL" else system.preadv; const readv_sym = if (builtin.os.tag == .linux and builtin.link_libc) std.os.linux.readv else if (builtin.os.tag.isDarwin()) system.@"readv$NOCANCEL" else system.readv; const pwritev_sym = if (builtin.os.tag == .linux and builtin.link_libc) std.os.linux.pwritev else if (builtin.os.tag.isDarwin()) system.@"pwritev$NOCANCEL" else system.pwritev; const writev_sym = if (builtin.os.tag == .linux and builtin.link_libc) std.os.linux.writev else if (builtin.os.tag.isDarwin()) system.@"writev$NOCANCEL" else system.writev; const pread_sym = if (builtin.os.tag == .linux and builtin.link_libc) sys.pread64 else if (builtin.os.tag.isDarwin()) system.@"pread$NOCANCEL" else system.pread; const fcntl_symbol = system.fcntl; pub fn pread(fd_: bun.FileDescriptor, buf: []u8, offset: i64) Maybe(usize) { const fd = bun.fdcast(fd_); const adjusted_len = @min(buf.len, max_count); const ioffset = @as(i64, @bitCast(offset)); // the OS treats this as unsigned while (true) { const rc = pread_sym(fd, buf.ptr, adjusted_len, ioffset); if (Maybe(usize).errnoSys(rc, .pread)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } unreachable; } const pwrite_sym = if (builtin.os.tag == .linux and builtin.link_libc) sys.pwrite64 else sys.pwrite; pub fn pwrite(fd_: bun.FileDescriptor, bytes: []const u8, offset: i64) Maybe(usize) { const fd = bun.fdcast(fd_); const adjusted_len = @min(bytes.len, max_count); const ioffset = @as(i64, @bitCast(offset)); // the OS treats this as unsigned while (true) { const rc = pwrite_sym(fd, bytes.ptr, adjusted_len, ioffset); return if (Maybe(usize).errnoSysFd(rc, .pwrite, fd)) |err| { switch (err.getErrno()) { .INTR => continue, else => return err, } } else Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } unreachable; } pub fn read(fd_: bun.FileDescriptor, buf: []u8) Maybe(usize) { const fd = bun.fdcast(fd_); const debug_timer = bun.Output.DebugTimer.start(); const adjusted_len = @min(buf.len, max_count); if (comptime Environment.isMac) { const rc = system.@"read$NOCANCEL"(fd, buf.ptr, adjusted_len); log("read({d}, {d}) = {d} ({any})", .{ fd, adjusted_len, rc, debug_timer }); if (Maybe(usize).errnoSys(rc, .read)) |err| { return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } else { while (true) { const rc = sys.read(fd, buf.ptr, adjusted_len); log("read({d}, {d}) = {d} ({any})", .{ fd, adjusted_len, rc, debug_timer }); if (Maybe(usize).errnoSysFd(rc, .read, fd)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } } unreachable; } pub fn recv(fd_: bun.FileDescriptor, buf: []u8, flag: u32) Maybe(usize) { const fd = bun.fdcast(fd_); const adjusted_len = @min(buf.len, max_count); if (comptime Environment.isMac) { const rc = system.@"recvfrom$NOCANCEL"(fd, buf.ptr, adjusted_len, flag, null, null); log("recv({d}, {d}, {d}) = {d}", .{ fd, adjusted_len, flag, rc }); if (Maybe(usize).errnoSys(rc, .recv)) |err| { return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } else { while (true) { const rc = linux.recvfrom(fd, buf.ptr, adjusted_len, flag | os.SOCK.CLOEXEC | linux.MSG.CMSG_CLOEXEC, null, null); log("recv({d}, {d}, {d}) = {d}", .{ fd, adjusted_len, flag, rc }); if (Maybe(usize).errnoSysFd(rc, .recv, fd)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } } unreachable; } pub fn send(fd_: bun.FileDescriptor, buf: []const u8, flag: u32) Maybe(usize) { const fd = bun.fdcast(fd_); if (comptime Environment.isMac) { const rc = system.@"sendto$NOCANCEL"(fd, buf.ptr, buf.len, flag, null, 0); if (Maybe(usize).errnoSys(rc, .send)) |err| { return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } else { while (true) { const rc = linux.sendto(fd, buf.ptr, buf.len, flag | os.SOCK.CLOEXEC | os.MSG.NOSIGNAL, null, 0); if (Maybe(usize).errnoSys(rc, .send)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } } unreachable; } pub fn readlink(in: [:0]const u8, buf: []u8) Maybe(usize) { while (true) { const rc = sys.readlink(in, buf.ptr, buf.len); if (Maybe(usize).errnoSys(rc, .readlink)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(usize){ .result = @as(usize, @intCast(rc)) }; } unreachable; } pub fn ftruncate(fd: fd_t, size: isize) Maybe(void) { if (comptime Environment.isWindows) { if (kernel32.SetFileValidData(bun.fdcast(fd), size) == 0) { return Maybe(void).errnoSys(0, .ftruncate) orelse Maybe(void).success; } return Maybe(void).success; } while (true) { if (Maybe(void).errnoSys(sys.ftruncate(fd, size), .ftruncate)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(void).success; } unreachable; } pub fn rename(from: [:0]const u8, to: [:0]const u8) Maybe(void) { while (true) { if (Maybe(void).errnoSys(sys.rename(from, to), .rename)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(void).success; } unreachable; } pub fn chown(path: [:0]const u8, uid: os.uid_t, gid: os.gid_t) Maybe(void) { while (true) { if (Maybe(void).errnoSys(C.chown(path, uid, gid), .chown)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(void).success; } unreachable; } pub fn symlink(from: [:0]const u8, to: [:0]const u8) Maybe(void) { while (true) { if (Maybe(void).errnoSys(sys.symlink(from, to), .symlink)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(void).success; } unreachable; } pub fn clonefile(from: [:0]const u8, to: [:0]const u8) Maybe(void) { if (comptime !Environment.isMac) @compileError("macOS only"); while (true) { if (Maybe(void).errnoSys(C.darwin.clonefile(from, to, 0), .clonefile)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(void).success; } unreachable; } pub fn copyfile(from: [:0]const u8, to: [:0]const u8, flags: c_int) Maybe(void) { if (comptime !Environment.isMac) @compileError("macOS only"); while (true) { if (Maybe(void).errnoSys(C.darwin.copyfile(from, to, null, flags), .copyfile)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(void).success; } unreachable; } pub fn fcopyfile(fd_in: std.os.fd_t, fd_out: std.os.fd_t, flags: u32) Maybe(void) { if (comptime !Environment.isMac) @compileError("macOS only"); while (true) { if (Maybe(void).errnoSys(system.fcopyfile(fd_in, fd_out, null, flags), .fcopyfile)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(void).success; } unreachable; } pub fn unlink(from: [:0]const u8) Maybe(void) { while (true) { if (Maybe(void).errnoSys(sys.unlink(from), .unlink)) |err| { if (err.getErrno() == .INTR) continue; return err; } return Maybe(void).success; } unreachable; } pub fn getFdPath(fd_: bun.FileDescriptor, out_buffer: *[MAX_PATH_BYTES]u8) Maybe([]u8) { const fd = bun.fdcast(fd_); switch (comptime builtin.os.tag) { .windows => { var wide_buf: [windows.PATH_MAX_WIDE]u16 = undefined; const wide_slice = std.os.windows.GetFinalPathNameByHandle(fd, .{}, wide_buf[0..]) catch { return Maybe([]u8){ .err = .{ .errno = @intFromEnum(bun.C.SystemErrno.EBADF) } }; }; // Trust that Windows gives us valid UTF-16LE. return .{ .result = @constCast(bun.strings.fromWPath(out_buffer, wide_slice)) }; }, .macos, .ios, .watchos, .tvos => { // On macOS, we can use F.GETPATH fcntl command to query the OS for // the path to the file descriptor. @memset(out_buffer[0..MAX_PATH_BYTES], 0); if (Maybe([]u8).errnoSys(system.fcntl(fd, os.F.GETPATH, out_buffer), .fcntl)) |err| { return err; } const len = mem.indexOfScalar(u8, out_buffer[0..], @as(u8, 0)) orelse MAX_PATH_BYTES; return .{ .result = out_buffer[0..len] }; }, .linux => { // TODO: alpine linux may not have /proc/self var procfs_buf: ["/proc/self/fd/-2147483648".len:0]u8 = undefined; const proc_path = std.fmt.bufPrintZ(procfs_buf[0..], "/proc/self/fd/{d}\x00", .{fd}) catch unreachable; return switch (readlink(proc_path, out_buffer)) { .err => |err| return .{ .err = err }, .result => |len| return .{ .result = out_buffer[0..len] }, }; }, // .solaris => { // var procfs_buf: ["/proc/self/path/-2147483648".len:0]u8 = undefined; // const proc_path = std.fmt.bufPrintZ(procfs_buf[0..], "/proc/self/path/{d}", .{fd}) catch unreachable; // const target = readlinkZ(proc_path, out_buffer) catch |err| switch (err) { // error.UnsupportedReparsePointType => unreachable, // error.NotLink => unreachable, // else => |e| return e, // }; // return target; // }, else => @compileError("querying for canonical path of a handle is unsupported on this host"), } } /// Use of a mapped region can result in these signals: /// * SIGSEGV - Attempted write into a region mapped as read-only. /// * SIGBUS - Attempted access to a portion of the buffer that does not correspond to the file fn mmap( ptr: ?[*]align(mem.page_size) u8, length: usize, prot: u32, flags: u32, fd_: bun.FileDescriptor, offset: u64, ) Maybe([]align(mem.page_size) u8) { const fd = bun.fdcast(fd_); const ioffset = @as(i64, @bitCast(offset)); // the OS treats this as unsigned const rc = std.c.mmap(ptr, length, prot, flags, fd, ioffset); const fail = std.c.MAP.FAILED; if (rc == fail) { return Maybe([]align(mem.page_size) u8){ .err = .{ .errno = @as(Syscall.Error.Int, @truncate(@intFromEnum(std.c.getErrno(@as(i64, @bitCast(@intFromPtr(fail))))))), .syscall = .mmap }, }; } return Maybe([]align(mem.page_size) u8){ .result = @as([*]align(mem.page_size) u8, @ptrCast(@alignCast(rc)))[0..length] }; } pub fn mmapFile(path: [:0]const u8, flags: u32, wanted_size: ?usize, offset: usize) Maybe([]align(mem.page_size) u8) { const fd = switch (open(path, os.O.RDWR, 0)) { .result => |fd| fd, .err => |err| return .{ .err = err }, }; var size = std.math.sub(usize, @as(usize, @intCast(switch (fstat(fd)) { .result => |result| result.size, .err => |err| { _ = close(fd); return .{ .err = err }; }, })), offset) catch 0; if (wanted_size) |size_| size = @min(size, size_); const map = switch (mmap(null, size, os.PROT.READ | os.PROT.WRITE, flags, fd, offset)) { .result => |map| map, .err => |err| { _ = close(fd); return .{ .err = err }; }, }; if (close(fd)) |err| { _ = munmap(map); return .{ .err = err }; } return .{ .result = map }; } pub fn munmap(memory: []align(mem.page_size) const u8) Maybe(void) { if (Maybe(void).errnoSys(system.munmap(memory.ptr, memory.len), .munmap)) |err| { return err; } else return Maybe(void).success; } pub const Error = struct { const E = bun.C.E; const max_errno_value = brk: { const errno_values = std.enums.values(E); var err = @intFromEnum(E.SUCCESS); for (errno_values) |errn| { err = @max(err, @intFromEnum(errn)); } break :brk err; }; pub const Int: type = std.math.IntFittingRange(0, max_errno_value + 5); errno: Int, syscall: Syscall.Tag = @as(Syscall.Tag, @enumFromInt(0)), path: []const u8 = "", fd: bun.FileDescriptor = bun.invalid_fd, pub inline fn isRetry(this: *const Error) bool { return this.getErrno() == .AGAIN; } pub fn fromCode(errno: E, syscall: Syscall.Tag) Error { return .{ .errno = @as(Int, @truncate(@intFromEnum(errno))), .syscall = syscall }; } pub fn format(self: Error, comptime fmt: []const u8, opts: std.fmt.FormatOptions, writer: anytype) !void { try self.toSystemError().format(fmt, opts, writer); } pub const oom = fromCode(E.NOMEM, .read); pub const retry = Error{ .errno = if (Environment.isLinux) @as(Int, @intCast(@intFromEnum(E.AGAIN))) else if (Environment.isMac) @as(Int, @intCast(@intFromEnum(E.WOULDBLOCK))) else @as(Int, @intCast(@intFromEnum(E.INTR))), .syscall = .retry, }; pub inline fn getErrno(this: Error) E { return @as(E, @enumFromInt(this.errno)); } pub inline fn withPath(this: Error, path: anytype) Error { return Error{ .errno = this.errno, .syscall = this.syscall, .path = bun.span(path), }; } pub inline fn withFd(this: Error, fd: anytype) Error { return Error{ .errno = this.errno, .syscall = this.syscall, .fd = @intCast(fd), }; } pub inline fn withPathLike(this: Error, pathlike: anytype) Error { return switch (pathlike) { .fd => |fd| this.withFd(fd), .path => |path| this.withPath(path.slice()), }; } pub inline fn withSyscall(this: Error, syscall: Syscall) Error { return Error{ .errno = this.errno, .syscall = syscall, .path = this.path, }; } pub const todo_errno = std.math.maxInt(Int) - 1; pub const todo = Error{ .errno = todo_errno }; pub fn toSystemError(this: Error) SystemError { var err = SystemError{ .errno = @as(c_int, this.errno) * -1, .syscall = bun.String.static(@tagName(this.syscall)), }; // errno label if (this.errno > 0 and this.errno < C.SystemErrno.max) { const system_errno = @as(C.SystemErrno, @enumFromInt(this.errno)); err.code = bun.String.static(@tagName(system_errno)); if (C.SystemErrno.labels.get(system_errno)) |label| { err.message = bun.String.static(label); } } if (this.path.len > 0) { err.path = bun.String.create(this.path); } if (this.fd != bun.invalid_fd) { if (this.fd <= std.math.maxInt(i32)) { err.fd = @intCast(this.fd); } } return err; } pub fn toJS(this: Error, ctx: JSC.C.JSContextRef) JSC.C.JSObjectRef { return this.toSystemError().toErrorInstance(ctx.ptr()).asObjectRef(); } pub fn toJSC(this: Error, ptr: *JSC.JSGlobalObject) JSC.JSValue { return this.toSystemError().toErrorInstance(ptr); } }; pub fn setPipeCapacityOnLinux(fd_: bun.FileDescriptor, capacity: usize) Maybe(usize) { const fd = bun.fdcast(fd_); if (comptime !Environment.isLinux) @compileError("Linux-only"); std.debug.assert(capacity > 0); // In Linux versions before 2.6.11, the capacity of a // pipe was the same as the system page size (e.g., 4096 // bytes on i386). Since Linux 2.6.11, the pipe // capacity is 16 pages (i.e., 65,536 bytes in a system // with a page size of 4096 bytes). Since Linux 2.6.35, // the default pipe capacity is 16 pages, but the // capacity can be queried and set using the // fcntl(2) F_GETPIPE_SZ and F_SETPIPE_SZ operations. // See fcntl(2) for more information. //:# define F_SETPIPE_SZ 1031 /* Set pipe page size array. const F_SETPIPE_SZ = 1031; const F_GETPIPE_SZ = 1032; // We don't use glibc here // It didn't work. Always returned 0. const pipe_len = std.os.linux.fcntl(fd, F_GETPIPE_SZ, 0); if (Maybe(usize).errno(pipe_len)) |err| return err; if (pipe_len == 0) return Maybe(usize){ .result = 0 }; if (pipe_len >= capacity) return Maybe(usize){ .result = pipe_len }; const new_pipe_len = std.os.linux.fcntl(fd, F_SETPIPE_SZ, capacity); if (Maybe(usize).errno(new_pipe_len)) |err| return err; return Maybe(usize){ .result = new_pipe_len }; } pub fn getMaxPipeSizeOnLinux() usize { return @as( usize, @intCast(bun.once(struct { fn once() c_int { const strings = bun.strings; const default_out_size = 512 * 1024; const pipe_max_size_fd = switch (bun.sys.open("/proc/sys/fs/pipe-max-size", std.os.O.RDONLY, 0)) { .result => |fd2| fd2, .err => |err| { log("Failed to open /proc/sys/fs/pipe-max-size: {d}\n", .{err.errno}); return default_out_size; }, }; defer _ = bun.sys.close(pipe_max_size_fd); var max_pipe_size_buf: [128]u8 = undefined; const max_pipe_size = switch (bun.sys.read(pipe_max_size_fd, max_pipe_size_buf[0..])) { .result => |bytes_read| std.fmt.parseInt(i64, strings.trim(max_pipe_size_buf[0..bytes_read], "\n"), 10) catch |err| { log("Failed to parse /proc/sys/fs/pipe-max-size: {any}\n", .{@errorName(err)}); return default_out_size; }, .err => |err| { log("Failed to read /proc/sys/fs/pipe-max-size: {d}\n", .{err.errno}); return default_out_size; }, }; // we set the absolute max to 8 MB because honestly that's a huge pipe // my current linux machine only goes up to 1 MB, so that's very unlikely to be hit return @min(@as(c_int, @truncate(max_pipe_size -| 32)), 1024 * 1024 * 8); } }.once, c_int)), ); } pub fn existsOSPath(path: bun.OSPathSlice) bool { if (comptime Environment.isPosix) { return system.access(path, 0) == 0; } if (comptime Environment.isWindows) { const rc = kernel32.GetFileAttributesW(path) != windows.INVALID_FILE_ATTRIBUTES; if (rc == windows.FALSE) { return false; } return true; } @compileError("TODO: existsOSPath"); } pub fn isExecutableFileOSPath(path: bun.OSPathSlice) bool { if (comptime Environment.isPosix) { return bun.is_executable_fileZ(path); } if (comptime Environment.isWindows) { var out: windows.DWORD = 8; const rc = kernel32.GetBinaryTypeW(path, &out); log("GetBinaryTypeW({}) = {d}", .{ bun.String.init(path), out }); if (rc == windows.FALSE) { return false; } return switch (out) { kernel32.SCS_32BIT_BINARY, kernel32.SCS_64BIT_BINARY, kernel32.SCS_DOS_BINARY, kernel32.SCS_OS216_BINARY, kernel32.SCS_PIF_BINARY, kernel32.SCS_POSIX_BINARY, => true, else => false, }; } @compileError("TODO: isExecutablePath"); } pub fn isExecutableFilePath(path: anytype) bool { const Type = @TypeOf(path); if (comptime Environment.isPosix) { switch (Type) { *[*:0]const u8, *[*:0]u8, [*:0]const u8, [*:0]u8 => return bun.is_executable_fileZ(path), [:0]const u8, [:0]u8 => return bun.is_executable_fileZ(path.ptr), []const u8, []u8 => return bun.is_executable_fileZ(&(std.os.toPosixPath(path) catch return false)), else => @compileError("TODO: isExecutableFilePath"), } } if (comptime Environment.isWindows) { var buf: [(bun.MAX_PATH_BYTES / 2) + 1]u16 = undefined; return isExecutableFileOSPath(bun.strings.toWPath(&buf, path)); } @compileError("TODO: isExecutablePath"); } pub fn setFileOffset(fd: bun.FileDescriptor, offset: usize) Maybe(void) { if (comptime Environment.isLinux) { return Maybe(void).errnoSysFd( linux.lseek(@intCast(fd), @intCast(offset), os.SEEK.SET), .lseek, @as(bun.FileDescriptor, @intCast(fd)), ) orelse Maybe(void).success; } if (comptime Environment.isMac) { return Maybe(void).errnoSysFd( std.c.lseek(fd, @as(std.c.off_t, @intCast(offset)), os.SEEK.SET), .lseek, @as(bun.FileDescriptor, @intCast(fd)), ) orelse Maybe(void).success; } if (comptime Environment.isWindows) { const offset_high: u64 = @as(u32, @intCast(offset >> 32)); const offset_low: u64 = @as(u32, @intCast(offset & 0xFFFFFFFF)); var plarge_integer: i64 = @bitCast(offset_high); const rc = kernel32.SetFilePointerEx( bun.fdcast(fd), @as(windows.LARGE_INTEGER, @bitCast(offset_low)), &plarge_integer, windows.FILE_BEGIN, ); if (rc == windows.FALSE) { return Maybe(void).errnoSys(0, .lseek) orelse Maybe(void).success; } return Maybe(void).success; } } pub fn dup(fd: bun.FileDescriptor) Maybe(bun.FileDescriptor) { if (comptime Environment.isWindows) { var target: *windows.HANDLE = undefined; const process = kernel32.GetCurrentProcess(); const out = kernel32.DuplicateHandle( process, bun.fdcast(fd), process, target, 0, w.TRUE, w.DUPLICATE_SAME_ACCESS, ); if (out == 0) { if (Maybe(bun.FileDescriptor).errnoSysFd(0, .dup, fd)) |err| { return err; } } return Maybe(bun.FileDescriptor){ .result = bun.toFD(out) }; } const out = std.c.dup(fd); return Maybe(bun.FileDescriptor).errnoSysFd(out, .dup, fd) orelse Maybe(bun.FileDescriptor){ .result = bun.toFD(out) }; }