From 4983da40d02632217e606098fd8a94bd7732bf0c Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Wed, 25 Jan 2023 10:10:50 +0100 Subject: [PATCH 01/84] self-hosted: remove unused `externally_managed` prong for Decls code --- src/arch/aarch64/CodeGen.zig | 18 ++++----- src/arch/arm/CodeGen.zig | 18 ++++----- src/arch/riscv64/CodeGen.zig | 18 ++++----- src/arch/sparc64/CodeGen.zig | 18 ++++----- src/arch/wasm/CodeGen.zig | 13 ++----- src/arch/x86_64/CodeGen.zig | 18 ++++----- src/codegen.zig | 75 +----------------------------------- src/link/Coff.zig | 2 - src/link/Elf.zig | 2 - src/link/MachO.zig | 2 - src/link/Plan9.zig | 2 - src/link/Wasm.zig | 2 - 12 files changed, 49 insertions(+), 139 deletions(-) diff --git a/src/arch/aarch64/CodeGen.zig b/src/arch/aarch64/CodeGen.zig index b333ffc666..532bfcb9bf 100644 --- a/src/arch/aarch64/CodeGen.zig +++ b/src/arch/aarch64/CodeGen.zig @@ -24,7 +24,7 @@ const log = std.log.scoped(.codegen); const build_options = @import("build_options"); const GenerateSymbolError = codegen.GenerateSymbolError; -const FnResult = codegen.FnResult; +const Result = codegen.Result; const DebugInfoOutput = codegen.DebugInfoOutput; const bits = @import("bits.zig"); @@ -349,7 +349,7 @@ pub fn generate( liveness: Liveness, code: *std.ArrayList(u8), debug_output: DebugInfoOutput, -) GenerateSymbolError!FnResult { +) GenerateSymbolError!Result { if (build_options.skip_non_native and builtin.cpu.arch != bin_file.options.target.cpu.arch) { @panic("Attempted to compile for architecture that was disabled by build configuration"); } @@ -392,8 +392,8 @@ pub fn generate( defer function.dbg_info_relocs.deinit(bin_file.allocator); var call_info = function.resolveCallingConventionValues(fn_type) catch |err| switch (err) { - error.CodegenFail => return FnResult{ .fail = function.err_msg.? }, - error.OutOfRegisters => return FnResult{ + error.CodegenFail => return Result{ .fail = function.err_msg.? }, + error.OutOfRegisters => return Result{ .fail = try ErrorMsg.create(bin_file.allocator, src_loc, "CodeGen ran out of registers. This is a bug in the Zig compiler.", .{}), }, else => |e| return e, @@ -406,8 +406,8 @@ pub fn generate( function.max_end_stack = call_info.stack_byte_count; function.gen() catch |err| switch (err) { - error.CodegenFail => return FnResult{ .fail = function.err_msg.? }, - error.OutOfRegisters => return FnResult{ + error.CodegenFail => return Result{ .fail = function.err_msg.? }, + error.OutOfRegisters => return Result{ .fail = try ErrorMsg.create(bin_file.allocator, src_loc, "CodeGen ran out of registers. This is a bug in the Zig compiler.", .{}), }, else => |e| return e, @@ -439,14 +439,14 @@ pub fn generate( defer emit.deinit(); emit.emitMir() catch |err| switch (err) { - error.EmitFail => return FnResult{ .fail = emit.err_msg.? }, + error.EmitFail => return Result{ .fail = emit.err_msg.? }, else => |e| return e, }; if (function.err_msg) |em| { - return FnResult{ .fail = em }; + return Result{ .fail = em }; } else { - return FnResult{ .appended = {} }; + return Result{ .appended = {} }; } } diff --git a/src/arch/arm/CodeGen.zig b/src/arch/arm/CodeGen.zig index fec844a867..38cf86c758 100644 --- a/src/arch/arm/CodeGen.zig +++ b/src/arch/arm/CodeGen.zig @@ -23,7 +23,7 @@ const leb128 = std.leb; const log = std.log.scoped(.codegen); const build_options = @import("build_options"); -const FnResult = codegen.FnResult; +const Result = codegen.Result; const GenerateSymbolError = codegen.GenerateSymbolError; const DebugInfoOutput = codegen.DebugInfoOutput; @@ -356,7 +356,7 @@ pub fn generate( liveness: Liveness, code: *std.ArrayList(u8), debug_output: DebugInfoOutput, -) GenerateSymbolError!FnResult { +) GenerateSymbolError!Result { if (build_options.skip_non_native and builtin.cpu.arch != bin_file.options.target.cpu.arch) { @panic("Attempted to compile for architecture that was disabled by build configuration"); } @@ -399,8 +399,8 @@ pub fn generate( defer function.dbg_info_relocs.deinit(bin_file.allocator); var call_info = function.resolveCallingConventionValues(fn_type) catch |err| switch (err) { - error.CodegenFail => return FnResult{ .fail = function.err_msg.? }, - error.OutOfRegisters => return FnResult{ + error.CodegenFail => return Result{ .fail = function.err_msg.? }, + error.OutOfRegisters => return Result{ .fail = try ErrorMsg.create(bin_file.allocator, src_loc, "CodeGen ran out of registers. This is a bug in the Zig compiler.", .{}), }, else => |e| return e, @@ -413,8 +413,8 @@ pub fn generate( function.max_end_stack = call_info.stack_byte_count; function.gen() catch |err| switch (err) { - error.CodegenFail => return FnResult{ .fail = function.err_msg.? }, - error.OutOfRegisters => return FnResult{ + error.CodegenFail => return Result{ .fail = function.err_msg.? }, + error.OutOfRegisters => return Result{ .fail = try ErrorMsg.create(bin_file.allocator, src_loc, "CodeGen ran out of registers. This is a bug in the Zig compiler.", .{}), }, else => |e| return e, @@ -446,14 +446,14 @@ pub fn generate( defer emit.deinit(); emit.emitMir() catch |err| switch (err) { - error.EmitFail => return FnResult{ .fail = emit.err_msg.? }, + error.EmitFail => return Result{ .fail = emit.err_msg.? }, else => |e| return e, }; if (function.err_msg) |em| { - return FnResult{ .fail = em }; + return Result{ .fail = em }; } else { - return FnResult{ .appended = {} }; + return Result{ .appended = {} }; } } diff --git a/src/arch/riscv64/CodeGen.zig b/src/arch/riscv64/CodeGen.zig index 2c63f171ad..71dcfef35e 100644 --- a/src/arch/riscv64/CodeGen.zig +++ b/src/arch/riscv64/CodeGen.zig @@ -22,7 +22,7 @@ const leb128 = std.leb; const log = std.log.scoped(.codegen); const build_options = @import("build_options"); -const FnResult = @import("../../codegen.zig").FnResult; +const Result = @import("../../codegen.zig").Result; const GenerateSymbolError = @import("../../codegen.zig").GenerateSymbolError; const DebugInfoOutput = @import("../../codegen.zig").DebugInfoOutput; @@ -225,7 +225,7 @@ pub fn generate( liveness: Liveness, code: *std.ArrayList(u8), debug_output: DebugInfoOutput, -) GenerateSymbolError!FnResult { +) GenerateSymbolError!Result { if (build_options.skip_non_native and builtin.cpu.arch != bin_file.options.target.cpu.arch) { @panic("Attempted to compile for architecture that was disabled by build configuration"); } @@ -268,8 +268,8 @@ pub fn generate( defer function.exitlude_jump_relocs.deinit(bin_file.allocator); var call_info = function.resolveCallingConventionValues(fn_type) catch |err| switch (err) { - error.CodegenFail => return FnResult{ .fail = function.err_msg.? }, - error.OutOfRegisters => return FnResult{ + error.CodegenFail => return Result{ .fail = function.err_msg.? }, + error.OutOfRegisters => return Result{ .fail = try ErrorMsg.create(bin_file.allocator, src_loc, "CodeGen ran out of registers. This is a bug in the Zig compiler.", .{}), }, else => |e| return e, @@ -282,8 +282,8 @@ pub fn generate( function.max_end_stack = call_info.stack_byte_count; function.gen() catch |err| switch (err) { - error.CodegenFail => return FnResult{ .fail = function.err_msg.? }, - error.OutOfRegisters => return FnResult{ + error.CodegenFail => return Result{ .fail = function.err_msg.? }, + error.OutOfRegisters => return Result{ .fail = try ErrorMsg.create(bin_file.allocator, src_loc, "CodeGen ran out of registers. This is a bug in the Zig compiler.", .{}), }, else => |e| return e, @@ -309,14 +309,14 @@ pub fn generate( defer emit.deinit(); emit.emitMir() catch |err| switch (err) { - error.EmitFail => return FnResult{ .fail = emit.err_msg.? }, + error.EmitFail => return Result{ .fail = emit.err_msg.? }, else => |e| return e, }; if (function.err_msg) |em| { - return FnResult{ .fail = em }; + return Result{ .fail = em }; } else { - return FnResult{ .appended = {} }; + return Result{ .appended = {} }; } } diff --git a/src/arch/sparc64/CodeGen.zig b/src/arch/sparc64/CodeGen.zig index 943d21c47b..a5ae985442 100644 --- a/src/arch/sparc64/CodeGen.zig +++ b/src/arch/sparc64/CodeGen.zig @@ -20,7 +20,7 @@ const Emit = @import("Emit.zig"); const Liveness = @import("../../Liveness.zig"); const Type = @import("../../type.zig").Type; const GenerateSymbolError = @import("../../codegen.zig").GenerateSymbolError; -const FnResult = @import("../../codegen.zig").FnResult; +const Result = @import("../../codegen.zig").Result; const DebugInfoOutput = @import("../../codegen.zig").DebugInfoOutput; const build_options = @import("build_options"); @@ -265,7 +265,7 @@ pub fn generate( liveness: Liveness, code: *std.ArrayList(u8), debug_output: DebugInfoOutput, -) GenerateSymbolError!FnResult { +) GenerateSymbolError!Result { if (build_options.skip_non_native and builtin.cpu.arch != bin_file.options.target.cpu.arch) { @panic("Attempted to compile for architecture that was disabled by build configuration"); } @@ -310,8 +310,8 @@ pub fn generate( defer function.exitlude_jump_relocs.deinit(bin_file.allocator); var call_info = function.resolveCallingConventionValues(fn_type, .callee) catch |err| switch (err) { - error.CodegenFail => return FnResult{ .fail = function.err_msg.? }, - error.OutOfRegisters => return FnResult{ + error.CodegenFail => return Result{ .fail = function.err_msg.? }, + error.OutOfRegisters => return Result{ .fail = try ErrorMsg.create(bin_file.allocator, src_loc, "CodeGen ran out of registers. This is a bug in the Zig compiler.", .{}), }, else => |e| return e, @@ -324,8 +324,8 @@ pub fn generate( function.max_end_stack = call_info.stack_byte_count; function.gen() catch |err| switch (err) { - error.CodegenFail => return FnResult{ .fail = function.err_msg.? }, - error.OutOfRegisters => return FnResult{ + error.CodegenFail => return Result{ .fail = function.err_msg.? }, + error.OutOfRegisters => return Result{ .fail = try ErrorMsg.create(bin_file.allocator, src_loc, "CodeGen ran out of registers. This is a bug in the Zig compiler.", .{}), }, else => |e| return e, @@ -351,14 +351,14 @@ pub fn generate( defer emit.deinit(); emit.emitMir() catch |err| switch (err) { - error.EmitFail => return FnResult{ .fail = emit.err_msg.? }, + error.EmitFail => return Result{ .fail = emit.err_msg.? }, else => |e| return e, }; if (function.err_msg) |em| { - return FnResult{ .fail = em }; + return Result{ .fail = em }; } else { - return FnResult{ .appended = {} }; + return Result{ .appended = {} }; } } diff --git a/src/arch/wasm/CodeGen.zig b/src/arch/wasm/CodeGen.zig index c27639e14a..55cfc1096a 100644 --- a/src/arch/wasm/CodeGen.zig +++ b/src/arch/wasm/CodeGen.zig @@ -627,13 +627,6 @@ test "Wasm - buildOpcode" { try testing.expectEqual(@as(wasm.Opcode, .f64_reinterpret_i64), f64_reinterpret_i64); } -pub const Result = union(enum) { - /// The codegen bytes have been appended to `Context.code` - appended: void, - /// The data is managed externally and are part of the `Result` - externally_managed: []const u8, -}; - /// Hashmap to store generated `WValue` for each `Air.Inst.Ref` pub const ValueTable = std.AutoArrayHashMapUnmanaged(Air.Inst.Ref, WValue); @@ -1171,7 +1164,7 @@ pub fn generate( liveness: Liveness, code: *std.ArrayList(u8), debug_output: codegen.DebugInfoOutput, -) codegen.GenerateSymbolError!codegen.FnResult { +) codegen.GenerateSymbolError!codegen.Result { _ = src_loc; var code_gen: CodeGen = .{ .gpa = bin_file.allocator, @@ -1190,11 +1183,11 @@ pub fn generate( defer code_gen.deinit(); genFunc(&code_gen) catch |err| switch (err) { - error.CodegenFail => return codegen.FnResult{ .fail = code_gen.err_msg }, + error.CodegenFail => return codegen.Result{ .fail = code_gen.err_msg }, else => |e| return e, }; - return codegen.FnResult{ .appended = {} }; + return codegen.Result{ .appended = {} }; } fn genFunc(func: *CodeGen) InnerError!void { diff --git a/src/arch/x86_64/CodeGen.zig b/src/arch/x86_64/CodeGen.zig index 2ad31bf7ba..d68aa81cac 100644 --- a/src/arch/x86_64/CodeGen.zig +++ b/src/arch/x86_64/CodeGen.zig @@ -16,7 +16,7 @@ const Compilation = @import("../../Compilation.zig"); const DebugInfoOutput = codegen.DebugInfoOutput; const DW = std.dwarf; const ErrorMsg = Module.ErrorMsg; -const FnResult = codegen.FnResult; +const Result = codegen.Result; const GenerateSymbolError = codegen.GenerateSymbolError; const Emit = @import("Emit.zig"); const Liveness = @import("../../Liveness.zig"); @@ -257,7 +257,7 @@ pub fn generate( liveness: Liveness, code: *std.ArrayList(u8), debug_output: DebugInfoOutput, -) GenerateSymbolError!FnResult { +) GenerateSymbolError!Result { if (build_options.skip_non_native and builtin.cpu.arch != bin_file.options.target.cpu.arch) { @panic("Attempted to compile for architecture that was disabled by build configuration"); } @@ -305,8 +305,8 @@ pub fn generate( defer if (builtin.mode == .Debug) function.mir_to_air_map.deinit(); var call_info = function.resolveCallingConventionValues(fn_type) catch |err| switch (err) { - error.CodegenFail => return FnResult{ .fail = function.err_msg.? }, - error.OutOfRegisters => return FnResult{ + error.CodegenFail => return Result{ .fail = function.err_msg.? }, + error.OutOfRegisters => return Result{ .fail = try ErrorMsg.create(bin_file.allocator, src_loc, "CodeGen ran out of registers. This is a bug in the Zig compiler.", .{}), }, else => |e| return e, @@ -319,8 +319,8 @@ pub fn generate( function.max_end_stack = call_info.stack_byte_count; function.gen() catch |err| switch (err) { - error.CodegenFail => return FnResult{ .fail = function.err_msg.? }, - error.OutOfRegisters => return FnResult{ + error.CodegenFail => return Result{ .fail = function.err_msg.? }, + error.OutOfRegisters => return Result{ .fail = try ErrorMsg.create(bin_file.allocator, src_loc, "CodeGen ran out of registers. This is a bug in the Zig compiler.", .{}), }, else => |e| return e, @@ -345,14 +345,14 @@ pub fn generate( }; defer emit.deinit(); emit.lowerMir() catch |err| switch (err) { - error.EmitFail => return FnResult{ .fail = emit.err_msg.? }, + error.EmitFail => return Result{ .fail = emit.err_msg.? }, else => |e| return e, }; if (function.err_msg) |em| { - return FnResult{ .fail = em }; + return Result{ .fail = em }; } else { - return FnResult{ .appended = {} }; + return Result{ .appended = {} }; } } diff --git a/src/codegen.zig b/src/codegen.zig index e8dd661684..1bb0d390e6 100644 --- a/src/codegen.zig +++ b/src/codegen.zig @@ -21,16 +21,9 @@ const TypedValue = @import("TypedValue.zig"); const Value = @import("value.zig").Value; const Zir = @import("Zir.zig"); -pub const FnResult = union(enum) { - /// The `code` parameter passed to `generateSymbol` has the value appended. - appended: void, - fail: *ErrorMsg, -}; pub const Result = union(enum) { /// The `code` parameter passed to `generateSymbol` has the value appended. appended: void, - /// The value is available externally, `code` is unused. - externally_managed: []const u8, fail: *ErrorMsg, }; @@ -89,7 +82,7 @@ pub fn generateFunction( liveness: Liveness, code: *std.ArrayList(u8), debug_output: DebugInfoOutput, -) GenerateSymbolError!FnResult { +) GenerateSymbolError!Result { switch (bin_file.options.target.cpu.arch) { .arm, .armeb, @@ -209,9 +202,6 @@ pub fn generateSymbol( .val = elem_val, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |slice| { - code.appendSliceAssumeCapacity(slice); - }, .fail => |em| return Result{ .fail = em }, } } @@ -230,9 +220,6 @@ pub fn generateSymbol( .val = array, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |slice| { - code.appendSliceAssumeCapacity(slice); - }, .fail => |em| return Result{ .fail = em }, } } @@ -243,9 +230,6 @@ pub fn generateSymbol( .val = sentinel_val, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |slice| { - code.appendSliceAssumeCapacity(slice); - }, .fail => |em| return Result{ .fail = em }, } } @@ -260,9 +244,6 @@ pub fn generateSymbol( .val = sentinel_val, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |slice| { - code.appendSliceAssumeCapacity(slice); - }, .fail => |em| return Result{ .fail = em }, } return Result{ .appended = {} }; @@ -310,9 +291,6 @@ pub fn generateSymbol( .val = slice.ptr, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } @@ -322,9 +300,6 @@ pub fn generateSymbol( .val = slice.len, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } @@ -376,9 +351,6 @@ pub fn generateSymbol( .val = container_ptr, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } return Result{ .appended = {} }; @@ -552,9 +524,6 @@ pub fn generateSymbol( .appended => { mem.copy(u8, code.items[current_pos..], tmp_list.items); }, - .externally_managed => |external_slice| { - mem.copy(u8, code.items[current_pos..], external_slice); - }, .fail => |em| return Result{ .fail = em }, } } else { @@ -577,9 +546,6 @@ pub fn generateSymbol( .val = field_val, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } const unpadded_field_end = code.items.len - struct_begin; @@ -613,9 +579,6 @@ pub fn generateSymbol( .val = union_obj.tag, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } } @@ -633,9 +596,6 @@ pub fn generateSymbol( .val = union_obj.val, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } @@ -651,9 +611,6 @@ pub fn generateSymbol( .val = union_obj.tag, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } } @@ -679,9 +636,6 @@ pub fn generateSymbol( .val = payload.data, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } } else if (!typed_value.val.isNull()) { @@ -690,9 +644,6 @@ pub fn generateSymbol( .val = typed_value.val, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } } else { @@ -709,9 +660,6 @@ pub fn generateSymbol( .val = value, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } @@ -741,9 +689,6 @@ pub fn generateSymbol( .val = if (is_payload) Value.initTag(.zero) else typed_value.val, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } } @@ -757,9 +702,6 @@ pub fn generateSymbol( .val = payload_val, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } const unpadded_end = code.items.len - begin; @@ -779,9 +721,6 @@ pub fn generateSymbol( .val = if (is_payload) Value.initTag(.zero) else typed_value.val, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } const unpadded_end = code.items.len - begin; @@ -826,9 +765,6 @@ pub fn generateSymbol( .val = elem_val, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |slice| { - code.appendSliceAssumeCapacity(slice); - }, .fail => |em| return Result{ .fail = em }, } } @@ -846,9 +782,6 @@ pub fn generateSymbol( .val = array, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |slice| { - code.appendSliceAssumeCapacity(slice); - }, .fail => |em| return Result{ .fail = em }, } } @@ -902,9 +835,6 @@ fn lowerDeclRef( .val = typed_value.val, }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } @@ -918,9 +848,6 @@ fn lowerDeclRef( .val = Value.initPayload(&slice_len.base), }, code, debug_output, reloc_info)) { .appended => {}, - .externally_managed => |external_slice| { - code.appendSliceAssumeCapacity(external_slice); - }, .fail => |em| return Result{ .fail = em }, } diff --git a/src/link/Coff.zig b/src/link/Coff.zig index 9c05114a1f..90073cf5ae 100644 --- a/src/link/Coff.zig +++ b/src/link/Coff.zig @@ -981,7 +981,6 @@ pub fn lowerUnnamedConst(self: *Coff, tv: TypedValue, decl_index: Module.Decl.In .parent_atom_index = atom.sym_index, }); const code = switch (res) { - .externally_managed => |x| x, .appended => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; @@ -1042,7 +1041,6 @@ pub fn updateDecl(self: *Coff, module: *Module, decl_index: Module.Decl.Index) ! .parent_atom_index = decl.link.coff.sym_index, }); const code = switch (res) { - .externally_managed => |x| x, .appended => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; diff --git a/src/link/Elf.zig b/src/link/Elf.zig index 48e0320dc6..db84cc38f7 100644 --- a/src/link/Elf.zig +++ b/src/link/Elf.zig @@ -2553,7 +2553,6 @@ pub fn updateDecl(self: *Elf, module: *Module, decl_index: Module.Decl.Index) !v }); const code = switch (res) { - .externally_managed => |x| x, .appended => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; @@ -2618,7 +2617,6 @@ pub fn lowerUnnamedConst(self: *Elf, typed_value: TypedValue, decl_index: Module .parent_atom_index = atom.local_sym_index, }); const code = switch (res) { - .externally_managed => |x| x, .appended => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; diff --git a/src/link/MachO.zig b/src/link/MachO.zig index e6924a6717..252df865d0 100644 --- a/src/link/MachO.zig +++ b/src/link/MachO.zig @@ -2082,7 +2082,6 @@ pub fn lowerUnnamedConst(self: *MachO, typed_value: TypedValue, decl_index: Modu .parent_atom_index = atom.sym_index, }); const code = switch (res) { - .externally_managed => |x| x, .appended => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; @@ -2167,7 +2166,6 @@ pub fn updateDecl(self: *MachO, module: *Module, decl_index: Module.Decl.Index) }); const code = switch (res) { - .externally_managed => |x| x, .appended => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; diff --git a/src/link/Plan9.zig b/src/link/Plan9.zig index 5423269bf0..3a76139fe1 100644 --- a/src/link/Plan9.zig +++ b/src/link/Plan9.zig @@ -358,7 +358,6 @@ pub fn lowerUnnamedConst(self: *Plan9, tv: TypedValue, decl_index: Module.Decl.I .parent_atom_index = @enumToInt(decl_index), }); const code = switch (res) { - .externally_managed => |x| x, .appended => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; @@ -403,7 +402,6 @@ pub fn updateDecl(self: *Plan9, module: *Module, decl_index: Module.Decl.Index) .parent_atom_index = @enumToInt(decl_index), }); const code = switch (res) { - .externally_managed => |x| x, .appended => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; diff --git a/src/link/Wasm.zig b/src/link/Wasm.zig index 7154cd7bc1..f11a052f45 100644 --- a/src/link/Wasm.zig +++ b/src/link/Wasm.zig @@ -1113,7 +1113,6 @@ pub fn updateDecl(wasm: *Wasm, mod: *Module, decl_index: Module.Decl.Index) !voi ); const code = switch (res) { - .externally_managed => |x| x, .appended => code_writer.items, .fail => |em| { decl.analysis = .codegen_failure; @@ -1250,7 +1249,6 @@ pub fn lowerUnnamedConst(wasm: *Wasm, tv: TypedValue, decl_index: Module.Decl.In }, ); const code = switch (result) { - .externally_managed => |x| x, .appended => value_bytes.items, .fail => |em| { decl.analysis = .codegen_failure; From a95d58caf289ecc2ab36cdb30437f634c07b64e4 Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Wed, 25 Jan 2023 10:28:18 +0100 Subject: [PATCH 02/84] self-hosted: rename codegen Result.appended to Result.ok --- src/arch/aarch64/CodeGen.zig | 2 +- src/arch/arm/CodeGen.zig | 2 +- src/arch/riscv64/CodeGen.zig | 2 +- src/arch/sparc64/CodeGen.zig | 2 +- src/arch/wasm/CodeGen.zig | 2 +- src/arch/x86_64/CodeGen.zig | 2 +- src/codegen.zig | 114 +++++++++++++++++------------------ src/link/Coff.zig | 6 +- src/link/Elf.zig | 6 +- src/link/MachO.zig | 6 +- src/link/Plan9.zig | 6 +- src/link/Wasm.zig | 6 +- 12 files changed, 78 insertions(+), 78 deletions(-) diff --git a/src/arch/aarch64/CodeGen.zig b/src/arch/aarch64/CodeGen.zig index 532bfcb9bf..53841a83a8 100644 --- a/src/arch/aarch64/CodeGen.zig +++ b/src/arch/aarch64/CodeGen.zig @@ -446,7 +446,7 @@ pub fn generate( if (function.err_msg) |em| { return Result{ .fail = em }; } else { - return Result{ .appended = {} }; + return Result.ok; } } diff --git a/src/arch/arm/CodeGen.zig b/src/arch/arm/CodeGen.zig index 38cf86c758..6a7986a7a8 100644 --- a/src/arch/arm/CodeGen.zig +++ b/src/arch/arm/CodeGen.zig @@ -453,7 +453,7 @@ pub fn generate( if (function.err_msg) |em| { return Result{ .fail = em }; } else { - return Result{ .appended = {} }; + return Result.ok; } } diff --git a/src/arch/riscv64/CodeGen.zig b/src/arch/riscv64/CodeGen.zig index 71dcfef35e..f9ef52e8d5 100644 --- a/src/arch/riscv64/CodeGen.zig +++ b/src/arch/riscv64/CodeGen.zig @@ -316,7 +316,7 @@ pub fn generate( if (function.err_msg) |em| { return Result{ .fail = em }; } else { - return Result{ .appended = {} }; + return Result.ok; } } diff --git a/src/arch/sparc64/CodeGen.zig b/src/arch/sparc64/CodeGen.zig index a5ae985442..4fa1695948 100644 --- a/src/arch/sparc64/CodeGen.zig +++ b/src/arch/sparc64/CodeGen.zig @@ -358,7 +358,7 @@ pub fn generate( if (function.err_msg) |em| { return Result{ .fail = em }; } else { - return Result{ .appended = {} }; + return Result.ok; } } diff --git a/src/arch/wasm/CodeGen.zig b/src/arch/wasm/CodeGen.zig index 55cfc1096a..a7d90a8bf9 100644 --- a/src/arch/wasm/CodeGen.zig +++ b/src/arch/wasm/CodeGen.zig @@ -1187,7 +1187,7 @@ pub fn generate( else => |e| return e, }; - return codegen.Result{ .appended = {} }; + return codegen.Result.ok; } fn genFunc(func: *CodeGen) InnerError!void { diff --git a/src/arch/x86_64/CodeGen.zig b/src/arch/x86_64/CodeGen.zig index d68aa81cac..2de358fee8 100644 --- a/src/arch/x86_64/CodeGen.zig +++ b/src/arch/x86_64/CodeGen.zig @@ -352,7 +352,7 @@ pub fn generate( if (function.err_msg) |em| { return Result{ .fail = em }; } else { - return Result{ .appended = {} }; + return Result.ok; } } diff --git a/src/codegen.zig b/src/codegen.zig index 1bb0d390e6..c0a04765b0 100644 --- a/src/codegen.zig +++ b/src/codegen.zig @@ -22,8 +22,10 @@ const Value = @import("value.zig").Value; const Zir = @import("Zir.zig"); pub const Result = union(enum) { - /// The `code` parameter passed to `generateSymbol` has the value appended. - appended: void, + /// The `code` parameter passed to `generateSymbol` has the value ok. + ok: void, + + /// There was a codegen error. fail: *ErrorMsg, }; @@ -138,7 +140,7 @@ pub fn generateSymbol( if (typed_value.val.isUndefDeep()) { const abi_size = math.cast(usize, typed_value.ty.abiSize(target)) orelse return error.Overflow; try code.appendNTimes(0xaa, abi_size); - return Result{ .appended = {} }; + return Result.ok; } switch (typed_value.ty.zigTypeTag()) { @@ -169,7 +171,7 @@ pub fn generateSymbol( 128 => writeFloat(f128, typed_value.val.toFloat(f128), target, endian, try code.addManyAsArray(16)), else => unreachable, } - return Result{ .appended = {} }; + return Result.ok; }, .Array => switch (typed_value.val.tag()) { .bytes => { @@ -178,7 +180,7 @@ pub fn generateSymbol( // The bytes payload already includes the sentinel, if any try code.ensureUnusedCapacity(len); code.appendSliceAssumeCapacity(bytes[0..len]); - return Result{ .appended = {} }; + return Result.ok; }, .str_lit => { const str_lit = typed_value.val.castTag(.str_lit).?.data; @@ -190,7 +192,7 @@ pub fn generateSymbol( const byte = @intCast(u8, sent_val.toUnsignedInt(target)); code.appendAssumeCapacity(byte); } - return Result{ .appended = {} }; + return Result.ok; }, .aggregate => { const elem_vals = typed_value.val.castTag(.aggregate).?.data; @@ -201,11 +203,11 @@ pub fn generateSymbol( .ty = elem_ty, .val = elem_val, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } } - return Result{ .appended = {} }; + return Result.ok; }, .repeated => { const array = typed_value.val.castTag(.repeated).?.data; @@ -219,7 +221,7 @@ pub fn generateSymbol( .ty = elem_ty, .val = array, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } } @@ -229,12 +231,12 @@ pub fn generateSymbol( .ty = elem_ty, .val = sentinel_val, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } } - return Result{ .appended = {} }; + return Result.ok; }, .empty_array_sentinel => { const elem_ty = typed_value.ty.childType(); @@ -243,10 +245,10 @@ pub fn generateSymbol( .ty = elem_ty, .val = sentinel_val, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } - return Result{ .appended = {} }; + return Result.ok; }, else => return Result{ .fail = try ErrorMsg.create( @@ -270,7 +272,7 @@ pub fn generateSymbol( }, else => unreachable, } - return Result{ .appended = {} }; + return Result.ok; }, .variable => { const decl = typed_value.val.castTag(.variable).?.data.owner_decl; @@ -290,7 +292,7 @@ pub fn generateSymbol( .ty = slice_ptr_field_type, .val = slice.ptr, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } @@ -299,11 +301,11 @@ pub fn generateSymbol( .ty = Type.initTag(.usize), .val = slice.len, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } - return Result{ .appended = {} }; + return Result.ok; }, .field_ptr => { const field_ptr = typed_value.val.castTag(.field_ptr).?.data; @@ -350,10 +352,10 @@ pub fn generateSymbol( .ty = typed_value.ty, .val = container_ptr, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } - return Result{ .appended = {} }; + return Result.ok; }, else => return Result{ .fail = try ErrorMsg.create( @@ -406,7 +408,7 @@ pub fn generateSymbol( .signed => @bitCast(u8, @intCast(i8, typed_value.val.toSignedInt(target))), }; try code.append(x); - return Result{ .appended = {} }; + return Result.ok; } if (info.bits > 64) { var bigint_buffer: Value.BigIntSpace = undefined; @@ -415,7 +417,7 @@ pub fn generateSymbol( const start = code.items.len; try code.resize(start + abi_size); bigint.writeTwosComplement(code.items[start..][0..abi_size], endian); - return Result{ .appended = {} }; + return Result.ok; } switch (info.signedness) { .unsigned => { @@ -443,7 +445,7 @@ pub fn generateSymbol( } }, } - return Result{ .appended = {} }; + return Result.ok; }, .Enum => { var int_buffer: Value.Payload.U64 = undefined; @@ -453,7 +455,7 @@ pub fn generateSymbol( if (info.bits <= 8) { const x = @intCast(u8, int_val.toUnsignedInt(target)); try code.append(x); - return Result{ .appended = {} }; + return Result.ok; } if (info.bits > 64) { return Result{ @@ -491,12 +493,12 @@ pub fn generateSymbol( } }, } - return Result{ .appended = {} }; + return Result.ok; }, .Bool => { const x: u8 = @boolToInt(typed_value.val.toBool()); try code.append(x); - return Result{ .appended = {} }; + return Result.ok; }, .Struct => { if (typed_value.ty.containerLayout() == .Packed) { @@ -521,9 +523,7 @@ pub fn generateSymbol( .ty = field_ty, .val = field_val, }, &tmp_list, debug_output, reloc_info)) { - .appended => { - mem.copy(u8, code.items[current_pos..], tmp_list.items); - }, + .ok => mem.copy(u8, code.items[current_pos..], tmp_list.items), .fail => |em| return Result{ .fail = em }, } } else { @@ -532,7 +532,7 @@ pub fn generateSymbol( bits += @intCast(u16, field_ty.bitSize(target)); } - return Result{ .appended = {} }; + return Result.ok; } const struct_begin = code.items.len; @@ -545,7 +545,7 @@ pub fn generateSymbol( .ty = field_ty, .val = field_val, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } const unpadded_field_end = code.items.len - struct_begin; @@ -559,7 +559,7 @@ pub fn generateSymbol( } } - return Result{ .appended = {} }; + return Result.ok; }, .Union => { const union_obj = typed_value.val.castTag(.@"union").?.data; @@ -578,7 +578,7 @@ pub fn generateSymbol( .ty = typed_value.ty.unionTagType().?, .val = union_obj.tag, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } } @@ -595,7 +595,7 @@ pub fn generateSymbol( .ty = field_ty, .val = union_obj.val, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } @@ -610,12 +610,12 @@ pub fn generateSymbol( .ty = union_ty.tag_ty, .val = union_obj.tag, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } } - return Result{ .appended = {} }; + return Result.ok; }, .Optional => { var opt_buf: Type.Payload.ElemType = undefined; @@ -626,7 +626,7 @@ pub fn generateSymbol( if (!payload_type.hasRuntimeBits()) { try code.writer().writeByteNTimes(@boolToInt(is_pl), abi_size); - return Result{ .appended = {} }; + return Result.ok; } if (typed_value.ty.optionalReprIsPayload()) { @@ -635,7 +635,7 @@ pub fn generateSymbol( .ty = payload_type, .val = payload.data, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } } else if (!typed_value.val.isNull()) { @@ -643,14 +643,14 @@ pub fn generateSymbol( .ty = payload_type, .val = typed_value.val, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } } else { try code.writer().writeByteNTimes(0, abi_size); } - return Result{ .appended = {} }; + return Result.ok; } const value = if (typed_value.val.castTag(.opt_payload)) |payload| payload.data else Value.initTag(.undef); @@ -659,11 +659,11 @@ pub fn generateSymbol( .ty = payload_type, .val = value, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } - return Result{ .appended = {} }; + return Result.ok; }, .ErrorUnion => { const error_ty = typed_value.ty.errorUnionSet(); @@ -688,7 +688,7 @@ pub fn generateSymbol( .ty = error_ty, .val = if (is_payload) Value.initTag(.zero) else typed_value.val, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } } @@ -701,7 +701,7 @@ pub fn generateSymbol( .ty = payload_ty, .val = payload_val, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } const unpadded_end = code.items.len - begin; @@ -720,7 +720,7 @@ pub fn generateSymbol( .ty = error_ty, .val = if (is_payload) Value.initTag(.zero) else typed_value.val, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } const unpadded_end = code.items.len - begin; @@ -732,7 +732,7 @@ pub fn generateSymbol( } } - return Result{ .appended = {} }; + return Result.ok; }, .ErrorSet => { switch (typed_value.val.tag()) { @@ -745,7 +745,7 @@ pub fn generateSymbol( try code.writer().writeByteNTimes(0, @intCast(usize, Type.anyerror.abiSize(target))); }, } - return Result{ .appended = {} }; + return Result.ok; }, .Vector => switch (typed_value.val.tag()) { .bytes => { @@ -753,7 +753,7 @@ pub fn generateSymbol( const len = @intCast(usize, typed_value.ty.arrayLen()); try code.ensureUnusedCapacity(len); code.appendSliceAssumeCapacity(bytes[0..len]); - return Result{ .appended = {} }; + return Result.ok; }, .aggregate => { const elem_vals = typed_value.val.castTag(.aggregate).?.data; @@ -764,11 +764,11 @@ pub fn generateSymbol( .ty = elem_ty, .val = elem_val, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } } - return Result{ .appended = {} }; + return Result.ok; }, .repeated => { const array = typed_value.val.castTag(.repeated).?.data; @@ -781,11 +781,11 @@ pub fn generateSymbol( .ty = elem_ty, .val = array, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } } - return Result{ .appended = {} }; + return Result.ok; }, .str_lit => { const str_lit = typed_value.val.castTag(.str_lit).?.data; @@ -793,7 +793,7 @@ pub fn generateSymbol( const bytes = mod.string_literal_bytes.items[str_lit.index..][0..str_lit.len]; try code.ensureUnusedCapacity(str_lit.len); code.appendSliceAssumeCapacity(bytes); - return Result{ .appended = {} }; + return Result.ok; }, else => unreachable, }, @@ -834,7 +834,7 @@ fn lowerDeclRef( .ty = slice_ptr_field_type, .val = typed_value.val, }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } @@ -847,11 +847,11 @@ fn lowerDeclRef( .ty = Type.usize, .val = Value.initPayload(&slice_len.base), }, code, debug_output, reloc_info)) { - .appended => {}, + .ok => {}, .fail => |em| return Result{ .fail = em }, } - return Result{ .appended = {} }; + return Result.ok; } const ptr_width = target.cpu.arch.ptrBitWidth(); @@ -859,7 +859,7 @@ fn lowerDeclRef( const is_fn_body = decl.ty.zigTypeTag() == .Fn; if (!is_fn_body and !decl.ty.hasRuntimeBits()) { try code.writer().writeByteNTimes(0xaa, @divExact(ptr_width, 8)); - return Result{ .appended = {} }; + return Result.ok; } module.markDeclAlive(decl); @@ -877,7 +877,7 @@ fn lowerDeclRef( else => unreachable, } - return Result{ .appended = {} }; + return Result.ok; } pub fn errUnionPayloadOffset(payload_ty: Type, target: std.Target) u64 { diff --git a/src/link/Coff.zig b/src/link/Coff.zig index 90073cf5ae..65aee010fd 100644 --- a/src/link/Coff.zig +++ b/src/link/Coff.zig @@ -928,7 +928,7 @@ pub fn updateFunc(self: *Coff, module: *Module, func: *Module.Fn, air: Air, live .none, ); const code = switch (res) { - .appended => code_buffer.items, + .ok => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; try module.failed_decls.put(module.gpa, decl_index, em); @@ -981,7 +981,7 @@ pub fn lowerUnnamedConst(self: *Coff, tv: TypedValue, decl_index: Module.Decl.In .parent_atom_index = atom.sym_index, }); const code = switch (res) { - .appended => code_buffer.items, + .ok => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; try mod.failed_decls.put(mod.gpa, decl_index, em); @@ -1041,7 +1041,7 @@ pub fn updateDecl(self: *Coff, module: *Module, decl_index: Module.Decl.Index) ! .parent_atom_index = decl.link.coff.sym_index, }); const code = switch (res) { - .appended => code_buffer.items, + .ok => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; try module.failed_decls.put(module.gpa, decl_index, em); diff --git a/src/link/Elf.zig b/src/link/Elf.zig index db84cc38f7..b0acef368a 100644 --- a/src/link/Elf.zig +++ b/src/link/Elf.zig @@ -2479,7 +2479,7 @@ pub fn updateFunc(self: *Elf, module: *Module, func: *Module.Fn, air: Air, liven try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .none); const code = switch (res) { - .appended => code_buffer.items, + .ok => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; try module.failed_decls.put(module.gpa, decl_index, em); @@ -2553,7 +2553,7 @@ pub fn updateDecl(self: *Elf, module: *Module, decl_index: Module.Decl.Index) !v }); const code = switch (res) { - .appended => code_buffer.items, + .ok => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; try module.failed_decls.put(module.gpa, decl_index, em); @@ -2617,7 +2617,7 @@ pub fn lowerUnnamedConst(self: *Elf, typed_value: TypedValue, decl_index: Module .parent_atom_index = atom.local_sym_index, }); const code = switch (res) { - .appended => code_buffer.items, + .ok => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; try mod.failed_decls.put(mod.gpa, decl_index, em); diff --git a/src/link/MachO.zig b/src/link/MachO.zig index 252df865d0..caf9a91e1a 100644 --- a/src/link/MachO.zig +++ b/src/link/MachO.zig @@ -2017,7 +2017,7 @@ pub fn updateFunc(self: *MachO, module: *Module, func: *Module.Fn, air: Air, liv try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .none); const code = switch (res) { - .appended => code_buffer.items, + .ok => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; try module.failed_decls.put(module.gpa, decl_index, em); @@ -2082,7 +2082,7 @@ pub fn lowerUnnamedConst(self: *MachO, typed_value: TypedValue, decl_index: Modu .parent_atom_index = atom.sym_index, }); const code = switch (res) { - .appended => code_buffer.items, + .ok => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; try module.failed_decls.put(module.gpa, decl_index, em); @@ -2166,7 +2166,7 @@ pub fn updateDecl(self: *MachO, module: *Module, decl_index: Module.Decl.Index) }); const code = switch (res) { - .appended => code_buffer.items, + .ok => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; try module.failed_decls.put(module.gpa, decl_index, em); diff --git a/src/link/Plan9.zig b/src/link/Plan9.zig index 3a76139fe1..e412c78f7f 100644 --- a/src/link/Plan9.zig +++ b/src/link/Plan9.zig @@ -299,7 +299,7 @@ pub fn updateFunc(self: *Plan9, module: *Module, func: *Module.Fn, air: Air, liv }, ); const code = switch (res) { - .appended => try code_buffer.toOwnedSlice(), + .ok => try code_buffer.toOwnedSlice(), .fail => |em| { decl.analysis = .codegen_failure; try module.failed_decls.put(module.gpa, decl_index, em); @@ -358,7 +358,7 @@ pub fn lowerUnnamedConst(self: *Plan9, tv: TypedValue, decl_index: Module.Decl.I .parent_atom_index = @enumToInt(decl_index), }); const code = switch (res) { - .appended => code_buffer.items, + .ok => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; try mod.failed_decls.put(mod.gpa, decl_index, em); @@ -402,7 +402,7 @@ pub fn updateDecl(self: *Plan9, module: *Module, decl_index: Module.Decl.Index) .parent_atom_index = @enumToInt(decl_index), }); const code = switch (res) { - .appended => code_buffer.items, + .ok => code_buffer.items, .fail => |em| { decl.analysis = .codegen_failure; try module.failed_decls.put(module.gpa, decl_index, em); diff --git a/src/link/Wasm.zig b/src/link/Wasm.zig index f11a052f45..7129722d16 100644 --- a/src/link/Wasm.zig +++ b/src/link/Wasm.zig @@ -1046,7 +1046,7 @@ pub fn updateFunc(wasm: *Wasm, mod: *Module, func: *Module.Fn, air: Air, livenes ); const code = switch (result) { - .appended => code_writer.items, + .ok => code_writer.items, .fail => |em| { decl.analysis = .codegen_failure; try mod.failed_decls.put(mod.gpa, decl_index, em); @@ -1113,7 +1113,7 @@ pub fn updateDecl(wasm: *Wasm, mod: *Module, decl_index: Module.Decl.Index) !voi ); const code = switch (res) { - .appended => code_writer.items, + .ok => code_writer.items, .fail => |em| { decl.analysis = .codegen_failure; try mod.failed_decls.put(mod.gpa, decl_index, em); @@ -1249,7 +1249,7 @@ pub fn lowerUnnamedConst(wasm: *Wasm, tv: TypedValue, decl_index: Module.Decl.In }, ); const code = switch (result) { - .appended => value_bytes.items, + .ok => value_bytes.items, .fail => |em| { decl.analysis = .codegen_failure; try mod.failed_decls.put(mod.gpa, decl_index, em); From 4d804c1b239e45a0a28f4caf1f9748dac44ddce2 Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Tue, 24 Jan 2023 17:55:10 +0100 Subject: [PATCH 03/84] macho: completely remove allocateDeclIndexes in favor of linker tracking --- src/Module.zig | 2 +- src/arch/aarch64/CodeGen.zig | 19 ++--- src/arch/x86_64/CodeGen.zig | 13 ++-- src/link.zig | 4 +- src/link/MachO.zig | 135 +++++++++++++++++++---------------- src/link/MachO/Atom.zig | 30 +++++--- 6 files changed, 115 insertions(+), 88 deletions(-) diff --git a/src/Module.zig b/src/Module.zig index b17c140231..2d85399baf 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -5324,7 +5324,7 @@ pub fn deleteUnusedDecl(mod: *Module, decl_index: Decl.Index) void { // Until then, we did call `allocateDeclIndexes` on this anonymous Decl and so we // must call `freeDecl` in the linker backend now. switch (mod.comp.bin_file.tag) { - .c => {}, // this linker backend has already migrated to the new API + .macho, .c => {}, // this linker backend has already migrated to the new API else => if (decl.has_tv) { if (decl.ty.isFnOrHasRuntimeBits()) { mod.comp.bin_file.freeDecl(decl_index); diff --git a/src/arch/aarch64/CodeGen.zig b/src/arch/aarch64/CodeGen.zig index 53841a83a8..b509e36f3a 100644 --- a/src/arch/aarch64/CodeGen.zig +++ b/src/arch/aarch64/CodeGen.zig @@ -3999,7 +3999,7 @@ fn store(self: *Self, ptr: MCValue, value: MCValue, ptr_ty: Type, value_ty: Type const mod = self.bin_file.options.module.?; const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { - .macho => owner_decl.link.macho.sym_index, + .macho => owner_decl.link.macho.getSymbolIndex().?, .coff => owner_decl.link.coff.sym_index, else => unreachable, // unsupported target format }; @@ -4328,10 +4328,11 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier if (func_value.castTag(.function)) |func_payload| { const func = func_payload.data; const fn_owner_decl = mod.declPtr(func.owner_decl); + try fn_owner_decl.link.macho.ensureInitialized(macho_file); try self.genSetReg(Type.initTag(.u64), .x30, .{ .linker_load = .{ .type = .got, - .sym_index = fn_owner_decl.link.macho.sym_index, + .sym_index = fn_owner_decl.link.macho.getSymbolIndex().?, }, }); // blr x30 @@ -4354,7 +4355,7 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier .tag = .call_extern, .data = .{ .relocation = .{ - .atom_index = mod.declPtr(self.mod_fn.owner_decl).link.macho.sym_index, + .atom_index = mod.declPtr(self.mod_fn.owner_decl).link.macho.getSymbolIndex().?, .sym_index = sym_index, }, }, @@ -5537,7 +5538,7 @@ fn genSetStack(self: *Self, ty: Type, stack_offset: u32, mcv: MCValue) InnerErro const mod = self.bin_file.options.module.?; const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { - .macho => owner_decl.link.macho.sym_index, + .macho => owner_decl.link.macho.getSymbolIndex().?, .coff => owner_decl.link.coff.sym_index, else => unreachable, // unsupported target format }; @@ -5651,7 +5652,7 @@ fn genSetReg(self: *Self, ty: Type, reg: Register, mcv: MCValue) InnerError!void const mod = self.bin_file.options.module.?; const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { - .macho => owner_decl.link.macho.sym_index, + .macho => owner_decl.link.macho.getSymbolIndex().?, .coff => owner_decl.link.coff.sym_index, else => unreachable, // unsupported target format }; @@ -5845,7 +5846,7 @@ fn genSetStackArgument(self: *Self, ty: Type, stack_offset: u32, mcv: MCValue) I const mod = self.bin_file.options.module.?; const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { - .macho => owner_decl.link.macho.sym_index, + .macho => owner_decl.link.macho.getSymbolIndex().?, .coff => owner_decl.link.coff.sym_index, else => unreachable, // unsupported target format }; @@ -6168,13 +6169,13 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne const got = &elf_file.program_headers.items[elf_file.phdr_got_index.?]; const got_addr = got.p_vaddr + decl.link.elf.offset_table_index * ptr_bytes; return MCValue{ .memory = got_addr }; - } else if (self.bin_file.cast(link.File.MachO)) |_| { + } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { // Because MachO is PIE-always-on, we defer memory address resolution until // the linker has enough info to perform relocations. - assert(decl.link.macho.sym_index != 0); + try decl.link.macho.ensureInitialized(macho_file); return MCValue{ .linker_load = .{ .type = .got, - .sym_index = decl.link.macho.sym_index, + .sym_index = decl.link.macho.getSymbolIndex().?, } }; } else if (self.bin_file.cast(link.File.Coff)) |_| { // Because COFF is PIE-always-on, we defer memory address resolution until diff --git a/src/arch/x86_64/CodeGen.zig b/src/arch/x86_64/CodeGen.zig index 2de358fee8..635c5d8d32 100644 --- a/src/arch/x86_64/CodeGen.zig +++ b/src/arch/x86_64/CodeGen.zig @@ -2671,7 +2671,7 @@ fn loadMemPtrIntoRegister(self: *Self, reg: Register, ptr_ty: Type, ptr: MCValue const mod = self.bin_file.options.module.?; const fn_owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = if (self.bin_file.tag == link.File.MachO.base_tag) - fn_owner_decl.link.macho.sym_index + fn_owner_decl.link.macho.getSymbolIndex().? else fn_owner_decl.link.coff.sym_index; const flags: u2 = switch (load_struct.type) { @@ -4090,7 +4090,8 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier if (func_value.castTag(.function)) |func_payload| { const func = func_payload.data; const fn_owner_decl = mod.declPtr(func.owner_decl); - const sym_index = fn_owner_decl.link.macho.sym_index; + try fn_owner_decl.link.macho.ensureInitialized(macho_file); + const sym_index = fn_owner_decl.link.macho.getSymbolIndex().?; try self.genSetReg(Type.initTag(.usize), .rax, .{ .linker_load = .{ .type = .got, @@ -4121,7 +4122,7 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier .ops = undefined, .data = .{ .relocation = .{ - .atom_index = mod.declPtr(self.mod_fn.owner_decl).link.macho.sym_index, + .atom_index = mod.declPtr(self.mod_fn.owner_decl).link.macho.getSymbolIndex().?, .sym_index = sym_index, }, }, @@ -6784,11 +6785,11 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne const got = &elf_file.program_headers.items[elf_file.phdr_got_index.?]; const got_addr = got.p_vaddr + decl.link.elf.offset_table_index * ptr_bytes; return MCValue{ .memory = got_addr }; - } else if (self.bin_file.cast(link.File.MachO)) |_| { - assert(decl.link.macho.sym_index != 0); + } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { + try decl.link.macho.ensureInitialized(macho_file); return MCValue{ .linker_load = .{ .type = .got, - .sym_index = decl.link.macho.sym_index, + .sym_index = decl.link.macho.getSymbolIndex().?, } }; } else if (self.bin_file.cast(link.File.Coff)) |_| { assert(decl.link.coff.sym_index != 0); diff --git a/src/link.zig b/src/link.zig index 976debb72b..1eee9cad7c 100644 --- a/src/link.zig +++ b/src/link.zig @@ -617,7 +617,7 @@ pub const File = struct { switch (base.tag) { .coff => return @fieldParentPtr(Coff, "base", base).allocateDeclIndexes(decl_index), .elf => return @fieldParentPtr(Elf, "base", base).allocateDeclIndexes(decl_index), - .macho => return @fieldParentPtr(MachO, "base", base).allocateDeclIndexes(decl_index), + .macho => {}, // no-op .wasm => return @fieldParentPtr(Wasm, "base", base).allocateDeclIndexes(decl_index), .plan9 => return @fieldParentPtr(Plan9, "base", base).allocateDeclIndexes(decl_index), .c, .spirv, .nvptx => {}, @@ -911,6 +911,8 @@ pub const File = struct { /// The linker is passed information about the containing atom, `parent_atom_index`, and offset within it's /// memory buffer, `offset`, so that it can make a note of potential relocation sites, should the /// `Decl`'s address was not yet resolved, or the containing atom gets moved in virtual memory. + /// May be called before or after updateFunc/updateDecl therefore it is up to the linker to allocate + /// the block/atom. pub fn getDeclVAddr(base: *File, decl_index: Module.Decl.Index, reloc_info: RelocInfo) !u64 { if (build_options.only_c) unreachable; switch (base.tag) { diff --git a/src/link/MachO.zig b/src/link/MachO.zig index caf9a91e1a..1ec8ecaaf8 100644 --- a/src/link/MachO.zig +++ b/src/link/MachO.zig @@ -1811,6 +1811,8 @@ pub fn deinit(self: *MachO) void { fn freeAtom(self: *MachO, atom: *Atom) void { log.debug("freeAtom {*}", .{atom}); + const gpa = self.base.allocator; + // Remove any relocs and base relocs associated with this Atom self.freeRelocationsForAtom(atom); @@ -1850,7 +1852,7 @@ fn freeAtom(self: *MachO, atom: *Atom) void { if (!already_have_free_list_node and prev.freeListEligible(self)) { // The free list is heuristics, it doesn't have to be perfect, so we can ignore // the OOM here. - free_list.append(self.base.allocator, prev) catch {}; + free_list.append(gpa, prev) catch {}; } } else { atom.prev = null; @@ -1862,6 +1864,33 @@ fn freeAtom(self: *MachO, atom: *Atom) void { atom.next = null; } + // Appending to free lists is allowed to fail because the free lists are heuristics based anyway. + const sym_index = atom.getSymbolIndex().?; + + self.locals_free_list.append(gpa, sym_index) catch {}; + + // Try freeing GOT atom if this decl had one + const got_target = SymbolWithLoc{ .sym_index = sym_index, .file = null }; + if (self.got_entries_table.get(got_target)) |got_index| { + self.got_entries_free_list.append(gpa, @intCast(u32, got_index)) catch {}; + self.got_entries.items[got_index] = .{ + .target = .{ .sym_index = 0, .file = null }, + .sym_index = 0, + }; + _ = self.got_entries_table.remove(got_target); + + if (self.d_sym) |*d_sym| { + d_sym.swapRemoveRelocs(sym_index); + } + + log.debug(" adding GOT index {d} to free list (target local@{d})", .{ got_index, sym_index }); + } + + self.locals.items[sym_index].n_type = 0; + _ = self.atom_by_index_table.remove(sym_index); + log.debug(" adding local symbol index {d} to free list", .{sym_index}); + atom.sym_index = 0; + if (self.d_sym) |*d_sym| { d_sym.dwarf.freeAtom(&atom.dbg_info_atom); } @@ -1883,7 +1912,7 @@ fn growAtom(self: *MachO, atom: *Atom, new_atom_size: u64, alignment: u64) !u64 return self.allocateAtom(atom, new_atom_size, alignment); } -fn allocateSymbol(self: *MachO) !u32 { +pub fn allocateSymbol(self: *MachO) !u32 { try self.locals.ensureUnusedCapacity(self.base.allocator, 1); const index = blk: { @@ -1975,16 +2004,6 @@ pub fn allocateStubEntry(self: *MachO, target: SymbolWithLoc) !u32 { return index; } -pub fn allocateDeclIndexes(self: *MachO, decl_index: Module.Decl.Index) !void { - if (self.llvm_object) |_| return; - const decl = self.base.options.module.?.declPtr(decl_index); - if (decl.link.macho.sym_index != 0) return; - - decl.link.macho.sym_index = try self.allocateSymbol(); - try self.atom_by_index_table.putNoClobber(self.base.allocator, decl.link.macho.sym_index, &decl.link.macho); - try self.decls.putNoClobber(self.base.allocator, decl_index, null); -} - pub fn updateFunc(self: *MachO, module: *Module, func: *Module.Fn, air: Air, liveness: Liveness) !void { if (build_options.skip_non_native and builtin.object_format != .macho) { @panic("Attempted to compile for object format that was disabled by build configuration"); @@ -1997,8 +2016,15 @@ pub fn updateFunc(self: *MachO, module: *Module, func: *Module.Fn, air: Air, liv const decl_index = func.owner_decl; const decl = module.declPtr(decl_index); - self.freeUnnamedConsts(decl_index); - self.freeRelocationsForAtom(&decl.link.macho); + const atom = &decl.link.macho; + try atom.ensureInitialized(self); + const gop = try self.decls.getOrPut(self.base.allocator, decl_index); + if (gop.found_existing) { + self.freeUnnamedConsts(decl_index); + self.freeRelocationsForAtom(atom); + } else { + gop.value_ptr.* = null; + } var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); @@ -2136,7 +2162,14 @@ pub fn updateDecl(self: *MachO, module: *Module, decl_index: Module.Decl.Index) } } - self.freeRelocationsForAtom(&decl.link.macho); + const atom = &decl.link.macho; + try atom.ensureInitialized(self); + const gop = try self.decls.getOrPut(self.base.allocator, decl_index); + if (gop.found_existing) { + self.freeRelocationsForAtom(atom); + } else { + gop.value_ptr.* = null; + } var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); @@ -2337,12 +2370,12 @@ fn updateDeclCode(self: *MachO, decl_index: Module.Decl.Index, code: []const u8) const decl = mod.declPtr(decl_index); const required_alignment = decl.getAlignment(self.base.options.target); - assert(decl.link.macho.sym_index != 0); // Caller forgot to call allocateDeclIndexes() const sym_name = try decl.getFullyQualifiedName(mod); defer self.base.allocator.free(sym_name); const atom = &decl.link.macho; + const sym_index = atom.getSymbolIndex().?; // Atom was not initialized const decl_ptr = self.decls.getPtr(decl_index).?; if (decl_ptr.* == null) { decl_ptr.* = self.getDeclOutputSection(decl); @@ -2368,7 +2401,7 @@ fn updateDeclCode(self: *MachO, decl_index: Module.Decl.Index, code: []const u8) if (vaddr != sym.n_value) { sym.n_value = vaddr; log.debug(" (updating GOT entry)", .{}); - const got_target = SymbolWithLoc{ .sym_index = atom.sym_index, .file = null }; + const got_target = SymbolWithLoc{ .sym_index = sym_index, .file = null }; const got_atom = self.getGotAtomForSymbol(got_target).?; self.markRelocsDirtyByTarget(got_target); try self.writePtrWidthAtom(got_atom); @@ -2399,10 +2432,10 @@ fn updateDeclCode(self: *MachO, decl_index: Module.Decl.Index, code: []const u8) atom.size = code_len; sym.n_value = vaddr; - const got_target = SymbolWithLoc{ .sym_index = atom.sym_index, .file = null }; + const got_target = SymbolWithLoc{ .sym_index = sym_index, .file = null }; const got_index = try self.allocateGotEntry(got_target); const got_atom = try self.createGotAtom(got_target); - self.got_entries.items[got_index].sym_index = got_atom.sym_index; + self.got_entries.items[got_index].sym_index = got_atom.getSymbolIndex().?; try self.writePtrWidthAtom(got_atom); } @@ -2438,7 +2471,14 @@ pub fn updateDeclExports( const gpa = self.base.allocator; const decl = module.declPtr(decl_index); - if (decl.link.macho.sym_index == 0) return; + const atom = &decl.link.macho; + try atom.ensureInitialized(self); + + const gop = try self.decls.getOrPut(gpa, decl_index); + if (!gop.found_existing) { + gop.value_ptr.* = null; + } + const decl_sym = decl.link.macho.getSymbol(self); for (exports) |exp| { @@ -2573,11 +2613,6 @@ fn freeUnnamedConsts(self: *MachO, decl_index: Module.Decl.Index) void { const unnamed_consts = self.unnamed_const_atoms.getPtr(decl_index) orelse return; for (unnamed_consts.items) |atom| { self.freeAtom(atom); - self.locals_free_list.append(gpa, atom.sym_index) catch {}; - self.locals.items[atom.sym_index].n_type = 0; - _ = self.atom_by_index_table.remove(atom.sym_index); - log.debug(" adding local symbol index {d} to free list", .{atom.sym_index}); - atom.sym_index = 0; } unnamed_consts.clearAndFree(gpa); } @@ -2591,39 +2626,11 @@ pub fn freeDecl(self: *MachO, decl_index: Module.Decl.Index) void { log.debug("freeDecl {*}", .{decl}); - const kv = self.decls.fetchSwapRemove(decl_index); - if (kv.?.value) |_| { - self.freeAtom(&decl.link.macho); - self.freeUnnamedConsts(decl_index); - } - - // Appending to free lists is allowed to fail because the free lists are heuristics based anyway. - const gpa = self.base.allocator; - const sym_index = decl.link.macho.sym_index; - if (sym_index != 0) { - self.locals_free_list.append(gpa, sym_index) catch {}; - - // Try freeing GOT atom if this decl had one - const got_target = SymbolWithLoc{ .sym_index = sym_index, .file = null }; - if (self.got_entries_table.get(got_target)) |got_index| { - self.got_entries_free_list.append(gpa, @intCast(u32, got_index)) catch {}; - self.got_entries.items[got_index] = .{ - .target = .{ .sym_index = 0, .file = null }, - .sym_index = 0, - }; - _ = self.got_entries_table.remove(got_target); - - if (self.d_sym) |*d_sym| { - d_sym.swapRemoveRelocs(sym_index); - } - - log.debug(" adding GOT index {d} to free list (target local@{d})", .{ got_index, sym_index }); + if (self.decls.fetchSwapRemove(decl_index)) |kv| { + if (kv.value) |_| { + self.freeAtom(&decl.link.macho); + self.freeUnnamedConsts(decl_index); } - - self.locals.items[sym_index].n_type = 0; - _ = self.atom_by_index_table.remove(sym_index); - log.debug(" adding local symbol index {d} to free list", .{sym_index}); - decl.link.macho.sym_index = 0; } if (self.d_sym) |*d_sym| { @@ -2636,7 +2643,9 @@ pub fn getDeclVAddr(self: *MachO, decl_index: Module.Decl.Index, reloc_info: Fil const decl = mod.declPtr(decl_index); assert(self.llvm_object == null); - assert(decl.link.macho.sym_index != 0); + + try decl.link.macho.ensureInitialized(self); + const sym_index = decl.link.macho.getSymbolIndex().?; const atom = self.getAtomForSymbol(.{ .sym_index = reloc_info.parent_atom_index, .file = null }).?; try atom.addRelocation(self, .{ @@ -2645,7 +2654,7 @@ pub fn getDeclVAddr(self: *MachO, decl_index: Module.Decl.Index, reloc_info: Fil .x86_64 => @enumToInt(macho.reloc_type_x86_64.X86_64_RELOC_UNSIGNED), else => unreachable, }, - .target = .{ .sym_index = decl.link.macho.sym_index, .file = null }, + .target = .{ .sym_index = sym_index, .file = null }, .offset = @intCast(u32, reloc_info.offset), .addend = reloc_info.addend, .pcrel = false, @@ -3179,7 +3188,7 @@ fn collectRebaseData(self: *MachO, rebase: *Rebase) !void { const slice = self.sections.slice(); for (self.rebases.keys()) |atom, i| { - log.debug(" ATOM(%{d}, '{s}')", .{ atom.sym_index, atom.getName(self) }); + log.debug(" ATOM(%{?d}, '{s}')", .{ atom.getSymbolIndex(), atom.getName(self) }); const sym = atom.getSymbol(self); const segment_index = slice.items(.segment_index)[sym.n_sect - 1]; @@ -3208,7 +3217,7 @@ fn collectBindData(self: *MachO, bind: anytype, raw_bindings: anytype) !void { const slice = self.sections.slice(); for (raw_bindings.keys()) |atom, i| { - log.debug(" ATOM(%{d}, '{s}')", .{ atom.sym_index, atom.getName(self) }); + log.debug(" ATOM(%{?d}, '{s}')", .{ atom.getSymbolIndex(), atom.getName(self) }); const sym = atom.getSymbol(self); const segment_index = slice.items(.segment_index)[sym.n_sect - 1]; @@ -4277,8 +4286,8 @@ pub fn logAtoms(self: *MachO) void { pub fn logAtom(self: *MachO, atom: *const Atom) void { const sym = atom.getSymbol(self); const sym_name = atom.getName(self); - log.debug(" ATOM(%{d}, '{s}') @ {x} (sizeof({x}), alignof({x})) in object({?d}) in sect({d})", .{ - atom.sym_index, + log.debug(" ATOM(%{?d}, '{s}') @ {x} (sizeof({x}), alignof({x})) in object({?d}) in sect({d})", .{ + atom.getSymbolIndex(), sym_name, sym.n_value, atom.size, diff --git a/src/link/MachO/Atom.zig b/src/link/MachO/Atom.zig index 47ef974cb1..f15958b3df 100644 --- a/src/link/MachO/Atom.zig +++ b/src/link/MachO/Atom.zig @@ -64,6 +64,17 @@ pub const empty = Atom{ .dbg_info_atom = undefined, }; +pub fn ensureInitialized(self: *Atom, macho_file: *MachO) !void { + if (self.getSymbolIndex() != null) return; // Already initialized + self.sym_index = try macho_file.allocateSymbol(); + try macho_file.atom_by_index_table.putNoClobber(macho_file.base.allocator, self.sym_index, self); +} + +pub fn getSymbolIndex(self: Atom) ?u32 { + if (self.sym_index == 0) return null; + return self.sym_index; +} + /// Returns symbol referencing this atom. pub fn getSymbol(self: Atom, macho_file: *MachO) macho.nlist_64 { return self.getSymbolPtr(macho_file).*; @@ -71,20 +82,23 @@ pub fn getSymbol(self: Atom, macho_file: *MachO) macho.nlist_64 { /// Returns pointer-to-symbol referencing this atom. pub fn getSymbolPtr(self: Atom, macho_file: *MachO) *macho.nlist_64 { + const sym_index = self.getSymbolIndex().?; return macho_file.getSymbolPtr(.{ - .sym_index = self.sym_index, + .sym_index = sym_index, .file = self.file, }); } pub fn getSymbolWithLoc(self: Atom) SymbolWithLoc { - return .{ .sym_index = self.sym_index, .file = self.file }; + const sym_index = self.getSymbolIndex().?; + return .{ .sym_index = sym_index, .file = self.file }; } /// Returns the name of this atom. pub fn getName(self: Atom, macho_file: *MachO) []const u8 { + const sym_index = self.getSymbolIndex().?; return macho_file.getSymbolName(.{ - .sym_index = self.sym_index, + .sym_index = sym_index, .file = self.file, }); } @@ -144,7 +158,7 @@ pub fn addRelocations( pub fn addRebase(self: *Atom, macho_file: *MachO, offset: u32) !void { const gpa = macho_file.base.allocator; - log.debug(" (adding rebase at offset 0x{x} in %{d})", .{ offset, self.sym_index }); + log.debug(" (adding rebase at offset 0x{x} in %{?d})", .{ offset, self.getSymbolIndex() }); const gop = try macho_file.rebases.getOrPut(gpa, self); if (!gop.found_existing) { gop.value_ptr.* = .{}; @@ -154,10 +168,10 @@ pub fn addRebase(self: *Atom, macho_file: *MachO, offset: u32) !void { pub fn addBinding(self: *Atom, macho_file: *MachO, binding: Binding) !void { const gpa = macho_file.base.allocator; - log.debug(" (adding binding to symbol {s} at offset 0x{x} in %{d})", .{ + log.debug(" (adding binding to symbol {s} at offset 0x{x} in %{?d})", .{ macho_file.getSymbolName(binding.target), binding.offset, - self.sym_index, + self.getSymbolIndex(), }); const gop = try macho_file.bindings.getOrPut(gpa, self); if (!gop.found_existing) { @@ -168,10 +182,10 @@ pub fn addBinding(self: *Atom, macho_file: *MachO, binding: Binding) !void { pub fn addLazyBinding(self: *Atom, macho_file: *MachO, binding: Binding) !void { const gpa = macho_file.base.allocator; - log.debug(" (adding lazy binding to symbol {s} at offset 0x{x} in %{d})", .{ + log.debug(" (adding lazy binding to symbol {s} at offset 0x{x} in %{?d})", .{ macho_file.getSymbolName(binding.target), binding.offset, - self.sym_index, + self.getSymbolIndex(), }); const gop = try macho_file.lazy_bindings.getOrPut(gpa, self); if (!gop.found_existing) { From 041bc71bc8ff45dc2d4df11d48023e457b8b021e Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Wed, 25 Jan 2023 23:17:13 +0100 Subject: [PATCH 04/84] self-hosted: clean up calling logic for x86_64 and aarch64 across linkers --- src/arch/aarch64/CodeGen.zig | 123 ++++++++--------------- src/arch/x86_64/CodeGen.zig | 189 ++++++++++++----------------------- 2 files changed, 105 insertions(+), 207 deletions(-) diff --git a/src/arch/aarch64/CodeGen.zig b/src/arch/aarch64/CodeGen.zig index b509e36f3a..93ac450bae 100644 --- a/src/arch/aarch64/CodeGen.zig +++ b/src/arch/aarch64/CodeGen.zig @@ -4302,32 +4302,19 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier // on linking. const mod = self.bin_file.options.module.?; if (self.air.value(callee)) |func_value| { - if (self.bin_file.cast(link.File.Elf)) |elf_file| { - if (func_value.castTag(.function)) |func_payload| { - const func = func_payload.data; + if (func_value.castTag(.function)) |func_payload| { + const func = func_payload.data; + const fn_owner_decl = mod.declPtr(func.owner_decl); + + if (self.bin_file.cast(link.File.Elf)) |elf_file| { const ptr_bits = self.target.cpu.arch.ptrBitWidth(); const ptr_bytes: u64 = @divExact(ptr_bits, 8); - const fn_owner_decl = mod.declPtr(func.owner_decl); const got_addr = blk: { const got = &elf_file.program_headers.items[elf_file.phdr_got_index.?]; break :blk @intCast(u32, got.p_vaddr + fn_owner_decl.link.elf.offset_table_index * ptr_bytes); }; - try self.genSetReg(Type.initTag(.usize), .x30, .{ .memory = got_addr }); - - _ = try self.addInst(.{ - .tag = .blr, - .data = .{ .reg = .x30 }, - }); - } else if (func_value.castTag(.extern_fn)) |_| { - return self.fail("TODO implement calling extern functions", .{}); - } else { - return self.fail("TODO implement calling bitcasted functions", .{}); - } - } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { - if (func_value.castTag(.function)) |func_payload| { - const func = func_payload.data; - const fn_owner_decl = mod.declPtr(func.owner_decl); + } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { try fn_owner_decl.link.macho.ensureInitialized(macho_file); try self.genSetReg(Type.initTag(.u64), .x30, .{ .linker_load = .{ @@ -4335,22 +4322,39 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier .sym_index = fn_owner_decl.link.macho.getSymbolIndex().?, }, }); - // blr x30 - _ = try self.addInst(.{ - .tag = .blr, - .data = .{ .reg = .x30 }, + } else if (self.bin_file.cast(link.File.Coff)) |_| { + try self.genSetReg(Type.initTag(.u64), .x30, .{ + .linker_load = .{ + .type = .got, + .sym_index = fn_owner_decl.link.coff.sym_index, + }, }); - } else if (func_value.castTag(.extern_fn)) |func_payload| { - const extern_fn = func_payload.data; - const decl_name = mod.declPtr(extern_fn.owner_decl).name; - if (extern_fn.lib_name) |lib_name| { - log.debug("TODO enforce that '{s}' is expected in '{s}' library", .{ - decl_name, - lib_name, - }); - } - const sym_index = try macho_file.getGlobalSymbol(mem.sliceTo(decl_name, 0)); + } else if (self.bin_file.cast(link.File.Plan9)) |p9| { + try p9.seeDecl(func.owner_decl); + const ptr_bits = self.target.cpu.arch.ptrBitWidth(); + const ptr_bytes: u64 = @divExact(ptr_bits, 8); + const got_addr = p9.bases.data; + const got_index = fn_owner_decl.link.plan9.got_index.?; + const fn_got_addr = got_addr + got_index * ptr_bytes; + try self.genSetReg(Type.initTag(.usize), .x30, .{ .memory = fn_got_addr }); + } else unreachable; + _ = try self.addInst(.{ + .tag = .blr, + .data = .{ .reg = .x30 }, + }); + } else if (func_value.castTag(.extern_fn)) |func_payload| { + const extern_fn = func_payload.data; + const decl_name = mod.declPtr(extern_fn.owner_decl).name; + if (extern_fn.lib_name) |lib_name| { + log.debug("TODO enforce that '{s}' is expected in '{s}' library", .{ + decl_name, + lib_name, + }); + } + + if (self.bin_file.cast(link.File.MachO)) |macho_file| { + const sym_index = try macho_file.getGlobalSymbol(mem.sliceTo(decl_name, 0)); _ = try self.addInst(.{ .tag = .call_extern, .data = .{ @@ -4360,33 +4364,7 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier }, }, }); - } else { - return self.fail("TODO implement calling bitcasted functions", .{}); - } - } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { - if (func_value.castTag(.function)) |func_payload| { - const func = func_payload.data; - const fn_owner_decl = mod.declPtr(func.owner_decl); - try self.genSetReg(Type.initTag(.u64), .x30, .{ - .linker_load = .{ - .type = .got, - .sym_index = fn_owner_decl.link.coff.sym_index, - }, - }); - // blr x30 - _ = try self.addInst(.{ - .tag = .blr, - .data = .{ .reg = .x30 }, - }); - } else if (func_value.castTag(.extern_fn)) |func_payload| { - const extern_fn = func_payload.data; - const decl_name = mod.declPtr(extern_fn.owner_decl).name; - if (extern_fn.lib_name) |lib_name| { - log.debug("TODO enforce that '{s}' is expected in '{s}' library", .{ - decl_name, - lib_name, - }); - } + } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { const sym_index = try coff_file.getGlobalSymbol(mem.sliceTo(decl_name, 0)); try self.genSetReg(Type.initTag(.u64), .x30, .{ .linker_load = .{ @@ -4394,35 +4372,16 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier .sym_index = sym_index, }, }); - // blr x30 _ = try self.addInst(.{ .tag = .blr, .data = .{ .reg = .x30 }, }); } else { - return self.fail("TODO implement calling bitcasted functions", .{}); - } - } else if (self.bin_file.cast(link.File.Plan9)) |p9| { - if (func_value.castTag(.function)) |func_payload| { - try p9.seeDecl(func_payload.data.owner_decl); - const ptr_bits = self.target.cpu.arch.ptrBitWidth(); - const ptr_bytes: u64 = @divExact(ptr_bits, 8); - const got_addr = p9.bases.data; - const got_index = mod.declPtr(func_payload.data.owner_decl).link.plan9.got_index.?; - const fn_got_addr = got_addr + got_index * ptr_bytes; - - try self.genSetReg(Type.initTag(.usize), .x30, .{ .memory = fn_got_addr }); - - _ = try self.addInst(.{ - .tag = .blr, - .data = .{ .reg = .x30 }, - }); - } else if (func_value.castTag(.extern_fn)) |_| { return self.fail("TODO implement calling extern functions", .{}); - } else { - return self.fail("TODO implement calling bitcasted functions", .{}); } - } else unreachable; + } else { + return self.fail("TODO implement calling bitcasted functions", .{}); + } } else { assert(ty.zigTypeTag() == .Pointer); const mcv = try self.resolveInst(callee); diff --git a/src/arch/x86_64/CodeGen.zig b/src/arch/x86_64/CodeGen.zig index 635c5d8d32..4e8c20efa1 100644 --- a/src/arch/x86_64/CodeGen.zig +++ b/src/arch/x86_64/CodeGen.zig @@ -3992,13 +3992,14 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier // Due to incremental compilation, how function calls are generated depends // on linking. const mod = self.bin_file.options.module.?; - if (self.bin_file.cast(link.File.Elf)) |elf_file| { - if (self.air.value(callee)) |func_value| { - if (func_value.castTag(.function)) |func_payload| { - const func = func_payload.data; + if (self.air.value(callee)) |func_value| { + if (func_value.castTag(.function)) |func_payload| { + const func = func_payload.data; + const fn_owner_decl = mod.declPtr(func.owner_decl); + + if (self.bin_file.cast(link.File.Elf)) |elf_file| { const ptr_bits = self.target.cpu.arch.ptrBitWidth(); const ptr_bytes: u64 = @divExact(ptr_bits, 8); - const fn_owner_decl = mod.declPtr(func.owner_decl); const got_addr = blk: { const got = &elf_file.program_headers.items[elf_file.phdr_got_index.?]; break :blk @intCast(u32, got.p_vaddr + fn_owner_decl.link.elf.offset_table_index * ptr_bytes); @@ -4008,29 +4009,7 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier .ops = Mir.Inst.Ops.encode(.{ .flags = 0b01 }), .data = .{ .imm = @truncate(u32, got_addr) }, }); - } else if (func_value.castTag(.extern_fn)) |_| { - return self.fail("TODO implement calling extern functions", .{}); - } else { - return self.fail("TODO implement calling bitcasted functions", .{}); - } - } else { - assert(ty.zigTypeTag() == .Pointer); - const mcv = try self.resolveInst(callee); - try self.genSetReg(Type.initTag(.usize), .rax, mcv); - _ = try self.addInst(.{ - .tag = .call, - .ops = Mir.Inst.Ops.encode(.{ - .reg1 = .rax, - .flags = 0b01, - }), - .data = undefined, - }); - } - } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { - if (self.air.value(callee)) |func_value| { - if (func_value.castTag(.function)) |func_payload| { - const func = func_payload.data; - const fn_owner_decl = mod.declPtr(func.owner_decl); + } else if (self.bin_file.cast(link.File.Coff)) |_| { try self.genSetReg(Type.initTag(.usize), .rax, .{ .linker_load = .{ .type = .got, @@ -4045,15 +4024,47 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier }), .data = undefined, }); - } else if (func_value.castTag(.extern_fn)) |func_payload| { - const extern_fn = func_payload.data; - const decl_name = mod.declPtr(extern_fn.owner_decl).name; - if (extern_fn.lib_name) |lib_name| { - log.debug("TODO enforce that '{s}' is expected in '{s}' library", .{ - decl_name, - lib_name, - }); - } + } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { + try fn_owner_decl.link.macho.ensureInitialized(macho_file); + const sym_index = fn_owner_decl.link.macho.getSymbolIndex().?; + try self.genSetReg(Type.initTag(.usize), .rax, .{ + .linker_load = .{ + .type = .got, + .sym_index = sym_index, + }, + }); + _ = try self.addInst(.{ + .tag = .call, + .ops = Mir.Inst.Ops.encode(.{ + .reg1 = .rax, + .flags = 0b01, + }), + .data = undefined, + }); + } else if (self.bin_file.cast(link.File.Plan9)) |p9| { + try p9.seeDecl(func.owner_decl); + const ptr_bits = self.target.cpu.arch.ptrBitWidth(); + const ptr_bytes: u64 = @divExact(ptr_bits, 8); + const got_addr = p9.bases.data; + const got_index = fn_owner_decl.link.plan9.got_index.?; + const fn_got_addr = got_addr + got_index * ptr_bytes; + _ = try self.addInst(.{ + .tag = .call, + .ops = Mir.Inst.Ops.encode(.{ .flags = 0b01 }), + .data = .{ .imm = @intCast(u32, fn_got_addr) }, + }); + } else unreachable; + } else if (func_value.castTag(.extern_fn)) |func_payload| { + const extern_fn = func_payload.data; + const decl_name = mod.declPtr(extern_fn.owner_decl).name; + if (extern_fn.lib_name) |lib_name| { + log.debug("TODO enforce that '{s}' is expected in '{s}' library", .{ + decl_name, + lib_name, + }); + } + + if (self.bin_file.cast(link.File.Coff)) |coff_file| { const sym_index = try coff_file.getGlobalSymbol(mem.sliceTo(decl_name, 0)); try self.genSetReg(Type.initTag(.usize), .rax, .{ .linker_load = .{ @@ -4069,53 +4080,7 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier }), .data = undefined, }); - } else { - return self.fail("TODO implement calling bitcasted functions", .{}); - } - } else { - assert(ty.zigTypeTag() == .Pointer); - const mcv = try self.resolveInst(callee); - try self.genSetReg(Type.initTag(.usize), .rax, mcv); - _ = try self.addInst(.{ - .tag = .call, - .ops = Mir.Inst.Ops.encode(.{ - .reg1 = .rax, - .flags = 0b01, - }), - .data = undefined, - }); - } - } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { - if (self.air.value(callee)) |func_value| { - if (func_value.castTag(.function)) |func_payload| { - const func = func_payload.data; - const fn_owner_decl = mod.declPtr(func.owner_decl); - try fn_owner_decl.link.macho.ensureInitialized(macho_file); - const sym_index = fn_owner_decl.link.macho.getSymbolIndex().?; - try self.genSetReg(Type.initTag(.usize), .rax, .{ - .linker_load = .{ - .type = .got, - .sym_index = sym_index, - }, - }); - // callq *%rax - _ = try self.addInst(.{ - .tag = .call, - .ops = Mir.Inst.Ops.encode(.{ - .reg1 = .rax, - .flags = 0b01, - }), - .data = undefined, - }); - } else if (func_value.castTag(.extern_fn)) |func_payload| { - const extern_fn = func_payload.data; - const decl_name = mod.declPtr(extern_fn.owner_decl).name; - if (extern_fn.lib_name) |lib_name| { - log.debug("TODO enforce that '{s}' is expected in '{s}' library", .{ - decl_name, - lib_name, - }); - } + } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { const sym_index = try macho_file.getGlobalSymbol(mem.sliceTo(decl_name, 0)); _ = try self.addInst(.{ .tag = .call_extern, @@ -4128,50 +4093,24 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier }, }); } else { - return self.fail("TODO implement calling bitcasted functions", .{}); + return self.fail("TODO implement calling extern functions", .{}); } } else { - assert(ty.zigTypeTag() == .Pointer); - const mcv = try self.resolveInst(callee); - try self.genSetReg(Type.initTag(.usize), .rax, mcv); - _ = try self.addInst(.{ - .tag = .call, - .ops = Mir.Inst.Ops.encode(.{ - .reg1 = .rax, - .flags = 0b01, - }), - .data = undefined, - }); + return self.fail("TODO implement calling bitcasted functions", .{}); } - } else if (self.bin_file.cast(link.File.Plan9)) |p9| { - if (self.air.value(callee)) |func_value| { - if (func_value.castTag(.function)) |func_payload| { - try p9.seeDecl(func_payload.data.owner_decl); - const ptr_bits = self.target.cpu.arch.ptrBitWidth(); - const ptr_bytes: u64 = @divExact(ptr_bits, 8); - const got_addr = p9.bases.data; - const got_index = mod.declPtr(func_payload.data.owner_decl).link.plan9.got_index.?; - const fn_got_addr = got_addr + got_index * ptr_bytes; - _ = try self.addInst(.{ - .tag = .call, - .ops = Mir.Inst.Ops.encode(.{ .flags = 0b01 }), - .data = .{ .imm = @intCast(u32, fn_got_addr) }, - }); - } else return self.fail("TODO implement calling extern fn on plan9", .{}); - } else { - assert(ty.zigTypeTag() == .Pointer); - const mcv = try self.resolveInst(callee); - try self.genSetReg(Type.initTag(.usize), .rax, mcv); - _ = try self.addInst(.{ - .tag = .call, - .ops = Mir.Inst.Ops.encode(.{ - .reg1 = .rax, - .flags = 0b01, - }), - .data = undefined, - }); - } - } else unreachable; + } else { + assert(ty.zigTypeTag() == .Pointer); + const mcv = try self.resolveInst(callee); + try self.genSetReg(Type.initTag(.usize), .rax, mcv); + _ = try self.addInst(.{ + .tag = .call, + .ops = Mir.Inst.Ops.encode(.{ + .reg1 = .rax, + .flags = 0b01, + }), + .data = undefined, + }); + } if (info.stack_byte_count > 0) { // Readjust the stack From 2b5d0ca73b6b0ae96f3362aabe92b792ece2ae63 Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Wed, 25 Jan 2023 23:34:57 +0100 Subject: [PATCH 05/84] elf: pull out logic for allocating a GOT entry into a helper --- src/link/Elf.zig | 40 ++++++++++++++++++++++++++-------------- 1 file changed, 26 insertions(+), 14 deletions(-) diff --git a/src/link/Elf.zig b/src/link/Elf.zig index b0acef368a..27e4602ed4 100644 --- a/src/link/Elf.zig +++ b/src/link/Elf.zig @@ -2289,31 +2289,43 @@ fn allocateLocalSymbol(self: *Elf) !u32 { return index; } +fn allocateGotOffset(self: *Elf) !u32 { + try self.offset_table.ensureUnusedCapacity(self.base.allocator, 1); + + const index = blk: { + if (self.offset_table_free_list.popOrNull()) |index| { + log.debug(" (reusing GOT offset at index {d})", .{index}); + break :blk index; + } else { + log.debug(" (allocating GOT offset at index {d})", .{self.offset_table.items.len}); + const index = @intCast(u32, self.offset_table.items.len); + _ = self.offset_table.addOneAssumeCapacity(); + self.offset_table_count_dirty = true; + break :blk index; + } + }; + + self.offset_table.items[index] = 0; + return index; +} + pub fn allocateDeclIndexes(self: *Elf, decl_index: Module.Decl.Index) !void { if (self.llvm_object) |_| return; const mod = self.base.options.module.?; const decl = mod.declPtr(decl_index); - if (decl.link.elf.local_sym_index != 0) return; - - try self.offset_table.ensureUnusedCapacity(self.base.allocator, 1); - try self.decls.putNoClobber(self.base.allocator, decl_index, null); + const block = &decl.link.elf; + if (block.local_sym_index != 0) return; const decl_name = try decl.getFullyQualifiedName(mod); defer self.base.allocator.free(decl_name); log.debug("allocating symbol indexes for {s}", .{decl_name}); - decl.link.elf.local_sym_index = try self.allocateLocalSymbol(); - try self.atom_by_index_table.putNoClobber(self.base.allocator, decl.link.elf.local_sym_index, &decl.link.elf); - if (self.offset_table_free_list.popOrNull()) |i| { - decl.link.elf.offset_table_index = i; - } else { - decl.link.elf.offset_table_index = @intCast(u32, self.offset_table.items.len); - _ = self.offset_table.addOneAssumeCapacity(); - self.offset_table_count_dirty = true; - } - self.offset_table.items[decl.link.elf.offset_table_index] = 0; + block.local_sym_index = try self.allocateLocalSymbol(); + block.offset_table_index = try self.allocateGotOffset(); + try self.atom_by_index_table.putNoClobber(self.base.allocator, block.local_sym_index, block); + try self.decls.putNoClobber(self.base.allocator, decl_index, null); } fn freeUnnamedConsts(self: *Elf, decl_index: Module.Decl.Index) void { From fb8d754a4bf823b66bcf3fa281c469af8be6f923 Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Thu, 26 Jan 2023 00:03:42 +0100 Subject: [PATCH 06/84] elf: move TextBlock into its own module and rename to Atom --- src/link/Elf.zig | 59 ++++--------------------------------------- src/link/Elf/Atom.zig | 56 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 61 insertions(+), 54 deletions(-) create mode 100644 src/link/Elf/Atom.zig diff --git a/src/link/Elf.zig b/src/link/Elf.zig index 27e4602ed4..e915fff423 100644 --- a/src/link/Elf.zig +++ b/src/link/Elf.zig @@ -10,6 +10,7 @@ const fs = std.fs; const elf = std.elf; const log = std.log.scoped(.link); +const Atom = @import("Elf/Atom.zig"); const Module = @import("../Module.zig"); const Compilation = @import("../Compilation.zig"); const Dwarf = @import("Dwarf.zig"); @@ -31,6 +32,8 @@ const Air = @import("../Air.zig"); const Liveness = @import("../Liveness.zig"); const LlvmObject = @import("../codegen/llvm.zig").Object; +pub const TextBlock = Atom; + const default_entry_addr = 0x8000000; pub const base_tag: File.Tag = .elf; @@ -188,62 +191,10 @@ const ideal_factor = 3; /// it as a possible place to put new symbols, it must have enough room for this many bytes /// (plus extra for reserved capacity). const minimum_text_block_size = 64; -const min_text_capacity = padToIdeal(minimum_text_block_size); +pub const min_text_capacity = padToIdeal(minimum_text_block_size); pub const PtrWidth = enum { p32, p64 }; -pub const TextBlock = struct { - /// Each decl always gets a local symbol with the fully qualified name. - /// The vaddr and size are found here directly. - /// The file offset is found by computing the vaddr offset from the section vaddr - /// the symbol references, and adding that to the file offset of the section. - /// If this field is 0, it means the codegen size = 0 and there is no symbol or - /// offset table entry. - local_sym_index: u32, - /// This field is undefined for symbols with size = 0. - offset_table_index: u32, - /// Points to the previous and next neighbors, based on the `text_offset`. - /// This can be used to find, for example, the capacity of this `TextBlock`. - prev: ?*TextBlock, - next: ?*TextBlock, - - dbg_info_atom: Dwarf.Atom, - - pub const empty = TextBlock{ - .local_sym_index = 0, - .offset_table_index = undefined, - .prev = null, - .next = null, - .dbg_info_atom = undefined, - }; - - /// Returns how much room there is to grow in virtual address space. - /// File offset relocation happens transparently, so it is not included in - /// this calculation. - fn capacity(self: TextBlock, elf_file: Elf) u64 { - const self_sym = elf_file.local_symbols.items[self.local_sym_index]; - if (self.next) |next| { - const next_sym = elf_file.local_symbols.items[next.local_sym_index]; - return next_sym.st_value - self_sym.st_value; - } else { - // We are the last block. The capacity is limited only by virtual address space. - return std.math.maxInt(u32) - self_sym.st_value; - } - } - - fn freeListEligible(self: TextBlock, elf_file: Elf) bool { - // No need to keep a free list node for the last block. - const next = self.next orelse return false; - const self_sym = elf_file.local_symbols.items[self.local_sym_index]; - const next_sym = elf_file.local_symbols.items[next.local_sym_index]; - const cap = next_sym.st_value - self_sym.st_value; - const ideal_cap = padToIdeal(self_sym.st_size); - if (cap <= ideal_cap) return false; - const surplus = cap - ideal_cap; - return surplus >= min_text_capacity; - } -}; - pub const Export = struct { sym_index: ?u32 = null, }; @@ -3052,7 +3003,7 @@ fn getLDMOption(target: std.Target) ?[]const u8 { } } -fn padToIdeal(actual_size: anytype) @TypeOf(actual_size) { +pub fn padToIdeal(actual_size: anytype) @TypeOf(actual_size) { return actual_size +| (actual_size / ideal_factor); } diff --git a/src/link/Elf/Atom.zig b/src/link/Elf/Atom.zig new file mode 100644 index 0000000000..e4061f5bbc --- /dev/null +++ b/src/link/Elf/Atom.zig @@ -0,0 +1,56 @@ +const Atom = @This(); + +const std = @import("std"); + +const Dwarf = @import("../Dwarf.zig"); +const Elf = @import("../Elf.zig"); + +/// Each decl always gets a local symbol with the fully qualified name. +/// The vaddr and size are found here directly. +/// The file offset is found by computing the vaddr offset from the section vaddr +/// the symbol references, and adding that to the file offset of the section. +/// If this field is 0, it means the codegen size = 0 and there is no symbol or +/// offset table entry. +local_sym_index: u32, +/// This field is undefined for symbols with size = 0. +offset_table_index: u32, +/// Points to the previous and next neighbors, based on the `text_offset`. +/// This can be used to find, for example, the capacity of this `TextBlock`. +prev: ?*Atom, +next: ?*Atom, + +dbg_info_atom: Dwarf.Atom, + +pub const empty = Atom{ + .local_sym_index = 0, + .offset_table_index = undefined, + .prev = null, + .next = null, + .dbg_info_atom = undefined, +}; + +/// Returns how much room there is to grow in virtual address space. +/// File offset relocation happens transparently, so it is not included in +/// this calculation. +pub fn capacity(self: Atom, elf_file: Elf) u64 { + const self_sym = elf_file.local_symbols.items[self.local_sym_index]; + if (self.next) |next| { + const next_sym = elf_file.local_symbols.items[next.local_sym_index]; + return next_sym.st_value - self_sym.st_value; + } else { + // We are the last block. The capacity is limited only by virtual address space. + return std.math.maxInt(u32) - self_sym.st_value; + } +} + +pub fn freeListEligible(self: Atom, elf_file: Elf) bool { + // No need to keep a free list node for the last block. + const next = self.next orelse return false; + const self_sym = elf_file.local_symbols.items[self.local_sym_index]; + const next_sym = elf_file.local_symbols.items[next.local_sym_index]; + const cap = next_sym.st_value - self_sym.st_value; + const ideal_cap = Elf.padToIdeal(self_sym.st_size); + if (cap <= ideal_cap) return false; + const surplus = cap - ideal_cap; + return surplus >= Elf.min_text_capacity; +} From e1b9800ffa74a637e2b0a6356249c2c37228ec01 Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Thu, 26 Jan 2023 13:17:38 +0100 Subject: [PATCH 07/84] elf: migrate to new non-allocateDeclIndexes API --- src/Module.zig | 2 +- src/arch/aarch64/CodeGen.zig | 17 ++---- src/arch/arm/CodeGen.zig | 103 ++++++++++++++++---------------- src/arch/riscv64/CodeGen.zig | 13 ++--- src/arch/sparc64/CodeGen.zig | 17 ++---- src/arch/x86_64/CodeGen.zig | 15 ++--- src/link.zig | 2 +- src/link/Elf.zig | 110 +++++++++++++++++------------------ src/link/Elf/Atom.zig | 52 +++++++++++++++-- src/link/MachO.zig | 7 ++- 10 files changed, 175 insertions(+), 163 deletions(-) diff --git a/src/Module.zig b/src/Module.zig index 2d85399baf..4e1f65aff4 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -5324,7 +5324,7 @@ pub fn deleteUnusedDecl(mod: *Module, decl_index: Decl.Index) void { // Until then, we did call `allocateDeclIndexes` on this anonymous Decl and so we // must call `freeDecl` in the linker backend now. switch (mod.comp.bin_file.tag) { - .macho, .c => {}, // this linker backend has already migrated to the new API + .elf, .macho, .c => {}, // this linker backend has already migrated to the new API else => if (decl.has_tv) { if (decl.ty.isFnOrHasRuntimeBits()) { mod.comp.bin_file.freeDecl(decl_index); diff --git a/src/arch/aarch64/CodeGen.zig b/src/arch/aarch64/CodeGen.zig index 93ac450bae..8c3f3e8168 100644 --- a/src/arch/aarch64/CodeGen.zig +++ b/src/arch/aarch64/CodeGen.zig @@ -4307,12 +4307,8 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier const fn_owner_decl = mod.declPtr(func.owner_decl); if (self.bin_file.cast(link.File.Elf)) |elf_file| { - const ptr_bits = self.target.cpu.arch.ptrBitWidth(); - const ptr_bytes: u64 = @divExact(ptr_bits, 8); - const got_addr = blk: { - const got = &elf_file.program_headers.items[elf_file.phdr_got_index.?]; - break :blk @intCast(u32, got.p_vaddr + fn_owner_decl.link.elf.offset_table_index * ptr_bytes); - }; + try fn_owner_decl.link.elf.ensureInitialized(elf_file); + const got_addr = @intCast(u32, fn_owner_decl.link.elf.getOffsetTableAddress(elf_file)); try self.genSetReg(Type.initTag(.usize), .x30, .{ .memory = got_addr }); } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { try fn_owner_decl.link.macho.ensureInitialized(macho_file); @@ -6125,20 +6121,15 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne mod.markDeclAlive(decl); if (self.bin_file.cast(link.File.Elf)) |elf_file| { - const got = &elf_file.program_headers.items[elf_file.phdr_got_index.?]; - const got_addr = got.p_vaddr + decl.link.elf.offset_table_index * ptr_bytes; - return MCValue{ .memory = got_addr }; + try decl.link.elf.ensureInitialized(elf_file); + return MCValue{ .memory = decl.link.elf.getOffsetTableAddress(elf_file) }; } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { - // Because MachO is PIE-always-on, we defer memory address resolution until - // the linker has enough info to perform relocations. try decl.link.macho.ensureInitialized(macho_file); return MCValue{ .linker_load = .{ .type = .got, .sym_index = decl.link.macho.getSymbolIndex().?, } }; } else if (self.bin_file.cast(link.File.Coff)) |_| { - // Because COFF is PIE-always-on, we defer memory address resolution until - // the linker has enough info to perform relocations. assert(decl.link.coff.sym_index != 0); return MCValue{ .linker_load = .{ .type = .got, diff --git a/src/arch/arm/CodeGen.zig b/src/arch/arm/CodeGen.zig index 6a7986a7a8..49f979624d 100644 --- a/src/arch/arm/CodeGen.zig +++ b/src/arch/arm/CodeGen.zig @@ -4253,59 +4253,57 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier // Due to incremental compilation, how function calls are generated depends // on linking. - switch (self.bin_file.tag) { - .elf => { - if (self.air.value(callee)) |func_value| { - if (func_value.castTag(.function)) |func_payload| { - const func = func_payload.data; - const ptr_bits = self.target.cpu.arch.ptrBitWidth(); - const ptr_bytes: u64 = @divExact(ptr_bits, 8); - const mod = self.bin_file.options.module.?; - const fn_owner_decl = mod.declPtr(func.owner_decl); - const got_addr = if (self.bin_file.cast(link.File.Elf)) |elf_file| blk: { - const got = &elf_file.program_headers.items[elf_file.phdr_got_index.?]; - break :blk @intCast(u32, got.p_vaddr + fn_owner_decl.link.elf.offset_table_index * ptr_bytes); - } else unreachable; - try self.genSetReg(Type.initTag(.usize), .lr, .{ .memory = got_addr }); - } else if (func_value.castTag(.extern_fn)) |_| { - return self.fail("TODO implement calling extern functions", .{}); - } else { - return self.fail("TODO implement calling bitcasted functions", .{}); - } + if (self.air.value(callee)) |func_value| { + if (func_value.castTag(.function)) |func_payload| { + const func = func_payload.data; + const mod = self.bin_file.options.module.?; + const fn_owner_decl = mod.declPtr(func.owner_decl); + + if (self.bin_file.cast(link.File.Elf)) |elf_file| { + try fn_owner_decl.link.elf.ensureInitialized(elf_file); + const got_addr = @intCast(u32, fn_owner_decl.link.elf.getOffsetTableAddress(elf_file)); + try self.genSetReg(Type.initTag(.usize), .lr, .{ .memory = got_addr }); + } else if (self.bin_file.cast(link.File.MachO)) |_| { + unreachable; // unsupported architecture for MachO } else { - assert(ty.zigTypeTag() == .Pointer); - const mcv = try self.resolveInst(callee); - - try self.genSetReg(Type.initTag(.usize), .lr, mcv); - } - - // TODO: add Instruction.supportedOn - // function for ARM - if (Target.arm.featureSetHas(self.target.cpu.features, .has_v5t)) { - _ = try self.addInst(.{ - .tag = .blx, - .data = .{ .reg = .lr }, + return self.fail("TODO implement call on {s} for {s}", .{ + @tagName(self.bin_file.tag), + @tagName(self.target.cpu.arch), }); - } else { - return self.fail("TODO fix blx emulation for ARM unreachable, // unsupported architecture for MachO - .coff => return self.fail("TODO implement call in COFF for {}", .{self.target.cpu.arch}), - .plan9 => return self.fail("TODO implement call on plan9 for {}", .{self.target.cpu.arch}), - else => unreachable, + } else if (func_value.castTag(.extern_fn)) |_| { + return self.fail("TODO implement calling extern functions", .{}); + } else { + return self.fail("TODO implement calling bitcasted functions", .{}); + } + } else { + assert(ty.zigTypeTag() == .Pointer); + const mcv = try self.resolveInst(callee); + + try self.genSetReg(Type.initTag(.usize), .lr, mcv); + } + + // TODO: add Instruction.supportedOn + // function for ARM + if (Target.arm.featureSetHas(self.target.cpu.features, .has_v5t)) { + _ = try self.addInst(.{ + .tag = .blx, + .data = .{ .reg = .lr }, + }); + } else { + return self.fail("TODO fix blx emulation for ARM return @fieldParentPtr(Coff, "base", base).allocateDeclIndexes(decl_index), - .elf => return @fieldParentPtr(Elf, "base", base).allocateDeclIndexes(decl_index), + .elf => {}, // no-op .macho => {}, // no-op .wasm => return @fieldParentPtr(Wasm, "base", base).allocateDeclIndexes(decl_index), .plan9 => return @fieldParentPtr(Plan9, "base", base).allocateDeclIndexes(decl_index), diff --git a/src/link/Elf.zig b/src/link/Elf.zig index e915fff423..9dbc5e846f 100644 --- a/src/link/Elf.zig +++ b/src/link/Elf.zig @@ -344,9 +344,10 @@ pub fn getDeclVAddr(self: *Elf, decl_index: Module.Decl.Index, reloc_info: File. const decl = mod.declPtr(decl_index); assert(self.llvm_object == null); - assert(decl.link.elf.local_sym_index != 0); - const target = decl.link.elf.local_sym_index; + try decl.link.elf.ensureInitialized(self); + const target = decl.link.elf.getSymbolIndex().?; + const vaddr = self.local_symbols.items[target].st_value; const atom = self.atom_by_index_table.get(reloc_info.parent_atom_index).?; const gop = try self.relocs.getOrPut(self.base.allocator, atom); @@ -447,7 +448,7 @@ fn makeString(self: *Elf, bytes: []const u8) !u32 { return @intCast(u32, result); } -fn getString(self: Elf, str_off: u32) []const u8 { +pub fn getString(self: Elf, str_off: u32) []const u8 { assert(str_off < self.shstrtab.items.len); return mem.sliceTo(@ptrCast([*:0]const u8, self.shstrtab.items.ptr + str_off), 0); } @@ -2069,7 +2070,7 @@ fn freeTextBlock(self: *Elf, text_block: *TextBlock, phdr_index: u16) void { if (text_block.prev) |prev| { prev.next = text_block.next; - if (!already_have_free_list_node and prev.freeListEligible(self.*)) { + if (!already_have_free_list_node and prev.freeListEligible(self)) { // The free list is heuristics, it doesn't have to be perfect, so we can // ignore the OOM here. free_list.append(self.base.allocator, prev) catch {}; @@ -2084,6 +2085,15 @@ fn freeTextBlock(self: *Elf, text_block: *TextBlock, phdr_index: u16) void { text_block.next = null; } + // Appending to free lists is allowed to fail because the free lists are heuristics based anyway. + const local_sym_index = text_block.getSymbolIndex().?; + self.local_symbol_free_list.append(self.base.allocator, local_sym_index) catch {}; + self.local_symbols.items[local_sym_index].st_info = 0; + _ = self.atom_by_index_table.remove(local_sym_index); + text_block.local_sym_index = 0; + + self.offset_table_free_list.append(self.base.allocator, text_block.offset_table_index) catch {}; + if (self.dwarf) |*dw| { dw.freeAtom(&text_block.dbg_info_atom); } @@ -2099,7 +2109,7 @@ fn shrinkTextBlock(self: *Elf, text_block: *TextBlock, new_block_size: u64, phdr fn growTextBlock(self: *Elf, text_block: *TextBlock, new_block_size: u64, alignment: u64, phdr_index: u16) !u64 { const sym = self.local_symbols.items[text_block.local_sym_index]; const align_ok = mem.alignBackwardGeneric(u64, sym.st_value, alignment) == sym.st_value; - const need_realloc = !align_ok or new_block_size > text_block.capacity(self.*); + const need_realloc = !align_ok or new_block_size > text_block.capacity(self); if (!need_realloc) return sym.st_value; return self.allocateTextBlock(text_block, new_block_size, alignment, phdr_index); } @@ -2128,7 +2138,7 @@ fn allocateTextBlock(self: *Elf, text_block: *TextBlock, new_block_size: u64, al // We now have a pointer to a live text block that has too much capacity. // Is it enough that we could fit this new text block? const sym = self.local_symbols.items[big_block.local_sym_index]; - const capacity = big_block.capacity(self.*); + const capacity = big_block.capacity(self); const ideal_capacity = padToIdeal(capacity); const ideal_capacity_end_vaddr = std.math.add(u64, sym.st_value, ideal_capacity) catch ideal_capacity; const capacity_end_vaddr = sym.st_value + capacity; @@ -2138,7 +2148,7 @@ fn allocateTextBlock(self: *Elf, text_block: *TextBlock, new_block_size: u64, al // Additional bookkeeping here to notice if this free list node // should be deleted because the block that it points to has grown to take up // more of the extra capacity. - if (!big_block.freeListEligible(self.*)) { + if (!big_block.freeListEligible(self)) { _ = free_list.swapRemove(i); } else { i += 1; @@ -2213,7 +2223,7 @@ fn allocateTextBlock(self: *Elf, text_block: *TextBlock, new_block_size: u64, al return vaddr; } -fn allocateLocalSymbol(self: *Elf) !u32 { +pub fn allocateLocalSymbol(self: *Elf) !u32 { try self.local_symbols.ensureUnusedCapacity(self.base.allocator, 1); const index = blk: { @@ -2240,7 +2250,7 @@ fn allocateLocalSymbol(self: *Elf) !u32 { return index; } -fn allocateGotOffset(self: *Elf) !u32 { +pub fn allocateGotOffset(self: *Elf) !u32 { try self.offset_table.ensureUnusedCapacity(self.base.allocator, 1); const index = blk: { @@ -2260,32 +2270,10 @@ fn allocateGotOffset(self: *Elf) !u32 { return index; } -pub fn allocateDeclIndexes(self: *Elf, decl_index: Module.Decl.Index) !void { - if (self.llvm_object) |_| return; - - const mod = self.base.options.module.?; - const decl = mod.declPtr(decl_index); - const block = &decl.link.elf; - if (block.local_sym_index != 0) return; - - const decl_name = try decl.getFullyQualifiedName(mod); - defer self.base.allocator.free(decl_name); - - log.debug("allocating symbol indexes for {s}", .{decl_name}); - - block.local_sym_index = try self.allocateLocalSymbol(); - block.offset_table_index = try self.allocateGotOffset(); - try self.atom_by_index_table.putNoClobber(self.base.allocator, block.local_sym_index, block); - try self.decls.putNoClobber(self.base.allocator, decl_index, null); -} - fn freeUnnamedConsts(self: *Elf, decl_index: Module.Decl.Index) void { const unnamed_consts = self.unnamed_const_atoms.getPtr(decl_index) orelse return; for (unnamed_consts.items) |atom| { self.freeTextBlock(atom, self.phdr_load_ro_index.?); - self.local_symbol_free_list.append(self.base.allocator, atom.local_sym_index) catch {}; - self.local_symbols.items[atom.local_sym_index].st_info = 0; - _ = self.atom_by_index_table.remove(atom.local_sym_index); } unnamed_consts.clearAndFree(self.base.allocator); } @@ -2298,20 +2286,13 @@ pub fn freeDecl(self: *Elf, decl_index: Module.Decl.Index) void { const mod = self.base.options.module.?; const decl = mod.declPtr(decl_index); - const kv = self.decls.fetchRemove(decl_index); - if (kv.?.value) |index| { - self.freeTextBlock(&decl.link.elf, index); - self.freeUnnamedConsts(decl_index); - } + log.debug("freeDecl {*}", .{decl}); - // Appending to free lists is allowed to fail because the free lists are heuristics based anyway. - if (decl.link.elf.local_sym_index != 0) { - self.local_symbol_free_list.append(self.base.allocator, decl.link.elf.local_sym_index) catch {}; - self.local_symbols.items[decl.link.elf.local_sym_index].st_info = 0; - _ = self.atom_by_index_table.remove(decl.link.elf.local_sym_index); - decl.link.elf.local_sym_index = 0; - - self.offset_table_free_list.append(self.base.allocator, decl.link.elf.offset_table_index) catch {}; + if (self.decls.fetchRemove(decl_index)) |kv| { + if (kv.value) |index| { + self.freeTextBlock(&decl.link.elf, index); + self.freeUnnamedConsts(decl_index); + } } if (self.dwarf) |*dw| { @@ -2363,7 +2344,7 @@ fn updateDeclCode(self: *Elf, decl_index: Module.Decl.Index, code: []const u8, s assert(decl.link.elf.local_sym_index != 0); // Caller forgot to allocateDeclIndexes() const local_sym = &self.local_symbols.items[decl.link.elf.local_sym_index]; if (local_sym.st_size != 0) { - const capacity = decl.link.elf.capacity(self.*); + const capacity = decl.link.elf.capacity(self); const need_realloc = code.len > capacity or !mem.isAlignedGeneric(u64, local_sym.st_value, required_alignment); if (need_realloc) { @@ -2424,12 +2405,19 @@ pub fn updateFunc(self: *Elf, module: *Module, func: *Module.Fn, air: Air, liven const tracy = trace(@src()); defer tracy.end(); - var code_buffer = std.ArrayList(u8).init(self.base.allocator); - defer code_buffer.deinit(); - const decl_index = func.owner_decl; const decl = module.declPtr(decl_index); - self.freeUnnamedConsts(decl_index); + const atom = &decl.link.elf; + try atom.ensureInitialized(self); + const gop = try self.decls.getOrPut(self.base.allocator, decl_index); + if (gop.found_existing) { + self.freeUnnamedConsts(decl_index); + } else { + gop.value_ptr.* = null; + } + + var code_buffer = std.ArrayList(u8).init(self.base.allocator); + defer code_buffer.deinit(); var decl_state: ?Dwarf.DeclState = if (self.dwarf) |*dw| try dw.initDeclState(module, decl_index) else null; defer if (decl_state) |*ds| ds.deinit(); @@ -2490,6 +2478,13 @@ pub fn updateDecl(self: *Elf, module: *Module, decl_index: Module.Decl.Index) !v assert(!self.unnamed_const_atoms.contains(decl_index)); + const atom = &decl.link.elf; + try atom.ensureInitialized(self); + const gop = try self.decls.getOrPut(self.base.allocator, decl_index); + if (!gop.found_existing) { + gop.value_ptr.* = null; + } + var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); @@ -2633,16 +2628,19 @@ pub fn updateDeclExports( const tracy = trace(@src()); defer tracy.end(); - try self.global_symbols.ensureUnusedCapacity(self.base.allocator, exports.len); const decl = module.declPtr(decl_index); - if (decl.link.elf.local_sym_index == 0) return; - const decl_sym = self.local_symbols.items[decl.link.elf.local_sym_index]; + const atom = &decl.link.elf; - const decl_ptr = self.decls.getPtr(decl_index).?; - if (decl_ptr.* == null) { - decl_ptr.* = try self.getDeclPhdrIndex(decl); + if (atom.getSymbolIndex() == null) return; + + const decl_sym = atom.getSymbol(self); + try self.global_symbols.ensureUnusedCapacity(self.base.allocator, exports.len); + + const gop = try self.decls.getOrPut(self.base.allocator, decl_index); + if (!gop.found_existing) { + gop.value_ptr.* = try self.getDeclPhdrIndex(decl); } - const phdr_index = decl_ptr.*.?; + const phdr_index = gop.value_ptr.*.?; const shdr_index = self.phdr_shdr_table.get(phdr_index).?; for (exports) |exp| { diff --git a/src/link/Elf/Atom.zig b/src/link/Elf/Atom.zig index e4061f5bbc..caeb3bfbc5 100644 --- a/src/link/Elf/Atom.zig +++ b/src/link/Elf/Atom.zig @@ -1,6 +1,8 @@ const Atom = @This(); const std = @import("std"); +const assert = std.debug.assert; +const elf = std.elf; const Dwarf = @import("../Dwarf.zig"); const Elf = @import("../Elf.zig"); @@ -12,8 +14,10 @@ const Elf = @import("../Elf.zig"); /// If this field is 0, it means the codegen size = 0 and there is no symbol or /// offset table entry. local_sym_index: u32, + /// This field is undefined for symbols with size = 0. offset_table_index: u32, + /// Points to the previous and next neighbors, based on the `text_offset`. /// This can be used to find, for example, the capacity of this `TextBlock`. prev: ?*Atom, @@ -29,13 +33,49 @@ pub const empty = Atom{ .dbg_info_atom = undefined, }; +pub fn ensureInitialized(self: *Atom, elf_file: *Elf) !void { + if (self.getSymbolIndex() != null) return; // Already initialized + self.local_sym_index = try elf_file.allocateLocalSymbol(); + self.offset_table_index = try elf_file.allocateGotOffset(); + try elf_file.atom_by_index_table.putNoClobber(elf_file.base.allocator, self.local_sym_index, self); +} + +pub fn getSymbolIndex(self: Atom) ?u32 { + if (self.local_sym_index == 0) return null; + return self.local_sym_index; +} + +pub fn getSymbol(self: Atom, elf_file: *Elf) elf.Elf64_Sym { + const sym_index = self.getSymbolIndex().?; + return elf_file.local_symbols.items[sym_index]; +} + +pub fn getSymbolPtr(self: Atom, elf_file: *Elf) *elf.Elf64_Sym { + const sym_index = self.getSymbolIndex().?; + return &elf_file.local_symbols.items[sym_index]; +} + +pub fn getName(self: Atom, elf_file: *Elf) []const u8 { + const sym = self.getSymbol(); + return elf_file.getString(sym.st_name); +} + +pub fn getOffsetTableAddress(self: Atom, elf_file: *Elf) u64 { + assert(self.getSymbolIndex() != null); + const target = elf_file.base.options.target; + const ptr_bits = target.cpu.arch.ptrBitWidth(); + const ptr_bytes: u64 = @divExact(ptr_bits, 8); + const got = elf_file.program_headers.items[elf_file.phdr_got_index.?]; + return got.p_vaddr + self.offset_table_index * ptr_bytes; +} + /// Returns how much room there is to grow in virtual address space. /// File offset relocation happens transparently, so it is not included in /// this calculation. -pub fn capacity(self: Atom, elf_file: Elf) u64 { - const self_sym = elf_file.local_symbols.items[self.local_sym_index]; +pub fn capacity(self: Atom, elf_file: *Elf) u64 { + const self_sym = self.getSymbol(elf_file); if (self.next) |next| { - const next_sym = elf_file.local_symbols.items[next.local_sym_index]; + const next_sym = next.getSymbol(elf_file); return next_sym.st_value - self_sym.st_value; } else { // We are the last block. The capacity is limited only by virtual address space. @@ -43,11 +83,11 @@ pub fn capacity(self: Atom, elf_file: Elf) u64 { } } -pub fn freeListEligible(self: Atom, elf_file: Elf) bool { +pub fn freeListEligible(self: Atom, elf_file: *Elf) bool { // No need to keep a free list node for the last block. const next = self.next orelse return false; - const self_sym = elf_file.local_symbols.items[self.local_sym_index]; - const next_sym = elf_file.local_symbols.items[next.local_sym_index]; + const self_sym = self.getSymbol(elf_file); + const next_sym = next.getSymbol(elf_file); const cap = next_sym.st_value - self_sym.st_value; const ideal_cap = Elf.padToIdeal(self_sym.st_size); if (cap <= ideal_cap) return false; diff --git a/src/link/MachO.zig b/src/link/MachO.zig index 1ec8ecaaf8..8fe5a1c712 100644 --- a/src/link/MachO.zig +++ b/src/link/MachO.zig @@ -2472,14 +2472,15 @@ pub fn updateDeclExports( const decl = module.declPtr(decl_index); const atom = &decl.link.macho; - try atom.ensureInitialized(self); + + if (atom.getSymbolIndex() == null) return; const gop = try self.decls.getOrPut(gpa, decl_index); if (!gop.found_existing) { - gop.value_ptr.* = null; + gop.value_ptr.* = self.getDeclOutputSection(decl); } - const decl_sym = decl.link.macho.getSymbol(self); + const decl_sym = atom.getSymbol(self); for (exports) |exp| { const exp_name = try std.fmt.allocPrint(gpa, "_{s}", .{exp.options.name}); From cc1d7a0e315ba63b0d8c0cd647b4c7e92a571bf2 Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Thu, 26 Jan 2023 14:28:44 +0100 Subject: [PATCH 08/84] coff: migrate to new non-allocateDeclIndexes API --- src/Module.zig | 7 +- src/arch/aarch64/CodeGen.zig | 19 ++--- src/arch/x86_64/CodeGen.zig | 14 ++-- src/link.zig | 12 ++- src/link/Coff.zig | 152 ++++++++++++++++++----------------- src/link/Coff/Atom.zig | 23 +++++- src/link/Elf.zig | 49 ++++++----- src/link/MachO.zig | 135 ++++++++++++------------------- 8 files changed, 209 insertions(+), 202 deletions(-) diff --git a/src/Module.zig b/src/Module.zig index 4e1f65aff4..360dd4d1ec 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -5324,7 +5324,12 @@ pub fn deleteUnusedDecl(mod: *Module, decl_index: Decl.Index) void { // Until then, we did call `allocateDeclIndexes` on this anonymous Decl and so we // must call `freeDecl` in the linker backend now. switch (mod.comp.bin_file.tag) { - .elf, .macho, .c => {}, // this linker backend has already migrated to the new API + .coff, + .elf, + .macho, + .c, + => {}, // this linker backend has already migrated to the new API + else => if (decl.has_tv) { if (decl.ty.isFnOrHasRuntimeBits()) { mod.comp.bin_file.freeDecl(decl_index); diff --git a/src/arch/aarch64/CodeGen.zig b/src/arch/aarch64/CodeGen.zig index 8c3f3e8168..200bf3b8e0 100644 --- a/src/arch/aarch64/CodeGen.zig +++ b/src/arch/aarch64/CodeGen.zig @@ -4000,7 +4000,7 @@ fn store(self: *Self, ptr: MCValue, value: MCValue, ptr_ty: Type, value_ty: Type const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { .macho => owner_decl.link.macho.getSymbolIndex().?, - .coff => owner_decl.link.coff.sym_index, + .coff => owner_decl.link.coff.getSymbolIndex().?, else => unreachable, // unsupported target format }; _ = try self.addInst(.{ @@ -4318,11 +4318,12 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier .sym_index = fn_owner_decl.link.macho.getSymbolIndex().?, }, }); - } else if (self.bin_file.cast(link.File.Coff)) |_| { + } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { + try fn_owner_decl.link.coff.ensureInitialized(coff_file); try self.genSetReg(Type.initTag(.u64), .x30, .{ .linker_load = .{ .type = .got, - .sym_index = fn_owner_decl.link.coff.sym_index, + .sym_index = fn_owner_decl.link.coff.getSymbolIndex().?, }, }); } else if (self.bin_file.cast(link.File.Plan9)) |p9| { @@ -5494,7 +5495,7 @@ fn genSetStack(self: *Self, ty: Type, stack_offset: u32, mcv: MCValue) InnerErro const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { .macho => owner_decl.link.macho.getSymbolIndex().?, - .coff => owner_decl.link.coff.sym_index, + .coff => owner_decl.link.coff.getSymbolIndex().?, else => unreachable, // unsupported target format }; _ = try self.addInst(.{ @@ -5608,7 +5609,7 @@ fn genSetReg(self: *Self, ty: Type, reg: Register, mcv: MCValue) InnerError!void const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { .macho => owner_decl.link.macho.getSymbolIndex().?, - .coff => owner_decl.link.coff.sym_index, + .coff => owner_decl.link.coff.getSymbolIndex().?, else => unreachable, // unsupported target format }; _ = try self.addInst(.{ @@ -5802,7 +5803,7 @@ fn genSetStackArgument(self: *Self, ty: Type, stack_offset: u32, mcv: MCValue) I const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { .macho => owner_decl.link.macho.getSymbolIndex().?, - .coff => owner_decl.link.coff.sym_index, + .coff => owner_decl.link.coff.getSymbolIndex().?, else => unreachable, // unsupported target format }; _ = try self.addInst(.{ @@ -6129,11 +6130,11 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne .type = .got, .sym_index = decl.link.macho.getSymbolIndex().?, } }; - } else if (self.bin_file.cast(link.File.Coff)) |_| { - assert(decl.link.coff.sym_index != 0); + } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { + try decl.link.coff.ensureInitialized(coff_file); return MCValue{ .linker_load = .{ .type = .got, - .sym_index = decl.link.coff.sym_index, + .sym_index = decl.link.coff.getSymbolIndex().?, } }; } else if (self.bin_file.cast(link.File.Plan9)) |p9| { try p9.seeDecl(decl_index); diff --git a/src/arch/x86_64/CodeGen.zig b/src/arch/x86_64/CodeGen.zig index 93f1269147..df24fe5e7d 100644 --- a/src/arch/x86_64/CodeGen.zig +++ b/src/arch/x86_64/CodeGen.zig @@ -2673,7 +2673,7 @@ fn loadMemPtrIntoRegister(self: *Self, reg: Register, ptr_ty: Type, ptr: MCValue const atom_index = if (self.bin_file.tag == link.File.MachO.base_tag) fn_owner_decl.link.macho.getSymbolIndex().? else - fn_owner_decl.link.coff.sym_index; + fn_owner_decl.link.coff.getSymbolIndex().?; const flags: u2 = switch (load_struct.type) { .got => 0b00, .direct => 0b01, @@ -4005,11 +4005,13 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier .ops = Mir.Inst.Ops.encode(.{ .flags = 0b01 }), .data = .{ .imm = got_addr }, }); - } else if (self.bin_file.cast(link.File.Coff)) |_| { + } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { + try fn_owner_decl.link.coff.ensureInitialized(coff_file); + const sym_index = fn_owner_decl.link.coff.getSymbolIndex().?; try self.genSetReg(Type.initTag(.usize), .rax, .{ .linker_load = .{ .type = .got, - .sym_index = fn_owner_decl.link.coff.sym_index, + .sym_index = sym_index, }, }); _ = try self.addInst(.{ @@ -6725,11 +6727,11 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne .type = .got, .sym_index = decl.link.macho.getSymbolIndex().?, } }; - } else if (self.bin_file.cast(link.File.Coff)) |_| { - assert(decl.link.coff.sym_index != 0); + } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { + try decl.link.coff.ensureInitialized(coff_file); return MCValue{ .linker_load = .{ .type = .got, - .sym_index = decl.link.coff.sym_index, + .sym_index = decl.link.coff.getSymbolIndex().?, } }; } else if (self.bin_file.cast(link.File.Plan9)) |p9| { try p9.seeDecl(decl_index); diff --git a/src/link.zig b/src/link.zig index d64c09d199..9be5b9ca3a 100644 --- a/src/link.zig +++ b/src/link.zig @@ -615,12 +615,16 @@ pub const File = struct { return; } switch (base.tag) { - .coff => return @fieldParentPtr(Coff, "base", base).allocateDeclIndexes(decl_index), - .elf => {}, // no-op - .macho => {}, // no-op .wasm => return @fieldParentPtr(Wasm, "base", base).allocateDeclIndexes(decl_index), .plan9 => return @fieldParentPtr(Plan9, "base", base).allocateDeclIndexes(decl_index), - .c, .spirv, .nvptx => {}, + + .coff, + .elf, + .macho, + .c, + .spirv, + .nvptx, + => {}, } } diff --git a/src/link/Coff.zig b/src/link/Coff.zig index 65aee010fd..dee3c7c381 100644 --- a/src/link/Coff.zig +++ b/src/link/Coff.zig @@ -480,16 +480,6 @@ fn growSectionVM(self: *Coff, sect_id: u32, needed_size: u32) !void { header.virtual_size = increased_size; } -pub fn allocateDeclIndexes(self: *Coff, decl_index: Module.Decl.Index) !void { - if (self.llvm_object) |_| return; - const decl = self.base.options.module.?.declPtr(decl_index); - if (decl.link.coff.sym_index != 0) return; - decl.link.coff.sym_index = try self.allocateSymbol(); - const gpa = self.base.allocator; - try self.atom_by_index_table.putNoClobber(gpa, decl.link.coff.sym_index, &decl.link.coff); - try self.decls.putNoClobber(gpa, decl_index, null); -} - fn allocateAtom(self: *Coff, atom: *Atom, new_atom_size: u32, alignment: u32) !u32 { const tracy = trace(@src()); defer tracy.end(); @@ -615,7 +605,7 @@ fn allocateAtom(self: *Coff, atom: *Atom, new_atom_size: u32, alignment: u32) !u return vaddr; } -fn allocateSymbol(self: *Coff) !u32 { +pub fn allocateSymbol(self: *Coff) !u32 { const gpa = self.base.allocator; try self.locals.ensureUnusedCapacity(gpa, 1); @@ -716,12 +706,11 @@ fn createGotAtom(self: *Coff, target: SymbolWithLoc) !*Atom { const atom = try gpa.create(Atom); errdefer gpa.destroy(atom); atom.* = Atom.empty; - atom.sym_index = try self.allocateSymbol(); + try atom.ensureInitialized(self); atom.size = @sizeOf(u64); atom.alignment = @alignOf(u64); try self.managed_atoms.append(gpa, atom); - try self.atom_by_index_table.putNoClobber(gpa, atom.sym_index, atom); const sym = atom.getSymbolPtr(self); sym.section_number = @intToEnum(coff.SectionNumber, self.got_section_index.? + 1); @@ -754,12 +743,11 @@ fn createImportAtom(self: *Coff) !*Atom { const atom = try gpa.create(Atom); errdefer gpa.destroy(atom); atom.* = Atom.empty; - atom.sym_index = try self.allocateSymbol(); + try atom.ensureInitialized(self); atom.size = @sizeOf(u64); atom.alignment = @alignOf(u64); try self.managed_atoms.append(gpa, atom); - try self.atom_by_index_table.putNoClobber(gpa, atom.sym_index, atom); const sym = atom.getSymbolPtr(self); sym.section_number = @intToEnum(coff.SectionNumber, self.idata_section_index.? + 1); @@ -790,7 +778,11 @@ fn writeAtom(self: *Coff, atom: *Atom, code: []const u8) !void { const sym = atom.getSymbol(self); const section = self.sections.get(@enumToInt(sym.section_number) - 1); const file_offset = section.header.pointer_to_raw_data + sym.value - section.header.virtual_address; - log.debug("writing atom for symbol {s} at file offset 0x{x} to 0x{x}", .{ atom.getName(self), file_offset, file_offset + code.len }); + log.debug("writing atom for symbol {s} at file offset 0x{x} to 0x{x}", .{ + atom.getName(self), + file_offset, + file_offset + code.len, + }); try self.base.file.?.pwriteAll(code, file_offset); try self.resolveRelocs(atom); } @@ -848,6 +840,7 @@ fn freeAtom(self: *Coff, atom: *Atom) void { // Remove any relocs and base relocs associated with this Atom self.freeRelocationsForAtom(atom); + const gpa = self.base.allocator; const sym = atom.getSymbol(self); const sect_id = @enumToInt(sym.section_number) - 1; const free_list = &self.sections.items(.free_list)[sect_id]; @@ -885,7 +878,7 @@ fn freeAtom(self: *Coff, atom: *Atom) void { if (!already_have_free_list_node and prev.freeListEligible(self)) { // The free list is heuristics, it doesn't have to be perfect, so we can // ignore the OOM here. - free_list.append(self.base.allocator, prev) catch {}; + free_list.append(gpa, prev) catch {}; } } else { atom.prev = null; @@ -896,6 +889,28 @@ fn freeAtom(self: *Coff, atom: *Atom) void { } else { atom.next = null; } + + // Appending to free lists is allowed to fail because the free lists are heuristics based anyway. + const sym_index = atom.getSymbolIndex().?; + self.locals_free_list.append(gpa, sym_index) catch {}; + + // Try freeing GOT atom if this decl had one + const got_target = SymbolWithLoc{ .sym_index = sym_index, .file = null }; + if (self.got_entries_table.get(got_target)) |got_index| { + self.got_entries_free_list.append(gpa, @intCast(u32, got_index)) catch {}; + self.got_entries.items[got_index] = .{ + .target = .{ .sym_index = 0, .file = null }, + .sym_index = 0, + }; + _ = self.got_entries_table.remove(got_target); + + log.debug(" adding GOT index {d} to free list (target local@{d})", .{ got_index, sym_index }); + } + + self.locals.items[sym_index].section_number = .UNDEFINED; + _ = self.atom_by_index_table.remove(sym_index); + log.debug(" adding local symbol index {d} to free list", .{sym_index}); + atom.sym_index = 0; } pub fn updateFunc(self: *Coff, module: *Module, func: *Module.Fn, air: Air, liveness: Liveness) !void { @@ -912,8 +927,15 @@ pub fn updateFunc(self: *Coff, module: *Module, func: *Module.Fn, air: Air, live const decl_index = func.owner_decl; const decl = module.declPtr(decl_index); - self.freeUnnamedConsts(decl_index); - self.freeRelocationsForAtom(&decl.link.coff); + const atom = &decl.link.coff; + try atom.ensureInitialized(self); + const gop = try self.decls.getOrPut(self.base.allocator, decl_index); + if (gop.found_existing) { + self.freeUnnamedConsts(decl_index); + self.freeRelocationsForAtom(&decl.link.coff); + } else { + gop.value_ptr.* = null; + } var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); @@ -960,9 +982,9 @@ pub fn lowerUnnamedConst(self: *Coff, tv: TypedValue, decl_index: Module.Decl.In const atom = try gpa.create(Atom); errdefer gpa.destroy(atom); atom.* = Atom.empty; + try atom.ensureInitialized(self); + try self.managed_atoms.append(gpa, atom); - atom.sym_index = try self.allocateSymbol(); - const sym = atom.getSymbolPtr(self); const sym_name = blk: { const decl_name = try decl.getFullyQualifiedName(mod); defer gpa.free(decl_name); @@ -971,14 +993,11 @@ pub fn lowerUnnamedConst(self: *Coff, tv: TypedValue, decl_index: Module.Decl.In break :blk try std.fmt.allocPrint(gpa, "__unnamed_{s}_{d}", .{ decl_name, index }); }; defer gpa.free(sym_name); - try self.setSymbolName(sym, sym_name); - sym.section_number = @intToEnum(coff.SectionNumber, self.rdata_section_index.? + 1); - - try self.managed_atoms.append(gpa, atom); - try self.atom_by_index_table.putNoClobber(gpa, atom.sym_index, atom); + try self.setSymbolName(atom.getSymbolPtr(self), sym_name); + atom.getSymbolPtr(self).section_number = @intToEnum(coff.SectionNumber, self.rdata_section_index.? + 1); const res = try codegen.generateSymbol(&self.base, decl.srcLoc(), tv, &code_buffer, .none, .{ - .parent_atom_index = atom.sym_index, + .parent_atom_index = atom.getSymbolIndex().?, }); const code = switch (res) { .ok => code_buffer.items, @@ -993,17 +1012,17 @@ pub fn lowerUnnamedConst(self: *Coff, tv: TypedValue, decl_index: Module.Decl.In const required_alignment = tv.ty.abiAlignment(self.base.options.target); atom.alignment = required_alignment; atom.size = @intCast(u32, code.len); - sym.value = try self.allocateAtom(atom, atom.size, atom.alignment); + atom.getSymbolPtr(self).value = try self.allocateAtom(atom, atom.size, atom.alignment); errdefer self.freeAtom(atom); try unnamed_consts.append(gpa, atom); - log.debug("allocated atom for {s} at 0x{x}", .{ sym_name, sym.value }); + log.debug("allocated atom for {s} at 0x{x}", .{ sym_name, atom.getSymbol(self).value }); log.debug(" (required alignment 0x{x})", .{required_alignment}); try self.writeAtom(atom, code); - return atom.sym_index; + return atom.getSymbolIndex().?; } pub fn updateDecl(self: *Coff, module: *Module, decl_index: Module.Decl.Index) !void { @@ -1028,7 +1047,14 @@ pub fn updateDecl(self: *Coff, module: *Module, decl_index: Module.Decl.Index) ! } } - self.freeRelocationsForAtom(&decl.link.coff); + const atom = &decl.link.coff; + try atom.ensureInitialized(self); + const gop = try self.decls.getOrPut(self.base.allocator, decl_index); + if (gop.found_existing) { + self.freeRelocationsForAtom(atom); + } else { + gop.value_ptr.* = null; + } var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); @@ -1038,7 +1064,7 @@ pub fn updateDecl(self: *Coff, module: *Module, decl_index: Module.Decl.Index) ! .ty = decl.ty, .val = decl_val, }, &code_buffer, .none, .{ - .parent_atom_index = decl.link.coff.sym_index, + .parent_atom_index = decl.link.coff.getSymbolIndex().?, }); const code = switch (res) { .ok => code_buffer.items, @@ -1099,7 +1125,7 @@ fn updateDeclCode(self: *Coff, decl_index: Module.Decl.Index, code: []const u8, const code_len = @intCast(u32, code.len); const atom = &decl.link.coff; - assert(atom.sym_index != 0); // Caller forgot to allocateDeclIndexes() + if (atom.size != 0) { const sym = atom.getSymbolPtr(self); try self.setSymbolName(sym, decl_name); @@ -1116,7 +1142,7 @@ fn updateDeclCode(self: *Coff, decl_index: Module.Decl.Index, code: []const u8, if (vaddr != sym.value) { sym.value = vaddr; log.debug(" (updating GOT entry)", .{}); - const got_target = SymbolWithLoc{ .sym_index = atom.sym_index, .file = null }; + const got_target = SymbolWithLoc{ .sym_index = atom.getSymbolIndex().?, .file = null }; const got_atom = self.getGotAtomForSymbol(got_target).?; self.markRelocsDirtyByTarget(got_target); try self.writePtrWidthAtom(got_atom); @@ -1137,10 +1163,10 @@ fn updateDeclCode(self: *Coff, decl_index: Module.Decl.Index, code: []const u8, atom.size = code_len; sym.value = vaddr; - const got_target = SymbolWithLoc{ .sym_index = atom.sym_index, .file = null }; + const got_target = SymbolWithLoc{ .sym_index = atom.getSymbolIndex().?, .file = null }; const got_index = try self.allocateGotEntry(got_target); const got_atom = try self.createGotAtom(got_target); - self.got_entries.items[got_index].sym_index = got_atom.sym_index; + self.got_entries.items[got_index].sym_index = got_atom.getSymbolIndex().?; try self.writePtrWidthAtom(got_atom); } @@ -1160,11 +1186,6 @@ fn freeUnnamedConsts(self: *Coff, decl_index: Module.Decl.Index) void { const unnamed_consts = self.unnamed_const_atoms.getPtr(decl_index) orelse return; for (unnamed_consts.items) |atom| { self.freeAtom(atom); - self.locals_free_list.append(gpa, atom.sym_index) catch {}; - self.locals.items[atom.sym_index].section_number = .UNDEFINED; - _ = self.atom_by_index_table.remove(atom.sym_index); - log.debug(" adding local symbol index {d} to free list", .{atom.sym_index}); - atom.sym_index = 0; } unnamed_consts.clearAndFree(gpa); } @@ -1179,35 +1200,11 @@ pub fn freeDecl(self: *Coff, decl_index: Module.Decl.Index) void { log.debug("freeDecl {*}", .{decl}); - const kv = self.decls.fetchRemove(decl_index); - if (kv.?.value) |_| { - self.freeAtom(&decl.link.coff); - self.freeUnnamedConsts(decl_index); - } - - // Appending to free lists is allowed to fail because the free lists are heuristics based anyway. - const gpa = self.base.allocator; - const sym_index = decl.link.coff.sym_index; - if (sym_index != 0) { - self.locals_free_list.append(gpa, sym_index) catch {}; - - // Try freeing GOT atom if this decl had one - const got_target = SymbolWithLoc{ .sym_index = sym_index, .file = null }; - if (self.got_entries_table.get(got_target)) |got_index| { - self.got_entries_free_list.append(gpa, @intCast(u32, got_index)) catch {}; - self.got_entries.items[got_index] = .{ - .target = .{ .sym_index = 0, .file = null }, - .sym_index = 0, - }; - _ = self.got_entries_table.remove(got_target); - - log.debug(" adding GOT index {d} to free list (target local@{d})", .{ got_index, sym_index }); + if (self.decls.fetchRemove(decl_index)) |kv| { + if (kv.value) |_| { + self.freeAtom(&decl.link.coff); + self.freeUnnamedConsts(decl_index); } - - self.locals.items[sym_index].section_number = .UNDEFINED; - _ = self.atom_by_index_table.remove(sym_index); - log.debug(" adding local symbol index {d} to free list", .{sym_index}); - decl.link.coff.sym_index = 0; } } @@ -1261,7 +1258,14 @@ pub fn updateDeclExports( const decl = module.declPtr(decl_index); const atom = &decl.link.coff; - if (atom.sym_index == 0) return; + + if (atom.getSymbolIndex() == null) return; + + const gop = try self.decls.getOrPut(gpa, decl_index); + if (!gop.found_existing) { + gop.value_ptr.* = self.getDeclOutputSection(decl); + } + const decl_sym = atom.getSymbol(self); for (exports) |exp| { @@ -1416,7 +1420,7 @@ pub fn flushModule(self: *Coff, comp: *Compilation, prog_node: *std.Progress.Nod const import_index = try self.allocateImportEntry(global); const import_atom = try self.createImportAtom(); - self.imports.items[import_index].sym_index = import_atom.sym_index; + self.imports.items[import_index].sym_index = import_atom.getSymbolIndex().?; try self.writePtrWidthAtom(import_atom); } @@ -1460,10 +1464,12 @@ pub fn getDeclVAddr( const decl = mod.declPtr(decl_index); assert(self.llvm_object == null); - assert(decl.link.coff.sym_index != 0); + + try decl.link.coff.ensureInitialized(self); + const sym_index = decl.link.coff.getSymbolIndex().?; const atom = self.getAtomForSymbol(.{ .sym_index = reloc_info.parent_atom_index, .file = null }).?; - const target = SymbolWithLoc{ .sym_index = decl.link.coff.sym_index, .file = null }; + const target = SymbolWithLoc{ .sym_index = sym_index, .file = null }; try atom.addRelocation(self, .{ .type = .direct, .target = target, diff --git a/src/link/Coff/Atom.zig b/src/link/Coff/Atom.zig index b1bb292c62..78824eac1d 100644 --- a/src/link/Coff/Atom.zig +++ b/src/link/Coff/Atom.zig @@ -39,30 +39,45 @@ pub const empty = Atom{ .next = null, }; +pub fn ensureInitialized(self: *Atom, coff_file: *Coff) !void { + if (self.getSymbolIndex() != null) return; // Already initialized + self.sym_index = try coff_file.allocateSymbol(); + try coff_file.atom_by_index_table.putNoClobber(coff_file.base.allocator, self.sym_index, self); +} + +pub fn getSymbolIndex(self: Atom) ?u32 { + if (self.sym_index == 0) return null; + return self.sym_index; +} + /// Returns symbol referencing this atom. pub fn getSymbol(self: Atom, coff_file: *const Coff) *const coff.Symbol { + const sym_index = self.getSymbolIndex().?; return coff_file.getSymbol(.{ - .sym_index = self.sym_index, + .sym_index = sym_index, .file = self.file, }); } /// Returns pointer-to-symbol referencing this atom. pub fn getSymbolPtr(self: Atom, coff_file: *Coff) *coff.Symbol { + const sym_index = self.getSymbolIndex().?; return coff_file.getSymbolPtr(.{ - .sym_index = self.sym_index, + .sym_index = sym_index, .file = self.file, }); } pub fn getSymbolWithLoc(self: Atom) SymbolWithLoc { - return .{ .sym_index = self.sym_index, .file = self.file }; + const sym_index = self.getSymbolIndex().?; + return .{ .sym_index = sym_index, .file = self.file }; } /// Returns the name of this atom. pub fn getName(self: Atom, coff_file: *const Coff) []const u8 { + const sym_index = self.getSymbolIndex().?; return coff_file.getSymbolName(.{ - .sym_index = self.sym_index, + .sym_index = sym_index, .file = self.file, }); } diff --git a/src/link/Elf.zig b/src/link/Elf.zig index 9dbc5e846f..2c55e55f83 100644 --- a/src/link/Elf.zig +++ b/src/link/Elf.zig @@ -893,7 +893,7 @@ fn growAllocSection(self: *Elf, shdr_index: u16, phdr_index: u16, needed_size: u // Must move the entire section. const new_offset = self.findFreeSpace(needed_size, self.page_size); const existing_size = if (self.atoms.get(phdr_index)) |last| blk: { - const sym = self.local_symbols.items[last.local_sym_index]; + const sym = last.getSymbol(self); break :blk (sym.st_value + sym.st_size) - phdr.p_vaddr; } else if (shdr_index == self.got_section_index.?) blk: { break :blk shdr.sh_size; @@ -1031,7 +1031,7 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node while (it.next()) |entry| { const atom = entry.key_ptr.*; const relocs = entry.value_ptr.*; - const source_sym = self.local_symbols.items[atom.local_sym_index]; + const source_sym = atom.getSymbol(self); const source_shdr = self.sections.items[source_sym.st_shndx]; log.debug("relocating '{s}'", .{self.getString(source_sym.st_name)}); @@ -2034,11 +2034,13 @@ fn writeElfHeader(self: *Elf) !void { } fn freeTextBlock(self: *Elf, text_block: *TextBlock, phdr_index: u16) void { - const local_sym = self.local_symbols.items[text_block.local_sym_index]; + const local_sym = text_block.getSymbol(self); const name_str_index = local_sym.st_name; const name = self.getString(name_str_index); log.debug("freeTextBlock {*} ({s})", .{ text_block, name }); + self.freeRelocationsForTextBlock(text_block); + const free_list = self.atom_free_lists.getPtr(phdr_index).?; var already_have_free_list_node = false; { @@ -2107,7 +2109,7 @@ fn shrinkTextBlock(self: *Elf, text_block: *TextBlock, new_block_size: u64, phdr } fn growTextBlock(self: *Elf, text_block: *TextBlock, new_block_size: u64, alignment: u64, phdr_index: u16) !u64 { - const sym = self.local_symbols.items[text_block.local_sym_index]; + const sym = text_block.getSymbol(self); const align_ok = mem.alignBackwardGeneric(u64, sym.st_value, alignment) == sym.st_value; const need_realloc = !align_ok or new_block_size > text_block.capacity(self); if (!need_realloc) return sym.st_value; @@ -2137,7 +2139,7 @@ fn allocateTextBlock(self: *Elf, text_block: *TextBlock, new_block_size: u64, al const big_block = free_list.items[i]; // We now have a pointer to a live text block that has too much capacity. // Is it enough that we could fit this new text block? - const sym = self.local_symbols.items[big_block.local_sym_index]; + const sym = big_block.getSymbol(self); const capacity = big_block.capacity(self); const ideal_capacity = padToIdeal(capacity); const ideal_capacity_end_vaddr = std.math.add(u64, sym.st_value, ideal_capacity) catch ideal_capacity; @@ -2168,7 +2170,7 @@ fn allocateTextBlock(self: *Elf, text_block: *TextBlock, new_block_size: u64, al } break :blk new_start_vaddr; } else if (self.atoms.get(phdr_index)) |last| { - const sym = self.local_symbols.items[last.local_sym_index]; + const sym = last.getSymbol(self); const ideal_capacity = padToIdeal(sym.st_size); const ideal_capacity_end_vaddr = sym.st_value + ideal_capacity; const new_start_vaddr = mem.alignForwardGeneric(u64, ideal_capacity_end_vaddr, alignment); @@ -2270,6 +2272,11 @@ pub fn allocateGotOffset(self: *Elf) !u32 { return index; } +fn freeRelocationsForTextBlock(self: *Elf, text_block: *TextBlock) void { + var removed_relocs = self.relocs.fetchRemove(text_block); + if (removed_relocs) |*relocs| relocs.value.deinit(self.base.allocator); +} + fn freeUnnamedConsts(self: *Elf, decl_index: Module.Decl.Index) void { const unnamed_consts = self.unnamed_const_atoms.getPtr(decl_index) orelse return; for (unnamed_consts.items) |atom| { @@ -2341,8 +2348,7 @@ fn updateDeclCode(self: *Elf, decl_index: Module.Decl.Index, code: []const u8, s const phdr_index = decl_ptr.*.?; const shdr_index = self.phdr_shdr_table.get(phdr_index).?; - assert(decl.link.elf.local_sym_index != 0); // Caller forgot to allocateDeclIndexes() - const local_sym = &self.local_symbols.items[decl.link.elf.local_sym_index]; + const local_sym = decl.link.elf.getSymbolPtr(self); if (local_sym.st_size != 0) { const capacity = decl.link.elf.capacity(self); const need_realloc = code.len > capacity or @@ -2366,7 +2372,7 @@ fn updateDeclCode(self: *Elf, decl_index: Module.Decl.Index, code: []const u8, s local_sym.st_other = 0; local_sym.st_shndx = shdr_index; // TODO this write could be avoided if no fields of the symbol were changed. - try self.writeSymbol(decl.link.elf.local_sym_index); + try self.writeSymbol(decl.link.elf.getSymbolIndex().?); } else { const name_str_index = try self.makeString(decl_name); const vaddr = try self.allocateTextBlock(&decl.link.elf, code.len, required_alignment, phdr_index); @@ -2383,7 +2389,7 @@ fn updateDeclCode(self: *Elf, decl_index: Module.Decl.Index, code: []const u8, s }; self.offset_table.items[decl.link.elf.offset_table_index] = vaddr; - try self.writeSymbol(decl.link.elf.local_sym_index); + try self.writeSymbol(decl.link.elf.getSymbolIndex().?); try self.writeOffsetTableEntry(decl.link.elf.offset_table_index); } @@ -2412,6 +2418,7 @@ pub fn updateFunc(self: *Elf, module: *Module, func: *Module.Fn, air: Air, liven const gop = try self.decls.getOrPut(self.base.allocator, decl_index); if (gop.found_existing) { self.freeUnnamedConsts(decl_index); + self.freeRelocationsForTextBlock(atom); } else { gop.value_ptr.* = null; } @@ -2481,7 +2488,9 @@ pub fn updateDecl(self: *Elf, module: *Module, decl_index: Module.Decl.Index) !v const atom = &decl.link.elf; try atom.ensureInitialized(self); const gop = try self.decls.getOrPut(self.base.allocator, decl_index); - if (!gop.found_existing) { + if (gop.found_existing) { + self.freeRelocationsForTextBlock(atom); + } else { gop.value_ptr.* = null; } @@ -2500,14 +2509,14 @@ pub fn updateDecl(self: *Elf, module: *Module, decl_index: Module.Decl.Index) !v }, &code_buffer, .{ .dwarf = ds, }, .{ - .parent_atom_index = decl.link.elf.local_sym_index, + .parent_atom_index = decl.link.elf.getSymbolIndex().?, }) else try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ .ty = decl.ty, .val = decl_val, }, &code_buffer, .none, .{ - .parent_atom_index = decl.link.elf.local_sym_index, + .parent_atom_index = decl.link.elf.getSymbolIndex().?, }); const code = switch (res) { @@ -2551,6 +2560,8 @@ pub fn lowerUnnamedConst(self: *Elf, typed_value: TypedValue, decl_index: Module const atom = try self.base.allocator.create(TextBlock); errdefer self.base.allocator.destroy(atom); atom.* = TextBlock.empty; + // TODO for unnamed consts we don't need GOT offset/entry allocated + try atom.ensureInitialized(self); try self.managed_atoms.append(self.base.allocator, atom); const name_str_index = blk: { @@ -2565,14 +2576,10 @@ pub fn lowerUnnamedConst(self: *Elf, typed_value: TypedValue, decl_index: Module }; const name = self.getString(name_str_index); - log.debug("allocating symbol indexes for {s}", .{name}); - atom.local_sym_index = try self.allocateLocalSymbol(); - try self.atom_by_index_table.putNoClobber(self.base.allocator, atom.local_sym_index, atom); - const res = try codegen.generateSymbol(&self.base, decl.srcLoc(), typed_value, &code_buffer, .{ .none = {}, }, .{ - .parent_atom_index = atom.local_sym_index, + .parent_atom_index = atom.getSymbolIndex().?, }); const code = switch (res) { .ok => code_buffer.items, @@ -2592,7 +2599,7 @@ pub fn lowerUnnamedConst(self: *Elf, typed_value: TypedValue, decl_index: Module log.debug("allocated text block for {s} at 0x{x}", .{ name, vaddr }); - const local_sym = &self.local_symbols.items[atom.local_sym_index]; + const local_sym = atom.getSymbolPtr(self); local_sym.* = .{ .st_name = name_str_index, .st_info = (elf.STB_LOCAL << 4) | elf.STT_OBJECT, @@ -2602,14 +2609,14 @@ pub fn lowerUnnamedConst(self: *Elf, typed_value: TypedValue, decl_index: Module .st_size = code.len, }; - try self.writeSymbol(atom.local_sym_index); + try self.writeSymbol(atom.getSymbolIndex().?); try unnamed_consts.append(self.base.allocator, atom); const section_offset = local_sym.st_value - self.program_headers.items[phdr_index].p_vaddr; const file_offset = self.sections.items[shdr_index].sh_offset + section_offset; try self.base.file.?.pwriteAll(code, file_offset); - return atom.local_sym_index; + return atom.getSymbolIndex().?; } pub fn updateDeclExports( diff --git a/src/link/MachO.zig b/src/link/MachO.zig index 8fe5a1c712..543cb473d7 100644 --- a/src/link/MachO.zig +++ b/src/link/MachO.zig @@ -1056,19 +1056,14 @@ pub fn allocateSpecialSymbols(self: *MachO) !void { pub fn createGotAtom(self: *MachO, target: SymbolWithLoc) !*Atom { const gpa = self.base.allocator; - const sym_index = try self.allocateSymbol(); - const atom = blk: { - const atom = try gpa.create(Atom); - atom.* = Atom.empty; - atom.sym_index = sym_index; - atom.size = @sizeOf(u64); - atom.alignment = @alignOf(u64); - break :blk atom; - }; + const atom = try gpa.create(Atom); + atom.* = Atom.empty; + try atom.ensureInitialized(self); + atom.size = @sizeOf(u64); + atom.alignment = @alignOf(u64); errdefer gpa.destroy(atom); try self.managed_atoms.append(gpa, atom); - try self.atom_by_index_table.putNoClobber(gpa, atom.sym_index, atom); const sym = atom.getSymbolPtr(self); sym.n_type = macho.N_SECT; @@ -1109,15 +1104,11 @@ pub fn createDyldPrivateAtom(self: *MachO) !void { const gpa = self.base.allocator; - const sym_index = try self.allocateSymbol(); - const atom = blk: { - const atom = try gpa.create(Atom); - atom.* = Atom.empty; - atom.sym_index = sym_index; - atom.size = @sizeOf(u64); - atom.alignment = @alignOf(u64); - break :blk atom; - }; + const atom = try gpa.create(Atom); + atom.* = Atom.empty; + try atom.ensureInitialized(self); + atom.size = @sizeOf(u64); + atom.alignment = @alignOf(u64); errdefer gpa.destroy(atom); const sym = atom.getSymbolPtr(self); @@ -1126,7 +1117,6 @@ pub fn createDyldPrivateAtom(self: *MachO) !void { self.dyld_private_atom = atom; try self.managed_atoms.append(gpa, atom); - try self.atom_by_index_table.putNoClobber(gpa, sym_index, atom); sym.n_value = try self.allocateAtom(atom, atom.size, @alignOf(u64)); log.debug("allocated dyld_private atom at 0x{x}", .{sym.n_value}); @@ -1144,18 +1134,14 @@ pub fn createStubHelperPreambleAtom(self: *MachO) !void { .aarch64 => 6 * @sizeOf(u32), else => unreachable, }; - const sym_index = try self.allocateSymbol(); - const atom = blk: { - const atom = try gpa.create(Atom); - atom.* = Atom.empty; - atom.sym_index = sym_index; - atom.size = size; - atom.alignment = switch (arch) { - .x86_64 => 1, - .aarch64 => @alignOf(u32), - else => unreachable, - }; - break :blk atom; + const atom = try gpa.create(Atom); + atom.* = Atom.empty; + try atom.ensureInitialized(self); + atom.size = size; + atom.alignment = switch (arch) { + .x86_64 => 1, + .aarch64 => @alignOf(u32), + else => unreachable, }; errdefer gpa.destroy(atom); @@ -1163,7 +1149,7 @@ pub fn createStubHelperPreambleAtom(self: *MachO) !void { sym.n_type = macho.N_SECT; sym.n_sect = self.stub_helper_section_index.? + 1; - const dyld_private_sym_index = self.dyld_private_atom.?.sym_index; + const dyld_private_sym_index = self.dyld_private_atom.?.getSymbolIndex().?; const code = try gpa.alloc(u8, size); defer gpa.free(code); @@ -1258,7 +1244,6 @@ pub fn createStubHelperPreambleAtom(self: *MachO) !void { self.stub_helper_preamble_atom = atom; try self.managed_atoms.append(gpa, atom); - try self.atom_by_index_table.putNoClobber(gpa, sym_index, atom); sym.n_value = try self.allocateAtom(atom, size, atom.alignment); log.debug("allocated stub preamble atom at 0x{x}", .{sym.n_value}); @@ -1273,18 +1258,14 @@ pub fn createStubHelperAtom(self: *MachO) !*Atom { .aarch64 => 3 * @sizeOf(u32), else => unreachable, }; - const sym_index = try self.allocateSymbol(); - const atom = blk: { - const atom = try gpa.create(Atom); - atom.* = Atom.empty; - atom.sym_index = sym_index; - atom.size = size; - atom.alignment = switch (arch) { - .x86_64 => 1, - .aarch64 => @alignOf(u32), - else => unreachable, - }; - break :blk atom; + const atom = try gpa.create(Atom); + atom.* = Atom.empty; + try atom.ensureInitialized(self); + atom.size = size; + atom.alignment = switch (arch) { + .x86_64 => 1, + .aarch64 => @alignOf(u32), + else => unreachable, }; errdefer gpa.destroy(atom); @@ -1306,7 +1287,7 @@ pub fn createStubHelperAtom(self: *MachO) !*Atom { try atom.addRelocation(self, .{ .type = @enumToInt(macho.reloc_type_x86_64.X86_64_RELOC_BRANCH), - .target = .{ .sym_index = self.stub_helper_preamble_atom.?.sym_index, .file = null }, + .target = .{ .sym_index = self.stub_helper_preamble_atom.?.getSymbolIndex().?, .file = null }, .offset = 6, .addend = 0, .pcrel = true, @@ -1329,7 +1310,7 @@ pub fn createStubHelperAtom(self: *MachO) !*Atom { try atom.addRelocation(self, .{ .type = @enumToInt(macho.reloc_type_arm64.ARM64_RELOC_BRANCH26), - .target = .{ .sym_index = self.stub_helper_preamble_atom.?.sym_index, .file = null }, + .target = .{ .sym_index = self.stub_helper_preamble_atom.?.getSymbolIndex().?, .file = null }, .offset = 4, .addend = 0, .pcrel = true, @@ -1340,7 +1321,6 @@ pub fn createStubHelperAtom(self: *MachO) !*Atom { } try self.managed_atoms.append(gpa, atom); - try self.atom_by_index_table.putNoClobber(gpa, sym_index, atom); sym.n_value = try self.allocateAtom(atom, size, atom.alignment); log.debug("allocated stub helper atom at 0x{x}", .{sym.n_value}); @@ -1351,15 +1331,11 @@ pub fn createStubHelperAtom(self: *MachO) !*Atom { pub fn createLazyPointerAtom(self: *MachO, stub_sym_index: u32, target: SymbolWithLoc) !*Atom { const gpa = self.base.allocator; - const sym_index = try self.allocateSymbol(); - const atom = blk: { - const atom = try gpa.create(Atom); - atom.* = Atom.empty; - atom.sym_index = sym_index; - atom.size = @sizeOf(u64); - atom.alignment = @alignOf(u64); - break :blk atom; - }; + const atom = try gpa.create(Atom); + atom.* = Atom.empty; + try atom.ensureInitialized(self); + atom.size = @sizeOf(u64); + atom.alignment = @alignOf(u64); errdefer gpa.destroy(atom); const sym = atom.getSymbolPtr(self); @@ -1385,7 +1361,6 @@ pub fn createLazyPointerAtom(self: *MachO, stub_sym_index: u32, target: SymbolWi }); try self.managed_atoms.append(gpa, atom); - try self.atom_by_index_table.putNoClobber(gpa, sym_index, atom); sym.n_value = try self.allocateAtom(atom, atom.size, @alignOf(u64)); log.debug("allocated lazy pointer atom at 0x{x} ({s})", .{ sym.n_value, self.getSymbolName(target) }); @@ -1402,19 +1377,15 @@ pub fn createStubAtom(self: *MachO, laptr_sym_index: u32) !*Atom { .aarch64 => 3 * @sizeOf(u32), else => unreachable, // unhandled architecture type }; - const sym_index = try self.allocateSymbol(); - const atom = blk: { - const atom = try gpa.create(Atom); - atom.* = Atom.empty; - atom.sym_index = sym_index; - atom.size = size; - atom.alignment = switch (arch) { - .x86_64 => 1, - .aarch64 => @alignOf(u32), - else => unreachable, // unhandled architecture type + const atom = try gpa.create(Atom); + atom.* = Atom.empty; + try atom.ensureInitialized(self); + atom.size = size; + atom.alignment = switch (arch) { + .x86_64 => 1, + .aarch64 => @alignOf(u32), + else => unreachable, // unhandled architecture type - }; - break :blk atom; }; errdefer gpa.destroy(atom); @@ -1476,7 +1447,6 @@ pub fn createStubAtom(self: *MachO, laptr_sym_index: u32) !*Atom { } try self.managed_atoms.append(gpa, atom); - try self.atom_by_index_table.putNoClobber(gpa, sym_index, atom); sym.n_value = try self.allocateAtom(atom, size, atom.alignment); log.debug("allocated stub atom at 0x{x}", .{sym.n_value}); @@ -1617,9 +1587,9 @@ pub fn resolveSymbolsInDylibs(self: *MachO) !void { const stub_index = try self.allocateStubEntry(global); const stub_helper_atom = try self.createStubHelperAtom(); - const laptr_atom = try self.createLazyPointerAtom(stub_helper_atom.sym_index, global); - const stub_atom = try self.createStubAtom(laptr_atom.sym_index); - self.stubs.items[stub_index].sym_index = stub_atom.sym_index; + const laptr_atom = try self.createLazyPointerAtom(stub_helper_atom.getSymbolIndex().?, global); + const stub_atom = try self.createStubAtom(laptr_atom.getSymbolIndex().?); + self.stubs.items[stub_index].sym_index = stub_atom.getSymbolIndex().?; self.markRelocsDirtyByTarget(global); } @@ -1717,7 +1687,7 @@ pub fn resolveDyldStubBinder(self: *MachO) !void { // Add dyld_stub_binder as the final GOT entry. const got_index = try self.allocateGotEntry(global); const got_atom = try self.createGotAtom(global); - self.got_entries.items[got_index].sym_index = got_atom.sym_index; + self.got_entries.items[got_index].sym_index = got_atom.getSymbolIndex().?; try self.writePtrWidthAtom(got_atom); } @@ -2098,14 +2068,11 @@ pub fn lowerUnnamedConst(self: *MachO, typed_value: TypedValue, decl_index: Modu const atom = try gpa.create(Atom); errdefer gpa.destroy(atom); atom.* = Atom.empty; - - atom.sym_index = try self.allocateSymbol(); - + try atom.ensureInitialized(self); try self.managed_atoms.append(gpa, atom); - try self.atom_by_index_table.putNoClobber(gpa, atom.sym_index, atom); const res = try codegen.generateSymbol(&self.base, decl.srcLoc(), typed_value, &code_buffer, .none, .{ - .parent_atom_index = atom.sym_index, + .parent_atom_index = atom.getSymbolIndex().?, }); const code = switch (res) { .ok => code_buffer.items, @@ -2137,7 +2104,7 @@ pub fn lowerUnnamedConst(self: *MachO, typed_value: TypedValue, decl_index: Modu try self.writeAtom(atom, code); - return atom.sym_index; + return atom.getSymbolIndex().?; } pub fn updateDecl(self: *MachO, module: *Module, decl_index: Module.Decl.Index) !void { @@ -2188,14 +2155,14 @@ pub fn updateDecl(self: *MachO, module: *Module, decl_index: Module.Decl.Index) }, &code_buffer, .{ .dwarf = ds, }, .{ - .parent_atom_index = decl.link.macho.sym_index, + .parent_atom_index = decl.link.macho.getSymbolIndex().?, }) else try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ .ty = decl.ty, .val = decl_val, }, &code_buffer, .none, .{ - .parent_atom_index = decl.link.macho.sym_index, + .parent_atom_index = decl.link.macho.getSymbolIndex().?, }); const code = switch (res) { From 3c6c4f88bbedef9579f16f0454998c9dcd7663da Mon Sep 17 00:00:00 2001 From: Takeshi Yoneda Date: Thu, 26 Jan 2023 20:13:07 +0900 Subject: [PATCH 09/84] wasm: uses main instead of main2 for test runner Signed-off-by: Takeshi Yoneda --- lib/test_runner.zig | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lib/test_runner.zig b/lib/test_runner.zig index d1e5683c98..3f57b42bf5 100644 --- a/lib/test_runner.zig +++ b/lib/test_runner.zig @@ -11,7 +11,7 @@ var log_err_count: usize = 0; pub fn main() void { if (builtin.zig_backend != .stage1 and - (builtin.zig_backend != .stage2_llvm or builtin.cpu.arch == .wasm32) and + builtin.zig_backend != .stage2_llvm and builtin.zig_backend != .stage2_c) { return main2() catch @panic("test failure"); From ce20ebb50c216b67b40c80915c9ebd409afa05db Mon Sep 17 00:00:00 2001 From: Takeshi Yoneda Date: Thu, 26 Jan 2023 17:56:41 +0900 Subject: [PATCH 10/84] wasi: remove unnecessary breakpoint() in abort Signed-off-by: Takeshi Yoneda --- lib/std/os.zig | 1 - 1 file changed, 1 deletion(-) diff --git a/lib/std/os.zig b/lib/std/os.zig index b71b17243d..74c7d43dbc 100644 --- a/lib/std/os.zig +++ b/lib/std/os.zig @@ -550,7 +550,6 @@ pub fn abort() noreturn { exit(0); // TODO choose appropriate exit code } if (builtin.os.tag == .wasi) { - @breakpoint(); exit(1); } if (builtin.os.tag == .cuda) { From 97b1a9bb6bcf1b293c3da5e3a3bfd829016c0e85 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Thu, 26 Jan 2023 12:22:39 -0700 Subject: [PATCH 11/84] cmake: no -Werror on the C++ code we copy from llvm --- CMakeLists.txt | 45 +++++++++------------------------------------ 1 file changed, 9 insertions(+), 36 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index 662bd09cdb..8a9de7bdc1 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -654,46 +654,19 @@ include_directories( "${CMAKE_SOURCE_DIR}/src" ) -# These have to go before the -Wno- flags if(MSVC) set(EXE_CXX_FLAGS "/std:c++14") -else(MSVC) - set(EXE_CXX_FLAGS "-std=c++14") -endif(MSVC) - -if("${CMAKE_BUILD_TYPE}" STREQUAL "Debug") - if(MSVC) - set(EXE_CXX_FLAGS "${EXE_CXX_FLAGS} /w") - else() - set(EXE_CXX_FLAGS "${EXE_CXX_FLAGS} -Werror -Wall") - # fallthrough support was added in GCC 7.0 - if(NOT CMAKE_CXX_COMPILER_ID STREQUAL "GNU" OR CMAKE_CXX_COMPILER_VERSION VERSION_GREATER_EQUAL 7.0) - set(EXE_CXX_FLAGS "${EXE_CXX_FLAGS} -Werror=implicit-fallthrough") - endif() - # GCC 9.2 and older are unable to detect valid variable initialization in some cases - if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU" AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS_EQUAL 9.2) - set(EXE_CXX_FLAGS "${EXE_CXX_FLAGS} -Wno-maybe-uninitialized") - endif() - endif() -endif() - -if(MSVC) - set(EXE_CXX_FLAGS "${EXE_CXX_FLAGS}") + set(EXE_LDFLAGS "/STACK:16777216") + if(NOT "${CMAKE_BUILD_TYPE}" STREQUAL "Release" AND NOT "${CMAKE_BUILD_TYPE}" STREQUAL "MinSizeRel") + set(EXE_LDFLAGS "${EXE_LDFLAGS} /debug:fastlink") + endif() else() - set(EXE_CXX_FLAGS "${EXE_CXX_FLAGS} -D__STDC_CONSTANT_MACROS -D__STDC_FORMAT_MACROS -D__STDC_LIMIT_MACROS -D_GNU_SOURCE -fvisibility-inlines-hidden -fno-exceptions -fno-rtti -Werror=type-limits -Wno-missing-braces -Wno-comment") - if(MINGW) - set(EXE_CXX_FLAGS "${EXE_CXX_FLAGS} -Wno-format") - endif() -endif() - -set(EXE_LDFLAGS " ") -if(MSVC) - set(EXE_LDFLAGS "${EXE_LDFLAGS} /STACK:16777216") - if(NOT "${CMAKE_BUILD_TYPE}" STREQUAL "Release" AND NOT "${CMAKE_BUILD_TYPE}" STREQUAL "MinSizeRel") - set(EXE_LDFLAGS "${EXE_LDFLAGS} /debug:fastlink") - endif() -elseif(MINGW) + set(EXE_CXX_FLAGS "-std=c++14 -D__STDC_CONSTANT_MACROS -D__STDC_FORMAT_MACROS -D__STDC_LIMIT_MACROS -D_GNU_SOURCE -fvisibility-inlines-hidden -fno-exceptions -fno-rtti -Werror=type-limits -Wno-missing-braces -Wno-comment") + set(EXE_LDFLAGS " ") + if(MINGW) + set(EXE_CXX_FLAGS "${EXE_CXX_FLAGS} -Wno-format") set(EXE_LDFLAGS "${EXE_LDFLAGS} -Wl,--stack,16777216") + endif() endif() if(ZIG_STATIC) From b25efb86e1b1b2a9e8aa269bf83b717d54f7e276 Mon Sep 17 00:00:00 2001 From: Luuk de Gram Date: Fri, 27 Jan 2023 19:24:15 +0100 Subject: [PATCH 12/84] wasm: migrate to new non-allocateDeclIndexes API --- src/Module.zig | 1 + src/arch/wasm/CodeGen.zig | 13 ++++++-- src/link.zig | 2 +- src/link/Wasm.zig | 70 +++++++++++++++++---------------------- src/link/Wasm/Atom.zig | 11 ++++++ 5 files changed, 53 insertions(+), 44 deletions(-) diff --git a/src/Module.zig b/src/Module.zig index 360dd4d1ec..713680c5fa 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -5328,6 +5328,7 @@ pub fn deleteUnusedDecl(mod: *Module, decl_index: Decl.Index) void { .elf, .macho, .c, + .wasm, => {}, // this linker backend has already migrated to the new API else => if (decl.has_tv) { diff --git a/src/arch/wasm/CodeGen.zig b/src/arch/wasm/CodeGen.zig index a7d90a8bf9..342d6b70cc 100644 --- a/src/arch/wasm/CodeGen.zig +++ b/src/arch/wasm/CodeGen.zig @@ -2120,22 +2120,28 @@ fn airCall(func: *CodeGen, inst: Air.Inst.Index, modifier: std.builtin.CallModif const module = func.bin_file.base.options.module.?; if (func_val.castTag(.function)) |function| { - break :blk module.declPtr(function.data.owner_decl); + const decl = module.declPtr(function.data.owner_decl); + try decl.link.wasm.ensureInitialized(func.bin_file); + break :blk decl; } else if (func_val.castTag(.extern_fn)) |extern_fn| { const ext_decl = module.declPtr(extern_fn.data.owner_decl); const ext_info = ext_decl.ty.fnInfo(); var func_type = try genFunctype(func.gpa, ext_info.cc, ext_info.param_types, ext_info.return_type, func.target); defer func_type.deinit(func.gpa); + const atom = &ext_decl.link.wasm; + try atom.ensureInitialized(func.bin_file); ext_decl.fn_link.wasm.type_index = try func.bin_file.putOrGetFuncType(func_type); try func.bin_file.addOrUpdateImport( mem.sliceTo(ext_decl.name, 0), - ext_decl.link.wasm.sym_index, + atom.getSymbolIndex().?, ext_decl.getExternFn().?.lib_name, ext_decl.fn_link.wasm.type_index, ); break :blk ext_decl; } else if (func_val.castTag(.decl_ref)) |decl_ref| { - break :blk module.declPtr(decl_ref.data); + const decl = module.declPtr(decl_ref.data); + try decl.link.wasm.ensureInitialized(func.bin_file); + break :blk decl; } return func.fail("Expected a function, but instead found type '{}'", .{func_val.tag()}); }; @@ -2752,6 +2758,7 @@ fn lowerDeclRefValue(func: *CodeGen, tv: TypedValue, decl_index: Module.Decl.Ind } module.markDeclAlive(decl); + try decl.link.wasm.ensureInitialized(func.bin_file); const target_sym_index = decl.link.wasm.sym_index; if (decl.ty.zigTypeTag() == .Fn) { diff --git a/src/link.zig b/src/link.zig index 9be5b9ca3a..f9081499a8 100644 --- a/src/link.zig +++ b/src/link.zig @@ -615,7 +615,6 @@ pub const File = struct { return; } switch (base.tag) { - .wasm => return @fieldParentPtr(Wasm, "base", base).allocateDeclIndexes(decl_index), .plan9 => return @fieldParentPtr(Plan9, "base", base).allocateDeclIndexes(decl_index), .coff, @@ -624,6 +623,7 @@ pub const File = struct { .c, .spirv, .nvptx, + .wasm, => {}, } } diff --git a/src/link/Wasm.zig b/src/link/Wasm.zig index 7129722d16..31dfb87659 100644 --- a/src/link/Wasm.zig +++ b/src/link/Wasm.zig @@ -986,31 +986,23 @@ pub fn deinit(wasm: *Wasm) void { } } -pub fn allocateDeclIndexes(wasm: *Wasm, decl_index: Module.Decl.Index) !void { - if (wasm.llvm_object) |_| return; - const decl = wasm.base.options.module.?.declPtr(decl_index); - if (decl.link.wasm.sym_index != 0) return; - +/// Allocates a new symbol and returns its index. +/// Will re-use slots when a symbol was freed at an earlier stage. +pub fn allocateSymbol(wasm: *Wasm) !u32 { try wasm.symbols.ensureUnusedCapacity(wasm.base.allocator, 1); - try wasm.decls.putNoClobber(wasm.base.allocator, decl_index, {}); - - const atom = &decl.link.wasm; - var symbol: Symbol = .{ .name = undefined, // will be set after updateDecl .flags = @enumToInt(Symbol.Flag.WASM_SYM_BINDING_LOCAL), .tag = undefined, // will be set after updateDecl .index = undefined, // will be set after updateDecl }; - if (wasm.symbols_free_list.popOrNull()) |index| { - atom.sym_index = index; wasm.symbols.items[index] = symbol; - } else { - atom.sym_index = @intCast(u32, wasm.symbols.items.len); - wasm.symbols.appendAssumeCapacity(symbol); + return index; } - try wasm.symbol_atom.putNoClobber(wasm.base.allocator, atom.symbolLoc(), atom); + const index = @intCast(u32, wasm.symbols.items.len); + wasm.symbols.appendAssumeCapacity(symbol); + return index; } pub fn updateFunc(wasm: *Wasm, mod: *Module, func: *Module.Fn, air: Air, liveness: Liveness) !void { @@ -1026,9 +1018,12 @@ pub fn updateFunc(wasm: *Wasm, mod: *Module, func: *Module.Fn, air: Air, livenes const decl_index = func.owner_decl; const decl = mod.declPtr(decl_index); - assert(decl.link.wasm.sym_index != 0); // Must call allocateDeclIndexes() - - decl.link.wasm.clear(); + const atom = &decl.link.wasm; + try atom.ensureInitialized(wasm); + const gop = try wasm.decls.getOrPut(wasm.base.allocator, decl_index); + if (gop.found_existing) { + atom.clear(); + } else gop.value_ptr.* = {}; var decl_state: ?Dwarf.DeclState = if (wasm.dwarf) |*dwarf| try dwarf.initDeclState(mod, decl_index) else null; defer if (decl_state) |*ds| ds.deinit(); @@ -1083,16 +1078,19 @@ pub fn updateDecl(wasm: *Wasm, mod: *Module, decl_index: Module.Decl.Index) !voi defer tracy.end(); const decl = mod.declPtr(decl_index); - assert(decl.link.wasm.sym_index != 0); // Must call allocateDeclIndexes() - - decl.link.wasm.clear(); - if (decl.val.castTag(.function)) |_| { return; } else if (decl.val.castTag(.extern_fn)) |_| { return; } + const atom = &decl.link.wasm; + try atom.ensureInitialized(wasm); + const gop = try wasm.decls.getOrPut(wasm.base.allocator, decl_index); + if (gop.found_existing) { + atom.clear(); + } else gop.value_ptr.* = {}; + if (decl.isExtern()) { const variable = decl.getVariable().?; const name = mem.sliceTo(decl.name, 0); @@ -1148,8 +1146,8 @@ fn finishUpdateDecl(wasm: *Wasm, decl: *Module.Decl, code: []const u8) !void { try atom.code.appendSlice(wasm.base.allocator, code); try wasm.resolved_symbols.put(wasm.base.allocator, atom.symbolLoc(), {}); - if (code.len == 0) return; atom.size = @intCast(u32, code.len); + if (code.len == 0) return; atom.alignment = decl.ty.abiAlignment(wasm.base.options.target); } @@ -1211,28 +1209,19 @@ pub fn lowerUnnamedConst(wasm: *Wasm, tv: TypedValue, decl_index: Module.Decl.In defer wasm.base.allocator.free(fqdn); const name = try std.fmt.allocPrintZ(wasm.base.allocator, "__unnamed_{s}_{d}", .{ fqdn, local_index }); defer wasm.base.allocator.free(name); - var symbol: Symbol = .{ - .name = try wasm.string_table.put(wasm.base.allocator, name), - .flags = 0, - .tag = .data, - .index = undefined, - }; - symbol.setFlag(.WASM_SYM_BINDING_LOCAL); const atom = try decl.link.wasm.locals.addOne(wasm.base.allocator); atom.* = Atom.empty; + try atom.ensureInitialized(wasm); atom.alignment = tv.ty.abiAlignment(wasm.base.options.target); - try wasm.symbols.ensureUnusedCapacity(wasm.base.allocator, 1); + wasm.symbols.items[atom.sym_index] = .{ + .name = try wasm.string_table.put(wasm.base.allocator, name), + .flags = @enumToInt(Symbol.Flag.WASM_SYM_BINDING_LOCAL), + .tag = .data, + .index = undefined, + }; - if (wasm.symbols_free_list.popOrNull()) |index| { - atom.sym_index = index; - wasm.symbols.items[index] = symbol; - } else { - atom.sym_index = @intCast(u32, wasm.symbols.items.len); - wasm.symbols.appendAssumeCapacity(symbol); - } try wasm.resolved_symbols.putNoClobber(wasm.base.allocator, atom.symbolLoc(), {}); - try wasm.symbol_atom.putNoClobber(wasm.base.allocator, atom.symbolLoc(), atom); var value_bytes = std.ArrayList(u8).init(wasm.base.allocator); defer value_bytes.deinit(); @@ -1304,8 +1293,8 @@ pub fn getDeclVAddr( ) !u64 { const mod = wasm.base.options.module.?; const decl = mod.declPtr(decl_index); + try decl.link.wasm.ensureInitialized(wasm); const target_symbol_index = decl.link.wasm.sym_index; - assert(target_symbol_index != 0); assert(reloc_info.parent_atom_index != 0); const atom = wasm.symbol_atom.get(.{ .file = null, .index = reloc_info.parent_atom_index }).?; const is_wasm32 = wasm.base.options.target.cpu.arch == .wasm32; @@ -1363,6 +1352,7 @@ pub fn updateDeclExports( } const decl = mod.declPtr(decl_index); + if (decl.link.wasm.getSymbolIndex() == null) return; // unititialized for (exports) |exp| { if (exp.options.section) |section| { diff --git a/src/link/Wasm/Atom.zig b/src/link/Wasm/Atom.zig index de9cefebdc..20f847e475 100644 --- a/src/link/Wasm/Atom.zig +++ b/src/link/Wasm/Atom.zig @@ -95,6 +95,17 @@ pub fn symbolLoc(atom: Atom) Wasm.SymbolLoc { return .{ .file = atom.file, .index = atom.sym_index }; } +pub fn ensureInitialized(atom: *Atom, wasm_bin: *Wasm) !void { + if (atom.getSymbolIndex() != null) return; // already initialized + atom.sym_index = try wasm_bin.allocateSymbol(); + try wasm_bin.symbol_atom.putNoClobber(wasm_bin.base.allocator, atom.symbolLoc(), atom); +} + +pub fn getSymbolIndex(atom: Atom) ?u32 { + if (atom.sym_index == 0) return null; + return atom.sym_index; +} + /// Returns the virtual address of the `Atom`. This is the address starting /// from the first entry within a section. pub fn getVA(atom: Atom, wasm: *const Wasm, symbol: *const Symbol) u32 { From a8987291390d80ad9e2bb45ba225313a108eed0b Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Fri, 27 Jan 2023 19:51:06 +0100 Subject: [PATCH 13/84] self-hosted: remove allocateDeclIndexes from the public link.File API --- src/Module.zig | 26 -------------------------- src/Sema.zig | 1 - src/link.zig | 35 +++-------------------------------- src/link/Plan9.zig | 9 ++------- 4 files changed, 5 insertions(+), 66 deletions(-) diff --git a/src/Module.zig b/src/Module.zig index 713680c5fa..dcdbeec322 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -4585,7 +4585,6 @@ fn semaDecl(mod: *Module, decl_index: Decl.Index) !bool { // We don't fully codegen the decl until later, but we do need to reserve a global // offset table index for it. This allows us to codegen decls out of dependency // order, increasing how many computations can be done in parallel. - try mod.comp.bin_file.allocateDeclIndexes(decl_index); try mod.comp.work_queue.writeItem(.{ .codegen_func = func }); if (type_changed and mod.emit_h != null) { try mod.comp.work_queue.writeItem(.{ .emit_h_decl = decl_index }); @@ -4697,7 +4696,6 @@ fn semaDecl(mod: *Module, decl_index: Decl.Index) !bool { // codegen backend wants full access to the Decl Type. try sema.resolveTypeFully(decl.ty); - try mod.comp.bin_file.allocateDeclIndexes(decl_index); try mod.comp.work_queue.writeItem(.{ .codegen_decl = decl_index }); if (type_changed and mod.emit_h != null) { @@ -5315,29 +5313,6 @@ pub fn deleteUnusedDecl(mod: *Module, decl_index: Decl.Index) void { const decl = mod.declPtr(decl_index); log.debug("deleteUnusedDecl {d} ({s})", .{ decl_index, decl.name }); - // TODO: remove `allocateDeclIndexes` and make the API that the linker backends - // are required to notice the first time `updateDecl` happens and keep track - // of it themselves. However they can rely on getting a `freeDecl` call if any - // `updateDecl` or `updateFunc` calls happen. This will allow us to avoid any call - // into the linker backend here, since the linker backend will never have been told - // about the Decl in the first place. - // Until then, we did call `allocateDeclIndexes` on this anonymous Decl and so we - // must call `freeDecl` in the linker backend now. - switch (mod.comp.bin_file.tag) { - .coff, - .elf, - .macho, - .c, - .wasm, - => {}, // this linker backend has already migrated to the new API - - else => if (decl.has_tv) { - if (decl.ty.isFnOrHasRuntimeBits()) { - mod.comp.bin_file.freeDecl(decl_index); - } - }, - } - assert(!mod.declIsRoot(decl_index)); assert(decl.src_namespace.anon_decls.swapRemove(decl_index)); @@ -5822,7 +5797,6 @@ pub fn initNewAnonDecl( // the Decl will be garbage collected by the `codegen_decl` task instead of sent // to the linker. if (typed_value.ty.isFnOrHasRuntimeBits()) { - try mod.comp.bin_file.allocateDeclIndexes(new_decl_index); try mod.comp.anon_work_queue.writeItem(.{ .codegen_decl = new_decl_index }); } } diff --git a/src/Sema.zig b/src/Sema.zig index 2e57de2406..9c553a0092 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -7510,7 +7510,6 @@ fn resolveGenericInstantiationType( // Queue up a `codegen_func` work item for the new Fn. The `comptime_args` field // will be populated, ensuring it will have `analyzeBody` called with the ZIR // parameters mapped appropriately. - try mod.comp.bin_file.allocateDeclIndexes(new_decl_index); try mod.comp.work_queue.writeItem(.{ .codegen_func = new_func }); return new_func; } diff --git a/src/link.zig b/src/link.zig index f9081499a8..668c5b72e3 100644 --- a/src/link.zig +++ b/src/link.zig @@ -533,8 +533,7 @@ pub const File = struct { } } - /// May be called before or after updateDeclExports but must be called - /// after allocateDeclIndexes for any given Decl. + /// May be called before or after updateDeclExports for any given Decl. pub fn updateDecl(base: *File, module: *Module, decl_index: Module.Decl.Index) UpdateDeclError!void { const decl = module.declPtr(decl_index); log.debug("updateDecl {*} ({s}), type={}", .{ decl, decl.name, decl.ty.fmtDebug() }); @@ -557,8 +556,7 @@ pub const File = struct { } } - /// May be called before or after updateDeclExports but must be called - /// after allocateDeclIndexes for any given Decl. + /// May be called before or after updateDeclExports for any given Decl. pub fn updateFunc(base: *File, module: *Module, func: *Module.Fn, air: Air, liveness: Liveness) UpdateDeclError!void { const owner_decl = module.declPtr(func.owner_decl); log.debug("updateFunc {*} ({s}), type={}", .{ @@ -602,32 +600,6 @@ pub const File = struct { } } - /// Must be called before any call to updateDecl or updateDeclExports for - /// any given Decl. - /// TODO we're transitioning to deleting this function and instead having - /// each linker backend notice the first time updateDecl or updateFunc is called, or - /// a callee referenced from AIR. - pub fn allocateDeclIndexes(base: *File, decl_index: Module.Decl.Index) error{OutOfMemory}!void { - const decl = base.options.module.?.declPtr(decl_index); - log.debug("allocateDeclIndexes {*} ({s})", .{ decl, decl.name }); - if (build_options.only_c) { - assert(base.tag == .c); - return; - } - switch (base.tag) { - .plan9 => return @fieldParentPtr(Plan9, "base", base).allocateDeclIndexes(decl_index), - - .coff, - .elf, - .macho, - .c, - .spirv, - .nvptx, - .wasm, - => {}, - } - } - pub fn releaseLock(self: *File) void { if (self.lock) |*lock| { lock.release(); @@ -878,8 +850,7 @@ pub const File = struct { AnalysisFail, }; - /// May be called before or after updateDecl, but must be called after - /// allocateDeclIndexes for any given Decl. + /// May be called before or after updateDecl for any given Decl. pub fn updateDeclExports( base: *File, module: *Module, diff --git a/src/link/Plan9.zig b/src/link/Plan9.zig index e412c78f7f..a8b8caafab 100644 --- a/src/link/Plan9.zig +++ b/src/link/Plan9.zig @@ -424,7 +424,7 @@ fn updateFinish(self: *Plan9, decl: *Module.Decl) !void { // write the internal linker metadata decl.link.plan9.type = sym_t; // write the symbol - // we already have the got index because that got allocated in allocateDeclIndexes + // we already have the got index const sym: aout.Sym = .{ .value = undefined, // the value of stuff gets filled in in flushModule .type = decl.link.plan9.type, @@ -737,7 +737,7 @@ fn addDeclExports( pub fn freeDecl(self: *Plan9, decl_index: Module.Decl.Index) void { // TODO audit the lifetimes of decls table entries. It's possible to get - // allocateDeclIndexes and then freeDecl without any updateDecl in between. + // freeDecl without any updateDecl in between. // However that is planned to change, see the TODO comment in Module.zig // in the deleteUnusedDecl function. const mod = self.base.options.module.?; @@ -959,11 +959,6 @@ pub fn writeSyms(self: *Plan9, buf: *std.ArrayList(u8)) !void { } } -/// this will be removed, moved to updateFinish -pub fn allocateDeclIndexes(self: *Plan9, decl_index: Module.Decl.Index) !void { - _ = self; - _ = decl_index; -} /// Must be called only after a successful call to `updateDecl`. pub fn updateDeclLineNumber(self: *Plan9, mod: *Module, decl: *const Module.Decl) !void { _ = self; From f68d3c63df0486c7039732ef442c87fcd7c6fc57 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Fri, 27 Jan 2023 14:53:17 -0700 Subject: [PATCH 14/84] CI: give x86_64-linux-release a little more time When the CPU cores are pegged, the thermal throttling kicks in and makes jobs take significantly longer. --- .github/workflows/ci.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml index 8f0bcb7b96..6bb0ce4a1b 100644 --- a/.github/workflows/ci.yaml +++ b/.github/workflows/ci.yaml @@ -18,6 +18,7 @@ jobs: - name: Build and Test run: sh ci/x86_64-linux-debug.sh x86_64-linux-release: + timeout-minutes: 420 runs-on: [self-hosted, Linux, x86_64] steps: - name: Checkout From 4c116841840bfa7f0068bef23984dd832da8a54d Mon Sep 17 00:00:00 2001 From: Jon-Eric Cook Date: Sat, 28 Jan 2023 08:26:36 -0800 Subject: [PATCH 15/84] std.json: check output and source lengths in `std.json` --- lib/std/json.zig | 3 ++- lib/std/json/test.zig | 6 ++++++ 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/lib/std/json.zig b/lib/std/json.zig index f16d70da80..92afeead90 100644 --- a/lib/std/json.zig +++ b/lib/std/json.zig @@ -1384,7 +1384,7 @@ fn ParseInternalErrorImpl(comptime T: type, comptime inferred_types: []const typ return errors; }, .Array => |arrayInfo| { - return error{ UnexpectedEndOfJson, UnexpectedToken } || TokenStream.Error || + return error{ UnexpectedEndOfJson, UnexpectedToken, LengthMismatch } || TokenStream.Error || UnescapeValidStringError || ParseInternalErrorImpl(arrayInfo.child, inferred_types ++ [_]type{T}); }, @@ -1625,6 +1625,7 @@ fn parseInternal( if (arrayInfo.child != u8) return error.UnexpectedToken; var r: T = undefined; const source_slice = stringToken.slice(tokens.slice, tokens.i - 1); + if (r.len != stringToken.decodedLength()) return error.LengthMismatch; switch (stringToken.escapes) { .None => mem.copy(u8, &r, source_slice), .Some => try unescapeValidString(&r, source_slice), diff --git a/lib/std/json/test.zig b/lib/std/json/test.zig index 2a590fdf15..0bf0797587 100644 --- a/lib/std/json/test.zig +++ b/lib/std/json/test.zig @@ -2238,6 +2238,12 @@ test "parse into struct with no fields" { try testing.expectEqual(T{}, try parse(T, &ts, ParseOptions{})); } +test "parse into struct where destination and source lengths mismatch" { + const T = struct { a: [2]u8 }; + var ts = TokenStream.init("{\"a\": \"bbb\"}"); + try testing.expectError(error.LengthMismatch, parse(T, &ts, ParseOptions{})); +} + test "parse into struct with misc fields" { @setEvalBranchQuota(10000); const options = ParseOptions{ .allocator = testing.allocator }; From 2b27bc2c65195a82e96995669314a86c76203a3e Mon Sep 17 00:00:00 2001 From: zigster64 Date: Tue, 22 Nov 2022 13:54:33 +1000 Subject: [PATCH 16/84] On BrokenPipe error during os.sendfile - return error rather than unreachable --- lib/std/os.zig | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/lib/std/os.zig b/lib/std/os.zig index 74c7d43dbc..32463aa30e 100644 --- a/lib/std/os.zig +++ b/lib/std/os.zig @@ -6028,7 +6028,7 @@ pub fn sendfile( .BADF => unreachable, // Always a race condition. .FAULT => unreachable, // Segmentation fault. .OVERFLOW => unreachable, // We avoid passing too large of a `count`. - .NOTCONN => unreachable, // `out_fd` is an unconnected socket. + .NOTCONN => return error.BrokenPipe, // `out_fd` is an unconnected socket .INVAL, .NOSYS => { // EINVAL could be any of the following situations: @@ -6096,7 +6096,7 @@ pub fn sendfile( .BADF => unreachable, // Always a race condition. .FAULT => unreachable, // Segmentation fault. - .NOTCONN => unreachable, // `out_fd` is an unconnected socket. + .NOTCONN => return error.BrokenPipe, // `out_fd` is an unconnected socket .INVAL, .OPNOTSUPP, .NOTSOCK, .NOSYS => { // EINVAL could be any of the following situations: @@ -6178,7 +6178,7 @@ pub fn sendfile( .BADF => unreachable, // Always a race condition. .FAULT => unreachable, // Segmentation fault. .INVAL => unreachable, - .NOTCONN => unreachable, // `out_fd` is an unconnected socket. + .NOTCONN => return error.BrokenPipe, // `out_fd` is an unconnected socket .OPNOTSUPP, .NOTSOCK, .NOSYS => break :sf, @@ -6472,7 +6472,7 @@ pub fn recvfrom( .BADF => unreachable, // always a race condition .FAULT => unreachable, .INVAL => unreachable, - .NOTCONN => unreachable, + .NOTCONN => return error.SocketNotConnected, .NOTSOCK => unreachable, .INTR => continue, .AGAIN => return error.WouldBlock, From 599b3ef9e947f044799d11aecf0dfe659f9a7728 Mon Sep 17 00:00:00 2001 From: Michael Dusan Date: Fri, 27 Jan 2023 13:27:41 -0500 Subject: [PATCH 17/84] netbsd: use versioned __msync13 from libc The system linker shows warning when `msync` is linked instead of `__msync13`: "warning: reference to compatibility msync(); include for correct reference" closes #14422 --- lib/std/c.zig | 3 ++- lib/std/c/netbsd.zig | 3 +++ 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/lib/std/c.zig b/lib/std/c.zig index de3ebe15a8..57d5beae56 100644 --- a/lib/std/c.zig +++ b/lib/std/c.zig @@ -90,6 +90,8 @@ pub usingnamespace switch (builtin.os.tag) { pub extern "c" fn stat(noalias path: [*:0]const u8, noalias buf: *c.Stat) c_int; pub extern "c" fn alarm(seconds: c_uint) c_uint; + + pub extern "c" fn msync(addr: *align(page_size) const anyopaque, len: usize, flags: c_int) c_int; }, }; @@ -145,7 +147,6 @@ pub extern "c" fn write(fd: c.fd_t, buf: [*]const u8, nbyte: usize) isize; pub extern "c" fn pwrite(fd: c.fd_t, buf: [*]const u8, nbyte: usize, offset: c.off_t) isize; pub extern "c" fn mmap(addr: ?*align(page_size) anyopaque, len: usize, prot: c_uint, flags: c_uint, fd: c.fd_t, offset: c.off_t) *anyopaque; pub extern "c" fn munmap(addr: *align(page_size) const anyopaque, len: usize) c_int; -pub extern "c" fn msync(addr: *align(page_size) const anyopaque, len: usize, flags: c_int) c_int; pub extern "c" fn mprotect(addr: *align(page_size) anyopaque, len: usize, prot: c_uint) c_int; pub extern "c" fn link(oldpath: [*:0]const u8, newpath: [*:0]const u8, flags: c_int) c_int; pub extern "c" fn linkat(oldfd: c.fd_t, oldpath: [*:0]const u8, newfd: c.fd_t, newpath: [*:0]const u8, flags: c_int) c_int; diff --git a/lib/std/c/netbsd.zig b/lib/std/c/netbsd.zig index bcd0291bb2..579e25d416 100644 --- a/lib/std/c/netbsd.zig +++ b/lib/std/c/netbsd.zig @@ -59,6 +59,9 @@ pub const sched_yield = __libc_thr_yield; pub extern "c" fn posix_memalign(memptr: *?*anyopaque, alignment: usize, size: usize) c_int; +pub extern "c" fn __msync13(addr: *align(std.mem.page_size) const anyopaque, len: usize, flags: c_int) c_int; +pub const msync = __msync13; + pub const pthread_mutex_t = extern struct { magic: u32 = 0x33330003, errorcheck: padded_pthread_spin_t = 0, From 76fcb95bdf5509f6b02ca8c68af2b8f630a6cfe0 Mon Sep 17 00:00:00 2001 From: Krzysztof Wolicki Der Teufel Date: Sun, 29 Jan 2023 14:42:18 +0100 Subject: [PATCH 18/84] autodoc: Implemented struct_init_empty for walkInstruction, fixed variable type with has_init but no type before = --- src/Autodoc.zig | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-) diff --git a/src/Autodoc.zig b/src/Autodoc.zig index 8afc9c859b..e51d4a3ca9 100644 --- a/src/Autodoc.zig +++ b/src/Autodoc.zig @@ -2200,17 +2200,10 @@ fn walkInstruction( false, ); - _ = operand; - - // WIP - - printWithContext( - file, - inst_index, - "TODO: implement `{s}` for walkInstruction\n\n", - .{@tagName(tags[inst_index])}, - ); - return self.cteTodo(@tagName(tags[inst_index])); + return DocData.WalkResult{ + .typeRef = operand.expr, + .expr = .{ .@"struct" = &.{} }, + }; }, .struct_init_anon => { const pl_node = data[inst_index].pl_node; @@ -2537,6 +2530,7 @@ fn walkInstruction( const var_init_ref = @intToEnum(Ref, file.zir.extra[extra_index]); const var_init = try self.walkRef(file, parent_scope, parent_src, var_init_ref, need_type); value.expr = var_init.expr; + value.typeRef = var_init.typeRef; } return value; From 090186a0c26447d99417dad9f1ba8bde49579191 Mon Sep 17 00:00:00 2001 From: joachimschmidt557 Date: Mon, 23 Jan 2023 21:08:43 +0100 Subject: [PATCH 19/84] stage2 AArch64: move copy-register-arg-to-stack code to fn prologue This enhances the debugging experience as upon encountering a breakpoint in a function, all arguments passed as registers have already been moved to the stack, ready to be inspected by the debugger. --- src/arch/aarch64/CodeGen.zig | 57 +++++++++++++++++------------------- 1 file changed, 27 insertions(+), 30 deletions(-) diff --git a/src/arch/aarch64/CodeGen.zig b/src/arch/aarch64/CodeGen.zig index 200bf3b8e0..0efd34937a 100644 --- a/src/arch/aarch64/CodeGen.zig +++ b/src/arch/aarch64/CodeGen.zig @@ -181,6 +181,7 @@ const DbgInfoReloc = struct { else => unreachable, } } + fn genArgDbgInfo(reloc: DbgInfoReloc, function: Self) error{OutOfMemory}!void { switch (function.debug_output) { .dwarf => |dw| { @@ -527,6 +528,28 @@ fn gen(self: *Self) !void { self.ret_mcv = MCValue{ .stack_offset = stack_offset }; } + for (self.args) |*arg, arg_index| { + // Copy register arguments to the stack + switch (arg.*) { + .register => |reg| { + // The first AIR instructions of the main body are guaranteed + // to be the functions arguments + const inst = self.air.getMainBody()[arg_index]; + assert(self.air.instructions.items(.tag)[inst] == .arg); + + const ty = self.air.typeOfIndex(inst); + + const abi_size = @intCast(u32, ty.abiSize(self.target.*)); + const abi_align = ty.abiAlignment(self.target.*); + const stack_offset = try self.allocMem(abi_size, abi_align, inst); + try self.genSetStack(ty, stack_offset, MCValue{ .register = reg }); + + arg.* = MCValue{ .stack_offset = stack_offset }; + }, + else => {}, + } + } + _ = try self.addInst(.{ .tag = .dbg_prologue_end, .data = .{ .nop = {} }, @@ -4163,45 +4186,19 @@ fn airArg(self: *Self, inst: Air.Inst.Index) !void { self.arg_index += 1; const ty = self.air.typeOfIndex(inst); - const result = self.args[arg_index]; + const tag = self.air.instructions.items(.tag)[inst]; const src_index = self.air.instructions.items(.data)[inst].arg.src_index; const name = self.mod_fn.getParamName(self.bin_file.options.module.?, src_index); - const mcv = switch (result) { - // Copy registers to the stack - .register => |reg| blk: { - const mod = self.bin_file.options.module.?; - const abi_size = math.cast(u32, ty.abiSize(self.target.*)) orelse { - return self.fail("type '{}' too big to fit into stack frame", .{ty.fmt(mod)}); - }; - const abi_align = ty.abiAlignment(self.target.*); - const stack_offset = try self.allocMem(abi_size, abi_align, inst); - try self.genSetStack(ty, stack_offset, MCValue{ .register = reg }); - - break :blk MCValue{ .stack_offset = stack_offset }; - }, - else => result, - }; - - const tag = self.air.instructions.items(.tag)[inst]; try self.dbg_info_relocs.append(self.gpa, .{ .tag = tag, .ty = ty, .name = name, - .mcv = result, + .mcv = self.args[arg_index], }); - if (self.liveness.isUnused(inst)) - return self.finishAirBookkeeping(); - - switch (mcv) { - .register => |reg| { - self.register_manager.getRegAssumeFree(reg, inst); - }, - else => {}, - } - - return self.finishAir(inst, mcv, .{ .none, .none, .none }); + const result: MCValue = if (self.liveness.isUnused(inst)) .dead else self.args[arg_index]; + return self.finishAir(inst, result, .{ .none, .none, .none }); } fn airBreakpoint(self: *Self) !void { From 317d57115dc11100022f55c1bdf432b68924b4d8 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Sun, 29 Jan 2023 12:48:38 -0700 Subject: [PATCH 20/84] std.debug: disable sporadically failing test see tracking issue #13963 --- lib/std/debug.zig | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/lib/std/debug.zig b/lib/std/debug.zig index d8c327829a..3708c4fe81 100644 --- a/lib/std/debug.zig +++ b/lib/std/debug.zig @@ -2060,6 +2060,11 @@ pub fn dumpStackPointerAddr(prefix: []const u8) void { test "manage resources correctly" { if (builtin.os.tag == .wasi) return error.SkipZigTest; + if (builtin.os.tag == .windows and builtin.cpu.arch == .x86_64) { + // https://github.com/ziglang/zig/issues/13963 + return error.SkipZigTest; + } + const writer = std.io.null_writer; var di = try openSelfDebugInfo(testing.allocator); defer di.deinit(); From fcb05ee2e70ab76c21211ecc2581d5d4ae5917b1 Mon Sep 17 00:00:00 2001 From: kcbanner Date: Sat, 28 Jan 2023 02:06:14 -0500 Subject: [PATCH 21/84] cbe: don't emit unused undefined array literals --- src/codegen/c.zig | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/src/codegen/c.zig b/src/codegen/c.zig index 68c20ea49c..70c62a1faa 100644 --- a/src/codegen/c.zig +++ b/src/codegen/c.zig @@ -3726,16 +3726,15 @@ fn airStore(f: *Function, inst: Air.Inst.Index) !CValue { const ptr_val = try f.resolveInst(bin_op.lhs); const src_ty = f.air.typeOf(bin_op.rhs); - const src_val = try f.resolveInst(bin_op.rhs); - - try reap(f, inst, &.{ bin_op.lhs, bin_op.rhs }); // TODO Sema should emit a different instruction when the store should // possibly do the safety 0xaa bytes for undefined. const src_val_is_undefined = if (f.air.value(bin_op.rhs)) |v| v.isUndefDeep() else false; - if (src_val_is_undefined) + if (src_val_is_undefined) { + try reap(f, inst, &.{ bin_op.lhs, bin_op.rhs }); return try storeUndefined(f, ptr_info.pointee_type, ptr_val); + } const target = f.object.dg.module.getTarget(); const is_aligned = ptr_info.@"align" == 0 or @@ -3744,6 +3743,9 @@ fn airStore(f: *Function, inst: Air.Inst.Index) !CValue { const need_memcpy = !is_aligned or is_array; const writer = f.object.writer(); + const src_val = try f.resolveInst(bin_op.rhs); + try reap(f, inst, &.{ bin_op.lhs, bin_op.rhs }); + if (need_memcpy) { // For this memcpy to safely work we need the rhs to have the same // underlying type as the lhs (i.e. they must both be arrays of the same underlying type). @@ -4344,8 +4346,9 @@ fn airDbgInline(f: *Function, inst: Air.Inst.Index) !CValue { fn airDbgVar(f: *Function, inst: Air.Inst.Index) !CValue { const pl_op = f.air.instructions.items(.data)[inst].pl_op; const name = f.air.nullTerminatedString(pl_op.payload); - const operand = try f.resolveInst(pl_op.operand); - _ = operand; + const operand_is_undef = if (f.air.value(pl_op.operand)) |v| v.isUndefDeep() else false; + if (!operand_is_undef) _ = try f.resolveInst(pl_op.operand); + try reap(f, inst, &.{pl_op.operand}); const writer = f.object.writer(); try writer.print("/* var:{s} */\n", .{name}); From 9177e0da4f8e3480f5a7fade6c42f2ec81f5ffd5 Mon Sep 17 00:00:00 2001 From: Yusuf Bham Date: Fri, 27 Jan 2023 21:40:23 -0500 Subject: [PATCH 22/84] std.os.uefi: fix shift in pool allocator --- lib/std/os/uefi/pool_allocator.zig | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lib/std/os/uefi/pool_allocator.zig b/lib/std/os/uefi/pool_allocator.zig index 69e2f1a37a..8e2d9fe3fc 100644 --- a/lib/std/os/uefi/pool_allocator.zig +++ b/lib/std/os/uefi/pool_allocator.zig @@ -22,7 +22,7 @@ const UefiPoolAllocator = struct { assert(len > 0); - const ptr_align = 1 << log2_ptr_align; + const ptr_align = @as(usize, 1) << @as(Allocator.Log2Align, log2_ptr_align); const metadata_len = mem.alignForward(@sizeOf(usize), ptr_align); From a9b68308b9eeb494524e2b7ab0d63cfa6b623cd0 Mon Sep 17 00:00:00 2001 From: kcbanner Date: Thu, 26 Jan 2023 00:45:40 -0500 Subject: [PATCH 23/84] cbe: fixes for tls, support for not linking libc, and enabling tests - cbe: Implement linksection support, to support TLS when not linking libc - cbe: Support under-aligned variables / struct fields - cbe: Support packed structs (in the C definition of packed) - windows: Fix regression with x86 _tls_array - compiler_rt: Add 128-bit atomics to compiler_rt - tests: Re-enable threadlocal tests on cbe+windows, and llvm+x86 - tests: Re-enable f80 tests that now pass - ci: change windows ci to run the CBE behaviour tests with -lc, to match how the compiler is bootstrapped - update zig1.wasm --- ci/x86_64-windows-debug.ps1 | 5 +- ci/x86_64-windows-release.ps1 | 5 +- lib/compiler_rt/atomics.zig | 104 ++++++++++++++++++++++++++++++++++ lib/std/start_windows_tls.zig | 8 ++- lib/zig.h | 24 ++++++++ src/codegen/c.zig | 54 +++++++++++++----- stage1/zig1.wasm | Bin 2367320 -> 2369157 bytes test/behavior/math.zig | 3 - test/behavior/muladd.zig | 2 - test/behavior/threadlocal.zig | 18 ++++-- 10 files changed, 190 insertions(+), 33 deletions(-) diff --git a/ci/x86_64-windows-debug.ps1 b/ci/x86_64-windows-debug.ps1 index 52d95f2959..65b9fbd92a 100644 --- a/ci/x86_64-windows-debug.ps1 +++ b/ci/x86_64-windows-debug.ps1 @@ -76,7 +76,8 @@ Write-Output "Build x86_64-windows-msvc behavior tests using the C backend..." -ofmt=c ` -femit-bin="test-x86_64-windows-msvc.c" ` --test-no-exec ` - -target x86_64-windows-msvc + -target x86_64-windows-msvc ` + -lc CheckLastExitCode & "stage3-debug\bin\zig.exe" build-obj ` @@ -99,7 +100,7 @@ Enter-VsDevShell -VsInstallPath "C:\Program Files\Microsoft Visual Studio\2022\E CheckLastExitCode Write-Output "Build and run behavior tests with msvc..." -& cl.exe -I..\lib test-x86_64-windows-msvc.c compiler_rt-x86_64-windows-msvc.c /W3 /Z7 -link -nologo -debug -subsystem:console -entry:wWinMainCRTStartup kernel32.lib ntdll.lib vcruntime.lib libucrt.lib +& cl.exe -I..\lib test-x86_64-windows-msvc.c compiler_rt-x86_64-windows-msvc.c /W3 /Z7 -link -nologo -debug -subsystem:console kernel32.lib ntdll.lib libcmt.lib CheckLastExitCode & .\test-x86_64-windows-msvc.exe diff --git a/ci/x86_64-windows-release.ps1 b/ci/x86_64-windows-release.ps1 index 6ab689ad7c..e3375ccb72 100644 --- a/ci/x86_64-windows-release.ps1 +++ b/ci/x86_64-windows-release.ps1 @@ -76,7 +76,8 @@ Write-Output "Build x86_64-windows-msvc behavior tests using the C backend..." -ofmt=c ` -femit-bin="test-x86_64-windows-msvc.c" ` --test-no-exec ` - -target x86_64-windows-msvc + -target x86_64-windows-msvc ` + -lc CheckLastExitCode & "stage3-release\bin\zig.exe" build-obj ` @@ -99,7 +100,7 @@ Enter-VsDevShell -VsInstallPath "C:\Program Files\Microsoft Visual Studio\2022\E CheckLastExitCode Write-Output "Build and run behavior tests with msvc..." -& cl.exe -I..\lib test-x86_64-windows-msvc.c compiler_rt-x86_64-windows-msvc.c /W3 /Z7 -link -nologo -debug -subsystem:console -entry:wWinMainCRTStartup kernel32.lib ntdll.lib vcruntime.lib libucrt.lib +& cl.exe -I..\lib test-x86_64-windows-msvc.c compiler_rt-x86_64-windows-msvc.c /W3 /Z7 -link -nologo -debug -subsystem:console kernel32.lib ntdll.lib libcmt.lib CheckLastExitCode & .\test-x86_64-windows-msvc.exe diff --git a/lib/compiler_rt/atomics.zig b/lib/compiler_rt/atomics.zig index 73bf3fa03b..4db6176dc0 100644 --- a/lib/compiler_rt/atomics.zig +++ b/lib/compiler_rt/atomics.zig @@ -192,6 +192,10 @@ fn __atomic_load_8(src: *u64, model: i32) callconv(.C) u64 { return atomic_load_N(u64, src, model); } +fn __atomic_load_16(src: *u128, model: i32) callconv(.C) u128 { + return atomic_load_N(u128, src, model); +} + inline fn atomic_store_N(comptime T: type, dst: *T, value: T, model: i32) void { _ = model; if (@sizeOf(T) > largest_atomic_size) { @@ -219,6 +223,10 @@ fn __atomic_store_8(dst: *u64, value: u64, model: i32) callconv(.C) void { return atomic_store_N(u64, dst, value, model); } +fn __atomic_store_16(dst: *u128, value: u128, model: i32) callconv(.C) void { + return atomic_store_N(u128, dst, value, model); +} + fn wideUpdate(comptime T: type, ptr: *T, val: T, update: anytype) T { const WideAtomic = std.meta.Int(.unsigned, smallest_atomic_fetch_exch_size * 8); @@ -282,6 +290,10 @@ fn __atomic_exchange_8(ptr: *u64, val: u64, model: i32) callconv(.C) u64 { return atomic_exchange_N(u64, ptr, val, model); } +fn __atomic_exchange_16(ptr: *u128, val: u128, model: i32) callconv(.C) u128 { + return atomic_exchange_N(u128, ptr, val, model); +} + inline fn atomic_compare_exchange_N( comptime T: type, ptr: *T, @@ -327,6 +339,10 @@ fn __atomic_compare_exchange_8(ptr: *u64, expected: *u64, desired: u64, success: return atomic_compare_exchange_N(u64, ptr, expected, desired, success, failure); } +fn __atomic_compare_exchange_16(ptr: *u128, expected: *u128, desired: u128, success: i32, failure: i32) callconv(.C) i32 { + return atomic_compare_exchange_N(u128, ptr, expected, desired, success, failure); +} + inline fn fetch_op_N(comptime T: type, comptime op: std.builtin.AtomicRmwOp, ptr: *T, val: T, model: i32) T { _ = model; const Updater = struct { @@ -338,6 +354,8 @@ inline fn fetch_op_N(comptime T: type, comptime op: std.builtin.AtomicRmwOp, ptr .Nand => ~(old & new), .Or => old | new, .Xor => old ^ new, + .Max => @max(old, new), + .Min => @min(old, new), else => @compileError("unsupported atomic op"), }; } @@ -374,6 +392,10 @@ fn __atomic_fetch_add_8(ptr: *u64, val: u64, model: i32) callconv(.C) u64 { return fetch_op_N(u64, .Add, ptr, val, model); } +fn __atomic_fetch_add_16(ptr: *u128, val: u128, model: i32) callconv(.C) u128 { + return fetch_op_N(u128, .Add, ptr, val, model); +} + fn __atomic_fetch_sub_1(ptr: *u8, val: u8, model: i32) callconv(.C) u8 { return fetch_op_N(u8, .Sub, ptr, val, model); } @@ -390,6 +412,10 @@ fn __atomic_fetch_sub_8(ptr: *u64, val: u64, model: i32) callconv(.C) u64 { return fetch_op_N(u64, .Sub, ptr, val, model); } +fn __atomic_fetch_sub_16(ptr: *u128, val: u128, model: i32) callconv(.C) u128 { + return fetch_op_N(u128, .Sub, ptr, val, model); +} + fn __atomic_fetch_and_1(ptr: *u8, val: u8, model: i32) callconv(.C) u8 { return fetch_op_N(u8, .And, ptr, val, model); } @@ -406,6 +432,10 @@ fn __atomic_fetch_and_8(ptr: *u64, val: u64, model: i32) callconv(.C) u64 { return fetch_op_N(u64, .And, ptr, val, model); } +fn __atomic_fetch_and_16(ptr: *u128, val: u128, model: i32) callconv(.C) u128 { + return fetch_op_N(u128, .And, ptr, val, model); +} + fn __atomic_fetch_or_1(ptr: *u8, val: u8, model: i32) callconv(.C) u8 { return fetch_op_N(u8, .Or, ptr, val, model); } @@ -422,6 +452,10 @@ fn __atomic_fetch_or_8(ptr: *u64, val: u64, model: i32) callconv(.C) u64 { return fetch_op_N(u64, .Or, ptr, val, model); } +fn __atomic_fetch_or_16(ptr: *u128, val: u128, model: i32) callconv(.C) u128 { + return fetch_op_N(u128, .Or, ptr, val, model); +} + fn __atomic_fetch_xor_1(ptr: *u8, val: u8, model: i32) callconv(.C) u8 { return fetch_op_N(u8, .Xor, ptr, val, model); } @@ -438,6 +472,10 @@ fn __atomic_fetch_xor_8(ptr: *u64, val: u64, model: i32) callconv(.C) u64 { return fetch_op_N(u64, .Xor, ptr, val, model); } +fn __atomic_fetch_xor_16(ptr: *u128, val: u128, model: i32) callconv(.C) u128 { + return fetch_op_N(u128, .Xor, ptr, val, model); +} + fn __atomic_fetch_nand_1(ptr: *u8, val: u8, model: i32) callconv(.C) u8 { return fetch_op_N(u8, .Nand, ptr, val, model); } @@ -454,6 +492,50 @@ fn __atomic_fetch_nand_8(ptr: *u64, val: u64, model: i32) callconv(.C) u64 { return fetch_op_N(u64, .Nand, ptr, val, model); } +fn __atomic_fetch_nand_16(ptr: *u128, val: u128, model: i32) callconv(.C) u128 { + return fetch_op_N(u128, .Nand, ptr, val, model); +} + +fn __atomic_fetch_umax_1(ptr: *u8, val: u8, model: i32) callconv(.C) u8 { + return fetch_op_N(u8, .Max, ptr, val, model); +} + +fn __atomic_fetch_umax_2(ptr: *u16, val: u16, model: i32) callconv(.C) u16 { + return fetch_op_N(u16, .Max, ptr, val, model); +} + +fn __atomic_fetch_umax_4(ptr: *u32, val: u32, model: i32) callconv(.C) u32 { + return fetch_op_N(u32, .Max, ptr, val, model); +} + +fn __atomic_fetch_umax_8(ptr: *u64, val: u64, model: i32) callconv(.C) u64 { + return fetch_op_N(u64, .Max, ptr, val, model); +} + +fn __atomic_fetch_umax_16(ptr: *u128, val: u128, model: i32) callconv(.C) u128 { + return fetch_op_N(u128, .Max, ptr, val, model); +} + +fn __atomic_fetch_umin_1(ptr: *u8, val: u8, model: i32) callconv(.C) u8 { + return fetch_op_N(u8, .Min, ptr, val, model); +} + +fn __atomic_fetch_umin_2(ptr: *u16, val: u16, model: i32) callconv(.C) u16 { + return fetch_op_N(u16, .Min, ptr, val, model); +} + +fn __atomic_fetch_umin_4(ptr: *u32, val: u32, model: i32) callconv(.C) u32 { + return fetch_op_N(u32, .Min, ptr, val, model); +} + +fn __atomic_fetch_umin_8(ptr: *u64, val: u64, model: i32) callconv(.C) u64 { + return fetch_op_N(u64, .Min, ptr, val, model); +} + +fn __atomic_fetch_umin_16(ptr: *u128, val: u128, model: i32) callconv(.C) u128 { + return fetch_op_N(u128, .Min, ptr, val, model); +} + comptime { if (supports_atomic_ops and builtin.object_format != .c) { @export(__atomic_load, .{ .name = "__atomic_load", .linkage = linkage, .visibility = visibility }); @@ -465,50 +547,72 @@ comptime { @export(__atomic_fetch_add_2, .{ .name = "__atomic_fetch_add_2", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_add_4, .{ .name = "__atomic_fetch_add_4", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_add_8, .{ .name = "__atomic_fetch_add_8", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_add_16, .{ .name = "__atomic_fetch_add_16", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_sub_1, .{ .name = "__atomic_fetch_sub_1", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_sub_2, .{ .name = "__atomic_fetch_sub_2", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_sub_4, .{ .name = "__atomic_fetch_sub_4", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_sub_8, .{ .name = "__atomic_fetch_sub_8", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_sub_16, .{ .name = "__atomic_fetch_sub_16", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_and_1, .{ .name = "__atomic_fetch_and_1", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_and_2, .{ .name = "__atomic_fetch_and_2", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_and_4, .{ .name = "__atomic_fetch_and_4", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_and_8, .{ .name = "__atomic_fetch_and_8", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_and_16, .{ .name = "__atomic_fetch_and_16", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_or_1, .{ .name = "__atomic_fetch_or_1", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_or_2, .{ .name = "__atomic_fetch_or_2", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_or_4, .{ .name = "__atomic_fetch_or_4", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_or_8, .{ .name = "__atomic_fetch_or_8", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_or_16, .{ .name = "__atomic_fetch_or_16", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_xor_1, .{ .name = "__atomic_fetch_xor_1", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_xor_2, .{ .name = "__atomic_fetch_xor_2", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_xor_4, .{ .name = "__atomic_fetch_xor_4", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_xor_8, .{ .name = "__atomic_fetch_xor_8", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_xor_16, .{ .name = "__atomic_fetch_xor_16", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_nand_1, .{ .name = "__atomic_fetch_nand_1", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_nand_2, .{ .name = "__atomic_fetch_nand_2", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_nand_4, .{ .name = "__atomic_fetch_nand_4", .linkage = linkage, .visibility = visibility }); @export(__atomic_fetch_nand_8, .{ .name = "__atomic_fetch_nand_8", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_nand_16, .{ .name = "__atomic_fetch_nand_16", .linkage = linkage, .visibility = visibility }); + + @export(__atomic_fetch_umax_1, .{ .name = "__atomic_fetch_umax_1", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_umax_2, .{ .name = "__atomic_fetch_umax_2", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_umax_4, .{ .name = "__atomic_fetch_umax_4", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_umax_8, .{ .name = "__atomic_fetch_umax_8", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_umax_16, .{ .name = "__atomic_fetch_umax_16", .linkage = linkage, .visibility = visibility }); + + @export(__atomic_fetch_umin_1, .{ .name = "__atomic_fetch_umin_1", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_umin_2, .{ .name = "__atomic_fetch_umin_2", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_umin_4, .{ .name = "__atomic_fetch_umin_4", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_umin_8, .{ .name = "__atomic_fetch_umin_8", .linkage = linkage, .visibility = visibility }); + @export(__atomic_fetch_umin_16, .{ .name = "__atomic_fetch_umin_16", .linkage = linkage, .visibility = visibility }); @export(__atomic_load_1, .{ .name = "__atomic_load_1", .linkage = linkage, .visibility = visibility }); @export(__atomic_load_2, .{ .name = "__atomic_load_2", .linkage = linkage, .visibility = visibility }); @export(__atomic_load_4, .{ .name = "__atomic_load_4", .linkage = linkage, .visibility = visibility }); @export(__atomic_load_8, .{ .name = "__atomic_load_8", .linkage = linkage, .visibility = visibility }); + @export(__atomic_load_16, .{ .name = "__atomic_load_16", .linkage = linkage, .visibility = visibility }); @export(__atomic_store_1, .{ .name = "__atomic_store_1", .linkage = linkage, .visibility = visibility }); @export(__atomic_store_2, .{ .name = "__atomic_store_2", .linkage = linkage, .visibility = visibility }); @export(__atomic_store_4, .{ .name = "__atomic_store_4", .linkage = linkage, .visibility = visibility }); @export(__atomic_store_8, .{ .name = "__atomic_store_8", .linkage = linkage, .visibility = visibility }); + @export(__atomic_store_16, .{ .name = "__atomic_store_16", .linkage = linkage, .visibility = visibility }); @export(__atomic_exchange_1, .{ .name = "__atomic_exchange_1", .linkage = linkage, .visibility = visibility }); @export(__atomic_exchange_2, .{ .name = "__atomic_exchange_2", .linkage = linkage, .visibility = visibility }); @export(__atomic_exchange_4, .{ .name = "__atomic_exchange_4", .linkage = linkage, .visibility = visibility }); @export(__atomic_exchange_8, .{ .name = "__atomic_exchange_8", .linkage = linkage, .visibility = visibility }); + @export(__atomic_exchange_16, .{ .name = "__atomic_exchange_16", .linkage = linkage, .visibility = visibility }); @export(__atomic_compare_exchange_1, .{ .name = "__atomic_compare_exchange_1", .linkage = linkage, .visibility = visibility }); @export(__atomic_compare_exchange_2, .{ .name = "__atomic_compare_exchange_2", .linkage = linkage, .visibility = visibility }); @export(__atomic_compare_exchange_4, .{ .name = "__atomic_compare_exchange_4", .linkage = linkage, .visibility = visibility }); @export(__atomic_compare_exchange_8, .{ .name = "__atomic_compare_exchange_8", .linkage = linkage, .visibility = visibility }); + @export(__atomic_compare_exchange_16, .{ .name = "__atomic_compare_exchange_16", .linkage = linkage, .visibility = visibility }); } } diff --git a/lib/std/start_windows_tls.zig b/lib/std/start_windows_tls.zig index 0a81f13d46..6a3aad7a99 100644 --- a/lib/std/start_windows_tls.zig +++ b/lib/std/start_windows_tls.zig @@ -7,12 +7,14 @@ export var _tls_end: u8 linksection(".tls$ZZZ") = 0; export var __xl_a: std.os.windows.PIMAGE_TLS_CALLBACK linksection(".CRT$XLA") = null; export var __xl_z: std.os.windows.PIMAGE_TLS_CALLBACK linksection(".CRT$XLZ") = null; -const tls_array: u32 = 0x2c; comptime { - if (builtin.target.cpu.arch == .x86) { + if (builtin.target.cpu.arch == .x86 and builtin.zig_backend != .stage2_c) { // The __tls_array is the offset of the ThreadLocalStoragePointer field // in the TEB block whose base address held in the %fs segment. - @export(tls_array, .{ .name = "_tls_array" }); + asm ( + \\ .global __tls_array + \\ __tls_array = 0x2C + ); } } diff --git a/lib/zig.h b/lib/zig.h index fb9698325e..0756d9f731 100644 --- a/lib/zig.h +++ b/lib/zig.h @@ -93,6 +93,14 @@ typedef char bool; #define zig_align zig_align_unavailable #endif +#if zig_has_attribute(aligned) +#define zig_under_align(alignment) __attribute__((aligned(alignment))) +#elif _MSC_VER +#define zig_under_align(alignment) zig_align(alignment) +#else +#define zig_align zig_align_unavailable +#endif + #if zig_has_attribute(aligned) #define zig_align_fn(alignment) __attribute__((aligned(alignment))) #elif _MSC_VER @@ -101,6 +109,22 @@ typedef char bool; #define zig_align_fn zig_align_fn_unavailable #endif +#if zig_has_attribute(packed) +#define zig_packed(definition) __attribute__((packed)) definition +#elif _MSC_VER +#define zig_packed(definition) __pragma(pack(1)) definition __pragma(pack()) +#else +#define zig_packed(definition) zig_packed_unavailable +#endif + +#if zig_has_attribute(section) +#define zig_linksection(name, def, ...) def __attribute__((section(name))) +#elif _MSC_VER +#define zig_linksection(name, def, ...) __pragma(section(name, __VA_ARGS__)) __declspec(allocate(name)) def +#else +#define zig_linksection(name, def, ...) zig_linksection_unavailable +#endif + #if zig_has_builtin(unreachable) || defined(zig_gnuc) #define zig_unreachable() __builtin_unreachable() #else diff --git a/src/codegen/c.zig b/src/codegen/c.zig index 70c62a1faa..eb0ae1b1f6 100644 --- a/src/codegen/c.zig +++ b/src/codegen/c.zig @@ -1663,6 +1663,22 @@ pub const DeclGen = struct { defer buffer.deinit(); try buffer.appendSlice("struct "); + + var needs_pack_attr = false; + { + var it = t.structFields().iterator(); + while (it.next()) |field| { + const field_ty = field.value_ptr.ty; + if (!field_ty.hasRuntimeBits()) continue; + const alignment = field.value_ptr.abi_align; + if (alignment != 0 and alignment < field_ty.abiAlignment(dg.module.getTarget())) { + needs_pack_attr = true; + try buffer.appendSlice("zig_packed("); + break; + } + } + } + try buffer.appendSlice(name); try buffer.appendSlice(" {\n"); { @@ -1672,7 +1688,7 @@ pub const DeclGen = struct { const field_ty = field.value_ptr.ty; if (!field_ty.hasRuntimeBits()) continue; - const alignment = field.value_ptr.abi_align; + const alignment = field.value_ptr.alignment(dg.module.getTarget(), t.containerLayout()); const field_name = CValue{ .identifier = field.key_ptr.* }; try buffer.append(' '); try dg.renderTypeAndName(buffer.writer(), field_ty, field_name, .Mut, alignment, .Complete); @@ -1682,7 +1698,7 @@ pub const DeclGen = struct { } if (empty) try buffer.appendSlice(" char empty_struct;\n"); } - try buffer.appendSlice("};\n"); + if (needs_pack_attr) try buffer.appendSlice("});\n") else try buffer.appendSlice("};\n"); const rendered = try buffer.toOwnedSlice(); errdefer dg.typedefs.allocator.free(rendered); @@ -2367,8 +2383,13 @@ pub const DeclGen = struct { depth += 1; } - if (alignment != 0 and alignment > ty.abiAlignment(target)) { - try w.print("zig_align({}) ", .{alignment}); + if (alignment != 0) { + const abi_alignment = ty.abiAlignment(target); + if (alignment < abi_alignment) { + try w.print("zig_under_align({}) ", .{alignment}); + } else if (alignment > abi_alignment) { + try w.print("zig_align({}) ", .{alignment}); + } } try dg.renderType(w, render_ty, kind); @@ -2860,27 +2881,30 @@ pub fn genDecl(o: *Object) !void { const w = o.writer(); if (!is_global) try w.writeAll("static "); if (variable.is_threadlocal) try w.writeAll("zig_threadlocal "); + if (o.dg.decl.@"linksection") |section| try w.print("zig_linksection(\"{s}\", ", .{section}); try o.dg.renderTypeAndName(w, o.dg.decl.ty, decl_c_value, .Mut, o.dg.decl.@"align", .Complete); + if (o.dg.decl.@"linksection" != null) try w.writeAll(", read, write)"); try w.writeAll(" = "); try o.dg.renderValue(w, tv.ty, variable.init, .StaticInitializer); try w.writeByte(';'); try o.indent_writer.insertNewline(); } else { + const is_global = o.dg.module.decl_exports.contains(o.dg.decl_index); + const fwd_decl_writer = o.dg.fwd_decl.writer(); const decl_c_value: CValue = .{ .decl = o.dg.decl_index }; - const fwd_decl_writer = o.dg.fwd_decl.writer(); - try fwd_decl_writer.writeAll("static "); - try o.dg.renderTypeAndName(fwd_decl_writer, tv.ty, decl_c_value, .Mut, o.dg.decl.@"align", .Complete); + try fwd_decl_writer.writeAll(if (is_global) "zig_extern " else "static "); + try o.dg.renderTypeAndName(fwd_decl_writer, tv.ty, decl_c_value, .Const, o.dg.decl.@"align", .Complete); try fwd_decl_writer.writeAll(";\n"); - const writer = o.writer(); - try writer.writeAll("static "); - // TODO ask the Decl if it is const - // https://github.com/ziglang/zig/issues/7582 - try o.dg.renderTypeAndName(writer, tv.ty, decl_c_value, .Mut, o.dg.decl.@"align", .Complete); - try writer.writeAll(" = "); - try o.dg.renderValue(writer, tv.ty, tv.val, .StaticInitializer); - try writer.writeAll(";\n"); + const w = o.writer(); + if (!is_global) try w.writeAll("static "); + if (o.dg.decl.@"linksection") |section| try w.print("zig_linksection(\"{s}\", ", .{section}); + try o.dg.renderTypeAndName(w, tv.ty, decl_c_value, .Const, o.dg.decl.@"align", .Complete); + if (o.dg.decl.@"linksection" != null) try w.writeAll(", read)"); + try w.writeAll(" = "); + try o.dg.renderValue(w, tv.ty, tv.val, .StaticInitializer); + try w.writeAll(";\n"); } } diff --git a/stage1/zig1.wasm b/stage1/zig1.wasm index 44052980162eb19a17493b624e4d1e52a2c98be6..e64e05fa1300ae7254391cbb74786b55abd1e48b 100644 GIT binary patch delta 661855 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

EbtQ;X}L#lr~HP|E{@;A`#EEXyC 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

-HQ!XO6%e^Gv4Y}n2O^mY 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%0DwHk0}B&3+W3zqv&?C5 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⋙-=kBoLgNU9 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⁡jF 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%0Ahdu|KFK=w*~O^{ht5#e2 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

oghSFdpWU|)loe+Y^Tk9lhIbPT!3Pbfh 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%0Db85fq7cnbj!z^SP_Oc`B_XS8Dhl>GqsWa0uEUP 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�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 diff --git a/test/behavior/math.zig b/test/behavior/math.zig index 2257a116b7..c5e36da383 100644 --- a/test/behavior/math.zig +++ b/test/behavior/math.zig @@ -1332,7 +1332,6 @@ test "float remainder division using @rem" { if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_sparc64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_x86_64) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_llvm and builtin.os.tag == .windows) return error.SkipZigTest; // https://github.com/ziglang/zig/issues/12602 comptime try frem(f16); comptime try frem(f32); @@ -1375,7 +1374,6 @@ test "float modulo division using @mod" { if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_x86_64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_sparc64) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_llvm and builtin.os.tag == .windows) return error.SkipZigTest; // https://github.com/ziglang/zig/issues/12602 comptime try fmod(f16); comptime try fmod(f32); @@ -1438,7 +1436,6 @@ test "@round f80" { if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_x86_64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_sparc64) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_llvm and builtin.os.tag == .windows) return error.SkipZigTest; // https://github.com/ziglang/zig/issues/12602 try testRound(f80, 12.0); comptime try testRound(f80, 12.0); diff --git a/test/behavior/muladd.zig b/test/behavior/muladd.zig index da00355b35..a2d9e6d16d 100644 --- a/test/behavior/muladd.zig +++ b/test/behavior/muladd.zig @@ -50,7 +50,6 @@ test "@mulAdd f80" { if (builtin.zig_backend == .stage2_arm) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_sparc64) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_llvm and builtin.os.tag == .windows) return error.SkipZigTest; // https://github.com/ziglang/zig/issues/12602 comptime try testMulAdd80(); try testMulAdd80(); @@ -178,7 +177,6 @@ test "vector f80" { if (builtin.zig_backend == .stage2_arm) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_sparc64) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_llvm and builtin.os.tag == .windows) return error.SkipZigTest; // https://github.com/ziglang/zig/issues/12602 comptime try vector80(); try vector80(); diff --git a/test/behavior/threadlocal.zig b/test/behavior/threadlocal.zig index 1844c5b92d..ebeb1177c2 100644 --- a/test/behavior/threadlocal.zig +++ b/test/behavior/threadlocal.zig @@ -7,8 +7,10 @@ test "thread local variable" { if (builtin.zig_backend == .stage2_x86_64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_arm) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_llvm and builtin.cpu.arch != .x86_64) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_c and builtin.os.tag == .windows) return error.SkipZigTest; // TODO + if (builtin.zig_backend == .stage2_llvm) switch (builtin.cpu.arch) { + .x86_64, .x86 => {}, + else => return error.SkipZigTest, + }; // TODO if (builtin.zig_backend == .stage2_sparc64) return error.SkipZigTest; // TODO const S = struct { @@ -23,8 +25,10 @@ test "pointer to thread local array" { if (builtin.zig_backend == .stage2_x86_64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_arm) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_llvm and builtin.cpu.arch != .x86_64) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_c and builtin.os.tag == .windows) return error.SkipZigTest; // TODO + if (builtin.zig_backend == .stage2_llvm) switch (builtin.cpu.arch) { + .x86_64, .x86 => {}, + else => return error.SkipZigTest, + }; // TODO if (builtin.zig_backend == .stage2_sparc64) return error.SkipZigTest; // TODO const s = "Hello world"; @@ -39,8 +43,10 @@ test "reference a global threadlocal variable" { if (builtin.zig_backend == .stage2_x86_64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_arm) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_llvm and builtin.cpu.arch != .x86_64) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_c and builtin.os.tag == .windows) return error.SkipZigTest; // TODO + if (builtin.zig_backend == .stage2_llvm) switch (builtin.cpu.arch) { + .x86_64, .x86 => {}, + else => return error.SkipZigTest, + }; // TODO if (builtin.zig_backend == .stage2_sparc64) return error.SkipZigTest; // TODO _ = nrfx_uart_rx(&g_uart0); From 7c2ba950a758b86893bfbe73521b29895f7ac4f0 Mon Sep 17 00:00:00 2001 From: kcbanner Date: Fri, 27 Jan 2023 18:01:49 -0500 Subject: [PATCH 24/84] build: .c ofmt does not produce a pdb --- lib/std/build/LibExeObjStep.zig | 1 + 1 file changed, 1 insertion(+) diff --git a/lib/std/build/LibExeObjStep.zig b/lib/std/build/LibExeObjStep.zig index 213c5c6559..cb37b24885 100644 --- a/lib/std/build/LibExeObjStep.zig +++ b/lib/std/build/LibExeObjStep.zig @@ -617,6 +617,7 @@ pub fn isStaticLibrary(self: *LibExeObjStep) bool { pub fn producesPdbFile(self: *LibExeObjStep) bool { if (!self.target.isWindows() and !self.target.isUefi()) return false; + if (self.target.getObjectFormat() == .c) return false; if (self.strip == true) return false; return self.isDynamicLibrary() or self.kind == .exe or self.kind == .test_exe; } From 23b7d28896609e3f01765730599119baf53a56c9 Mon Sep 17 00:00:00 2001 From: Isaac Freund Date: Sun, 22 Jan 2023 16:40:00 +0100 Subject: [PATCH 25/84] std: restrict mem.span() and mem.len() to sentinel terminated pointers These functions are currently footgunny when working with pointers to arrays and slices. They just return the stated length of the array/slice without iterating and looking for the first sentinel, even if the array/slice is a sentinel terminated type. From looking at the quite small list of places in the standard library/compiler that this change breaks existing code, the new code looks to be more readable in all cases. The usage of std.mem.span/len was totally unneeded in most of the cases affected by this breaking change. We could remove these functions entirely in favor of other existing functions in std.mem such as std.mem.sliceTo(), but that would be a somewhat nasty breaking change as std.mem.span() is very widely used for converting sentinel terminated pointers to slices. It is however not at all widely used for anything else. Therefore I think it is better to break these few non-standard and potentially incorrect usages of these functions now and at some later time, if deemed worthwhile, finally remove these functions. If we wait for at least a full release cycle so that everyone adapts to this change first, updating for the removal could be a simple find and replace without needing to worry about the semantics. --- lib/std/Thread.zig | 2 +- lib/std/bounded_array.zig | 6 +- lib/std/cstr.zig | 1 - lib/std/fs.zig | 2 +- lib/std/io/fixed_buffer_stream.zig | 25 +++++-- lib/std/mem.zig | 102 +++++++---------------------- src/link/MachO/load_commands.zig | 2 +- src/main.zig | 8 +-- test/behavior/basic.zig | 2 +- 9 files changed, 56 insertions(+), 94 deletions(-) diff --git a/lib/std/Thread.zig b/lib/std/Thread.zig index d27474584f..8004f94d7f 100644 --- a/lib/std/Thread.zig +++ b/lib/std/Thread.zig @@ -166,7 +166,7 @@ pub const GetNameError = error{ pub fn getName(self: Thread, buffer_ptr: *[max_name_len:0]u8) GetNameError!?[]const u8 { buffer_ptr[max_name_len] = 0; - var buffer = std.mem.span(buffer_ptr); + var buffer: [:0]u8 = buffer_ptr; switch (target.os.tag) { .linux => if (use_pthreads and is_gnu) { diff --git a/lib/std/bounded_array.zig b/lib/std/bounded_array.zig index 3d74e5e47f..7f1957d6dc 100644 --- a/lib/std/bounded_array.zig +++ b/lib/std/bounded_array.zig @@ -29,7 +29,11 @@ pub fn BoundedArray(comptime T: type, comptime buffer_capacity: usize) type { } /// View the internal array as a slice whose size was previously set. - pub fn slice(self: anytype) mem.Span(@TypeOf(&self.buffer)) { + pub fn slice(self: anytype) switch (@TypeOf(&self.buffer)) { + *[buffer_capacity]T => []T, + *const [buffer_capacity]T => []const T, + else => unreachable, + } { return self.buffer[0..self.len]; } diff --git a/lib/std/cstr.zig b/lib/std/cstr.zig index 068fc419ac..52524c5084 100644 --- a/lib/std/cstr.zig +++ b/lib/std/cstr.zig @@ -28,7 +28,6 @@ test "cstr fns" { fn testCStrFnsImpl() !void { try testing.expect(cmp("aoeu", "aoez") == -1); - try testing.expect(mem.len("123456789") == 9); } /// Returns a mutable, null-terminated slice with the same length as `slice`. diff --git a/lib/std/fs.zig b/lib/std/fs.zig index 1b00064108..244f3a38ce 100644 --- a/lib/std/fs.zig +++ b/lib/std/fs.zig @@ -834,7 +834,7 @@ pub const IterableDir = struct { self.end_index = self.index; // Force fd_readdir in the next loop. continue :start_over; } - const name = mem.span(self.buf[name_index .. name_index + entry.d_namlen]); + const name = self.buf[name_index .. name_index + entry.d_namlen]; const next_index = name_index + entry.d_namlen; self.index = next_index; diff --git a/lib/std/io/fixed_buffer_stream.zig b/lib/std/io/fixed_buffer_stream.zig index f486356491..2fcb260c72 100644 --- a/lib/std/io/fixed_buffer_stream.zig +++ b/lib/std/io/fixed_buffer_stream.zig @@ -113,14 +113,27 @@ pub fn FixedBufferStream(comptime Buffer: type) type { }; } -pub fn fixedBufferStream(buffer: anytype) FixedBufferStream(NonSentinelSpan(@TypeOf(buffer))) { - return .{ .buffer = mem.span(buffer), .pos = 0 }; +pub fn fixedBufferStream(buffer: anytype) FixedBufferStream(Slice(@TypeOf(buffer))) { + return .{ .buffer = buffer, .pos = 0 }; } -fn NonSentinelSpan(comptime T: type) type { - var ptr_info = @typeInfo(mem.Span(T)).Pointer; - ptr_info.sentinel = null; - return @Type(.{ .Pointer = ptr_info }); +fn Slice(comptime T: type) type { + switch (@typeInfo(T)) { + .Pointer => |ptr_info| { + var new_ptr_info = ptr_info; + switch (ptr_info.size) { + .Slice => {}, + .One => switch (@typeInfo(ptr_info.child)) { + .Array => |info| new_ptr_info.child = info.child, + else => @compileError("invalid type given to fixedBufferStream"), + }, + else => @compileError("invalid type given to fixedBufferStream"), + } + new_ptr_info.size = .Slice; + return @Type(.{ .Pointer = new_ptr_info }); + }, + else => @compileError("invalid type given to fixedBufferStream"), + } } test "FixedBufferStream output" { diff --git a/lib/std/mem.zig b/lib/std/mem.zig index 8691c5bbad..371ef8fd8d 100644 --- a/lib/std/mem.zig +++ b/lib/std/mem.zig @@ -636,12 +636,9 @@ test "indexOfDiff" { try testing.expectEqual(indexOfDiff(u8, "xne", "one"), 0); } -/// Takes a pointer to an array, a sentinel-terminated pointer, or a slice, and -/// returns a slice. If there is a sentinel on the input type, there will be a -/// sentinel on the output type. The constness of the output type matches -/// the constness of the input type. `[*c]` pointers are assumed to be 0-terminated, -/// and assumed to not allow null. -pub fn Span(comptime T: type) type { +/// Takes a sentinel-terminated pointer and returns a slice preserving pointer attributes. +/// `[*c]` pointers are assumed to be 0-terminated and assumed to not be allowzero. +fn Span(comptime T: type) type { switch (@typeInfo(T)) { .Optional => |optional_info| { return ?Span(optional_info.child); @@ -649,39 +646,22 @@ pub fn Span(comptime T: type) type { .Pointer => |ptr_info| { var new_ptr_info = ptr_info; switch (ptr_info.size) { - .One => switch (@typeInfo(ptr_info.child)) { - .Array => |info| { - new_ptr_info.child = info.child; - new_ptr_info.sentinel = info.sentinel; - }, - else => @compileError("invalid type given to std.mem.Span"), - }, .C => { new_ptr_info.sentinel = &@as(ptr_info.child, 0); new_ptr_info.is_allowzero = false; }, - .Many, .Slice => {}, + .Many => if (ptr_info.sentinel == null) @compileError("invalid type given to std.mem.span: " ++ @typeName(T)), + .One, .Slice => @compileError("invalid type given to std.mem.span: " ++ @typeName(T)), } new_ptr_info.size = .Slice; return @Type(.{ .Pointer = new_ptr_info }); }, - else => @compileError("invalid type given to std.mem.Span"), + else => {}, } + @compileError("invalid type given to std.mem.span: " ++ @typeName(T)); } test "Span" { - try testing.expect(Span(*[5]u16) == []u16); - try testing.expect(Span(?*[5]u16) == ?[]u16); - try testing.expect(Span(*const [5]u16) == []const u16); - try testing.expect(Span(?*const [5]u16) == ?[]const u16); - try testing.expect(Span([]u16) == []u16); - try testing.expect(Span(?[]u16) == ?[]u16); - try testing.expect(Span([]const u8) == []const u8); - try testing.expect(Span(?[]const u8) == ?[]const u8); - try testing.expect(Span([:1]u16) == [:1]u16); - try testing.expect(Span(?[:1]u16) == ?[:1]u16); - try testing.expect(Span([:1]const u8) == [:1]const u8); - try testing.expect(Span(?[:1]const u8) == ?[:1]const u8); try testing.expect(Span([*:1]u16) == [:1]u16); try testing.expect(Span(?[*:1]u16) == ?[:1]u16); try testing.expect(Span([*:1]const u8) == [:1]const u8); @@ -692,13 +672,10 @@ test "Span" { try testing.expect(Span(?[*c]const u8) == ?[:0]const u8); } -/// Takes a pointer to an array, a sentinel-terminated pointer, or a slice, and -/// returns a slice. If there is a sentinel on the input type, there will be a -/// sentinel on the output type. The constness of the output type matches -/// the constness of the input type. -/// -/// When there is both a sentinel and an array length or slice length, the -/// length value is used instead of the sentinel. +/// Takes a sentinel-terminated pointer and returns a slice, iterating over the +/// memory to find the sentinel and determine the length. +/// Ponter attributes such as const are preserved. +/// `[*c]` pointers are assumed to be non-null and 0-terminated. pub fn span(ptr: anytype) Span(@TypeOf(ptr)) { if (@typeInfo(@TypeOf(ptr)) == .Optional) { if (ptr) |non_null| { @@ -722,7 +699,6 @@ test "span" { var array: [5]u16 = [_]u16{ 1, 2, 3, 4, 5 }; const ptr = @as([*:3]u16, array[0..2 :3]); try testing.expect(eql(u16, span(ptr), &[_]u16{ 1, 2 })); - try testing.expect(eql(u16, span(&array), &[_]u16{ 1, 2, 3, 4, 5 })); try testing.expectEqual(@as(?[:0]u16, null), span(@as(?[*:0]u16, null))); } @@ -919,22 +895,15 @@ test "lenSliceTo" { } } -/// Takes a pointer to an array, an array, a vector, a sentinel-terminated pointer, -/// a slice or a tuple, and returns the length. -/// In the case of a sentinel-terminated array, it uses the array length. -/// For C pointers it assumes it is a pointer-to-many with a 0 sentinel. +/// Takes a sentinel-terminated pointer and iterates over the memory to find the +/// sentinel and determine the length. +/// `[*c]` pointers are assumed to be non-null and 0-terminated. pub fn len(value: anytype) usize { - return switch (@typeInfo(@TypeOf(value))) { - .Array => |info| info.len, - .Vector => |info| info.len, + switch (@typeInfo(@TypeOf(value))) { .Pointer => |info| switch (info.size) { - .One => switch (@typeInfo(info.child)) { - .Array => value.len, - else => @compileError("invalid type given to std.mem.len"), - }, .Many => { const sentinel_ptr = info.sentinel orelse - @compileError("length of pointer with no sentinel"); + @compileError("invalid type given to std.mem.len: " ++ @typeName(@TypeOf(value))); const sentinel = @ptrCast(*align(1) const info.child, sentinel_ptr).*; return indexOfSentinel(info.child, sentinel, value); }, @@ -942,41 +911,18 @@ pub fn len(value: anytype) usize { assert(value != null); return indexOfSentinel(info.child, 0, value); }, - .Slice => value.len, + else => @compileError("invalid type given to std.mem.len: " ++ @typeName(@TypeOf(value))), }, - .Struct => |info| if (info.is_tuple) { - return info.fields.len; - } else @compileError("invalid type given to std.mem.len"), - else => @compileError("invalid type given to std.mem.len"), - }; + else => @compileError("invalid type given to std.mem.len: " ++ @typeName(@TypeOf(value))), + } } test "len" { - try testing.expect(len("aoeu") == 4); - - { - var array: [5]u16 = [_]u16{ 1, 2, 3, 4, 5 }; - try testing.expect(len(&array) == 5); - try testing.expect(len(array[0..3]) == 3); - array[2] = 0; - const ptr = @as([*:0]u16, array[0..2 :0]); - try testing.expect(len(ptr) == 2); - } - { - var array: [5:0]u16 = [_:0]u16{ 1, 2, 3, 4, 5 }; - try testing.expect(len(&array) == 5); - array[2] = 0; - try testing.expect(len(&array) == 5); - } - { - const vector: meta.Vector(2, u32) = [2]u32{ 1, 2 }; - try testing.expect(len(vector) == 2); - } - { - const tuple = .{ 1, 2 }; - try testing.expect(len(tuple) == 2); - try testing.expect(tuple[0] == 1); - } + var array: [5]u16 = [_]u16{ 1, 2, 0, 4, 5 }; + const ptr = @as([*:4]u16, array[0..3 :4]); + try testing.expect(len(ptr) == 3); + const c_ptr = @as([*c]u16, ptr); + try testing.expect(len(c_ptr) == 2); } pub fn indexOfSentinel(comptime Elem: type, comptime sentinel: Elem, ptr: [*:sentinel]const Elem) usize { diff --git a/src/link/MachO/load_commands.zig b/src/link/MachO/load_commands.zig index 0e3760526c..a452551a0a 100644 --- a/src/link/MachO/load_commands.zig +++ b/src/link/MachO/load_commands.zig @@ -12,7 +12,7 @@ pub const default_dyld_path: [*:0]const u8 = "/usr/lib/dyld"; fn calcInstallNameLen(cmd_size: u64, name: []const u8, assume_max_path_len: bool) u64 { const darwin_path_max = 1024; - const name_len = if (assume_max_path_len) darwin_path_max else std.mem.len(name) + 1; + const name_len = if (assume_max_path_len) darwin_path_max else name.len + 1; return mem.alignForwardGeneric(u64, cmd_size + name_len, @alignOf(u64)); } diff --git a/src/main.zig b/src/main.zig index fdc761ac92..72e7e094e6 100644 --- a/src/main.zig +++ b/src/main.zig @@ -893,7 +893,7 @@ fn buildOutputType( i: usize = 0, fn next(it: *@This()) ?[]const u8 { if (it.i >= it.args.len) { - if (it.resp_file) |*resp| return if (resp.next()) |sentinel| std.mem.span(sentinel) else null; + if (it.resp_file) |*resp| return resp.next(); return null; } defer it.i += 1; @@ -901,7 +901,7 @@ fn buildOutputType( } fn nextOrFatal(it: *@This()) []const u8 { if (it.i >= it.args.len) { - if (it.resp_file) |*resp| if (resp.next()) |sentinel| return std.mem.span(sentinel); + if (it.resp_file) |*resp| if (resp.next()) |ret| return ret; fatal("expected parameter after {s}", .{it.args[it.i - 1]}); } defer it.i += 1; @@ -4973,7 +4973,7 @@ pub const ClangArgIterator = struct { // rather than an argument to a parameter. // We adjust the len below when necessary. self.other_args = (self.argv.ptr + self.next_index)[0..1]; - var arg = mem.span(self.argv[self.next_index]); + var arg = self.argv[self.next_index]; self.incrementArgIndex(); if (mem.startsWith(u8, arg, "@")) { @@ -5017,7 +5017,7 @@ pub const ClangArgIterator = struct { self.has_next = true; self.other_args = (self.argv.ptr + self.next_index)[0..1]; // We adjust len below when necessary. - arg = mem.span(self.argv[self.next_index]); + arg = self.argv[self.next_index]; self.incrementArgIndex(); } diff --git a/test/behavior/basic.zig b/test/behavior/basic.zig index ebca81be96..8a97b3cbcd 100644 --- a/test/behavior/basic.zig +++ b/test/behavior/basic.zig @@ -703,7 +703,7 @@ test "string concatenation" { comptime try expect(@TypeOf(a) == *const [12:0]u8); comptime try expect(@TypeOf(b) == *const [12:0]u8); - const len = mem.len(b); + const len = b.len; const len_with_null = len + 1; { var i: u32 = 0; From 92dfc07489c3f8514792434e2857b419ebf1f208 Mon Sep 17 00:00:00 2001 From: Veikka Tuominen Date: Sun, 22 Jan 2023 13:29:05 +0200 Subject: [PATCH 26/84] TypedValue: fix crash when string-like aggregate has undefined element Closes #6334 --- src/TypedValue.zig | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/src/TypedValue.zig b/src/TypedValue.zig index 6e096ee90a..cb28274f10 100644 --- a/src/TypedValue.zig +++ b/src/TypedValue.zig @@ -176,7 +176,9 @@ pub fn print( var i: u32 = 0; while (i < max_len) : (i += 1) { - buf[i] = std.math.cast(u8, val.fieldValue(ty, i).toUnsignedInt(target)) orelse break :str; + const elem = val.fieldValue(ty, i); + if (elem.isUndef()) break :str; + buf[i] = std.math.cast(u8, elem.toUnsignedInt(target)) orelse break :str; } const truncated = if (len > max_string_len) " (truncated)" else ""; @@ -390,6 +392,7 @@ pub fn print( while (i < max_len) : (i += 1) { var elem_buf: Value.ElemValueBuffer = undefined; const elem_val = payload.ptr.elemValueBuffer(mod, i, &elem_buf); + if (elem_val.isUndef()) break :str; buf[i] = std.math.cast(u8, elem_val.toUnsignedInt(target)) orelse break :str; } From d8c3c11c6c5288118b3529c6a99810a4c4add9e9 Mon Sep 17 00:00:00 2001 From: Jiacai Liu Date: Mon, 30 Jan 2023 06:00:14 +0800 Subject: [PATCH 27/84] std: add expectEqualDeep (#13995) --- lib/std/testing.zig | 246 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 246 insertions(+) diff --git a/lib/std/testing.zig b/lib/std/testing.zig index 53877967c9..895a9a0973 100644 --- a/lib/std/testing.zig +++ b/lib/std/testing.zig @@ -670,6 +670,252 @@ pub fn expectStringEndsWith(actual: []const u8, expected_ends_with: []const u8) return error.TestExpectedEndsWith; } +/// This function is intended to be used only in tests. When the two values are not +/// deeply equal, prints diagnostics to stderr to show exactly how they are not equal, +/// then returns a test failure error. +/// `actual` is casted to the type of `expected`. +/// +/// Deeply equal is defined as follows: +/// Primitive types are deeply equal if they are equal using `==` operator. +/// Struct values are deeply equal if their corresponding fields are deeply equal. +/// Container types(like Array/Slice/Vector) deeply equal when their corresponding elements are deeply equal. +/// Pointer values are deeply equal if values they point to are deeply equal. +/// +/// Note: Self-referential structs are not supported (e.g. things like std.SinglyLinkedList) +pub fn expectEqualDeep(expected: anytype, actual: @TypeOf(expected)) !void { + switch (@typeInfo(@TypeOf(actual))) { + .NoReturn, + .Opaque, + .Frame, + .AnyFrame, + => @compileError("value of type " ++ @typeName(@TypeOf(actual)) ++ " encountered"), + + .Undefined, + .Null, + .Void, + => return, + + .Type => { + if (actual != expected) { + std.debug.print("expected type {s}, found type {s}\n", .{ @typeName(expected), @typeName(actual) }); + return error.TestExpectedEqual; + } + }, + + .Bool, + .Int, + .Float, + .ComptimeFloat, + .ComptimeInt, + .EnumLiteral, + .Enum, + .Fn, + .ErrorSet, + => { + if (actual != expected) { + std.debug.print("expected {}, found {}\n", .{ expected, actual }); + return error.TestExpectedEqual; + } + }, + + .Pointer => |pointer| { + switch (pointer.size) { + // We have no idea what is behind those pointers, so the best we can do is `==` check. + .C, .Many => { + if (actual != expected) { + std.debug.print("expected {*}, found {*}\n", .{ expected, actual }); + return error.TestExpectedEqual; + } + }, + .One => { + // Length of those pointers are runtime value, so the best we can do is `==` check. + switch (@typeInfo(pointer.child)) { + .Fn, .Opaque => { + if (actual != expected) { + std.debug.print("expected {*}, found {*}\n", .{ expected, actual }); + return error.TestExpectedEqual; + } + }, + else => try expectEqualDeep(expected.*, actual.*), + } + }, + .Slice => { + if (expected.len != actual.len) { + std.debug.print("Slice len not the same, expected {d}, found {d}\n", .{ expected.len, actual.len }); + return error.TestExpectedEqual; + } + var i: usize = 0; + while (i < expected.len) : (i += 1) { + expectEqualDeep(expected[i], actual[i]) catch |e| { + std.debug.print("index {d} incorrect. expected {any}, found {any}\n", .{ + i, expected[i], actual[i], + }); + return e; + }; + } + }, + } + }, + + .Array => |_| { + if (expected.len != actual.len) { + std.debug.print("Array len not the same, expected {d}, found {d}\n", .{ expected.len, actual.len }); + return error.TestExpectedEqual; + } + var i: usize = 0; + while (i < expected.len) : (i += 1) { + expectEqualDeep(expected[i], actual[i]) catch |e| { + std.debug.print("index {d} incorrect. expected {any}, found {any}\n", .{ + i, expected[i], actual[i], + }); + return e; + }; + } + }, + + .Vector => |info| { + if (info.len != @typeInfo(@TypeOf(actual)).Vector.len) { + std.debug.print("Vector len not the same, expected {d}, found {d}\n", .{ info.len, @typeInfo(@TypeOf(actual)).Vector.len }); + return error.TestExpectedEqual; + } + var i: usize = 0; + while (i < info.len) : (i += 1) { + expectEqualDeep(expected[i], actual[i]) catch |e| { + std.debug.print("index {d} incorrect. expected {any}, found {any}\n", .{ + i, expected[i], actual[i], + }); + return e; + }; + } + }, + + .Struct => |structType| { + inline for (structType.fields) |field| { + expectEqualDeep(@field(expected, field.name), @field(actual, field.name)) catch |e| { + std.debug.print("Field {s} incorrect. expected {any}, found {any}\n", .{ field.name, @field(expected, field.name), @field(actual, field.name) }); + return e; + }; + } + }, + + .Union => |union_info| { + if (union_info.tag_type == null) { + @compileError("Unable to compare untagged union values"); + } + + const Tag = std.meta.Tag(@TypeOf(expected)); + + const expectedTag = @as(Tag, expected); + const actualTag = @as(Tag, actual); + + try expectEqual(expectedTag, actualTag); + + // we only reach this loop if the tags are equal + switch (expected) { + inline else => |val, tag| { + try expectEqualDeep(val, @field(actual, @tagName(tag))); + }, + } + }, + + .Optional => { + if (expected) |expected_payload| { + if (actual) |actual_payload| { + try expectEqualDeep(expected_payload, actual_payload); + } else { + std.debug.print("expected {any}, found null\n", .{expected_payload}); + return error.TestExpectedEqual; + } + } else { + if (actual) |actual_payload| { + std.debug.print("expected null, found {any}\n", .{actual_payload}); + return error.TestExpectedEqual; + } + } + }, + + .ErrorUnion => { + if (expected) |expected_payload| { + if (actual) |actual_payload| { + try expectEqualDeep(expected_payload, actual_payload); + } else |actual_err| { + std.debug.print("expected {any}, found {any}\n", .{ expected_payload, actual_err }); + return error.TestExpectedEqual; + } + } else |expected_err| { + if (actual) |actual_payload| { + std.debug.print("expected {any}, found {any}\n", .{ expected_err, actual_payload }); + return error.TestExpectedEqual; + } else |actual_err| { + try expectEqualDeep(expected_err, actual_err); + } + } + }, + } +} + +test "expectEqualDeep primitive type" { + try expectEqualDeep(1, 1); + try expectEqualDeep(true, true); + try expectEqualDeep(1.5, 1.5); + try expectEqualDeep(u8, u8); + try expectEqualDeep(error.Bad, error.Bad); + + // optional + { + const foo: ?u32 = 1; + const bar: ?u32 = 1; + try expectEqualDeep(foo, bar); + try expectEqualDeep(?u32, ?u32); + } + // function type + { + const fnType = struct { + fn foo() void { + unreachable; + } + }.foo; + try expectEqualDeep(fnType, fnType); + } +} + +test "expectEqualDeep pointer" { + const a = 1; + const b = 1; + try expectEqualDeep(&a, &b); +} + +test "expectEqualDeep composite type" { + try expectEqualDeep("abc", "abc"); + const s1: []const u8 = "abc"; + const s2 = "abcd"; + const s3: []const u8 = s2[0..3]; + try expectEqualDeep(s1, s3); + + const TestStruct = struct { s: []const u8 }; + try expectEqualDeep(TestStruct{ .s = "abc" }, TestStruct{ .s = "abc" }); + try expectEqualDeep([_][]const u8{ "a", "b", "c" }, [_][]const u8{ "a", "b", "c" }); + + // vector + try expectEqualDeep(@splat(4, @as(u32, 4)), @splat(4, @as(u32, 4))); + + // nested array + { + const a = [2][2]f32{ + [_]f32{ 1.0, 0.0 }, + [_]f32{ 0.0, 1.0 }, + }; + + const b = [2][2]f32{ + [_]f32{ 1.0, 0.0 }, + [_]f32{ 0.0, 1.0 }, + }; + + try expectEqualDeep(a, b); + try expectEqualDeep(&a, &b); + } +} + fn printIndicatorLine(source: []const u8, indicator_index: usize) void { const line_begin_index = if (std.mem.lastIndexOfScalar(u8, source[0..indicator_index], '\n')) |line_begin| line_begin + 1 From 885d6968958e1cad4862ed1b6f1ea0b2d84c3845 Mon Sep 17 00:00:00 2001 From: Techatrix <19954306+Techatrix@users.noreply.github.com> Date: Sun, 29 Jan 2023 17:37:48 +0100 Subject: [PATCH 28/84] zig fmt: fix file ending in a multi line comment --- lib/std/zig/parser_test.zig | 9 +++++++++ lib/std/zig/render.zig | 3 +-- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/lib/std/zig/parser_test.zig b/lib/std/zig/parser_test.zig index 42eb1abdde..49b0715695 100644 --- a/lib/std/zig/parser_test.zig +++ b/lib/std/zig/parser_test.zig @@ -186,6 +186,15 @@ test "zig fmt: file ends in comment" { ); } +test "zig fmt: file ends in multi line comment" { + try testTransform( + \\ \\foobar + , + \\\\foobar + \\ + ); +} + test "zig fmt: file ends in comment after var decl" { try testTransform( \\const x = 42; diff --git a/lib/std/zig/render.zig b/lib/std/zig/render.zig index bfee5b0599..1145007ff3 100644 --- a/lib/std/zig/render.zig +++ b/lib/std/zig/render.zig @@ -2759,8 +2759,7 @@ fn tokenSliceForRender(tree: Ast, token_index: Ast.TokenIndex) []const u8 { var ret = tree.tokenSlice(token_index); switch (tree.tokens.items(.tag)[token_index]) { .multiline_string_literal_line => { - assert(ret[ret.len - 1] == '\n'); - ret.len -= 1; + if (ret[ret.len - 1] == '\n') ret.len -= 1; }, .container_doc_comment, .doc_comment => { ret = mem.trimRight(u8, ret, &std.ascii.whitespace); From 720d82721fa6013b2e7e7ff2866db9404bfd2901 Mon Sep 17 00:00:00 2001 From: Veikka Tuominen Date: Sun, 22 Jan 2023 17:26:32 +0200 Subject: [PATCH 29/84] Sema: ensure args to inline comptime args are comptime-known Closes #14413 --- src/Sema.zig | 5 +++++ ...ine_call_runtime_value_to_comptime_param.zig | 17 +++++++++++++++++ 2 files changed, 22 insertions(+) create mode 100644 test/cases/compile_errors/inline_call_runtime_value_to_comptime_param.zig diff --git a/src/Sema.zig b/src/Sema.zig index 9c553a0092..3b744a4f78 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -6879,6 +6879,8 @@ fn analyzeInlineCallArg( if (err == error.AnalysisFail and param_block.comptime_reason != null) try param_block.comptime_reason.?.explain(sema, sema.err); return err; }; + } else if (!is_comptime_call and zir_tags[inst] == .param_comptime) { + _ = try sema.resolveConstMaybeUndefVal(arg_block, arg_src, uncasted_arg, "parameter is comptime"); } const casted_arg = sema.coerceExtra(arg_block, param_ty, uncasted_arg, arg_src, .{ .param_src = .{ .func_inst = func_inst, @@ -6952,6 +6954,9 @@ fn analyzeInlineCallArg( .val = arg_val, }; } else { + if (zir_tags[inst] == .param_anytype_comptime) { + _ = try sema.resolveConstMaybeUndefVal(arg_block, arg_src, uncasted_arg, "parameter is comptime"); + } sema.inst_map.putAssumeCapacityNoClobber(inst, uncasted_arg); } diff --git a/test/cases/compile_errors/inline_call_runtime_value_to_comptime_param.zig b/test/cases/compile_errors/inline_call_runtime_value_to_comptime_param.zig new file mode 100644 index 0000000000..cddd91384b --- /dev/null +++ b/test/cases/compile_errors/inline_call_runtime_value_to_comptime_param.zig @@ -0,0 +1,17 @@ +inline fn needComptime(comptime a: u64) void { + if (a != 0) @compileError("foo"); +} +fn acceptRuntime(value: u64) void { + needComptime(value); +} +pub export fn entry() void { + var value: u64 = 0; + acceptRuntime(value); +} + +// error +// backend=stage2 +// target=native +// +// :5:18: error: unable to resolve comptime value +// :5:18: note: parameter is comptime From dd300d47b22c740ab75ace54057a3831606f7952 Mon Sep 17 00:00:00 2001 From: Veikka Tuominen Date: Mon, 23 Jan 2023 20:23:12 +0200 Subject: [PATCH 30/84] add test for already implemented proposal Closes #1564 --- test/behavior/sizeof_and_typeof.zig | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/test/behavior/sizeof_and_typeof.zig b/test/behavior/sizeof_and_typeof.zig index ef4487d9b9..cfe948ac02 100644 --- a/test/behavior/sizeof_and_typeof.zig +++ b/test/behavior/sizeof_and_typeof.zig @@ -292,3 +292,12 @@ test "@sizeOf optional of previously unresolved union" { const Node = union { a: usize }; try expect(@sizeOf(?Node) == @sizeOf(Node) + @alignOf(Node)); } + +test "@offsetOf zero-bit field" { + const S = packed struct { + a: u32, + b: u0, + c: u32, + }; + try expect(@offsetOf(S, "b") == @offsetOf(S, "c")); +} From b129350cb5de2251d50b142a50d8d74ccd92ae73 Mon Sep 17 00:00:00 2001 From: Veikka Tuominen Date: Fri, 27 Jan 2023 15:54:11 +0200 Subject: [PATCH 31/84] AstGen: fix crash on invalid decltest Closes #14476 --- src/AstGen.zig | 29 ++++++++++++++++++- .../cases/compile_errors/invalid_decltest.zig | 13 +++++++++ 2 files changed, 41 insertions(+), 1 deletion(-) create mode 100644 test/cases/compile_errors/invalid_decltest.zig diff --git a/src/AstGen.zig b/src/AstGen.zig index 15b3611a1e..df111906e6 100644 --- a/src/AstGen.zig +++ b/src/AstGen.zig @@ -4278,7 +4278,34 @@ fn testDecl( var num_namespaces_out: u32 = 0; var capturing_namespace: ?*Scope.Namespace = null; while (true) switch (s.tag) { - .local_val, .local_ptr => unreachable, // a test cannot be in a local scope + .local_val => { + const local_val = s.cast(Scope.LocalVal).?; + if (local_val.name == name_str_index) { + local_val.used = test_name_token; + return astgen.failTokNotes(test_name_token, "cannot test a {s}", .{ + @tagName(local_val.id_cat), + }, &[_]u32{ + try astgen.errNoteTok(local_val.token_src, "{s} declared here", .{ + @tagName(local_val.id_cat), + }), + }); + } + s = local_val.parent; + }, + .local_ptr => { + const local_ptr = s.cast(Scope.LocalPtr).?; + if (local_ptr.name == name_str_index) { + local_ptr.used = test_name_token; + return astgen.failTokNotes(test_name_token, "cannot test a {s}", .{ + @tagName(local_ptr.id_cat), + }, &[_]u32{ + try astgen.errNoteTok(local_ptr.token_src, "{s} declared here", .{ + @tagName(local_ptr.id_cat), + }), + }); + } + s = local_ptr.parent; + }, .gen_zir => s = s.cast(GenZir).?.parent, .defer_normal, .defer_error => s = s.cast(Scope.Defer).?.parent, .namespace, .enum_namespace => { diff --git a/test/cases/compile_errors/invalid_decltest.zig b/test/cases/compile_errors/invalid_decltest.zig new file mode 100644 index 0000000000..cde984f366 --- /dev/null +++ b/test/cases/compile_errors/invalid_decltest.zig @@ -0,0 +1,13 @@ +export fn foo() void { + const a = 1; + struct { + test a {} + }; +} + +// error +// backend=stage2 +// target=native +// +// :4:14: error: cannot test a local constant +// :2:11: note: local constant declared here From a9785fe8eef564011b4266e8a1b9aa15b7e37189 Mon Sep 17 00:00:00 2001 From: Veikka Tuominen Date: Fri, 27 Jan 2023 16:03:51 +0200 Subject: [PATCH 32/84] Sema: add helpful notes to invalid `@ptrCast` operations Closes #14474 --- doc/langref.html.in | 9 +++++++++ src/Sema.zig | 11 ++++++++++- .../increase_pointer_alignment_in_ptrCast.zig | 1 + 3 files changed, 20 insertions(+), 1 deletion(-) diff --git a/doc/langref.html.in b/doc/langref.html.in index fd4aa8ae76..e1521795ca 100644 --- a/doc/langref.html.in +++ b/doc/langref.html.in @@ -8799,6 +8799,15 @@ pub const PrefetchOptions = struct { {#link|Optional Pointers#} are allowed. Casting an optional pointer which is {#link|null#} to a non-optional pointer invokes safety-checked {#link|Undefined Behavior#}.

+

+ {#syntax#}@ptrCast{#endsyntax#} cannot be used for: +

+
    +
  • Removing {#syntax#}const{#endsyntax#} or {#syntax#}volatile{#endsyntax#} qualifier. TODO add a {#syntax#}@qualCast{#endsyntax#} builtin.
    • +
  • Changing pointer address space, use {#link|@addrSpaceCast#}
    • +
  • Increasing pointer alignment, use {#link|@alignCast#}
    • +
  • Casting a non-slice pointer to a slice, use slicing syntax {#syntax#}ptr[start..end]{#endsyntax#}
    • +
{#header_close#} {#header_open|@ptrToInt#} diff --git a/src/Sema.zig b/src/Sema.zig index 3b744a4f78..712a684bf8 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -19535,7 +19535,14 @@ fn zirPtrCast(sema: *Sema, block: *Block, inst: Zir.Inst.Index) CompileError!Air return sema.fail(block, src, "cast discards volatile qualifier", .{}); } if (operand_info.@"addrspace" != dest_info.@"addrspace") { - return sema.fail(block, src, "cast changes pointer address space", .{}); + const msg = msg: { + const msg = try sema.errMsg(block, src, "cast changes pointer address space", .{}); + errdefer msg.destroy(sema.gpa); + + try sema.errNote(block, src, msg, "consider using '@addrSpaceCast'", .{}); + break :msg msg; + }; + return sema.failWithOwnedErrorMsg(msg); } const dest_is_slice = dest_ty.isSlice(); @@ -19590,6 +19597,8 @@ fn zirPtrCast(sema: *Sema, block: *Block, inst: Zir.Inst.Index) CompileError!Air try sema.errNote(block, dest_ty_src, msg, "'{}' has alignment '{d}'", .{ dest_ty.fmt(sema.mod), dest_align, }); + + try sema.errNote(block, src, msg, "consider using '@alignCast'", .{}); break :msg msg; }; return sema.failWithOwnedErrorMsg(msg); diff --git a/test/cases/compile_errors/increase_pointer_alignment_in_ptrCast.zig b/test/cases/compile_errors/increase_pointer_alignment_in_ptrCast.zig index 9cc5ed3a42..242454e859 100644 --- a/test/cases/compile_errors/increase_pointer_alignment_in_ptrCast.zig +++ b/test/cases/compile_errors/increase_pointer_alignment_in_ptrCast.zig @@ -11,3 +11,4 @@ export fn entry() u32 { // :3:17: error: cast increases pointer alignment // :3:32: note: '*u8' has alignment '1' // :3:26: note: '*u32' has alignment '4' +// :3:17: note: consider using '@alignCast' From fe4ea31f7e9e1c8caea6a1df107b91e8ea1a7b8a Mon Sep 17 00:00:00 2001 From: Veikka Tuominen Date: Fri, 27 Jan 2023 16:04:58 +0200 Subject: [PATCH 33/84] Sema: replace backticks with single quotes Most error messages already use single quotes for everything so this makes the remaining ones consistent. --- src/Sema.zig | 10 +++++----- ...ionals_with_a_function_that_returns_an_optional.zig | 2 +- test/cases/compile_errors/discarding_error_value.zig | 2 +- .../helpful_return_type_error_message.zig | 4 ++-- .../compile_errors/ignored_deferred_function_call.zig | 2 +- .../ignored_expression_in_while_continuation.zig | 6 +++--- ...on_of_optional_anyopaque_to_anyopaque_must_fail.zig | 2 +- ...properly_when_assigning_a_value_within_a_struct.zig | 2 +- ...ation_incompatibility_mismatching_handle_is_ptr.zig | 2 +- ...tibility_mismatching_handle_is_ptr_generic_call.zig | 2 +- 10 files changed, 17 insertions(+), 17 deletions(-) diff --git a/src/Sema.zig b/src/Sema.zig index 712a684bf8..b4731d9509 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -3294,7 +3294,7 @@ fn ensureResultUsed( const msg = msg: { const msg = try sema.errMsg(block, src, "error is ignored", .{}); errdefer msg.destroy(sema.gpa); - try sema.errNote(block, src, msg, "consider using `try`, `catch`, or `if`", .{}); + try sema.errNote(block, src, msg, "consider using 'try', 'catch', or 'if'", .{}); break :msg msg; }; return sema.failWithOwnedErrorMsg(msg); @@ -3325,7 +3325,7 @@ fn zirEnsureResultNonError(sema: *Sema, block: *Block, inst: Zir.Inst.Index) Com const msg = msg: { const msg = try sema.errMsg(block, src, "error is discarded", .{}); errdefer msg.destroy(sema.gpa); - try sema.errNote(block, src, msg, "consider using `try`, `catch`, or `if`", .{}); + try sema.errNote(block, src, msg, "consider using 'try', 'catch', or 'if'", .{}); break :msg msg; }; return sema.failWithOwnedErrorMsg(msg); @@ -8477,7 +8477,7 @@ fn handleExternLibName( return sema.fail( block, src_loc, - "dependency on dynamic library '{s}' requires enabling Position Independent Code. Fixed by `-l{s}` or `-fPIC`.", + "dependency on dynamic library '{s}' requires enabling Position Independent Code. Fixed by '-l{s}' or '-fPIC'.", .{ lib_name, lib_name }, ); } @@ -25150,7 +25150,7 @@ fn coerceExtra( (try sema.coerceInMemoryAllowed(block, inst_ty.errorUnionPayload(), dest_ty, false, target, dest_ty_src, inst_src)) == .ok) { try sema.errNote(block, inst_src, msg, "cannot convert error union to payload type", .{}); - try sema.errNote(block, inst_src, msg, "consider using `try`, `catch`, or `if`", .{}); + try sema.errNote(block, inst_src, msg, "consider using 'try', 'catch', or 'if'", .{}); } // ?T to T @@ -25159,7 +25159,7 @@ fn coerceExtra( (try sema.coerceInMemoryAllowed(block, inst_ty.optionalChild(&buf), dest_ty, false, target, dest_ty_src, inst_src)) == .ok) { try sema.errNote(block, inst_src, msg, "cannot convert optional to payload type", .{}); - try sema.errNote(block, inst_src, msg, "consider using `.?`, `orelse`, or `if`", .{}); + try sema.errNote(block, inst_src, msg, "consider using '.?', 'orelse', or 'if'", .{}); } try in_memory_result.report(sema, block, inst_src, msg); diff --git a/test/cases/compile_errors/assigning_to_struct_or_union_fields_that_are_not_optionals_with_a_function_that_returns_an_optional.zig b/test/cases/compile_errors/assigning_to_struct_or_union_fields_that_are_not_optionals_with_a_function_that_returns_an_optional.zig index 762eb284f2..530e5ffb74 100644 --- a/test/cases/compile_errors/assigning_to_struct_or_union_fields_that_are_not_optionals_with_a_function_that_returns_an_optional.zig +++ b/test/cases/compile_errors/assigning_to_struct_or_union_fields_that_are_not_optionals_with_a_function_that_returns_an_optional.zig @@ -20,4 +20,4 @@ export fn entry() void { // // :11:27: error: expected type 'u8', found '?u8' // :11:27: note: cannot convert optional to payload type -// :11:27: note: consider using `.?`, `orelse`, or `if` +// :11:27: note: consider using '.?', 'orelse', or 'if' diff --git a/test/cases/compile_errors/discarding_error_value.zig b/test/cases/compile_errors/discarding_error_value.zig index 6dfe0be231..c24d517d3e 100644 --- a/test/cases/compile_errors/discarding_error_value.zig +++ b/test/cases/compile_errors/discarding_error_value.zig @@ -10,4 +10,4 @@ fn foo() !void { // target=native // // :2:12: error: error is discarded -// :2:12: note: consider using `try`, `catch`, or `if` +// :2:12: note: consider using 'try', 'catch', or 'if' diff --git a/test/cases/compile_errors/helpful_return_type_error_message.zig b/test/cases/compile_errors/helpful_return_type_error_message.zig index b8e48036de..871e948537 100644 --- a/test/cases/compile_errors/helpful_return_type_error_message.zig +++ b/test/cases/compile_errors/helpful_return_type_error_message.zig @@ -26,7 +26,7 @@ export fn quux() u32 { // :11:15: error: expected type 'u32', found '@typeInfo(@typeInfo(@TypeOf(tmp.bar)).Fn.return_type.?).ErrorUnion.error_set!u32' // :10:17: note: function cannot return an error // :11:15: note: cannot convert error union to payload type -// :11:15: note: consider using `try`, `catch`, or `if` +// :11:15: note: consider using 'try', 'catch', or 'if' // :15:14: error: expected type 'u32', found '@typeInfo(@typeInfo(@TypeOf(tmp.bar)).Fn.return_type.?).ErrorUnion.error_set!u32' // :15:14: note: cannot convert error union to payload type -// :15:14: note: consider using `try`, `catch`, or `if` +// :15:14: note: consider using 'try', 'catch', or 'if' diff --git a/test/cases/compile_errors/ignored_deferred_function_call.zig b/test/cases/compile_errors/ignored_deferred_function_call.zig index 05c4373705..b318baa16c 100644 --- a/test/cases/compile_errors/ignored_deferred_function_call.zig +++ b/test/cases/compile_errors/ignored_deferred_function_call.zig @@ -8,4 +8,4 @@ fn bar() anyerror!i32 { return 0; } // target=native // // :2:14: error: error is ignored -// :2:14: note: consider using `try`, `catch`, or `if` +// :2:14: note: consider using 'try', 'catch', or 'if' diff --git a/test/cases/compile_errors/ignored_expression_in_while_continuation.zig b/test/cases/compile_errors/ignored_expression_in_while_continuation.zig index d7de0aac57..d108903c82 100644 --- a/test/cases/compile_errors/ignored_expression_in_while_continuation.zig +++ b/test/cases/compile_errors/ignored_expression_in_while_continuation.zig @@ -18,8 +18,8 @@ fn bad() anyerror!void { // target=native // // :2:24: error: error is ignored -// :2:24: note: consider using `try`, `catch`, or `if` +// :2:24: note: consider using 'try', 'catch', or 'if' // :6:25: error: error is ignored -// :6:25: note: consider using `try`, `catch`, or `if` +// :6:25: note: consider using 'try', 'catch', or 'if' // :10:25: error: error is ignored -// :10:25: note: consider using `try`, `catch`, or `if` +// :10:25: note: consider using 'try', 'catch', or 'if' diff --git a/test/cases/compile_errors/issue_5618_coercion_of_optional_anyopaque_to_anyopaque_must_fail.zig b/test/cases/compile_errors/issue_5618_coercion_of_optional_anyopaque_to_anyopaque_must_fail.zig index f4716bc24d..95bba054b3 100644 --- a/test/cases/compile_errors/issue_5618_coercion_of_optional_anyopaque_to_anyopaque_must_fail.zig +++ b/test/cases/compile_errors/issue_5618_coercion_of_optional_anyopaque_to_anyopaque_must_fail.zig @@ -10,5 +10,5 @@ export fn foo() void { // // :4:9: error: expected type '*anyopaque', found '?*anyopaque' // :4:9: note: cannot convert optional to payload type -// :4:9: note: consider using `.?`, `orelse`, or `if` +// :4:9: note: consider using '.?', 'orelse', or 'if' // :4:9: note: '?*anyopaque' could have null values which are illegal in type '*anyopaque' diff --git a/test/cases/compile_errors/regression_test_2980_base_type_u32_is_not_type_checked_properly_when_assigning_a_value_within_a_struct.zig b/test/cases/compile_errors/regression_test_2980_base_type_u32_is_not_type_checked_properly_when_assigning_a_value_within_a_struct.zig index 09c496211a..1b951528bb 100644 --- a/test/cases/compile_errors/regression_test_2980_base_type_u32_is_not_type_checked_properly_when_assigning_a_value_within_a_struct.zig +++ b/test/cases/compile_errors/regression_test_2980_base_type_u32_is_not_type_checked_properly_when_assigning_a_value_within_a_struct.zig @@ -20,4 +20,4 @@ export fn entry() void { // // :12:25: error: expected type 'u32', found '@typeInfo(@typeInfo(@TypeOf(tmp.get_uval)).Fn.return_type.?).ErrorUnion.error_set!u32' // :12:25: note: cannot convert error union to payload type -// :12:25: note: consider using `try`, `catch`, or `if` +// :12:25: note: consider using 'try', 'catch', or 'if' diff --git a/test/cases/compile_errors/result_location_incompatibility_mismatching_handle_is_ptr.zig b/test/cases/compile_errors/result_location_incompatibility_mismatching_handle_is_ptr.zig index cc1d2c976a..26c1a8d9cf 100644 --- a/test/cases/compile_errors/result_location_incompatibility_mismatching_handle_is_ptr.zig +++ b/test/cases/compile_errors/result_location_incompatibility_mismatching_handle_is_ptr.zig @@ -17,4 +17,4 @@ pub const Container = struct { // // :3:36: error: expected type 'i32', found '?i32' // :3:36: note: cannot convert optional to payload type -// :3:36: note: consider using `.?`, `orelse`, or `if` +// :3:36: note: consider using '.?', 'orelse', or 'if' diff --git a/test/cases/compile_errors/result_location_incompatibility_mismatching_handle_is_ptr_generic_call.zig b/test/cases/compile_errors/result_location_incompatibility_mismatching_handle_is_ptr_generic_call.zig index 897675d448..471f9cca04 100644 --- a/test/cases/compile_errors/result_location_incompatibility_mismatching_handle_is_ptr_generic_call.zig +++ b/test/cases/compile_errors/result_location_incompatibility_mismatching_handle_is_ptr_generic_call.zig @@ -17,4 +17,4 @@ pub const Container = struct { // // :3:36: error: expected type 'i32', found '?i32' // :3:36: note: cannot convert optional to payload type -// :3:36: note: consider using `.?`, `orelse`, or `if` +// :3:36: note: consider using '.?', 'orelse', or 'if' From f16c10a86b7183e99e54a70344f4681211cd52bb Mon Sep 17 00:00:00 2001 From: Veikka Tuominen Date: Fri, 27 Jan 2023 20:25:48 +0200 Subject: [PATCH 34/84] implement `@qualCast` --- doc/langref.html.in | 15 +++-- lib/std/child_process.zig | 4 +- lib/std/fs.zig | 2 +- lib/std/os.zig | 2 +- lib/std/os/windows.zig | 14 ++--- lib/std/zig/c_translation.zig | 2 +- src/AstGen.zig | 2 + src/BuiltinFn.zig | 8 +++ src/Sema.zig | 62 ++++++++++++++++++- src/Zir.zig | 6 ++ src/print_zir.zig | 1 + .../cases/compile_errors/invalid_qualcast.zig | 12 ++++ .../ptrCast_discards_const_qualifier.zig | 1 + 13 files changed, 113 insertions(+), 18 deletions(-) create mode 100644 test/cases/compile_errors/invalid_qualcast.zig diff --git a/doc/langref.html.in b/doc/langref.html.in index e1521795ca..8c7781ee42 100644 --- a/doc/langref.html.in +++ b/doc/langref.html.in @@ -8803,10 +8803,10 @@ pub const PrefetchOptions = struct { {#syntax#}@ptrCast{#endsyntax#} cannot be used for:

    -
  • Removing {#syntax#}const{#endsyntax#} or {#syntax#}volatile{#endsyntax#} qualifier. TODO add a {#syntax#}@qualCast{#endsyntax#} builtin.
    • -
  • Changing pointer address space, use {#link|@addrSpaceCast#}
    • -
  • Increasing pointer alignment, use {#link|@alignCast#}
    • -
  • Casting a non-slice pointer to a slice, use slicing syntax {#syntax#}ptr[start..end]{#endsyntax#}
    • +
  • Removing {#syntax#}const{#endsyntax#} or {#syntax#}volatile{#endsyntax#} qualifier, use {#link|@qualCast#}.
    • +
  • Changing pointer address space, use {#link|@addrSpaceCast#}.
    • +
  • Increasing pointer alignment, use {#link|@alignCast#}.
    • +
  • Casting a non-slice pointer to a slice, use slicing syntax {#syntax#}ptr[start..end]{#endsyntax#}.
{#header_close#} @@ -8820,6 +8820,13 @@ pub const PrefetchOptions = struct { {#header_close#} + {#header_open|@qualCast#} + 
{#syntax#}@qualCast(comptime DestType: type, value: anytype) DestType{#endsyntax#}
+

+ Remove {#syntax#}const{#endsyntax#} or {#syntax#}volatile{#endsyntax#} qualifier from a pointer. +

+ {#header_close#} + {#header_open|@rem#} 
{#syntax#}@rem(numerator: T, denominator: T) T{#endsyntax#}

diff --git a/lib/std/child_process.zig b/lib/std/child_process.zig index 4a816c8318..21d7b4fe3e 100644 --- a/lib/std/child_process.zig +++ b/lib/std/child_process.zig @@ -1164,7 +1164,7 @@ fn windowsCreateProcessPathExt( var app_name_unicode_string = windows.UNICODE_STRING{ .Length = app_name_len_bytes, .MaximumLength = app_name_len_bytes, - .Buffer = @intToPtr([*]u16, @ptrToInt(app_name_wildcard.ptr)), + .Buffer = @qualCast([*:0]u16, app_name_wildcard.ptr), }; const rc = windows.ntdll.NtQueryDirectoryFile( dir.fd, @@ -1261,7 +1261,7 @@ fn windowsCreateProcessPathExt( var app_name_unicode_string = windows.UNICODE_STRING{ .Length = app_name_len_bytes, .MaximumLength = app_name_len_bytes, - .Buffer = @intToPtr([*]u16, @ptrToInt(app_name_appended.ptr)), + .Buffer = @qualCast([*:0]u16, app_name_appended.ptr), }; // Re-use the directory handle but this time we call with the appended app name diff --git a/lib/std/fs.zig b/lib/std/fs.zig index 244f3a38ce..2300ad044a 100644 --- a/lib/std/fs.zig +++ b/lib/std/fs.zig @@ -1763,7 +1763,7 @@ pub const Dir = struct { var nt_name = w.UNICODE_STRING{ .Length = path_len_bytes, .MaximumLength = path_len_bytes, - .Buffer = @intToPtr([*]u16, @ptrToInt(sub_path_w)), + .Buffer = @qualCast([*:0]u16, sub_path_w), }; var attr = w.OBJECT_ATTRIBUTES{ .Length = @sizeOf(w.OBJECT_ATTRIBUTES), diff --git a/lib/std/os.zig b/lib/std/os.zig index 32463aa30e..3cee30c32d 100644 --- a/lib/std/os.zig +++ b/lib/std/os.zig @@ -4513,7 +4513,7 @@ pub fn faccessatW(dirfd: fd_t, sub_path_w: [*:0]const u16, mode: u32, flags: u32 var nt_name = windows.UNICODE_STRING{ .Length = path_len_bytes, .MaximumLength = path_len_bytes, - .Buffer = @intToPtr([*]u16, @ptrToInt(sub_path_w)), + .Buffer = @qualCast([*:0]u16, sub_path_w), }; var attr = windows.OBJECT_ATTRIBUTES{ .Length = @sizeOf(windows.OBJECT_ATTRIBUTES), diff --git a/lib/std/os/windows.zig b/lib/std/os/windows.zig index e53387b27c..93e762827b 100644 --- a/lib/std/os/windows.zig +++ b/lib/std/os/windows.zig @@ -85,7 +85,7 @@ pub fn OpenFile(sub_path_w: []const u16, options: OpenFileOptions) OpenError!HAN var nt_name = UNICODE_STRING{ .Length = path_len_bytes, .MaximumLength = path_len_bytes, - .Buffer = @intToPtr([*]u16, @ptrToInt(sub_path_w.ptr)), + .Buffer = @qualCast([*]u16, sub_path_w.ptr), }; var attr = OBJECT_ATTRIBUTES{ .Length = @sizeOf(OBJECT_ATTRIBUTES), @@ -634,7 +634,7 @@ pub fn SetCurrentDirectory(path_name: []const u16) SetCurrentDirectoryError!void var nt_name = UNICODE_STRING{ .Length = path_len_bytes, .MaximumLength = path_len_bytes, - .Buffer = @intToPtr([*]u16, @ptrToInt(path_name.ptr)), + .Buffer = @qualCast([*]u16, path_name.ptr), }; const rc = ntdll.RtlSetCurrentDirectory_U(&nt_name); @@ -766,7 +766,7 @@ pub fn ReadLink(dir: ?HANDLE, sub_path_w: []const u16, out_buffer: []u8) ReadLin var nt_name = UNICODE_STRING{ .Length = path_len_bytes, .MaximumLength = path_len_bytes, - .Buffer = @intToPtr([*]u16, @ptrToInt(sub_path_w.ptr)), + .Buffer = @qualCast([*]u16, sub_path_w.ptr), }; var attr = OBJECT_ATTRIBUTES{ .Length = @sizeOf(OBJECT_ATTRIBUTES), @@ -876,7 +876,7 @@ pub fn DeleteFile(sub_path_w: []const u16, options: DeleteFileOptions) DeleteFil .Length = path_len_bytes, .MaximumLength = path_len_bytes, // The Windows API makes this mutable, but it will not mutate here. - .Buffer = @intToPtr([*]u16, @ptrToInt(sub_path_w.ptr)), + .Buffer = @qualCast([*]u16, sub_path_w.ptr), }; if (sub_path_w[0] == '.' and sub_path_w[1] == 0) { @@ -1414,7 +1414,7 @@ pub fn sendmsg( } pub fn sendto(s: ws2_32.SOCKET, buf: [*]const u8, len: usize, flags: u32, to: ?*const ws2_32.sockaddr, to_len: ws2_32.socklen_t) i32 { - var buffer = ws2_32.WSABUF{ .len = @truncate(u31, len), .buf = @intToPtr([*]u8, @ptrToInt(buf)) }; + var buffer = ws2_32.WSABUF{ .len = @truncate(u31, len), .buf = @qualCast([*]u8, buf) }; var bytes_send: DWORD = undefined; if (ws2_32.WSASendTo(s, @ptrCast([*]ws2_32.WSABUF, &buffer), 1, &bytes_send, flags, to, @intCast(i32, to_len), null, null) == ws2_32.SOCKET_ERROR) { return ws2_32.SOCKET_ERROR; @@ -1876,13 +1876,13 @@ pub fn eqlIgnoreCaseWTF16(a: []const u16, b: []const u16) bool { const a_string = UNICODE_STRING{ .Length = a_bytes, .MaximumLength = a_bytes, - .Buffer = @intToPtr([*]u16, @ptrToInt(a.ptr)), + .Buffer = @qualCast([*]u16, a.ptr), }; const b_bytes = @intCast(u16, b.len * 2); const b_string = UNICODE_STRING{ .Length = b_bytes, .MaximumLength = b_bytes, - .Buffer = @intToPtr([*]u16, @ptrToInt(b.ptr)), + .Buffer = @qualCast([*]u16, b.ptr), }; return ntdll.RtlEqualUnicodeString(&a_string, &b_string, TRUE) == TRUE; } diff --git a/lib/std/zig/c_translation.zig b/lib/std/zig/c_translation.zig index a050e592a2..d33c74d777 100644 --- a/lib/std/zig/c_translation.zig +++ b/lib/std/zig/c_translation.zig @@ -75,7 +75,7 @@ fn castPtr(comptime DestType: type, target: anytype) DestType { const source = ptrInfo(@TypeOf(target)); if (source.is_const and !dest.is_const or source.is_volatile and !dest.is_volatile) - return @intToPtr(DestType, @ptrToInt(target)) + return @qualCast(DestType, target) else if (@typeInfo(dest.child) == .Opaque) // dest.alignment would error out return @ptrCast(DestType, target) diff --git a/src/AstGen.zig b/src/AstGen.zig index df111906e6..a5667ce9e8 100644 --- a/src/AstGen.zig +++ b/src/AstGen.zig @@ -2530,6 +2530,7 @@ fn addEnsureResult(gz: *GenZir, maybe_unused_result: Zir.Inst.Ref, statement: As .bit_size_of, .typeof_log2_int_type, .ptr_to_int, + .qual_cast, .align_of, .bool_to_int, .embed_file, @@ -8037,6 +8038,7 @@ fn builtinCall( .float_cast => return typeCast(gz, scope, ri, node, params[0], params[1], .float_cast), .int_cast => return typeCast(gz, scope, ri, node, params[0], params[1], .int_cast), .ptr_cast => return typeCast(gz, scope, ri, node, params[0], params[1], .ptr_cast), + .qual_cast => return typeCast(gz, scope, ri, node, params[0], params[1], .qual_cast), .truncate => return typeCast(gz, scope, ri, node, params[0], params[1], .truncate), // zig fmt: on diff --git a/src/BuiltinFn.zig b/src/BuiltinFn.zig index b71d96c3dd..80eb739185 100644 --- a/src/BuiltinFn.zig +++ b/src/BuiltinFn.zig @@ -75,6 +75,7 @@ pub const Tag = enum { prefetch, ptr_cast, ptr_to_int, + qual_cast, rem, return_address, select, @@ -674,6 +675,13 @@ pub const list = list: { .param_count = 1, }, }, + .{ + "@qualCast", + .{ + .tag = .qual_cast, + .param_count = 2, + }, + }, .{ "@rem", .{ diff --git a/src/Sema.zig b/src/Sema.zig index b4731d9509..d306c68e08 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -1015,6 +1015,7 @@ fn analyzeBodyInner( .float_cast => try sema.zirFloatCast(block, inst), .int_cast => try sema.zirIntCast(block, inst), .ptr_cast => try sema.zirPtrCast(block, inst), + .qual_cast => try sema.zirQualCast(block, inst), .truncate => try sema.zirTruncate(block, inst), .align_cast => try sema.zirAlignCast(block, inst), .has_decl => try sema.zirHasDecl(block, inst), @@ -19529,10 +19530,24 @@ fn zirPtrCast(sema: *Sema, block: *Block, inst: Zir.Inst.Index) CompileError!Air const operand_info = operand_ty.ptrInfo().data; const dest_info = dest_ty.ptrInfo().data; if (!operand_info.mutable and dest_info.mutable) { - return sema.fail(block, src, "cast discards const qualifier", .{}); + const msg = msg: { + const msg = try sema.errMsg(block, src, "cast discards const qualifier", .{}); + errdefer msg.destroy(sema.gpa); + + try sema.errNote(block, src, msg, "consider using '@qualCast'", .{}); + break :msg msg; + }; + return sema.failWithOwnedErrorMsg(msg); } if (operand_info.@"volatile" and !dest_info.@"volatile") { - return sema.fail(block, src, "cast discards volatile qualifier", .{}); + const msg = msg: { + const msg = try sema.errMsg(block, src, "cast discards volatile qualifier", .{}); + errdefer msg.destroy(sema.gpa); + + try sema.errNote(block, src, msg, "consider using '@qualCast'", .{}); + break :msg msg; + }; + return sema.failWithOwnedErrorMsg(msg); } if (operand_info.@"addrspace" != dest_info.@"addrspace") { const msg = msg: { @@ -19634,6 +19649,49 @@ fn zirPtrCast(sema: *Sema, block: *Block, inst: Zir.Inst.Index) CompileError!Air return block.addBitCast(aligned_dest_ty, ptr); } +fn zirQualCast(sema: *Sema, block: *Block, inst: Zir.Inst.Index) CompileError!Air.Inst.Ref { + const inst_data = sema.code.instructions.items(.data)[inst].pl_node; + const src = inst_data.src(); + const dest_ty_src: LazySrcLoc = .{ .node_offset_builtin_call_arg0 = inst_data.src_node }; + const operand_src: LazySrcLoc = .{ .node_offset_builtin_call_arg1 = inst_data.src_node }; + const extra = sema.code.extraData(Zir.Inst.Bin, inst_data.payload_index).data; + const dest_ty = try sema.resolveType(block, dest_ty_src, extra.lhs); + const operand = try sema.resolveInst(extra.rhs); + const operand_ty = sema.typeOf(operand); + + try sema.checkPtrType(block, dest_ty_src, dest_ty); + try sema.checkPtrOperand(block, operand_src, operand_ty); + + var operand_payload = operand_ty.ptrInfo(); + var dest_info = dest_ty.ptrInfo(); + + operand_payload.data.mutable = dest_info.data.mutable; + operand_payload.data.@"volatile" = dest_info.data.@"volatile"; + + const altered_operand_ty = Type.initPayload(&operand_payload.base); + if (!altered_operand_ty.eql(dest_ty, sema.mod)) { + const msg = msg: { + const msg = try sema.errMsg(block, src, "'@qualCast' can only modify 'const' and 'volatile' qualifiers", .{}); + errdefer msg.destroy(sema.gpa); + + dest_info.data.mutable = !operand_ty.isConstPtr(); + dest_info.data.@"volatile" = operand_ty.isVolatilePtr(); + const altered_dest_ty = Type.initPayload(&dest_info.base); + try sema.errNote(block, src, msg, "expected type '{}'", .{altered_dest_ty.fmt(sema.mod)}); + try sema.errNote(block, src, msg, "got type '{}'", .{operand_ty.fmt(sema.mod)}); + break :msg msg; + }; + return sema.failWithOwnedErrorMsg(msg); + } + + if (try sema.resolveMaybeUndefVal(operand)) |operand_val| { + return sema.addConstant(dest_ty, operand_val); + } + + try sema.requireRuntimeBlock(block, src, null); + return block.addBitCast(dest_ty, operand); +} + fn zirTruncate(sema: *Sema, block: *Block, inst: Zir.Inst.Index) CompileError!Air.Inst.Ref { const inst_data = sema.code.instructions.items(.data)[inst].pl_node; const src = inst_data.src(); diff --git a/src/Zir.zig b/src/Zir.zig index 94e6a9a11a..b93422177e 100644 --- a/src/Zir.zig +++ b/src/Zir.zig @@ -857,6 +857,9 @@ pub const Inst = struct { /// Implements the `@ptrCast` builtin. /// Uses `pl_node` with payload `Bin`. `lhs` is dest type, `rhs` is operand. ptr_cast, + /// Implements the `@qualCast` builtin. + /// Uses `pl_node` with payload `Bin`. `lhs` is dest type, `rhs` is operand. + qual_cast, /// Implements the `@truncate` builtin. /// Uses `pl_node` with payload `Bin`. `lhs` is dest type, `rhs` is operand. truncate, @@ -1195,6 +1198,7 @@ pub const Inst = struct { .float_cast, .int_cast, .ptr_cast, + .qual_cast, .truncate, .align_cast, .has_field, @@ -1484,6 +1488,7 @@ pub const Inst = struct { .float_cast, .int_cast, .ptr_cast, + .qual_cast, .truncate, .align_cast, .has_field, @@ -1755,6 +1760,7 @@ pub const Inst = struct { .float_cast = .pl_node, .int_cast = .pl_node, .ptr_cast = .pl_node, + .qual_cast = .pl_node, .truncate = .pl_node, .align_cast = .pl_node, .typeof_builtin = .pl_node, diff --git a/src/print_zir.zig b/src/print_zir.zig index 6e8923bed9..e5fc8815ed 100644 --- a/src/print_zir.zig +++ b/src/print_zir.zig @@ -332,6 +332,7 @@ const Writer = struct { .float_cast, .int_cast, .ptr_cast, + .qual_cast, .truncate, .align_cast, .div_exact, diff --git a/test/cases/compile_errors/invalid_qualcast.zig b/test/cases/compile_errors/invalid_qualcast.zig new file mode 100644 index 0000000000..20b223b727 --- /dev/null +++ b/test/cases/compile_errors/invalid_qualcast.zig @@ -0,0 +1,12 @@ +pub export fn entry() void { + var a: [*:0]const volatile u16 = undefined; + _ = @qualCast([*]u16, a); +} + +// error +// backend=stage2 +// target=native +// +// :3:9: error: '@qualCast' can only modify 'const' and 'volatile' qualifiers +// :3:9: note: expected type '[*]const volatile u16' +// :3:9: note: got type '[*:0]const volatile u16' diff --git a/test/cases/compile_errors/ptrCast_discards_const_qualifier.zig b/test/cases/compile_errors/ptrCast_discards_const_qualifier.zig index a2fea4ff11..eedef01234 100644 --- a/test/cases/compile_errors/ptrCast_discards_const_qualifier.zig +++ b/test/cases/compile_errors/ptrCast_discards_const_qualifier.zig @@ -9,3 +9,4 @@ export fn entry() void { // target=native // // :3:15: error: cast discards const qualifier +// :3:15: note: consider using '@qualCast' From f3bb1957fa7f317873584cfc0ea8e3fd59283ec2 Mon Sep 17 00:00:00 2001 From: Veikka Tuominen Date: Sun, 29 Jan 2023 23:39:03 +0200 Subject: [PATCH 35/84] update zig1.wasm to include `@qualCast` --- stage1/zig1.wasm | Bin 2369157 -> 2373912 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/stage1/zig1.wasm b/stage1/zig1.wasm index e64e05fa1300ae7254391cbb74786b55abd1e48b..ef7d7891c9aef6a9f65ea39fed25ecb815a38f9d 100644 GIT binary patch delta 437132 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

?dcdO zYFl9gPPPI-uyZy98qlUEaVKhU0bi{HJl}g7T)$>&-8 zDbj-!u;NoB9Gl-eABGg9UGrfT4e59JBv|vg{@^^{KTX=OQ~7X^uh7ikszqKHIm)u_j+pWzDdYCx5$vA%YQ$!EyNDB#=~O@MHg#2`H9EVl!u z0czP2b~sXD!kv?n$0pEF1Q+M3+uPGjX~=hVVG z@buJpyu?h%#hZ>W0mwxq%=aE?Ts`{?-zfx%_;ny>Ir9t~a*ur7qQWAn0yBU&m7|KS zgUne@&4WlKh8d$_ijZT0ye^MDy+?YHyK0B~&~4BHBOa2UYSf5^e4G_NrXa&fQf%?o zYc#r=E;Azmc4cgyp87hvz>Fg2WUx7UdMdn_6AWNS9I2QaUxDQI1t{GDEKVipJXrRwwKe|*sR)g**wBi_xGtv%*@?-H_CAy2kmK~hXMI#mQ zjjejslZHFd>@_SffL^7!%a~Z3uAy;-EVDL^1y~I?QH8*DA66JhufYvlRSlwtiG667 zK-`zbhCq3%Sid?{L1{PY(Ay~GL|ytl>=4t!>rsOEPW9;>#5WA3t?2wh^|Mg=w*U-m zSY!Gz5Y)`Z^nC$(w)(Isl_knz)Ml+|3!O3jJeVq%@JF3Qj;|I0wu-LA7DWigi|`~U;TpcRw`pM4fC~pz9~qD4Q2k8 z6MWVQ=%q59j{|H|XKG|IohkYw6#yB0c%J&K3#~)Q6Xx5E{tU_7ZnVff|ERftVPrY? zDEqNH)F^X}n%kYa<1J=(z6V{5>4ctigc%NGfA^%nq3H3wD4a^htbk~|$?y{^?Mc1Z z{N8jJjai{S>`l)*(p@vuqXXy=3N>TFpU^&ZXF2=v6WSCAEcFxm1I{g8gXlh-WZ3z^ z^aD)m4nYyS)G0$~IK?0PhtXhx7MG~EN6-Oo_@n)|)JH^p2K_)+V*2t2ItP}LGsn~4 z$q7~Zk^bmJPP2)V=qMu|h_t4OuF#3#Bqs;cQg(k5jrQVe5h5qffrT1{<%kokW+L2t}tv;LyZ>8x37&tKHb)zY?5jF}a_z$NeWV6`IYVI1l=BI!|Q zx-EunoJm{L9Wm_oO!_e?W$(|TzCIA0hNlDY(A6cv6lfx$g43UA__iXMeLstS0^5Q^ zvmg^xu+wbn&wOW7z2BY~(AoMX3BovXdNw#MypfAs^}Y62VQ`dj=fVD(O+&p7SD^`- zb#~9DVf0vx`Ve@ids&8E4=c@Jb>nDPTOSs{Q&{^j@8i*N6c=&oKXG)3h(_+O&_fip z_D-O9L6db$p!NU1B+N*lb2&ewINdUDMr*P0415s)^BJ9oN0N0C=_Tw)ViFzT3d^>^ ztEoSBwF#@CA0eZZPUA3Lm`Dys+JjWEzjx3GQlXCC zNhiW5*3=8Ts1qUos@HeJCURvsr!$@$cL|iu_MQ5M|6cw zd32a-I+zL8C^-bCsS@^m9_@{!oq2Q>jR&`R9OAa*GK)S%O|H;a9q~(dE+#j_Wwr@W zWR-gQ6kS7TY$5xrfcp5A!=}{m%0q92{VoRaz}<;5N4{1!7tl_Q

{aOha7?FqE#t zAV~T{R{uO*tGk3BP045H&(n|UKEh{rPoR&357oYeC&NMlKBxu#7`BBl^%1yk&h}lW ze)L8X`}P8Tk7h1n=@)1_dSem0j;XSk1zZG+tX<4L!8C6%i@iwO=^icy*&(dp3i#VA z7pXHzGF=4Clk^*axMM;mSHT zy%bcdSjTpk0zG;?E5$T%Jrk}1K65>L57VRT*?35G*Ve<_q}No>xeBU3T+d$Lf((DJ zXQtbbR;*{$uhE6Nm&oX1X1qq7buk+NVdMyXi~t6Ncz~R|fjztixwdRz)vtqE`5RcT z>!8+y4J`UP6gO)lWOCOsWn!jG$h2r9yL=roZQjVp4bbi6M%EV7dmGvJkm_PGt(n-K z8=zxiCa;_>6$zf2PTcN0GMW2L$ay-Gb;tBxCf3r(rrv;MMtliq9lZ&%*w;6HlUCov zOW>o&1jx1dUUH?jS6;W5e+S0vvE^*b9Z)oC z1$%_)>J_ZPT`)?{3N{+kk`*iw)9EYODNNH=GTl8$kE~=JFnzp|{fz1IRJIn={i*EQ zJ&^M>mHFSN?Hpg?m#?xGvJv-b6Z&^5n*&JQhE*0T1hI$rX${9^O8{}ofsMaSeQUt! z1!?RsPlD&f+(Iu_vlb6vB3!*%9sYpE5pt5@U(6{k5|1IGTadRI3?Tnl7 zgE!5;VGFM2^56ZOamToDo0$On#nTvGrm{0`r4lf>jK5(cHRU$PSHrg23D-6N58oHn z%ky9#!heG|TK=3>D+hlIvq<}L8cepak>#`|eU{E9mV>{$p(d5nD-?YEZ%^s3)H8Pj z8~~L%;A&B>4zgfsEX!1-zp0asOk-}ZXd#XZ z$YYYPpg;s6$ybp5ELUOhw1-Iu0Xy)+X>R<@k~z@n!sBQV zB^xE<{R#;T6(Q##n-)bg?~JW%Ujs`Su$)2`c>Tnhn1oLff&?dCMvwrXngkBmCYg&e zKfQ5)M?rjnBL@jVUS|1LniJoEGobl8TMJ-If`q;(^?s007gJ-f@F%8u!GbSaA1u@| z1Nb_F$ss}{ru##LY1M6aoc<(2qhycAo=rMLws z(?!Uo_T(ED@_i&f1M>Yswzh%rzE^o6zxNVUqYYhvd*vmL5pqQ#d)+`V)hV~+T8ES^ zoMPTkVkBo5Afk#`=Z3-u)#Ho!4mAjTB9dZ?*it~dFVWB%azPQRXeeA5VBYp3Qk3gQ z$obGg%^@Ta=6|`=4(^OkX7KTAChV29%_u^-=6#@G0-*R93u!EL^w)#u~PYwUA4ZTn6L?XW8;F(BDo~n4ZqCmtlf`^%N~{ z5M1ZMx+b1wp-qKAdrPLE(@%#*Ay{%$Q=x@1)l$Miq#Oszy0a{;sSxI#ZLdh?S$4Cj zaH7R73wsVKlnV+Sv}ZH7SsQvB$wfeha&9&gg52}%*>cY^ujWFJP9^rpB8%vJ)TGn` zy+SD3IYKV8V6bYjfG9u9lA8-%BBLNGVYOI=g=>K`=CcGWG7-v#OtJRN@fLC}lJkL_ zXiqKyM5;YviG{xi_@M*P`;fAcEd)c~Onbg`3tuV9-C}_%5Q>70^)7qn91A(R8jxdw zoO@2)-9nfP0U8UbR6-AdL+czH)kLZG~=->}o44h2%f&5K@=76MjO^=-FQQ8WPC;HzdEjFHC@B zX}A!ix^)n|kfTnxFcC5UZX|+lItsr5II)v3M1-`UtFVLUW5A`$sqo!j!%Q`yyC8^G zhrXdV_)Y!&^*DEMzpsw%BWyF^UMBccVYn~M6;Ts~fdcNp&-^Yl!RUnahY-&lA&VBK zYr9|p#*lfR+szf`v5RVpX+o0DXme2}xF3n1bcU1h(%C{iibv+oal&5DWecJW5!~TB zYK!y<^0Ec&Qk>A)r3AuPX0>3!$b=T`)49UWB!v~u6-MA0d-HhV5MHiRUn~&TQ+-)3 z@IQlppqiVQP=~s%w%*zBHpHmclZ0#x{HVz*gaHzSZpzaHKS*5CF;VNM3!f9`V*KKv zv;69qx*$XFtQ7UZ+kPy2jj##wM64BxaR=CSolva?g!=mJ5&Dwq>p)|uXOK?wSgCnz z!(O3|dj;GWG!F>agDg|8?G-wRWSVL^D6|pXV<66Brt0LV^K4A6z&ui5N|p1uhk`{L zbhh&2%y3jVIAm)vJgNs z6WGPe!XF3^y#mb%@XRa12q#NJv4VC1Aud|<0_IFA8`!CK0XQ+K-Aje00?hrtUKg_X z#fC;Vg%}=r*>+1fZ0%9=ZVP?*z24IMLY&q+(8E^h9W45Ru#(JY^&bifEze-P9}4HN z%OyM#oCsx8SW3CjoNmrwMdiY;j%*6-a`L9KaZd$5_T6K_o#stpe?1m@A;;0jLXY6Q zslefActGKjBj2RKg3-CLgBz?DAwU2T3CPgmi7>TR$ws)|;Z~VZ<4BmsPCpSA+7~tu z; zAR0e|y%fbWG_?xbvD1!Xb6SzcbWUP8eVxX-JBf?QTz1V#yh`s)W`~^NK0#&?D{~fqXfDBmrHn+t zzorPoT`7q60)xWm9k7SP>|IU(fHa;0M?6}2I*Y3&Hh=HZbZ8C=DmihLy15d*9yLk* zKrLJTimLfbr?ZEUpWdI&g7o4bNBrJ`d~`C4)Qk8T1eTx|i)hw#_N|NPO|R_LPQ(avNs0t6J2yEgc_XL-0EUI7FAtzCW-2- z>f$=$oU7UJ0cH73j7H}z$H28Y7|LOz*x2Zi5N52#e)A9+Sd5N8Tu0=!ZxZ)VlX+0)@cNJg@sVROz-RVleTx*43;LOd;@z zLiq&iS6B2Vci7i;#l|F#CDaw8vD??G2epFq%X(sM5}(k;_@VG`)J#@XPYf5LCeLJ^ z^~FvcGo-%Qkz*EFFqbTt+M(jdoM%EPj3ww>Pea8<&X5~-1Yq>#-Hc(JKCFRR>f#1s zUAtE4)ZO^G+PI;ZK>Tg$Lr4Z34);JtZq&>owX~6_BhWDYn}|mCvauLS7P2}`#D*HG zBes=OZ(~<>wu#t_++?OOu@?4@@G$X5XgYOsm{^Tq+wExzPGZY3R@zhyrPrdFzM1HQ z40W4{btp3QX<=pXV$)iP9`s~1Thsy$Hx?XMceW5WQCfPGjcYCX(c+_Qc55*K#Raz! z9}9cIYBk%6i|L|i>Xx=*8TaZ--xJ3{ld5j*#lf^@(Jk&~px40FVC^qL@aqD9bP$`7 z3+jdr;(nd;OYBF%8oOpNNw}Dqxplo=xF1V-QO`Xpg7>M1CR5{X`6IRjlo2+6XD|-H^^@jZp5kko^t#8?7{OZ`6+$C1C) zoX^DG0*yY-T*in~o#J7E0(++t#>R*fpo=m0uf)%s&c?y&sg9=9aOV7ts3&LH)vv@; zW)4pVHR`Ma;V7Yr$JL?;Q4sJD?EH7)m&6vAcLLGY$Ug6AL%tVzM7`{LF%MRyTYeB< zIN{Q7<8R_t2)Q3)V}2J~L8>PIE;2{m5;)ol)G^mvu0HC(sbY#(ATDwZuV72eoj)Au zz{OKJ1*SLHmqD+%zn&Qvi3MaUyR}GcPPVB&i$y=a&S||wY%M^L|GQ=4AT06FGI1HD zxy#itE5u)1Xv$sn(gty{pwuvv?!s5-HgE&B3$)s!SFjOY+O%Yg+#a5y~hcf95 z3t8$RaRo%US_r=1`SpFvrYA%XQdD$Ylit4BpodzrA1!Ln4RV_1`IEUiFn1Of7*0vNE{*axS@ z)*h#F!2=NU*R;&5`~{~)H^DtU&$=sjkW=#5rZeIX_DBLqwdq+{hd}&3uvm;E=U8U3 zI0=%5=S3g?r*j}Y$Kzk_utPW(%OQw>IRSK+jXp0PL=Ro>0@M=Hk1l{$f%K;f;un~n zzW_6ymin>A7sXmN`SMi<`}@kPPIc5p5pK3zR40~*3v}cKbGM07aREQ)%vo7VX2Wlyy@x#!-i!}ayP0I%Eep}uD^7AF1|-|PO#sfgY!sDVNain z9qGPo*79$03%!-b?*0w*M`>!^e?(tC8+EP_SJSo0>~4iPi)J5V6JEfy_hu7Iej)au z(VN-*7vNeUa_;l57*5jJkbhz3fMt89SE4^#_EMBs{!!VD2x)0G9ev?1U@) zTQ9{SX4dA_*1>}*yv$*E#Hzm(Ycl1Pcmk$q^|RL^e4zXBDmD3yxCbMs!->=q-W%>x z=L=FYcN5Jd>9IiL&#NKM5&`FSUaeP6N+;wz%hyYdYhKU?5xbQn#%G-(4Ck5A1s)}u z?`>AOf4S2|`V@}%eO;x|a4P+WtK?2dHj8zWzMJ?75ppUHCbGun-d!uAcX=VClT(XCI?77Z0S*38d`}dwss{Z7k0L` zl#l`Z?qx6)j?J}4({0O5wJT# z87wkTYDZ(1sXGFtqa@%sSj)OYkAmrd{~0b(j)k8PF0BMss0!u)uZlq5*+1&E7kP6l7aW!9rdLCbr)03E^`&|N zmN2VJ8=*eTO_pdTe-D_L!G5VPjiIR->{5Lx36>aaVyN^j%`RiNLZvvY(hysZa%jcDjXqpQQ;T?|7Jt< zu{c8w=p)S#-OZ5_jFU)kPf6XFNtiKUk^-4@c?`mi$R9 z>poa&BgDX3KWeblpHBOi6%LjrK&IY9qe^N!)nK4nS0en5!TFKW4CGrf zO7dfWjsitBpshCXIN_qAa=7E(C@B&m0_wM;rSJF^q>GhE{rhb43!R7R@x4^4`){!!RX0KUfs!@s*NM`YfjYSY?xdJ^+M;1U z4U!r=Y$Y;;Pu<7Mw4bZd1c==PW;vZnG~9rbbr(-qs=)6lg0Bh8@HISS2B?VoazAB~ z*r?y6u0&E-{U){I-MVCw6px{ralcDVFzm7PcgbIH-tZFs{zM(TL^rN(MXJ z;7F<54g{82cHs4>s?E3!jUE%r{M#_Rd|fg4?pq3 zeVhit+>Nv;8pM|raBjgNHh!|yjcu3;?;t?if~iu7ohompO8nODtZ1pF9r{SLRPLFF zPvry(3j{f2tQ!>__yXbhG|9(z##tocA*&Ny0o{RbCcq(4xP8XnPLl>;LGz|d{_Kb8 zlCyUf1U})faf~!i3othe;8!%3y59Sdiq{UbNdu_($2KeiuFR60$zgUPMry|D&5%62 zw;;RTp8fx~u#aX+_1TpfTHg+x32J^n14=o`=Eg`o`~tYTFh@Y4UA<3Xd0zJAnbk8h zfv}BOT{26mD_n<(cwUU;VMh2fuKsH_W)?`gkq1{V|C=PpYUR8$ONw=0Vq0cXc|jhF zo-OgqWr49$qX5g@ryz(?*v2b<_7-kwII<>j(x>cbtTw=(#!C3@N7i`GyB#hiu2P5F z9`|2Z=1Pt=%%^&;vaQE=i+`6ldtN1R1@qoz>8ey>8KJz(lE0u5%bf)<3RoPATqw=6 zIVyZMZgo_Gc?gbS@d;X`cO*cj-Er(A_P=E^vR@J<9)6siC}nt}ZYxDl}XzZGaWch1F7T zlC0KAlZFxZ=oIS&=pesZ#^TbYY^-(94DgVUPRx*IVk)eW-m?V8>sOg62Ck8YgK09? zNHIPTAa8dN7KbV9_k%DhVLlcQNuSd43+fk#B)H0&a#4*q4C_Ak6!>d6=9$+)PCUhq z9FZEn^R|%WO75OPnJ3{^EQT|1i3Mki+4eBpea<<_nqQK({||hs>t(4M9^db$nK?Ks$3aOJ!mZ^d7>71MZZqQlxBN0*|1h%Y;u3lu$Dt=7^ zr^IjJW=A@Q;Pr&dSiQVJgOC=Xms4z<-{|FSHrm&E`R#UmB`#yWui#?YHY+qnFJH3B z{8BGJjhboU{6a5hv2I;;p^@pg`JE8VK1wgovOy#D{M#aC(Vs$)6dtSsger}IJ0oxy zV1|Z+f*f-B58Ok!YLz!kFVC^5I#e&`Y7(%lA$s`;LXn!l!64AaI!G_y)pW(eKGDk? zIL+l_z5FT>ADnO{2Ev6FZWosUdU-9}LpH10UoS7U$@&QH-q>XI)5~i#S$*~L3y{UW z?WU_1scLdQ)XV2>Dt@4sQ*Cm3!xKT90eb1>2R5la;l7S0wFk6^O~dYbd9Nn98{F=( zwP9Did_|Ltrs$%Nl#}3_8fNu7>*d9^Vr9L&-d43vdikcU5j*PTG#h6)$X2Ja9Eg~FHh`S%;(p$Hq?L+4?b z3SW-}fk>=Q26=+?@~XAGP^@(z+|J@pI%S051?mHh z6V-zksITD97@K9o3)Evrxf<}E6WsE$ZeR>1)iXu;V-Lr zXNDK33Gl}(Kplc97XJ@Cx-5{4qs<(6;aj^?_C$%m+`6UvTMM zCcH#lsZ|GQ@Dg?39?bVCF9PnZz2Vov@YdQTThTDtE}CK09&WDTs&=9Fj1=y!fh2j) zJ*+E!YyqFP7I0w0L#A@M{ zHT;UgF5YEum3{dUZ-EG`owH%>)O7kzO zp`Yqj@QLEYC|w%AwKd^$T|?V?0Ufw?;lkIrJ3rU)9ah&bbbO)q*B82>5OXR1LiaJL zHWmJg7hI)xFid5w$LNB|RCU-GT`VyzfazCGfe5Q%ru9M_zt~_2g7muJ+ERV*Yu&$; z7M*0R$Lcyjs{S%ow~CTP<~I&L|B}e2jMH_8L%5^kbj8$=V$?TwfS2?<42KuiHjUT4 zAuYEjLDlhYkz03Hu*Mu11pM3ZumB4mFSqU4`9)_6;yfZ`H+*Hit_-Unhzfgyww(XkFS?E)_ywdYccZDyk*_`UQwe_7 zs*H7;pzG4;Vaf~xbiRAnr(;r9z?0L5F#*kL^>C%~bhu~ zg@rKV|2t8)69Wh8Z_tsRvx~p!AaIZ{Nf#o_2Wq`Zy1_IjmqkqiY5_}~r0duCCX8!& zBMe}uJ{ce6;0L$LB@-lC(-}tTYv9tV8UzvH&V=cA-B?QIsiXUn6q zAlLuL+jqc6RYd)AH_6_ao84qXI%%7P5&|LgCLoJ6MVg2O6|gHR#oh@v0)hl7Cn{h- z5Ts}*x1y=3RS$Z!Xv8n>!D@ zud-+r^PS%}x0&zYo16Hq{m;HRgeNH9T#@OU^V$mRD+4@Df8Gamdba&px?z@GDZM#! z>`|a)FV3>};hjyTv+NT!AFVm3s?Vq|{4X~FVsNtIKZ9dn2gg1(L zlRmJowrM|k_bjlN+ibg!dzXG_-xY+|jR{Na$>F)XL48#KH&fq>v~r2PLH%7Tfj5ze zbYWD z!vj62*s@Mfd+iNv@SMKywcpQX&F~_-a-HTC+555U^l*`#U8mlf%kBMw;(l5Pl3Q1$ z_j_dwex|6O^GDMQEA5Bc1}F-!-9gLAMd+KQAOQ*L+s9E4?lyEW_t+l%UKwb7UX0^ zEDjlhzqzbkS!L$I_{l$YT+p*Mv%Usic?TBT z7irqJUdQM5!&-O%)WMv~K3Qw8sWtd3cmOnR1)3!g!AvO8nzi;QZ{KzHr?6MDj5dA= zxI=xa{L+3%LoAkeZ;AbFW#D^uqkTc6g85aD^W@`3DUS&9#V}#cT^RU!_I&EM$^MZ) zgi3C^ESO`e^Tx9rgt(Dr-=M{WN5W-rv}-wQFC{Tl?%yv@g7y_SruU(YAX> z9kwsF!G+T7sC}vSG95W;Ul3K50`DkqJvoY;1+RGDKW49|g)b}eHwSuOM7xjMcm3(% zmnZCt;xGHs0%Q$GG>v#ZIf@ES+Hd}wZ)VO4iHwb6mJ6(!7TDPR=rrt{ zJ(@b6vro__QRz9*j7jvzIka|J7rf1WvNs6^-riejk6^m;)Nl5yaq<3UU&En7&;D+& z!%+b+mp4`Brez| z*hb;L~D<>I$*ET&PH?1{EHJLz3q;ci%Y$)2SBK;PnGdjnx! zcslT#3ur<5>uAk&z&pj;RZz$42SG1{|7}Np3(GJ9wrg+`Uqd{CDcIM&?))0Iwjcz6 z^6SqRPkBsls7;+xpu;L{(7Pde3iZ(R`tbZAS=lW$w?LPH_|Om%3Anywd-Fa`pQ){* zQ8pbxp5?UIroWf?(T8Xz;IljgKWGpy(?VQd((oYtG3_E93etbj)>B!q?y=1-rxELG z#!$l$ofECx5~6o8t8~+<5Zx&ixeA8pOXVT@IZSPdUEiRU&{?6U(J~!f#%60>hu3l= zKkJS76pz#=$GxYbGbe|1fmIt3*ez{^A!esfNemF3f5y<05br~Vz6xb-3e`JXWnQs& zaR#FdB-#SIS!PM7S*C+SmAT!azo%`Q>eQ!en`wqqZ;y@x2yQy>)E|a1`@t}M2sg1K zOuvS&wZip5e0?rluf*^lcj>1v{JSFj!;hy`5&8v;du2_1sJ71AAW{$061O?rB3o;o zCb6eQWY`*~>e$iJdI%OMfZabzucw{xz7VDV9*k5fPsi&+0GxyI`Z3$u*|fEmeh6_8 zOB3_~*kc@)sCU-B^7c#Af7NVbXVCS@xJNK)vYu%>5{i90&i-%#-*evCntG(@$)Jlv zQuH05Sct^zr$X+gr0Lyl<2TX1G(E*O^V_NEdK}ZmTIu=%+k1y-eY&2G3@#_q^`0Cq z*0#3(EToN%-cRc2KWS)bK|QmjgpjZm^k#;>#Flr$JH{TCZ1djJ0CQ$r{*CwJhPp=! zFaACtXXmo-DWsA9qwV`p`tW(JuJ%15*YvJ@oA?4U$KmREK}+(^&qil?7yPIudOOVJ zswVp9+C=ZDrur=GdYw*nn(LW}5bD!h?;Ogyn-!%_@8Usx1vZ4T?&Fp{oN(KMx4Ly# znIp|kBZel#Qe+GLdJVfKT43ULcwcOxpU`bzJE-8GGnK}**CRvMf+qU5GtFI8(^<@I#ZTWYY&K7Ebe7c;x@8jS7AF8qf(>+zDKJ6yA(LWj|y$L$Shd1pP8Y1WsW z^-lI(ICtAMi^96-X{fkK7rmE_LwQDZ)9xd#=3Th#`u-4(KqFRcDru5V4fV1@f!zaa42-&$O!h zT718@>OP+D3##tp_|X{A=#z)(jP-m;=h5V3B|xX_xm5=zM{bUY(KqU z@W?ZPPmlU{*ljH!x@A`)^>)n&!WOF{{9T16x+r%}AKCs_tOTs=C2atGaiZ(zw<=)Zv>tI&UgotVq~H!va;`EOuDSZUtegn`3`Q0#vNw&Hv4a2KPdIzz_?ZJztKWH6$@y@K)u|y`Fn4-LAp)jA3X-^@Wm`V;_Z7UNSR~v z5fDk7YluOvrqOrl8Mc$()8f0pg~uK7es`DN-_hpGtN>&J@>Kfo&DDqViZUU{fu}Pg2z_!KC3rtaP$Zamm%gJ z=U~&y8p2U?a0i)&;ShGeb3Ue36#bm8wp6x%4lHr`7j*M;`rS-;S3akw^Zj?v>4hM= zZ$7V|Q~5zg=jcwm{lo>tIkrL)L_LNIU(;`}owz{3qxA~pKie}}e?;5u?UAb|X!c{r zAn{#gepfkKzrpvQPp-a#ri|6&Z66+^!m;|pxO$Uc*T2^6XU9TL%MK`FJ@6ONE>MRz z(8dK?_=f(CeK%~r9=G}Z%nAApX#1xLIs)QeI!3OEdWL-x_o0^g!HpC3+xf+kiO5nn z=@=cK2=+YZIPHB?e}u0+C+XklCy%4R+8Snw!&CJe{7>4GzMT3`(Hq)x%kfP;^ONaQ z004;JXQ${D_D{CqMP^l5+b7$+ZAkB=*%qIm7xFRE#V5Qc^7X4Y$gqbrUfiG&)sd;vJL+9#Epuirc4)gRR+qA=U z$2g zW>G;Qq_$ja#4pr~Y8ET=|bH^*gw9-_IaPV)4HJnSO@`C-W*uGoN}rt8nt4 z?c@>Kxms_9`3x)8AG1MEd+BriI7=KuztEq<)qCO#Jx1dPLF>>7TxYJ+*YWj%FZGAw z^QuKW+e`&TNhBw~)K{~_vS__NhCgpzqHn;}8?*uEKk$S08+8@ceBVYrJ5Z!iq7Mqr z-KaMVe6Bzn)Z&@vr})YY18QWul2Y6T2P}3eYb7%CUSfOMQJ+ae4{_3&7j}E zfl&S~#ea)Mm%EVqeydO55(mE3N1}qecIoQ^)TG9{_2v*8@7=8rwiO$+CSD|R2OF?ZBG=@_+-f*{a$<$w^x4+TYlc%tFPB)(f#`%0U-^Q zd0D(qzb~LE_kO)6thz(@qkG7)uwVZ!ykZRqn+wK5D>UeZ??A>*&|BZ>4MZis!(MnA zm?dtaUcc(GG1lk)?dw*l-Ura?33~j1-VAwX<{i+H(d7`GJBSX>@!om}$beYU;fEob zzfYeX#<%Z#4;vbu>#Cii$@r@hCa z&b(3L%{Za&)8LR1r=Wb!q~?5CNrO)z@pe9aeF``^lfr*MCsxumKj`~m&ZvD_uV$=a zd)ra?LSDg{HX@oTPeat5?|tkH_jn(zI*ST_rsHRUWiS6ikw5Bn!}EUu6!;icM7zM8 zO5J}{I^}&oqS1Y{=SMX9Gew`%n{kQj&go5KtP*}8Sq0xbhk?)bde0#S4?U~+santG zMWAQ%BDiPtvwl6}%i*8(UD#={<`=!bZPGS6`3sQi7rO6PY)YB5&HL`JI?^^=q>q2o z8`PdQ4K`l~I_X4G(mdoObwkL=ui4U8SrgS()*RxQKaGNaN0%?sbHAg4Y13%g?|M@k z9v}T(KZ*YA_(Oj$z_ydi1#@e%S!>*R9XWJ9d!Jfggfz2@?!E|B_87f>QGb@7>X)#L zc2S2*fcr7;qnGp*JiJDl2&}Fk3e^=v@$h=uL=xF-Vrll0jR38VUPr172^^H=ITJA? zEf}_HHG(q{Ep0j6ksOR*B^|PfIxrg;LE^C(tE>g&AgcPVp=*r<`J|wt!ZKiLVixKRFzg z5*70Wq3Pk`Q9K;vLY+k9LY+%!lS_2At$KwbBE%YCN?C+Bi2P0DjYN?j=^$UGQh1bj z5)WUCLdhR#RTN52_5K(oz~4}`PK+4t@71ChagDZ=&c=uscnn0WNYoZlomlZ4{SYez z&5IRXwU6j@thgSRc5xyT8(r>?6D`cwv*W~It&l?EMK4@#j2F2eI(y#q)Dd4j7?Z&#Ey?Pe{XVAM>lGi5TJxx-U^&jh5d}6dlpzkwj65yZj{4f$fDA zNn!xLX_k!HN4JtiTbRKnC5t{{I?|kiYK9P2Mi#}Tpv8G~ZHh?4j6R$qy5qZ#Q$!zB ziToqC0zQM?A{p;SxaTuiX9*rCKhQ0Rw!zne4_ao&s;uz=auvb0>6 zyZ*56H@_vkb$NenDQ>hy=6wKywFH0MVF_trzza~;fo;J0j?=SkL~64iu;Is3&-Iw6 z>O*HjniJ+d<A~V$MICUl9sGj&wi7Wl$|G*atGyn~>MDxqgaQY>*L4DxX(ws+ zHKM+4?02;78Z76N)U`7#%wxavj_iyH#OxmKg8J4{L|0MAc4~uJU$3sH??YP974@y9 zgI!VIDQ|2yQON1pO0E+PjMtc;W`LlE)1_RIXe-2qbM8r#9w>R5-spiwUfW3Pdtmhz zdVlXB*6}XX;-2D5Tt@d2&w!$6y~QKikKSRu#a&wXJJ75Yg$~1E+W^)6J|Z5h{P#ZM z*%<4c1yxp4u?FXOKkAEd+TJW6qn~(~uTS?Azu9)p;QLxM{zh>FWUKu*Volp- z&7jnq@DZ*PZW6zNwYYD>%+0SOjVIy5;ntk)OOX?-C<814!gO;8yRG=N{0E`E>U^!02KcbB}lo?=IYfPv55|_u?|2 z?&V7{y>+kHlk_nFmtl)ag^3kL(Nu;fd?TRGV>vE8!JKfN@a@*lG=Le^Mlb zpXP^HygroZbH9kUy@jnNYE|4XZjZ5wSpcsIfUDA34`ANI9uP9ds>1()gEjp|9!5MNTJpnd zpAZ#EpQuT0ZccJzHOU#iN&bX7Jc&vE{R?22t@@ZVFY&`f|Ck}XMJS>ixX@;-#W%uS zXbqnN7_6GCVLE(ZnDLaT9b;AKe`kRJ?-D}&OLxXv@5QIYOE%aEMm;NLXmIAap9fI# z>H6nIJ=@mpCQx2~9zdBwN1q2!^2z-IfU?zl;|t;*P1`}sUqpfZbeJy_7*`&{!&gV* z)BW_>NPIfMdv>I_S+iYQOV^FUikVCgkAl^IsCaj21K!E$QlUkY3(dM#IL5iDJ%L zuyx=u6(84=sqT1z)FW$Y_;@iH0s=kshRCGGZwRCTR5$$~OsvK;%}dAM5FgodxpX4s zT}0W>CWv0P+_he3p6Jbf-a96O02R^e6UFoP83=rI%_ZlXVwSdt3f~m>)Z8-*McsZ2 z3`{mucao?C7x%g+V+i0Cw@eZD+Ahy3=iN*q4O=hi^jo;*yho95gG=o4wt8DE3JzX@ zoSl5ojhn=~B4y;SuOnJU9l?SGk)HGB9W2UxH<{EqGAcF_As|OoOc`v-9DR0pKg^3N zGA#smn|7*quqq?gz%zNSFEWkaRd6h&icI6X8GI&35XVgNmw&YW-WQt2w<|eqV329E zM3hO9x`XA3-z|Gj-6@-;&9lL~_g!&Hv+X`cTV{$B+YiU+^ek|$;924}et73Ba05J? zG7H@O%rV+J3m=_V9}VOC!SCTc?kB$|`r9rZqZ9Ap{cFd~O44SFTlwJ&v+)rgE}ku( z4$nOfS)5f~0}f1Z{nm3tl5Mgo(T4Koh?X(d7uH%uf;;oW-E%;mCm;9P-WMB!GN*Di zNR(&21%<%=Yixt#KqM!ewaAjf+u}SktiFWK7q`Y(g{+$GzM7w%FY4N69QV$eFTNE> zI7Kfm6@57IROwRTWCYmzu~-x`cS4kHE9HG6&I0LQ@`~>Inz^HFucUrW+r1*vx`E%* zE9yE+kyZS9Xc*~Ssr;wkN7!rIl*iw5>R0W0ST~gX10tJ$#{k zu6?Pk)7ENHG0|(ZBCYc^T{?NS?%kGaOSEO$Qmt9jCXE+s#oB6Zjy79+PxH*uKGjxf zD{;8x3hi6%8=QW%OWUUvY9DDIYKydm+5&C9_JQ`;qm8l}Hpr}>F;nYF+ElGTgSMhg z*QRN2Ywu`pY5CebZLan{vgdbgu@`4kOw!)ea2VFrb!rcNgJov!<_uYHX-FM!V zr%lk_(8g=ywAZz<+8%8TeX~;34*yZB5n|VDLBZMj6OX5yA;)K;W!LlSAQsp~aP{PK zEC(k+@KlBmaob(X1a|O+WNXu0X~Al99d=3O<2Q28#@I%>8(JOt03Er zr8T%v@hX_O!dDBAmP>tCi>}mXwFst{Pa2usjJ7rY2R*)Ge^W4K$|@GO{OjJ1GJ8un zdASMoS|eJtRO2j-^g*oz2JRZJkA*v=eo$#-+LgzgV~zP$s#pUq^fEa<2Wu*$2R|3x z!x$`jP)AtSw64wzwEAVSJ`ZRR zjVoJeaYcj-hc_-`3~7h>lW_L)Bd<0Acco~Gujq1HB~0j+iOMbMi*cRN5M)P zknp_u`zZhZ!~9*rzkkPX#2zav5g2>kHrH3uh2o z=h>#D5)oU6=f+&(JU_ueSESGcx)!-CbOjof(XA!oM#RH>SOWdAf;=0y1!_^vNiljpPH~M_D=*H6&x9tw}%Q#N<{|^DUyIQ`G_B@S|UO zy1Lg?YdWoMjg>r5Ok0tQM)VJjp|e|H2P-DmRyZ4qsqR+czOBgBDyWcW7b~WMue{f; zrENFkGeBYiTH&t;cx_GJ=78xdak<_MLRuH@vxUzLPqaC6t7yz^mu(dtQi^%5)bk;( z4QjrQMhDJU<82}~+C&%~!i02fwp)~&Zr>*EU`DRysRH(EbDqlm^8_+5oRT++_;$ms z1(5Bo?aJjX8EBCi0pklQg+8-hwOtt=&^Bgsc&K|gz1G&qrbC@WvuJFo7)paTix9d{ z3fm;SwcFL)-LhQ_ppKidl2Z1HkO(y!JblGT;!x^vFQbFoF@0)AvTFR~=;Fj2eFf|4 zC3^lVk>s?NX^uHn?|&uwn^k1k_B+t=UjV|cw0No!OX+1$Cl1q-WoU27c9CF*vlYvn z&X&OLO*}#iGo{Os&r|_t zqXvWI(DMBv^;%~7KW&7Ozf4q#HxD4e8GP90CgKM;rYazo|3!}#QjcW>e}MZ%evfe8 z^zXzi=+yJyiD}^h(fHSLR_J;M(2-Jl?tn-VV81V7MoOsQfQX5`vXt=?t?3+^0t3jY z1ENiOKy5A1DQ1!_P^;->M-Ld?u004b1fvY13+?#6 zL;Sif5MtL|2C+vjgV-Y$#9liL0+Ubc4~sT6%N0Ld7Mbc)JRvf52i5#uv~Igob9ZDJ zrG~pBmr^-vvX!t>!<~&MyzFbZ8OVNcT+1IKpyQSAVO!lv3%?h4*4%-GS%{P%tf?*J zYdNJHfrwg4cOHQgq?DdN0{&1+?;H`&)~h1^ynK-97`(lm>nlY)u}lH}Y&^x0zeh#V zWfQ1bqVYKzepKA(P^$vVMRakVqtc_wofdZt%jH*Vxgd##<41F{f2F&Q!9aJ0-a003 ziN@r4YNVz!;;Z=3agZF(ko~xr9l`SolHSr*8()mm9A|08aad=5L})%tK<7xDz};E8 zbDWVxT~CNpPIMR&Y1rJf+m+XhE6J$zai*sq1LwWneCJLBshj~!!YKrN;^-32)` znQuTOK}KxX9E_)Qmk80$c~72(DGQKDK8u)}ADJHF%pTX6Ajgjyq#%~IC3toX{PPX` z1cR$S75^f1@3^x9>8=pI-{736o59RmgB$vF(D7^y@}APAJS^1#Ql+ zzzey01y$YYLP_Kym%&uTEfKe5Ox5OD(_zi4RlU`);6Ho<< zpR9C+rqOCUaOHFrt{|nI1Hk?uBrzxVc-klf8cJZ zzAd5IzY0&}LB@d+bTV4WX?)|Y{1rYPj{Se^H}On!hLt%M0K_jv@8=m~=?f2;(`MD! z9nDesYJ3&s{#`s1vzA#lq`+bZyg9Srt@P3FA|^eDVFgg+0ThbO0u)N!W~o52)^Nle zh;BFV%qbayVT9%Yp#yktDNgvs5(KiRvdX1a5IzDJf!#cZ`Iy5q*bS{L|GYZF)5>Yo zA0p~uu9syBrQhRkAVw50MgYI-V;)W22?SD2o^P4{RU?)~>Z~HW5F(WfQbF2z@t8c} z!=b80g)IY0o}|5NMD0XdM{~hLT`*SzQ%F@4r;(Z*=0sN_Z|{3p0XhHTZnJjAEg18L^H?9D$G4XZ{Z1zzXZYO zyGyVTZ^o}FZkahHREE<%@(xg=I=@~WFz#qenzo`|+J%2@#i{*|({37oLdm=QYI^VJC$ zxNE!CSvr9-2>^XFurL{$6nA1ugdKK$ZE^&R5P$<-FrudkI&-&-ZXKO!0M<43M5jh@ zS`i1DV~`zXv|^H_CdooqHK__6Fqz1Am1H0P27LF8Y2bTCY$HxaWtCP`+2jJC&6klW z%$tu)B>}}1{=x=nR#jygcbuTrL2|Y{2uLy=mnO>PX)>Dz_Yc+SUEvI+Z-QmB_&^z# zf#w%os7{E?3IH1qNQd>yk6q{s!wX9a!U7Xl78(?+fejX{G1f^TviXe+a}y>K2z!Y6 zv!a?9Ct^5E^1==9+rz2}g`D^Xo+$vNQv#ELbYeCjYJBTGCfSelC@?A>~17rml^*s2+#xHARObk?p83U1BXcyGP?SB)@`QZg3y%z z)p#PUHY{qV*bWs6nOHT#b=5~`3w8Wpj_^}MPXC9|1WbwTwVgC4RHjrP!-qTn_haCi zdpl%SRhK{9S#46#H-{!*vd|LaIq}1GY6MsF z@m2q31d7D{X&q_QI9#T7G+Xg?_&Cd;;Dh+fhQNtdf^mM#3!(tB#pPYOK1?RkRzqG# zGhA{YhIzpyCuj%EiN+F4pwKo(G8XK?2-z%#>1Vnr!|%mUrc)7~8gwc`cAz0OWhV8n zDWmBF{BrPdw$`V+Op{%Bq;x?{b4SW-t%UlRmz+qMMP)T*3px-f>$5%3871SRd@P^4 z4NDT%J*-@9qvX{(G&s4auaia%Fe0h&(NKe?N69cXF@Mq*m^3T8X>dIyv@J@eL^3sD zLz`#WRD|iU!>*jPXxX^^4xgG3+>zA>-neS=uS!)y39gK0JA8uj{+f^%Ko{!+ndssB zok{djybP^d5zS&tU=x12!0IQPs$Hi9oj&QPMLVNqdh25Vm6EtzKR{PR+#P?##F?)^ z8&@f&&vLLZ8O}!qAJ`$dHHnc;{$b?G_;dNlUnYzk3D3=uCs0|8jIMwA@cr0%`S2+s z7L)wQ{mw)+-iCgFTGd*kMXJ<*;hG^qN9mbZnHGsxJProL3%(a0#>$6yk`v zP~e$4$qIH(4p!Gu{4$l~RzdrzeWHwu-OVqdFW_$;%iZ9=_*qI1C(1u~f6;?UGW{kt z@Vg^TgTDtg9%4$TYTS=sz8Wj|E7-$e!!2R5t7DS~s)N$UpI1b28?19#ZIpNqB!T26 zVv%AA*sJ_hP_hgbP#|+smlT=Nqe3wq?m!Mp-KH<<5F1{m;GnSm`~&`~e5EB+Ii=9g zh1@&XduDUbAj;ULQBjIahxD{NMW*mJ<_jsZNhB5_dxelEUa>m-%_omrrn4E{_aXzX zDaHEo=^3}oR%ZBUcd+XVrBgtY=PrkNY>#7R@R;C! zRhrxv1tSXJ<2KBLoX)TmSw@S~<(COcLku&uLYCqosJ4d1odr00v$nji=AJ5wTfr2? z-Hm2^=SU#eq|h*GR!5$7FalY)^tHEfUHO>i*j4ptCw){;c9wocoX*#isi4%!88Rjm zWK@ZCOh&KHkX@4?ou)xU!9XoTu_tAOC#)NDc>rlvhP)57Ue=daJHD-IVh4+&wUKFA zKH>bP>T$V7;V(HGP@PO!*9dT_^v{%yq|#!5q7^hQQ+B+QrDCiX%TVIu69Hc7Jba*N zgvmSb8*~OPtV$(D`@GcbqgFC4>({2d&7MNtvyrkI$a_uo1|{GTg)mE6Z6k`7HIRu7 z{Bm!gVam^F6rW`qJEIp3Z75^y-y8(bZ%YLm9I+yp6L0g3vI$BmgMp8FB+|1DWoT3L zYrp1VbAZo!7J(g^+*a`eAGJ`kUqRl6a;)3|Xe!zeu>QZU;=8mmOGfMJ^s>p=MUf>N z;m82Jk*tdtUB7m4V{6H9On=Uu2j}NqLT6xBRtAX<*9W)4ze_`P3*| zcKln;#M}K9Pwty(M29PN1T*W|TZ{CjnJZ z)5dZg22~}xl&kJH#F1%?7K*E0K7e3WR+PyDtB)#}RjXkM>Y%d&gGwKF@mpRkim+@O}%Gw2;jmT(w1q z5Q^4PHmCC~BvN>{l=Z1yOBtRP;_eE;5TmGQw?hDwAY>b zs8)}zTOqQ^)k-2eRT&kvlI4R;5@GY~=W}6vDmo~IaJ~Y1rA)_cj=&y#VP?m6W}M=AA+S2bhDiPo}%Zt|Ml)VPgImMj9PsiT|Q$n=ri0VM$P_i(}n zyFO789QuIcVfa%e)jE6@3#Esf=*F_$RK+>awEyFL1VS)f_M}*|24j$7y-<(T{8lPf ziSxYiO=%RG2b@~v&Q-Y#J z&D{o@4l@u>Qbyz3fhlgK#qH!09Aa`$d%3Na`PF2OH;K)#-J@_Um+#8FJv+#kR4%0L zSIZV?MDNJ8Q{#>@jx*3)*HNl1uroSJm4RwgNBM!KZSy|SNopFn#Z%YFA&A>OaE*-9 zQ0$M+vK=lRZjfzyx3uL7YRQ1jk}7Fb`I_`}@>f)eyJpMn1ta3A!8wL7p-&wlKl zF+3IcYwCnXwsurc3x`3UI!rfe;SeQRvjrF~Qp~|9ixR465&tka$NrxiwN}VZZ)#V7 z5AYk*4S`AJ^kO%el31n%b+oB}s0U5nfZjl&Y0g+n%e%>?AWM&Qmx=J@p#IX}A&B%= z5|8022_EA5iVC`8;N`TuJE$`fO>{@qW%SYYGDXt$bj*}JD| zeP~ZSET>b~qWDVsuqTwcKG(^9;VP?)0SpYrxk#f{(vs_BfAm500N?(d>h}O5l+&gj zAo^cX@b%Jdb_{26R&{KD2zTtN>t#kTg!y1v-CfP-#C481y1%D%(#I%=4(+@iUD)wA z{o2X>>Z_Ga?Ir8--lL3OvNKLT!UBzPeMpb@k_G5XbZ^-ded*rY2c-S>fWB1Nxi8Q4 z{-?gg^ih3j-{-Gjw3B}5BT2^+(VkB&qj7y@OSJk$U)j@S`#=C#x`9@NaYobCPdM!% z98;-qv6nWU#@`?tVBgSkTyFYwld_UL2A$7DM!z0~m3~EJH1$Ud8Tq67LHl(!lLg=* zwe1Hp*?1b%Pqso!)K4~xvRX26unY2KI=;0Kxw0Qr>T=4sQ8o)I*E&$d1EC4@%#Csx z7FDDEaumz6i~GxLhf>v8&H;6zll|qL2;Av)ldL~dnFUO;1%`*$MG$aJI;04vpJ=tT zu|bsS5Tt6P)P_|Vbjb}m1a89E%qC#V3S?7)3bR~*x&^2aXGcYjM`fpRUGkYV5!u9t zJ>#GSri&#onPAMwUU;*72bUc;%l4GjU$&!Ow?G~!r<-n(nOB)aXc@>Z)2a&QvgKIz zr2*_##oU0M7DijHF5kFU+#=I3?!BnzAI9yczm>3@{LQ$l2FxZfYrsu0V9s5u$S>G* z)quHL44%h2`c}x6Wt1`i^}iqvlW@E`#t#~1c- zod7`G70kf-v58sI)^Gq0tohnVBL{(I zenEpjawg-SQfH=*yc{z z26+3}ow6RDzH_I1yD8VJmtWYRXIjNCes0#GxE5GT~tY*s-juAfWSH36)fN3c88;jxM6wcvX`k!2!nU}Ze zBgmR#qZ&QS+R!N3Q})X}vN)cx9uouwLSgUjnyxXxP2f9iyH~~;Ok4V(J3z^^_sT|U z(0&gw`-ijdlM@hJF&9ocY$#%9JEhz&>(bf#Wa^)vUthaOjSlvC*B;2U$}!CAs(K9* z?w7S0sXo46W?ohazarNIGCWxwbiG?xr_Wxgjx-wdfQ)MZ0gP#u6{?930oSxo*ogWC zKvKPB^gWr1ACPtlf3PBh6}0UEc`sdh7Fu30b$U>GkRA@bcn#Xl__B3}$=#HcPa^~>2AjD3)4bxV^vjfS- zt#U(GSrxE90uLd6pb!i!?>q!kNIre`kW9jE-dzt#_ehq>13alf$QT4G05cf@nVr{G zL6*sg;^9b1Kp_A|&Ihd}`5B`O+s1J89$VaCfxs!q$~dMR?8stJVN*ogfC&kMV2Kj8 zQ5!w`Fvzf41kCl=8||^qPaR|hQ6c`oaSszwRxQ{uZU&dA(CEAIxKIt95tCIE_L_4j z25UKrQUfZ10Va2|Y|93b^Zsze%CPV>P(uh0Ol*NoZ6A^K6VNAK_lp1Wy06K_nAmte zq8A^LS7E>Wr;o^l+t~Q0B0j7uD>6!i;L;U*gR9bV)MDqS`AmOttu#&S(0V-M3G!Dk z&d;$9tcIilWvB5_5Xnh&%TS0CM0rDH9anWw<*cN2L*?Ck*mmYHnVP~R!R}h47AEgr zP&Rm8$ym8rHQx3P872oIk&KJ_J}RSCfS=F*?>#w!)tEIj^)X;z|a#0&@Wzo;r$7 zJt?n>o0SVVh$=YnY1V3wdB>+@TFfGT%jY*)6RerLrtmI4)NeOhoJ-T5l1V+4B971* zMdo3V^2}uz2h`2SX8WOxb>SN9s~0_GZ1h*TWDMD#h9 z@_9w1ueH)hCTix_Aa!PbNk4Po9)YBFz=Cas9z&s4X#Ob_1l|;&ypn8T0g9-IuKI`y zsU9Hir7_RSC+X@J!3CC)^EsH|VH|Jt9F_qn%k|I6I{@_g&&d{bSSQ)kp? z)>H^$U(f*%19&JHUVb8g3ehFpmq%J$MM;T$&=#nPBHGqA5blGD%i@Z{(UgJz+{TyWM?mvuUzRQYEd8#2Stbd^C7H#2^a|wXi*){F*doSJ#w#-QzA4iXK^1EX z!4STEW-%XW>ET0twRjjFmkGfL`V!9T7#yYqqt>z7)5A-yTFWCZzJs<3sXjyaoQg&QMD3u+3SBB) zptYN7P|g@xADcN?E>t_JmX49v1l&&@D?0_;()D9y>t1G{F!sp;b!RHnExwG9_HcA# zp^uTjwmZQm2Q$`n^B{DQ`wVdyQXaG8ug1!)fo;rxUG}KY1dF9VQ(j!j;t+by#K~No z*vP=8L6(!p$rtNZvb`LA33hn6VJ2+RuH{PnR5CS?jG`>BL14PFP&Z`6zO*!1pnH1-T?tMkh|J?*x%TSUwJn5cu z^j@B97HL-Rx8A^H=%r(MvS;@qHHDrcbcvPx`auPkZP$8B^M`ROJ;Z_q*o#TL_baD; zDZMyRw$E1h;sZT!!L%CyZ-kRg1&lW~&$oPxpouldC(0hpnO1vJEjgjFB_=TL@H{bL z=8Z%k%z@ZV556f!W2evAH{o7BO}9*fEB$-AI7v1N-xLZRO8JV0L+mM|t0qJK-b2q# zmI-!qiBZ9$$;ogTWqJ=ymVAI6T{Ts?M5a!auVUH~NiMOya+Kh)qrLs!fqF_SrolKcb(*Y0iPL2&?Vct(!u&L1nsmb}ir;1Q;&j>5R&boQ zOqWNsGVdodPMRfagEF-W z$`J|_Yi7w8v=6*jzsJs^GV;v!0lhWdI!A^vH223sJmNGu9NXkX&;`;kd_7wxwJ73; zNXq!XpOEY4z%D-+N?EDl+JX#A*;+1L{h^Gf zuNOfm+DoSw$)PpNG@fp(z|=6ChO>pSoQ8d<+*iX374BRtme<@q<|UwpiRiElnd`MO z?h5O*G#(gM5YOwi6n{;sjF#ucD?crkc|kmDNNV}!;A6Bm;v*TCX0=c?esRuELjK2HnzR=a+sMxsG{;we*`>MFdxH$6 zKNQNC|FScO_FUGP?SI*s2WbCN`Ds;;b}W-UzyMM|mhM}BDo0RbErqOhCc4!okxdFr zOa2yO_~;6gsL`cmCTm4vwD=*O?`hS?vT3x{oNrdaS^-0PaT!eZYWnI^k53Tqih~7; zWoruk7;)zx{|r>C1JV@fb}?xx`a~w(x`!VIkfv(g_VJ3p?KVF8%WkJILaT0Djhp=i z23dW$-wOg}^}#n55U}zqO~KpBP<$n<#jM1JLeYcc81=foqw__|6$Lb|4u{FhW!jxe zDObI6Jr2_HpD#O&a+k{ty82TYRxhBf08Rah81^b7S1h?!AQoaDC9J>*3cQ{b@24ugg3fD;lUr^Vyw zUWeQ18pVm>@}MhaJ8+T%u+v+%3hsGOEoCOQK4zOcwJnC(cM{!JEFY*seMP*!;#i3P zr^L%@!G{{AkAs=^mC)e!&*f0`aMS1Vl(x>h{0nHNh#bfD3GaY)aNdG=-1Q}#?T6{D zFXb27_uf0!%da%;h_~?u`3N)hKxR0aPZ~0}a{gD$(5kX(Fl#I{zf1yYz8O6a>`mv^ zufz7*_&?-?@u_Bw|Javbwjg*0(x_`|fHZpVRvE?78qzh_p30I>MFjJu5@bT&M|oRi z1B1QcXOJBka^NlCfJ={^NMIm$J-Rtv5?}rvFRe#-&+RR`tf` zhpIl)E(eyLrvS!q-IE{5z`LhRK3u(f2y5wGE@Q4B5&UZjK5YlXyGa1Qy>fTxp&hcd z?Wm=4tlc5|RqsmMw`W7U*!JIQ7rr{HVD%TPV%gX7P4uT*gD4wHne)Dp(f=zz z&1MNWH2_e>S6rdGkTO6qZyF&)#N|_T1it|KOpqw_=Ud8IKR*rptIGo>h}TF=68fTIY2j> ze%UKOLC)4i`>^TeI63x15k0|TZQR_E`=Q{Rq@3^MH`*y0a6nGN328qZkafU)VZQ;} z$f{90Eu6mFg8{WX2zeKjDsXU#H0B_pG$CLt!rQKY78@_e+kY`Ajb1n?GqSAVfGZ&d zF+>=6GnCflw}L|qT4&8z)j;FC;|^hdps-^!+1`2I%Lg^b87GVF=i}0F5E-pGj(t{* zkHSZGnED)*UpUVOyw&LJ2^s5cbxdBP*^W4=@Ozo*eg8P*WF#X%jcFuK%KMRWbofa* z9<2J}Ng0?#y)q7cgq{sn{qZUJvv!Ua{2(VF`irwYK#x2vyIv8UkNgMdeB^R;UVTM$ zrjBQ22(%qpK1Fx_C`x7!TTS_i{;Z?d!;T1E zf1LVjt>M-=2&)KJH*c~~Mwoeg2aDLxG7}4P_RsPM1bR;T1$r0Ib<3|l-CZro#;x9G zMbppg|MhD8OOr`0t3uy6Yz`mbEv)>ZQmzK2`0zKFleT+X{*FCw=+~EjRO?qAy6QZ{ z_I)Lg&^h6LxM@)sbY3Q4={|Q}*0a63fo7kVnavh%@JaFicbyOSDU2rV&?x)7tVLH} zkTS+<)*J!^cB}P)7hr%mMlWBG&A9cV3$kf~)w*xAScE?QQZ?K-Z_|sAFEPs8OA=`Y zr*t!lwDPH%u>%YakJ6}8Gaj|S^f_iCo@UO4&1-@UgsN<=j6pUIOt;@E1KwJ6_5DLN|l!&0{)kcAR8@s`$2qG8=uYjvd;Kz&e-E9 zoUN51R_$?AdoQZjWN~Zf66zan%s``O!vC`E&jZ?S{jb`FH@VuD2w&S~O;v55bz#Q- zw(Z?{5T06_<8Jk@+HUz5ZJRY!Yx^nEBMlDC{+q!cI{+oZ0({GV)qxg&(E+ojsty3~ zPtu$yFmlEcMuUi`d6J zhPdfL@ono?o)cAY8ZC@AIFWQkw9y#R5I$EHLRLpOnxh_1K8_~gj0V269MmwzNT{d$ zW2k}02d^-jW)Sm+@;UhLOv=lBoK4voLPKMWdVEw6#UNg~nAXP_nStJ_KVpm|gam8- zoXv1)vO2U5JsOMc%Ahr|c!S(3d{<0cV~z2co7>}zrnpRqGp6CvFy6R=lXXPAku=ih z>U4p;v5!|Jww=A+G%#_Wui#zH^3A9UEHJ&R3^xB#Qe$ptju?hrrZqYe_31q$Mu z;6M~ESP=~|0v;E&Z+XHgAN7L$$Q&+C(o8VoIN%K5u&D=9flK8JQsb)OAJ<=u368tJ z>88cy7Tc`usxTRF7fY~o;stQUQ!=#Lj99~|D(oMY^7LI^n9G`U4*q0oh*f2Q@Ngrm z2mwS1@WF)a; z^qnLlC7r!ln(}9{3oO`57NR0MGI>1g72T6$+!4T2@}WN|o`MMLzfRL3oWLWW>zReG zN+2nETnVo#f|ogb)QxK%$AIJ^X5{N{fx3LskvVnnMIz1wCmyLj6h|Yln!m(WNY7#Z zG7evM!n7mE!Oym=@T7)5ELVXh>|<8ZB~_c^RrpK;g*2Q!Ds|*vb;g2xA-nq+pUh58 zv~m{kV;2XWewN#4fbEOGfbq~YqlX>9=L&C6GwS?B=H&Oy8fq@6ssT{tuF{4yqmi$M3u#8Hzo=o3 z75y@w9!fV_V{f|;p*c{;?kT(oQ6kIr8wP?b!U&0RrrSm`$v~1K+LmtA2ATaS-Ds~u zwyM)bE9VTthNQDD&va=xosEDmeNSye+V^ij#SPRJ$!y6-&YB{V03!s1kch9+NCeLu4yW20+dENQ@B2aqDFc~*?LoxFe4d$Y%mRj7B@6vDD1jW zdj?pu>DJ)o>tBo(Xw{Z&x9TThmu(~sujL4C%>+1eE3kfR(X!(K%}{oRksN8(?4O_L zP{#)}I0Hg7cyxwQ=N~o@r}~GMOuu9p;q<`Fp&ns7uE`G;FuN9#-GzPv2!34d|-*p|yg#I2U;9H!^x?$U8cB z1Slgilx7<_=*)#|qaNMA5Ge?nHa4EbgAW=jA#8VJ13QT~PHh4?t&EbJDB-zF6QgUG zKZuX%X$ig6#7LI&p{jj=|L0M06C>feSs-ZXW*(ZEOxwUnbx_P1=I>JeJ>C3W!oR1P zzl-_zJLc~q{{1#QcGo{DThZ-Jjj)t_^UXYdL*{S9yaqd_@^38aF-?t>29t4PlIKbO zUvHWp7jVIe{-=3V*3`J!IRy`_uIAZj;b}*G8r;li*csmGk#3|(tC8k_?Cq(M8txg1 za6r_}d7d4f;D`8KIHHWw)YB26;BOAjPaCG*rbfVJRN4#*Ho#}J_{Y@(63y{mAOy+w z()nQWP1KCj8!Zgq26UI&l+WmFil@3tjLC~8l#aGA!f-CouPuyEt2Unh!N!8fY8%gY zwKSZyFC)_!lPM`GG7Z}4UonB3(5=cWIx&elwK9&_#wsn>O`WD2v05;1+fC4d%!^O| z_2nqCjkb0}a>Am}R{{25Y`mCcbC|gR5^|C0)+#f$jd4RvkqRYadW~2n*BcQ0c&iNk z*v9DBQ{~#g&IU!RnG8cjQuLZPM_Sa{iccyG)Uv?0KgH~Q8Yn}UdCN0Y%4*&(sib|U zZ!4848|0|SNf2GSc#@ z#0dPm4JUY20igcCIo#%fB_e$5O1sE>5wWLKrokZObESwELSs|SoD_%#4v0yto+-Xh zd!t$)n4^^eg|U`7D&UZjV6B%sNI?sniQxdS4=E&xA{;;WI@7#frOru|W7(E*COyQV3Fv>-)wE&a37f|hNLz8^E22ymYInzAj7SZtQjW+E} z5g$EOB#BohM{|N=UqD(5riqa+{HNx;hmo zZHh3J15l8rYrB4SsX;@>P^V{LHt5Tq#tpXp%c)i`BQ1?3W=_>KK_M}3{8fda7N89d z*)5@gy^I(;chs?gp6z8^RcniyV;szyX6|E%K=95Y=?-#iq;0*7IPCC6KAj{A>20*D zry`Cn7tO1y5xh864(n{C9${WRADjnQg$fRP402fW=gNS58D*);Vy)7-WSJW@7%_Ym z_(*}~*oHoX3A=;*0cQz)j7QPcH~JW2cCK+n4@u(PmGfw!Cn_cdbDcqubU z^l$Ftqwjp0Gowfe<@Ysih2A{GwFGWnv}zyXSZ_iV$11FjK_kqu+(EpRB-lElpoD(B z!RX9ted~Tkod`>#PB*j5ab}pI{fu64IjG6`wx2NsTTJHybI+U{l>H0!6H9wv~ld(PAc8 z0C!cg0=41Mf{72&JzstVb2Wr3bPce;U#v{O&87kZiC;n6#a~7x`!MF;;7j6z*d?Qs zHQqB6!@X3>n$@VE(FC^bGtFRqsWtuQF8DP$_$PRsD4a9>-C?&Hf}Xy~IQst=h_5qf zYX2J`F8&_?vGac&s#s!paDitr9uCd-6fcb9n-|p0kB;nT;PWRMtrsCjVl{n=+4u~ zTFp76vK0~rY%+v^;|~SU986gLM0S#B&TU421f>6Qo6+*VbxeEE2RjJtDlHV`j?G7W zW|--aFu74bSH2?T;6cGGX280Hgw?)jztu!-J?3Qq9{Y(BM%4yZh%($mq`|wx=!BRn6`gmPrEZle#C$CdAM?PxT$U-KE zFfgi_2CAu<4opeSWRpp*x#!j-HNI>OO7u`X48)@F7Tmg7sskgg1iPZca|t1lZ;I<*{ZJO)?H{K1f)i@h5M zqiz@rR5JTA`r%F^F+s_n!AM^bAby(rO!BGDT}BhOEikE^N25*~wb;u3>|Mq{)ipqh zjc=Abl*2ogY|yFIhLiJZOFO%>$ac3;M=Pa_yJ2)Fp{{qs^ISo*?>2h>#l$W*Cw3LH zipDhH9wQRlC5GMup)t&#u7l}z8GUxIk=~R=QV$YNDl4MGB%mNat4cDMhv`z5ZVxZk zQX2fQ(LbX|O%Xp}MUW>g7YoUEK#)&(!FVU!XLL+ujMWf9il|UXbjse2h0H0IO;NLi z&fI6D{~zk!13ao~>mSY}A?55nWFQ4dLNW<8Kqw+0O&LUNG#eJATR}vM?Rqr<5u+jo zDJv>q5D-LAP!y~L6^#NK1i4W`u!4dYP{fF+|KD2s%*>g|1ajZ|zTdr{J`a=Ac3FGv z)%Gf>4BHYpQ{(V5%{wtCmVTRrl)h(QZyjl7wwCGAs9+HUJ-YG+YlBmE&%Mza*vzm> z|EIj^&8Jn)AR?M~BV>#cN*rUg^TLj4(8Z2Aov6GM9qQY9BUiuiUj*koiW_G&_}>Bc zhcx_VXfd^dI96#A4ZXp7%?b61twSu~Q{`ig7&4B!sw^;2^nkf|WlazN7^&4Yd zO;xuDI_n7#jKFko0!zauTG=&YG2<>|Z-c-1cR7s128&luw7!GYhac;j@e+ZOocIz6ZF4x=vFBL)HX0+-K%R)NX zP*_fexn<_wlZm}++C+}pS(#un=LTdJ~HISzM%_@ND0%3%9NMTWZh<>)F zU5LNSDQB9M26A-9G^-npzsvgd41S%{=GfdV(FQ5V8Y?KWk$Ij>!NISQ-YP}(1Sqoi z;Q-}@zguTDo`ckC*kE-zD{ER`Iot;+1$9s5=*W80K?U;ewvsYJcI9PkdW3;ON`&p8 zOYXM5j;?rx&bY_w?0_ZRagUYlxL&vD9@qw9t-^qr8yR~Lr~{VfqePn|i?t&bB-!Hi zf!2;SW7*@I0_#Q4;F3b?OyLH_Nx+6L3avJvUyhTx%OqL4uZ*&%SPk4E5wCRi6suKc zB;HXa7y|ac;YKTqGG<$vUYuf04K*ZPro5LqDA7woiRk7#tv(zXHx+xMR;#xTtJlF5 zzH;&Z%F11G>P2f6x?Y1r*K6=}vtHfr4_&Xj?hjcnT5`WNt@?8DPO5piU?||_8d_w{ z!E*gnWSw!QAhn;t*h)Jm`{%=D5CZH_i4g^ru-QZCvfc22byf9IR7V;)^Rkh~9>uQ@ z2+}3CSa?!=?k zI9CrwgJ@qvBtcB{EEN(hWlV)Y!=5FwDJ<_>qa8GgS&UGqrE{!N=`0s5Tbc|^si zDmnFb(9ro-(=>a40gc%n=eGG)M)qDF$X?9C9&q3#Gj765O`|c$U*}sL&#?z--jN)c z8w^VW4w*`2Frz^pwkwq(8@IW}$s0UfSWr%aBj)%8);N|zzF1(Sk>3`CN+bCTtsj{& zW?K%9Q-?JjDv&_9CDw+tVFl1JRS#ZYMt8Q)+cQ&u9Sh5k6gwbS*}rULPiL zTrN@h;`M_414~pI7^!%@VBf;)g?tlXrhoHh)!3Cp9eSuN8nDPp$Y8|;zS*ox?!SzDqG?sqS5H|jleYbc<3)Bo!_H@PYqZ$PIQ?tB83Enc zg25{cX6^ft-#L@5HOBXdJZ)9V8I1KO#Vl9^B4Cz_zJChtNA_TBta$@uSq3EzX4o5k zA2B>&s!^2+avnf^d(6Ra16xJ*Ritmj=h7_rF_sI?N+(~ox>UNvicjQ3N(nf>lr{8H z#S*JgyAZ;Bx$<7_AXzWEY)K%9=Hw|-d9HQTdnxP>>zKrYfU>b+H9f$$UN*Ou^R4Hp zf^WTKZk6(_=cvKcxV6^YD&bqJXc*sm(cCKLTPtZP-+IB^D&kwu(m~v!Jx^QlafN(i z1$A78cUGHss_Nj@GxRsyqH)Xc&SAc>oHp`1&zX1j^Q~o+upGBmnOl4L*3&c)x2%=s zR%M+W8n^-e9A)(7%T|LHhMfkr6R;A`ZebT<|BnXR0|XV6z0Mj18^9OOSdHBB#N~fd z{G2t!&SB=yd?%C(ZTbrsaTDcK_jw$+2iJo(uCRtNGs=0^YEW0wUf>LoU&Xy)Yps6$ zgYSa9U%`9W?7<>vP+|F;cmhn`qkUVEFvGK5_)5s(3+;K<8s+T%!j)DJmO&Q1WTlM; z3kvHE;Ht4VCREI*LV62VbFNU{D;&tS)F|sKSXnn^#YVggSC9YvGW37mEW@hjYqJbj z)^ZuP)U*s^S6idtx#3inuH3*h=f; z{}9YWCw&!N^t^Rd3+7;aGKu<^I0E8K(4M`vuqG0jb3a@Z0=27Zxe%LcSO{#Xt7!ac zYgqWWWHF|_6kLpIo8zilE{3D)@Wr@Fd9QM8j>SfQT(!np_Fu6&Luy=|FKf3tLu$D? zAJn`$Lu7TF6zk9{L5fvvhYYFZqBwdCUz8!rJA~@K{2$vP&bc0W-B6{A-lz>#y1JI& ze!m8AQ_`EE%;By#PXg+zYYA#cZ{eW6T6wRg$6x)AfjV^44;6H0zPo#4WN?Slo}sk_ zcX=RwJqTrgo%eSS=Uh zy_y$eScJtGW)@@Zd%?x1#t4ShaxolThcCu30-*5=Jn*#?|?@cB?bI zmaFq_&8suK8Y9TwauVt^yq1gN=rMdzhAZ!IIt6 zFUF_{i!sV9#y6h^7o!>@7*)%~aC9BM7^9STl!FmGVHkmX=YI(!7+vG)d|$iO8C}cO zd8_8t8C{JL4E*9G)M<1r7sb(I_@azf-qCdPXaBJs;$#FDeQ6lMnlB?$rcg$3O)bH_ zu?BF{_^(14!RKF{1k~5m64Z{~!aK+>u}g#tGw6J^slXcRC>_bfFq?5Kf>=}JDoU! z0K_uN|H*3H4X1G8MaKq84zFd$1l!XfE|?j>cC zh1ByG_-jK7!zU_qlPlEw`K+9<#E#U~`BErIb04BYwOQ%ZM0o=Hlx4<2Z(q$P4=zrkp-Gju4)$Wc_aS1%@JnO`DK> z9HmUIN|EDy%~yz%K-pV!`WJLuwlfuQ>;QbF{KfyoF^LaWLIbd1vgQmVoWo5{rK{!Q z;G_{5;eGngm!owlH8^1nw{WhFmT7e25fg>pF%FcEXCV5WUx2>X?=0(!M^ew;&a*s z23vN4s>NXCX!ca#4Gh-q;$(xJ`*$_oRW|pa%4p#CCgCX+!DGRcS1Y3|mzs&`;N;Ms z0f}CVQ8g^V`~x_0=8PzEgiQYzv$DIeXSFbV2}UGYqsbei?)EPM4>mD?FEr>jcUsaq zjx^-cbEH+{BlW5nM6+(BhFlhW8+GL$z+!>T#M6y^a&NC*0KY@bnyhJ{S!>!rO6UESY8v;$4~W0-%F)=3@{y0!5G~9=7!3Yp zccTE&l6+ivDG)+Uo0U@aO&fvun^^r6wO5MsQ8~MNL8+$k-|j+pTcf1EMpjMzQIbX& zG6#7`2lec){7bvYMYHN#6KIQ8JDQG=Ffj7O=!o0dk;i=G z@8?O=PYWQp-=m7xstkvW+F8Z}^ei6%Y1Fa^rtbJ8_2=k$^z%}e$}% zdM2wb$#$cT4ZTn{G%Ze6T;bZ0uPc>x9$-3>;~>ftq(>s-s8x#Um|MwSOZJX-hEYg$ zC?r8ZN$Y|XEOa@&k)krP#8*RV?I1f>20URBOdUluii$UMEJbCr*ttAaWf~`qgn*NV zFIBC8FnBOkHERby63=fSIMqX5*_CXAlMc*2B^?--pxUlGo~F)l<*@7#tRu9S{S+}W z#KNY+=L{pPTz5%BmE>|73T|qoLgMDvH&O$g&+DbDE84T)i@1#8-zw0sP#@kng9YMp zjht3YMITF7tpT%5>FRohN81e5(7*#39r+F1yEH=$vwcVXj=kXIkoq=ds3y)4{FI?W zLc4ops@@$#D0F|b!0;Fq0*wTra6$t@8TxFT&_JKpWUAx>iK#)#xiSuXg8vR)5^rKV zIlvr_Q==S}5ggj);Lt_~i1bN^CPbyyLo@CBDcOA5kfXTb zbr4jIMLMIFIZl90{TPyQPXQRxkh<$!#`O23qY|;W)}yl9e>q3pMFV@NI!IQfJkf95 zOJ6p@UfoXVP5mnwad@9Rjp4O7!^>`~>ZC*(9&Kx?QrpyS0qq6@<7r{21y;B27|$jw zcsrL+48Wc#2E2lCkK_L1bAA)v&P;T2oV6gS?3ACxXvJNGqpiE!E^) z7OE0Z4I&AqqBzf=(w8{KMMEYuH0HIIYPh82@F!RVx7tpv^3=I7RQ1Y(>uPbHibE<# z%2N+GX-=zF>NFE8XtJna*PH3t@g8)0D>b&eFb_DFGUH%bk7M#A4v%RA(|A)}Dx5YH zfLu{oj=F^&ZmsIZ&N?N9zpAmyr*2c-P3W#RYG_gzccy)9AgGs7e7@@7`jWclV|LqV zO1|nDF&oKgaZi375C(}cOJ0*mZ}dt7hpX7l(~S zvfvUz>nP)!L@%^exuLHAg?91d;}hxY3Jn1`LoD5!NC)s}KQsI#osSxEp^fX9vPpvE>b+srRai5tC$3zc-JgJO%R z_cWE~UGE7N92JX?sg^8WZX5|hH=d^YApRfY0j5=ofrOow@rQUz)pz3;C>7=BC7D7~=v4D6o2_fXC7!>NsFLl5Z6vc-8*(|{Q&&HdSKh_sx-5?nHcCg4_qo!WFgMAW1F zRPYUp+Ob6Y;deD_$MHs~_>8XZ4C&Y&fnPdC zu7r6;I)1CO8rE8Ho!uun(s_sIw6LwaIC-iVFBxnuuDXr9A*emb)##GCfyNks^c1$R znk&W{Nm@i`rguCjHngzHE*5{5*WcX*U~rBJ+f#o}7qo;FR9#fF(K7;o!VLazKt&z8 zLyUTt7M-D_n%ao&swukv{0!AG+3wyCCFFi9F-8HzFbU=xep5;Px~jKAfgo7XHh>k8 zr(PIg>e2Id(TZ-W>F9U(p~Hyse}E=t?u8+9=l-X6hkfK7O6m%&xEG8doWBVMG-0kX zSvVQ@P;D^d@O{uEIAahvEH#&R^u2T#3d2ir_+EQDvru}sw*7CdtL6C>H!zX z?#i=NW4GwGBAjq_(4A+gF^*U1f?mjHRzWxRQfG~ZK7l00zW52bvE8CLVYL^(9HHlX zs=&9Xz#E+(H6g=jAi{T81^{oY!QL~)7?naNK?A$03~KIE=f^x0!dzB#R5^6!y~<6W z`c%6nK@P*@Lx>mm#soXo)PFust$V8sEa17l)ukfX3Zr0B6Urz+VPpNAl@q>5l3qSM z;B*eA9IYIsMInIby>J=+wh!115C;?lo zg3q>JZDQacXcM))10~l%U1`PHFuGPdSHXE_tbV|pv(2Pi`l#k@w@A%a5ZC11F-4xm zKwY+0*Z|)rhcniF*+-r3YGULZ|M?&a0 zzq`G_tSkGfu_js=qvG=w&@B==M4p}(s20d(eeDIRO^5HNBQs7N z(1kd}{oTok04qAubOns@hy5=APF0BZlVB`KX@#s3W`3A6kTx{TPe_MdIX&w_m5lyQ zyAV3n_cZoGb=p~Ws}8bWERrf?Kg&-DF?H%YBB?s{on04(>N|=3)FdZWnBFghpwRw) z>JmgMJ50s{%=#FV@yGc@7K@n$SJk6MFXEK>(f%s6S6D+F92*euik$J&A}YlCl_MOD z3;iykef`z=>sd!YS~hIr4I&Th@@l-C===BtguNWk0-3d6ni9_eh<}i4 z=+;51U-I*O&=lio<8w`bmjH)?ZlxWA)Hj`(Wr@tq>#_@p+k92gW4w(y)a0$`+_;v} zH+WsBKVy=Y0-jRUcn6JauQTcZ{?IOA{_LG9?1`!j}Rja^BWeb@Gs+0UmUPqg?#6WRVx_XmQW;3Rp#DB>UI~Et zDk=36)hyZW+P^X4m7Y!gFHxCbabqq~8Qsf0#*kLw8N()0e91rM9!9}R6fnbhJYyun zQ&xckB5e(%g32xtv+Jjqs4i%(-lcNY>QdD;ed|_82R5u-%C{*hr?>L<21TDvcbnJd zU5bO69rVGas=c~T7$X!4Zyaa!>fn07I96PLnd*~-1(Bp~B3M+U(UT=AjVdlv^*af` z4c}r`$Xh+p_YmWP*Tx0I#ux{JG_k>8brqQ8#KEekq_Gm1Ge#NKZ33U6TL@uhaAd3Aw1cB-pPdgOAIhK8TM zT(xZzucgOB0w8~?y?Ixthro7bT%iVMO#?>(mU7ZlWIj#6Z(sK`1NK;b zuVHCLtbFBB*|CJ!b^WhYAG$g*r}S>U19WZUU5vx8@FoeAa|7C z@HcLV>U5QG2i}kjdT<927DwE;aEHoBDg(5PLRJ~@Tg38Y5#-6KGqG;*qE||H`o{oQYW0jt16t#;H zc;RF^e;=x{kUtck`OVy*0Lz`{kVdwEK(=A1njXD+2c0`i-P(p3LA0+0<2{T3an39W zAd$ijkQ@^OX8CvjFm#%WyT(HPxv5 z_XjX8o*o&YJg$m$r6XXZbtZ~tY%j%`k?$Ih?$jRjznaq05a}!C~wa=#m`2#-Q z3kr}3;%;Xb=yeU0-7jdwHLBUjWBkl%6{wE6q4Xz6^J|B>RQGz-D9s*1fco1bNxc?& z?-$hVTIjv@NE}G_h(Wsf*QyEd3_Y2gCqi7U;jx9Tx(+8ndujT0Q1_?p^g|%9d#hVU z!eH<(T1Es0t}WE^dhnsWG~#+p*Y4IoT~JUn-K2n;Z`4TIcD-7Yzyb0>w?$gvzpQWkh5wQUbIL$(oE$s}OGJjk_64zr!#5w zjVi4!G8tmm*u`e5=*T40n%RG&dM*?Mt~vDb808(g{QsMo&*5(B`H3v%$?1bnHFJAx z|JKY;j8)gQGAcr>opwczL$L8fjzgd@bHOSju`j(z)pOFQvYXUU=XHy5>b-7Ef>W`A zA+k6xUorSUm?{3kE0N@IYI(C71it`>YB5kmG_e~PI?D@eYSK{Y&8lM}1a8Ue5Kj{( zq8!a{H>&lp_&n>cUfy0dl2%Urfcw04WEhc(081jVZT@|N2bE@_@tDf!!8D#dshrZCNE)}ZP8s~=Sdd#3bEqgbi_7wGYhIO zX2<%r{Lg)fUDH!A&+?xVN7)Yr-K zc>$&?^8%Yt0*`sQkJX1_&@JjaF^%R&{aWAGim&(aHCx{$7g}^L5e8yw zR5m&hWq{6i$BD^=QhDdKi<+C7<7R_1MkFc(Xouf#P%0Av^=yf0M;Zh#p|cff)%lLC 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%0A}zI)bo##2a;zTe!cUYoza|b&?YyEpF(9wX~X_ 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 delta 436299 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%0Ag}3&w3?5_hsyFt4P`IQCFGM_~5M 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

X7f65DtJmc0xMk-5wijKFwzYb)^ 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%0D>PNkkce*?B*z_}VfTPVJ_D~!Pqte>u?*q>;e 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𝔱OeUuDiHKR=4VA$1(G|O|pu`6MBq;Qqk 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 Date: Mon, 30 Jan 2023 18:22:50 +0100 Subject: [PATCH 36/84] link: make MachO atoms fully owned by the linker --- src/Module.zig | 12 +- src/Sema.zig | 2 +- src/arch/aarch64/CodeGen.zig | 38 +- src/arch/aarch64/Emit.zig | 10 +- src/arch/riscv64/CodeGen.zig | 4 +- src/arch/x86_64/CodeGen.zig | 31 +- src/arch/x86_64/Emit.zig | 8 +- src/link.zig | 4 +- src/link/Dwarf.zig | 2 +- src/link/MachO.zig | 719 ++++++++++++++++++---------------- src/link/MachO/Atom.zig | 81 ++-- src/link/MachO/Relocation.zig | 16 +- 12 files changed, 495 insertions(+), 432 deletions(-) diff --git a/src/Module.zig b/src/Module.zig index dcdbeec322..8301505492 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -4098,7 +4098,7 @@ pub fn ensureDeclAnalyzed(mod: *Module, decl_index: Decl.Index) SemaError!void { // The exports this Decl performs will be re-discovered, so we remove them here // prior to re-analysis. - mod.deleteDeclExports(decl_index); + try mod.deleteDeclExports(decl_index); // Similarly, `@setAlignStack` invocations will be re-discovered. if (decl.getFunction()) |func| { @@ -5265,7 +5265,7 @@ pub fn clearDecl( assert(emit_h.decl_table.swapRemove(decl_index)); } _ = mod.compile_log_decls.swapRemove(decl_index); - mod.deleteDeclExports(decl_index); + try mod.deleteDeclExports(decl_index); if (decl.has_tv) { if (decl.ty.isFnOrHasRuntimeBits()) { @@ -5276,7 +5276,7 @@ pub fn clearDecl( decl.link = switch (mod.comp.bin_file.tag) { .coff => .{ .coff = link.File.Coff.Atom.empty }, .elf => .{ .elf = link.File.Elf.TextBlock.empty }, - .macho => .{ .macho = link.File.MachO.Atom.empty }, + .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = link.File.Plan9.DeclBlock.empty }, .c => .{ .c = {} }, .wasm => .{ .wasm = link.File.Wasm.DeclBlock.empty }, @@ -5358,7 +5358,7 @@ pub fn abortAnonDecl(mod: *Module, decl_index: Decl.Index) void { /// Delete all the Export objects that are caused by this Decl. Re-analysis of /// this Decl will cause them to be re-created (or not). -fn deleteDeclExports(mod: *Module, decl_index: Decl.Index) void { +fn deleteDeclExports(mod: *Module, decl_index: Decl.Index) Allocator.Error!void { var export_owners = (mod.export_owners.fetchSwapRemove(decl_index) orelse return).value; for (export_owners.items) |exp| { @@ -5384,7 +5384,7 @@ fn deleteDeclExports(mod: *Module, decl_index: Decl.Index) void { elf.deleteExport(exp.link.elf); } if (mod.comp.bin_file.cast(link.File.MachO)) |macho| { - macho.deleteExport(exp.link.macho); + try macho.deleteDeclExport(decl_index, exp.options.name); } if (mod.comp.bin_file.cast(link.File.Wasm)) |wasm| { wasm.deleteExport(exp.link.wasm); @@ -5696,7 +5696,7 @@ pub fn allocateNewDecl( .link = switch (mod.comp.bin_file.tag) { .coff => .{ .coff = link.File.Coff.Atom.empty }, .elf => .{ .elf = link.File.Elf.TextBlock.empty }, - .macho => .{ .macho = link.File.MachO.Atom.empty }, + .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = link.File.Plan9.DeclBlock.empty }, .c => .{ .c = {} }, .wasm => .{ .wasm = link.File.Wasm.DeclBlock.empty }, diff --git a/src/Sema.zig b/src/Sema.zig index 9c553a0092..9083cc92ab 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -5567,7 +5567,7 @@ pub fn analyzeExport( .link = switch (mod.comp.bin_file.tag) { .coff => .{ .coff = .{} }, .elf => .{ .elf = .{} }, - .macho => .{ .macho = .{} }, + .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = null }, .c => .{ .c = {} }, .wasm => .{ .wasm = .{} }, diff --git a/src/arch/aarch64/CodeGen.zig b/src/arch/aarch64/CodeGen.zig index 0efd34937a..edbe7905a2 100644 --- a/src/arch/aarch64/CodeGen.zig +++ b/src/arch/aarch64/CodeGen.zig @@ -4022,7 +4022,11 @@ fn store(self: *Self, ptr: MCValue, value: MCValue, ptr_ty: Type, value_ty: Type const mod = self.bin_file.options.module.?; const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { - .macho => owner_decl.link.macho.getSymbolIndex().?, + .macho => blk: { + const macho_file = self.bin_file.cast(link.File.MachO).?; + const atom = try macho_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); + break :blk macho_file.getAtom(atom).getSymbolIndex().?; + }, .coff => owner_decl.link.coff.getSymbolIndex().?, else => unreachable, // unsupported target format }; @@ -4308,11 +4312,12 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier const got_addr = @intCast(u32, fn_owner_decl.link.elf.getOffsetTableAddress(elf_file)); try self.genSetReg(Type.initTag(.usize), .x30, .{ .memory = got_addr }); } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { - try fn_owner_decl.link.macho.ensureInitialized(macho_file); + const atom = try macho_file.getOrCreateAtomForDecl(func.owner_decl); + const sym_index = macho_file.getAtom(atom).getSymbolIndex().?; try self.genSetReg(Type.initTag(.u64), .x30, .{ .linker_load = .{ .type = .got, - .sym_index = fn_owner_decl.link.macho.getSymbolIndex().?, + .sym_index = sym_index, }, }); } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { @@ -4349,11 +4354,13 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier if (self.bin_file.cast(link.File.MachO)) |macho_file| { const sym_index = try macho_file.getGlobalSymbol(mem.sliceTo(decl_name, 0)); + const atom = try macho_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); + const atom_index = macho_file.getAtom(atom).getSymbolIndex().?; _ = try self.addInst(.{ .tag = .call_extern, .data = .{ .relocation = .{ - .atom_index = mod.declPtr(self.mod_fn.owner_decl).link.macho.getSymbolIndex().?, + .atom_index = atom_index, .sym_index = sym_index, }, }, @@ -5491,7 +5498,11 @@ fn genSetStack(self: *Self, ty: Type, stack_offset: u32, mcv: MCValue) InnerErro const mod = self.bin_file.options.module.?; const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { - .macho => owner_decl.link.macho.getSymbolIndex().?, + .macho => blk: { + const macho_file = self.bin_file.cast(link.File.MachO).?; + const atom = try macho_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); + break :blk macho_file.getAtom(atom).getSymbolIndex().?; + }, .coff => owner_decl.link.coff.getSymbolIndex().?, else => unreachable, // unsupported target format }; @@ -5605,7 +5616,11 @@ fn genSetReg(self: *Self, ty: Type, reg: Register, mcv: MCValue) InnerError!void const mod = self.bin_file.options.module.?; const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { - .macho => owner_decl.link.macho.getSymbolIndex().?, + .macho => blk: { + const macho_file = self.bin_file.cast(link.File.MachO).?; + const atom = try macho_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); + break :blk macho_file.getAtom(atom).getSymbolIndex().?; + }, .coff => owner_decl.link.coff.getSymbolIndex().?, else => unreachable, // unsupported target format }; @@ -5799,7 +5814,11 @@ fn genSetStackArgument(self: *Self, ty: Type, stack_offset: u32, mcv: MCValue) I const mod = self.bin_file.options.module.?; const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { - .macho => owner_decl.link.macho.getSymbolIndex().?, + .macho => blk: { + const macho_file = self.bin_file.cast(link.File.MachO).?; + const atom = try macho_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); + break :blk macho_file.getAtom(atom).getSymbolIndex().?; + }, .coff => owner_decl.link.coff.getSymbolIndex().?, else => unreachable, // unsupported target format }; @@ -6122,10 +6141,11 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne try decl.link.elf.ensureInitialized(elf_file); return MCValue{ .memory = decl.link.elf.getOffsetTableAddress(elf_file) }; } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { - try decl.link.macho.ensureInitialized(macho_file); + const atom = try macho_file.getOrCreateAtomForDecl(decl_index); + const sym_index = macho_file.getAtom(atom).getSymbolIndex().?; return MCValue{ .linker_load = .{ .type = .got, - .sym_index = decl.link.macho.getSymbolIndex().?, + .sym_index = sym_index, } }; } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { try decl.link.coff.ensureInitialized(coff_file); diff --git a/src/arch/aarch64/Emit.zig b/src/arch/aarch64/Emit.zig index 3812597789..f348fb70e3 100644 --- a/src/arch/aarch64/Emit.zig +++ b/src/arch/aarch64/Emit.zig @@ -670,9 +670,9 @@ fn mirCallExtern(emit: *Emit, inst: Mir.Inst.Index) !void { if (emit.bin_file.cast(link.File.MachO)) |macho_file| { // Add relocation to the decl. - const atom = macho_file.getAtomForSymbol(.{ .sym_index = relocation.atom_index, .file = null }).?; + const atom_index = macho_file.getAtomIndexForSymbol(.{ .sym_index = relocation.atom_index, .file = null }).?; const target = macho_file.getGlobalByIndex(relocation.sym_index); - try atom.addRelocation(macho_file, .{ + try link.File.MachO.Atom.addRelocation(macho_file, atom_index, .{ .type = @enumToInt(std.macho.reloc_type_arm64.ARM64_RELOC_BRANCH26), .target = target, .offset = offset, @@ -883,10 +883,10 @@ fn mirLoadMemoryPie(emit: *Emit, inst: Mir.Inst.Index) !void { } if (emit.bin_file.cast(link.File.MachO)) |macho_file| { - const atom = macho_file.getAtomForSymbol(.{ .sym_index = data.atom_index, .file = null }).?; + const atom_index = macho_file.getAtomIndexForSymbol(.{ .sym_index = data.atom_index, .file = null }).?; // TODO this causes segfault in stage1 // try atom.addRelocations(macho_file, 2, .{ - try atom.addRelocation(macho_file, .{ + try link.File.MachO.Atom.addRelocation(macho_file, atom_index, .{ .target = .{ .sym_index = data.sym_index, .file = null }, .offset = offset, .addend = 0, @@ -902,7 +902,7 @@ fn mirLoadMemoryPie(emit: *Emit, inst: Mir.Inst.Index) !void { else => unreachable, }, }); - try atom.addRelocation(macho_file, .{ + try link.File.MachO.Atom.addRelocation(macho_file, atom_index, .{ .target = .{ .sym_index = data.sym_index, .file = null }, .offset = offset + 4, .addend = 0, diff --git a/src/arch/riscv64/CodeGen.zig b/src/arch/riscv64/CodeGen.zig index d50a614206..07a8dcd858 100644 --- a/src/arch/riscv64/CodeGen.zig +++ b/src/arch/riscv64/CodeGen.zig @@ -2556,9 +2556,7 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne try decl.link.elf.ensureInitialized(elf_file); return MCValue{ .memory = decl.link.elf.getOffsetTableAddress(elf_file) }; } else if (self.bin_file.cast(link.File.MachO)) |_| { - // TODO I'm hacking my way through here by repurposing .memory for storing - // index to the GOT target symbol index. - return MCValue{ .memory = decl.link.macho.sym_index }; + unreachable; } else if (self.bin_file.cast(link.File.Coff)) |_| { return self.fail("TODO codegen COFF const Decl pointer", .{}); } else if (self.bin_file.cast(link.File.Plan9)) |p9| { diff --git a/src/arch/x86_64/CodeGen.zig b/src/arch/x86_64/CodeGen.zig index df24fe5e7d..fc244e3130 100644 --- a/src/arch/x86_64/CodeGen.zig +++ b/src/arch/x86_64/CodeGen.zig @@ -2670,10 +2670,12 @@ fn loadMemPtrIntoRegister(self: *Self, reg: Register, ptr_ty: Type, ptr: MCValue const abi_size = @intCast(u32, ptr_ty.abiSize(self.target.*)); const mod = self.bin_file.options.module.?; const fn_owner_decl = mod.declPtr(self.mod_fn.owner_decl); - const atom_index = if (self.bin_file.tag == link.File.MachO.base_tag) - fn_owner_decl.link.macho.getSymbolIndex().? - else - fn_owner_decl.link.coff.getSymbolIndex().?; + const atom_index = if (self.bin_file.cast(link.File.MachO)) |macho_file| blk: { + const atom = try macho_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); + break :blk macho_file.getAtom(atom).getSymbolIndex().?; + } else if (self.bin_file.cast(link.File.Coff)) |_| blk: { + break :blk fn_owner_decl.link.coff.getSymbolIndex().?; + } else unreachable; const flags: u2 = switch (load_struct.type) { .got => 0b00, .direct => 0b01, @@ -4023,8 +4025,8 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier .data = undefined, }); } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { - try fn_owner_decl.link.macho.ensureInitialized(macho_file); - const sym_index = fn_owner_decl.link.macho.getSymbolIndex().?; + const atom_index = try macho_file.getOrCreateAtomForDecl(func.owner_decl); + const sym_index = macho_file.getAtom(atom_index).getSymbolIndex().?; try self.genSetReg(Type.initTag(.usize), .rax, .{ .linker_load = .{ .type = .got, @@ -4080,15 +4082,15 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier }); } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { const sym_index = try macho_file.getGlobalSymbol(mem.sliceTo(decl_name, 0)); + const atom = try macho_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); + const atom_index = macho_file.getAtom(atom).getSymbolIndex().?; _ = try self.addInst(.{ .tag = .call_extern, .ops = undefined, - .data = .{ - .relocation = .{ - .atom_index = mod.declPtr(self.mod_fn.owner_decl).link.macho.getSymbolIndex().?, - .sym_index = sym_index, - }, - }, + .data = .{ .relocation = .{ + .atom_index = atom_index, + .sym_index = sym_index, + } }, }); } else { return self.fail("TODO implement calling extern functions", .{}); @@ -6722,10 +6724,11 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne try decl.link.elf.ensureInitialized(elf_file); return MCValue{ .memory = decl.link.elf.getOffsetTableAddress(elf_file) }; } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { - try decl.link.macho.ensureInitialized(macho_file); + const atom_index = try macho_file.getOrCreateAtomForDecl(decl_index); + const sym_index = macho_file.getAtom(atom_index).getSymbolIndex().?; return MCValue{ .linker_load = .{ .type = .got, - .sym_index = decl.link.macho.getSymbolIndex().?, + .sym_index = sym_index, } }; } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { try decl.link.coff.ensureInitialized(coff_file); diff --git a/src/arch/x86_64/Emit.zig b/src/arch/x86_64/Emit.zig index af3ed5e053..980dbfd41e 100644 --- a/src/arch/x86_64/Emit.zig +++ b/src/arch/x86_64/Emit.zig @@ -1001,8 +1001,8 @@ fn mirLeaPic(emit: *Emit, inst: Mir.Inst.Index) InnerError!void { 0b01 => @enumToInt(std.macho.reloc_type_x86_64.X86_64_RELOC_SIGNED), else => unreachable, }; - const atom = macho_file.getAtomForSymbol(.{ .sym_index = relocation.atom_index, .file = null }).?; - try atom.addRelocation(macho_file, .{ + const atom_index = macho_file.getAtomIndexForSymbol(.{ .sym_index = relocation.atom_index, .file = null }).?; + try link.File.MachO.Atom.addRelocation(macho_file, atom_index, .{ .type = reloc_type, .target = .{ .sym_index = relocation.sym_index, .file = null }, .offset = @intCast(u32, end_offset - 4), @@ -1140,9 +1140,9 @@ fn mirCallExtern(emit: *Emit, inst: Mir.Inst.Index) InnerError!void { if (emit.bin_file.cast(link.File.MachO)) |macho_file| { // Add relocation to the decl. - const atom = macho_file.getAtomForSymbol(.{ .sym_index = relocation.atom_index, .file = null }).?; + const atom_index = macho_file.getAtomIndexForSymbol(.{ .sym_index = relocation.atom_index, .file = null }).?; const target = macho_file.getGlobalByIndex(relocation.sym_index); - try atom.addRelocation(macho_file, .{ + try link.File.MachO.Atom.addRelocation(macho_file, atom_index, .{ .type = @enumToInt(std.macho.reloc_type_x86_64.X86_64_RELOC_BRANCH), .target = target, .offset = offset, diff --git a/src/link.zig b/src/link.zig index 668c5b72e3..2a96efe89d 100644 --- a/src/link.zig +++ b/src/link.zig @@ -264,7 +264,7 @@ pub const File = struct { pub const LinkBlock = union { elf: Elf.TextBlock, coff: Coff.Atom, - macho: MachO.Atom, + macho: void, plan9: Plan9.DeclBlock, c: void, wasm: Wasm.DeclBlock, @@ -286,7 +286,7 @@ pub const File = struct { pub const Export = union { elf: Elf.Export, coff: Coff.Export, - macho: MachO.Export, + macho: void, plan9: Plan9.Export, c: void, wasm: Wasm.Export, diff --git a/src/link/Dwarf.zig b/src/link/Dwarf.zig index 1b65bbb04b..2595cd8ba5 100644 --- a/src/link/Dwarf.zig +++ b/src/link/Dwarf.zig @@ -2639,7 +2639,7 @@ fn getDbgInfoAtom(tag: File.Tag, mod: *Module, decl_index: Module.Decl.Index) *A const decl = mod.declPtr(decl_index); return switch (tag) { .elf => &decl.link.elf.dbg_info_atom, - .macho => &decl.link.macho.dbg_info_atom, + .macho => unreachable, .wasm => &decl.link.wasm.dbg_info_atom, else => unreachable, }; diff --git a/src/link/MachO.zig b/src/link/MachO.zig index 543cb473d7..29aed25b31 100644 --- a/src/link/MachO.zig +++ b/src/link/MachO.zig @@ -66,7 +66,7 @@ const Section = struct { // TODO is null here necessary, or can we do away with tracking via section // size in incremental context? - last_atom: ?*Atom = null, + last_atom_index: ?Atom.Index = null, /// A list of atoms that have surplus capacity. This list can have false /// positives, as functions grow and shrink over time, only sometimes being added @@ -83,7 +83,7 @@ const Section = struct { /// overcapacity can be negative. A simple way to have negative overcapacity is to /// allocate a fresh atom, which will have ideal capacity, and then grow it /// by 1 byte. It will then have -1 overcapacity. - free_list: std.ArrayListUnmanaged(*Atom) = .{}, + free_list: std.ArrayListUnmanaged(Atom.Index) = .{}, }; base: File, @@ -140,8 +140,8 @@ locals_free_list: std.ArrayListUnmanaged(u32) = .{}, globals_free_list: std.ArrayListUnmanaged(u32) = .{}, dyld_stub_binder_index: ?u32 = null, -dyld_private_atom: ?*Atom = null, -stub_helper_preamble_atom: ?*Atom = null, +dyld_private_atom_index: ?Atom.Index = null, +stub_helper_preamble_atom_index: ?Atom.Index = null, strtab: StringTable(.strtab) = .{}, @@ -164,10 +164,10 @@ segment_table_dirty: bool = false, cold_start: bool = true, /// List of atoms that are either synthetic or map directly to the Zig source program. -managed_atoms: std.ArrayListUnmanaged(*Atom) = .{}, +atoms: std.ArrayListUnmanaged(Atom) = .{}, /// Table of atoms indexed by the symbol index. -atom_by_index_table: std.AutoHashMapUnmanaged(u32, *Atom) = .{}, +atom_by_index_table: std.AutoHashMapUnmanaged(u32, Atom.Index) = .{}, /// Table of unnamed constants associated with a parent `Decl`. /// We store them here so that we can free the constants whenever the `Decl` @@ -210,11 +210,36 @@ bindings: BindingTable = .{}, /// this will be a table indexed by index into the list of Atoms. lazy_bindings: BindingTable = .{}, -/// Table of Decls that are currently alive. -/// We store them here so that we can properly dispose of any allocated -/// memory within the atom in the incremental linker. -/// TODO consolidate this. -decls: std.AutoArrayHashMapUnmanaged(Module.Decl.Index, ?u8) = .{}, +/// Table of tracked Decls. +decls: std.AutoArrayHashMapUnmanaged(Module.Decl.Index, DeclMetadata) = .{}, + +const DeclMetadata = struct { + atom: Atom.Index, + section: u8, + /// A list of all exports aliases of this Decl. + /// TODO do we actually need this at all? + exports: std.ArrayListUnmanaged(u32) = .{}, + + fn getExport(m: DeclMetadata, macho_file: *const MachO, name: []const u8) ?u32 { + for (m.exports.items) |exp| { + if (mem.eql(u8, name, macho_file.getSymbolName(.{ + .sym_index = exp, + .file = null, + }))) return exp; + } + return null; + } + + fn getExportPtr(m: *DeclMetadata, macho_file: *MachO, name: []const u8) ?*u32 { + for (m.exports.items) |*exp| { + if (mem.eql(u8, name, macho_file.getSymbolName(.{ + .sym_index = exp.*, + .file = null, + }))) return exp; + } + return null; + } +}; const Entry = struct { target: SymbolWithLoc, @@ -229,8 +254,8 @@ const Entry = struct { return macho_file.getSymbolPtr(.{ .sym_index = entry.sym_index, .file = null }); } - pub fn getAtom(entry: Entry, macho_file: *MachO) ?*Atom { - return macho_file.getAtomForSymbol(.{ .sym_index = entry.sym_index, .file = null }); + pub fn getAtomIndex(entry: Entry, macho_file: *MachO) ?Atom.Index { + return macho_file.getAtomIndexForSymbol(.{ .sym_index = entry.sym_index, .file = null }); } pub fn getName(entry: Entry, macho_file: *MachO) []const u8 { @@ -238,10 +263,10 @@ const Entry = struct { } }; -const BindingTable = std.AutoArrayHashMapUnmanaged(*Atom, std.ArrayListUnmanaged(Atom.Binding)); -const UnnamedConstTable = std.AutoArrayHashMapUnmanaged(Module.Decl.Index, std.ArrayListUnmanaged(*Atom)); -const RebaseTable = std.AutoArrayHashMapUnmanaged(*Atom, std.ArrayListUnmanaged(u32)); -const RelocationTable = std.AutoArrayHashMapUnmanaged(*Atom, std.ArrayListUnmanaged(Relocation)); +const BindingTable = std.AutoArrayHashMapUnmanaged(Atom.Index, std.ArrayListUnmanaged(Atom.Binding)); +const UnnamedConstTable = std.AutoArrayHashMapUnmanaged(Module.Decl.Index, std.ArrayListUnmanaged(Atom.Index)); +const RebaseTable = std.AutoArrayHashMapUnmanaged(Atom.Index, std.ArrayListUnmanaged(u32)); +const RelocationTable = std.AutoArrayHashMapUnmanaged(Atom.Index, std.ArrayListUnmanaged(Relocation)); const PendingUpdate = union(enum) { resolve_undef: u32, @@ -286,10 +311,6 @@ pub const default_pagezero_vmsize: u64 = 0x100000000; /// potential future extensions. pub const default_headerpad_size: u32 = 0x1000; -pub const Export = struct { - sym_index: ?u32 = null, -}; - pub fn openPath(allocator: Allocator, options: link.Options) !*MachO { assert(options.target.ofmt == .macho); @@ -451,9 +472,9 @@ pub fn flushModule(self: *MachO, comp: *Compilation, prog_node: *std.Progress.No const module = self.base.options.module orelse return error.LinkingWithoutZigSourceUnimplemented; - if (self.d_sym) |*d_sym| { - try d_sym.dwarf.flushModule(module); - } + // if (self.d_sym) |*d_sym| { + // try d_sym.dwarf.flushModule(module); + // } var libs = std.StringArrayHashMap(link.SystemLib).init(arena); try resolveLibSystem( @@ -547,8 +568,8 @@ pub fn flushModule(self: *MachO, comp: *Compilation, prog_node: *std.Progress.No try self.allocateSpecialSymbols(); - for (self.relocs.keys()) |atom| { - try atom.resolveRelocations(self); + for (self.relocs.keys()) |atom_index| { + try Atom.resolveRelocations(self, atom_index); } if (build_options.enable_logging) { @@ -643,10 +664,10 @@ pub fn flushModule(self: *MachO, comp: *Compilation, prog_node: *std.Progress.No try self.writeCodeSignature(comp, csig); // code signing always comes last } - if (self.d_sym) |*d_sym| { - // Flush debug symbols bundle. - try d_sym.flushModule(self); - } + // if (self.d_sym) |*d_sym| { + // // Flush debug symbols bundle. + // try d_sym.flushModule(self); + // } // if (build_options.enable_link_snapshots) { // if (self.base.options.enable_link_snapshots) @@ -999,18 +1020,19 @@ pub fn parseDependentLibs(self: *MachO, syslibroot: ?[]const u8, dependent_libs: } } -pub fn writeAtom(self: *MachO, atom: *Atom, code: []const u8) !void { +pub fn writeAtom(self: *MachO, atom_index: Atom.Index, code: []const u8) !void { + const atom = self.getAtom(atom_index); const sym = atom.getSymbol(self); const section = self.sections.get(sym.n_sect - 1); const file_offset = section.header.offset + sym.n_value - section.header.addr; log.debug("writing atom for symbol {s} at file offset 0x{x}", .{ atom.getName(self), file_offset }); try self.base.file.?.pwriteAll(code, file_offset); - try atom.resolveRelocations(self); + try Atom.resolveRelocations(self, atom_index); } -fn writePtrWidthAtom(self: *MachO, atom: *Atom) !void { +fn writePtrWidthAtom(self: *MachO, atom_index: Atom.Index) !void { var buffer: [@sizeOf(u64)]u8 = [_]u8{0} ** @sizeOf(u64); - try self.writeAtom(atom, &buffer); + try self.writeAtom(atom_index, &buffer); } fn markRelocsDirtyByTarget(self: *MachO, target: SymbolWithLoc) void { @@ -1026,7 +1048,8 @@ fn markRelocsDirtyByTarget(self: *MachO, target: SymbolWithLoc) void { fn markRelocsDirtyByAddress(self: *MachO, addr: u64) void { for (self.relocs.values()) |*relocs| { for (relocs.items) |*reloc| { - const target_atom = reloc.getTargetAtom(self) orelse continue; + const target_atom_index = reloc.getTargetAtomIndex(self) orelse continue; + const target_atom = self.getAtom(target_atom_index); const target_sym = target_atom.getSymbol(self); if (target_sym.n_value < addr) continue; reloc.dirty = true; @@ -1053,26 +1076,39 @@ pub fn allocateSpecialSymbols(self: *MachO) !void { } } -pub fn createGotAtom(self: *MachO, target: SymbolWithLoc) !*Atom { +pub fn createAtom(self: *MachO) !Atom.Index { const gpa = self.base.allocator; + const atom_index = @intCast(Atom.Index, self.atoms.items.len); + const atom = try self.atoms.addOne(gpa); + const sym_index = try self.allocateSymbol(); + try self.atom_by_index_table.putNoClobber(gpa, sym_index, atom_index); + atom.* = .{ + .sym_index = sym_index, + .file = null, + .size = 0, + .alignment = 0, + .prev_index = null, + .next_index = null, + .dbg_info_atom = undefined, + }; + log.debug("creating ATOM(%{d}) at index {d}", .{ sym_index, atom_index }); + return atom_index; +} - const atom = try gpa.create(Atom); - atom.* = Atom.empty; - try atom.ensureInitialized(self); +pub fn createGotAtom(self: *MachO, target: SymbolWithLoc) !Atom.Index { + const atom_index = try self.createAtom(); + const atom = self.getAtomPtr(atom_index); atom.size = @sizeOf(u64); atom.alignment = @alignOf(u64); - errdefer gpa.destroy(atom); - - try self.managed_atoms.append(gpa, atom); const sym = atom.getSymbolPtr(self); sym.n_type = macho.N_SECT; sym.n_sect = self.got_section_index.? + 1; - sym.n_value = try self.allocateAtom(atom, atom.size, @alignOf(u64)); + sym.n_value = try self.allocateAtom(atom_index, atom.size, @alignOf(u64)); log.debug("allocated GOT atom at 0x{x}", .{sym.n_value}); - try atom.addRelocation(self, .{ + try Atom.addRelocation(self, atom_index, .{ .type = switch (self.base.options.target.cpu.arch) { .aarch64 => @enumToInt(macho.reloc_type_arm64.ARM64_RELOC_UNSIGNED), .x86_64 => @enumToInt(macho.reloc_type_x86_64.X86_64_RELOC_UNSIGNED), @@ -1087,45 +1123,39 @@ pub fn createGotAtom(self: *MachO, target: SymbolWithLoc) !*Atom { const target_sym = self.getSymbol(target); if (target_sym.undf()) { - try atom.addBinding(self, .{ + try Atom.addBinding(self, atom_index, .{ .target = self.getGlobal(self.getSymbolName(target)).?, .offset = 0, }); } else { - try atom.addRebase(self, 0); + try Atom.addRebase(self, atom_index, 0); } - return atom; + return atom_index; } pub fn createDyldPrivateAtom(self: *MachO) !void { if (self.dyld_stub_binder_index == null) return; - if (self.dyld_private_atom != null) return; + if (self.dyld_private_atom_index != null) return; - const gpa = self.base.allocator; - - const atom = try gpa.create(Atom); - atom.* = Atom.empty; - try atom.ensureInitialized(self); + const atom_index = try self.createAtom(); + const atom = self.getAtomPtr(atom_index); atom.size = @sizeOf(u64); atom.alignment = @alignOf(u64); - errdefer gpa.destroy(atom); const sym = atom.getSymbolPtr(self); sym.n_type = macho.N_SECT; sym.n_sect = self.data_section_index.? + 1; - self.dyld_private_atom = atom; + self.dyld_private_atom_index = atom_index; - try self.managed_atoms.append(gpa, atom); - - sym.n_value = try self.allocateAtom(atom, atom.size, @alignOf(u64)); + sym.n_value = try self.allocateAtom(atom_index, atom.size, @alignOf(u64)); log.debug("allocated dyld_private atom at 0x{x}", .{sym.n_value}); - try self.writePtrWidthAtom(atom); + try self.writePtrWidthAtom(atom_index); } pub fn createStubHelperPreambleAtom(self: *MachO) !void { if (self.dyld_stub_binder_index == null) return; - if (self.stub_helper_preamble_atom != null) return; + if (self.stub_helper_preamble_atom_index != null) return; const gpa = self.base.allocator; const arch = self.base.options.target.cpu.arch; @@ -1134,22 +1164,23 @@ pub fn createStubHelperPreambleAtom(self: *MachO) !void { .aarch64 => 6 * @sizeOf(u32), else => unreachable, }; - const atom = try gpa.create(Atom); - atom.* = Atom.empty; - try atom.ensureInitialized(self); + const atom_index = try self.createAtom(); + const atom = self.getAtomPtr(atom_index); atom.size = size; atom.alignment = switch (arch) { .x86_64 => 1, .aarch64 => @alignOf(u32), else => unreachable, }; - errdefer gpa.destroy(atom); const sym = atom.getSymbolPtr(self); sym.n_type = macho.N_SECT; sym.n_sect = self.stub_helper_section_index.? + 1; - const dyld_private_sym_index = self.dyld_private_atom.?.getSymbolIndex().?; + const dyld_private_sym_index = if (self.dyld_private_atom_index) |dyld_index| + self.getAtom(dyld_index).getSymbolIndex().? + else + unreachable; const code = try gpa.alloc(u8, size); defer gpa.free(code); @@ -1168,7 +1199,7 @@ pub fn createStubHelperPreambleAtom(self: *MachO) !void { code[9] = 0xff; code[10] = 0x25; - try atom.addRelocations(self, 2, .{ .{ + try Atom.addRelocations(self, atom_index, 2, .{ .{ .type = @enumToInt(macho.reloc_type_x86_64.X86_64_RELOC_SIGNED), .target = .{ .sym_index = dyld_private_sym_index, .file = null }, .offset = 3, @@ -1208,7 +1239,7 @@ pub fn createStubHelperPreambleAtom(self: *MachO) !void { // br x16 mem.writeIntLittle(u32, code[20..][0..4], aarch64.Instruction.br(.x16).toU32()); - try atom.addRelocations(self, 4, .{ .{ + try Atom.addRelocations(self, atom_index, 4, .{ .{ .type = @enumToInt(macho.reloc_type_arm64.ARM64_RELOC_PAGE21), .target = .{ .sym_index = dyld_private_sym_index, .file = null }, .offset = 0, @@ -1241,16 +1272,14 @@ pub fn createStubHelperPreambleAtom(self: *MachO) !void { else => unreachable, } - self.stub_helper_preamble_atom = atom; + self.stub_helper_preamble_atom_index = atom_index; - try self.managed_atoms.append(gpa, atom); - - sym.n_value = try self.allocateAtom(atom, size, atom.alignment); + sym.n_value = try self.allocateAtom(atom_index, size, atom.alignment); log.debug("allocated stub preamble atom at 0x{x}", .{sym.n_value}); - try self.writeAtom(atom, code); + try self.writeAtom(atom_index, code); } -pub fn createStubHelperAtom(self: *MachO) !*Atom { +pub fn createStubHelperAtom(self: *MachO) !Atom.Index { const gpa = self.base.allocator; const arch = self.base.options.target.cpu.arch; const size: u4 = switch (arch) { @@ -1258,16 +1287,14 @@ pub fn createStubHelperAtom(self: *MachO) !*Atom { .aarch64 => 3 * @sizeOf(u32), else => unreachable, }; - const atom = try gpa.create(Atom); - atom.* = Atom.empty; - try atom.ensureInitialized(self); + const atom_index = try self.createAtom(); + const atom = self.getAtomPtr(atom_index); atom.size = size; atom.alignment = switch (arch) { .x86_64 => 1, .aarch64 => @alignOf(u32), else => unreachable, }; - errdefer gpa.destroy(atom); const sym = atom.getSymbolPtr(self); sym.n_type = macho.N_SECT; @@ -1277,6 +1304,11 @@ pub fn createStubHelperAtom(self: *MachO) !*Atom { defer gpa.free(code); mem.set(u8, code, 0); + const stub_helper_preamble_atom_sym_index = if (self.stub_helper_preamble_atom_index) |stub_index| + self.getAtom(stub_index).getSymbolIndex().? + else + unreachable; + switch (arch) { .x86_64 => { // pushq @@ -1285,9 +1317,9 @@ pub fn createStubHelperAtom(self: *MachO) !*Atom { // jmpq code[5] = 0xe9; - try atom.addRelocation(self, .{ + try Atom.addRelocation(self, atom_index, .{ .type = @enumToInt(macho.reloc_type_x86_64.X86_64_RELOC_BRANCH), - .target = .{ .sym_index = self.stub_helper_preamble_atom.?.getSymbolIndex().?, .file = null }, + .target = .{ .sym_index = stub_helper_preamble_atom_sym_index, .file = null }, .offset = 6, .addend = 0, .pcrel = true, @@ -1308,9 +1340,9 @@ pub fn createStubHelperAtom(self: *MachO) !*Atom { mem.writeIntLittle(u32, code[4..8], aarch64.Instruction.b(0).toU32()); // Next 4 bytes 8..12 are just a placeholder populated in `populateLazyBindOffsetsInStubHelper`. - try atom.addRelocation(self, .{ + try Atom.addRelocation(self, atom_index, .{ .type = @enumToInt(macho.reloc_type_arm64.ARM64_RELOC_BRANCH26), - .target = .{ .sym_index = self.stub_helper_preamble_atom.?.getSymbolIndex().?, .file = null }, + .target = .{ .sym_index = stub_helper_preamble_atom_sym_index, .file = null }, .offset = 4, .addend = 0, .pcrel = true, @@ -1320,29 +1352,24 @@ pub fn createStubHelperAtom(self: *MachO) !*Atom { else => unreachable, } - try self.managed_atoms.append(gpa, atom); - - sym.n_value = try self.allocateAtom(atom, size, atom.alignment); + sym.n_value = try self.allocateAtom(atom_index, size, atom.alignment); log.debug("allocated stub helper atom at 0x{x}", .{sym.n_value}); - try self.writeAtom(atom, code); + try self.writeAtom(atom_index, code); - return atom; + return atom_index; } -pub fn createLazyPointerAtom(self: *MachO, stub_sym_index: u32, target: SymbolWithLoc) !*Atom { - const gpa = self.base.allocator; - const atom = try gpa.create(Atom); - atom.* = Atom.empty; - try atom.ensureInitialized(self); +pub fn createLazyPointerAtom(self: *MachO, stub_sym_index: u32, target: SymbolWithLoc) !Atom.Index { + const atom_index = try self.createAtom(); + const atom = self.getAtomPtr(atom_index); atom.size = @sizeOf(u64); atom.alignment = @alignOf(u64); - errdefer gpa.destroy(atom); const sym = atom.getSymbolPtr(self); sym.n_type = macho.N_SECT; sym.n_sect = self.la_symbol_ptr_section_index.? + 1; - try atom.addRelocation(self, .{ + try Atom.addRelocation(self, atom_index, .{ .type = switch (self.base.options.target.cpu.arch) { .aarch64 => @enumToInt(macho.reloc_type_arm64.ARM64_RELOC_UNSIGNED), .x86_64 => @enumToInt(macho.reloc_type_x86_64.X86_64_RELOC_UNSIGNED), @@ -1354,22 +1381,20 @@ pub fn createLazyPointerAtom(self: *MachO, stub_sym_index: u32, target: SymbolWi .pcrel = false, .length = 3, }); - try atom.addRebase(self, 0); - try atom.addLazyBinding(self, .{ + try Atom.addRebase(self, atom_index, 0); + try Atom.addLazyBinding(self, atom_index, .{ .target = self.getGlobal(self.getSymbolName(target)).?, .offset = 0, }); - try self.managed_atoms.append(gpa, atom); - - sym.n_value = try self.allocateAtom(atom, atom.size, @alignOf(u64)); + sym.n_value = try self.allocateAtom(atom_index, atom.size, @alignOf(u64)); log.debug("allocated lazy pointer atom at 0x{x} ({s})", .{ sym.n_value, self.getSymbolName(target) }); - try self.writePtrWidthAtom(atom); + try self.writePtrWidthAtom(atom_index); - return atom; + return atom_index; } -pub fn createStubAtom(self: *MachO, laptr_sym_index: u32) !*Atom { +pub fn createStubAtom(self: *MachO, laptr_sym_index: u32) !Atom.Index { const gpa = self.base.allocator; const arch = self.base.options.target.cpu.arch; const size: u4 = switch (arch) { @@ -1377,9 +1402,8 @@ pub fn createStubAtom(self: *MachO, laptr_sym_index: u32) !*Atom { .aarch64 => 3 * @sizeOf(u32), else => unreachable, // unhandled architecture type }; - const atom = try gpa.create(Atom); - atom.* = Atom.empty; - try atom.ensureInitialized(self); + const atom_index = try self.createAtom(); + const atom = self.getAtomPtr(atom_index); atom.size = size; atom.alignment = switch (arch) { .x86_64 => 1, @@ -1387,7 +1411,6 @@ pub fn createStubAtom(self: *MachO, laptr_sym_index: u32) !*Atom { else => unreachable, // unhandled architecture type }; - errdefer gpa.destroy(atom); const sym = atom.getSymbolPtr(self); sym.n_type = macho.N_SECT; @@ -1403,7 +1426,7 @@ pub fn createStubAtom(self: *MachO, laptr_sym_index: u32) !*Atom { code[0] = 0xff; code[1] = 0x25; - try atom.addRelocation(self, .{ + try Atom.addRelocation(self, atom_index, .{ .type = @enumToInt(macho.reloc_type_x86_64.X86_64_RELOC_BRANCH), .target = .{ .sym_index = laptr_sym_index, .file = null }, .offset = 2, @@ -1424,7 +1447,7 @@ pub fn createStubAtom(self: *MachO, laptr_sym_index: u32) !*Atom { // br x16 mem.writeIntLittle(u32, code[8..12], aarch64.Instruction.br(.x16).toU32()); - try atom.addRelocations(self, 2, .{ + try Atom.addRelocations(self, atom_index, 2, .{ .{ .type = @enumToInt(macho.reloc_type_arm64.ARM64_RELOC_PAGE21), .target = .{ .sym_index = laptr_sym_index, .file = null }, @@ -1446,13 +1469,11 @@ pub fn createStubAtom(self: *MachO, laptr_sym_index: u32) !*Atom { else => unreachable, } - try self.managed_atoms.append(gpa, atom); - - sym.n_value = try self.allocateAtom(atom, size, atom.alignment); + sym.n_value = try self.allocateAtom(atom_index, size, atom.alignment); log.debug("allocated stub atom at 0x{x}", .{sym.n_value}); - try self.writeAtom(atom, code); + try self.writeAtom(atom_index, code); - return atom; + return atom_index; } pub fn createMhExecuteHeaderSymbol(self: *MachO) !void { @@ -1586,9 +1607,12 @@ pub fn resolveSymbolsInDylibs(self: *MachO) !void { if (self.stubs_table.contains(global)) break :blk; const stub_index = try self.allocateStubEntry(global); - const stub_helper_atom = try self.createStubHelperAtom(); - const laptr_atom = try self.createLazyPointerAtom(stub_helper_atom.getSymbolIndex().?, global); - const stub_atom = try self.createStubAtom(laptr_atom.getSymbolIndex().?); + const stub_helper_atom_index = try self.createStubHelperAtom(); + const stub_helper_atom = self.getAtom(stub_helper_atom_index); + const laptr_atom_index = try self.createLazyPointerAtom(stub_helper_atom.getSymbolIndex().?, global); + const laptr_atom = self.getAtom(laptr_atom_index); + const stub_atom_index = try self.createStubAtom(laptr_atom.getSymbolIndex().?); + const stub_atom = self.getAtom(stub_atom_index); self.stubs.items[stub_index].sym_index = stub_atom.getSymbolIndex().?; self.markRelocsDirtyByTarget(global); } @@ -1686,10 +1710,11 @@ pub fn resolveDyldStubBinder(self: *MachO) !void { // Add dyld_stub_binder as the final GOT entry. const got_index = try self.allocateGotEntry(global); - const got_atom = try self.createGotAtom(global); + const got_atom_index = try self.createGotAtom(global); + const got_atom = self.getAtom(got_atom_index); self.got_entries.items[got_index].sym_index = got_atom.getSymbolIndex().?; - try self.writePtrWidthAtom(got_atom); + try self.writePtrWidthAtom(got_atom_index); } pub fn deinit(self: *MachO) void { @@ -1699,9 +1724,9 @@ pub fn deinit(self: *MachO) void { if (self.llvm_object) |llvm_object| llvm_object.destroy(gpa); } - if (self.d_sym) |*d_sym| { - d_sym.deinit(); - } + // if (self.d_sym) |*d_sym| { + // d_sym.deinit(); + // } self.got_entries.deinit(gpa); self.got_entries_free_list.deinit(gpa); @@ -1739,12 +1764,12 @@ pub fn deinit(self: *MachO) void { } self.sections.deinit(gpa); - for (self.managed_atoms.items) |atom| { - gpa.destroy(atom); - } - self.managed_atoms.deinit(gpa); + self.atoms.deinit(gpa); if (self.base.options.module) |_| { + for (self.decls.values()) |*m| { + m.exports.deinit(gpa); + } self.decls.deinit(gpa); } else { assert(self.decls.count() == 0); @@ -1778,14 +1803,15 @@ pub fn deinit(self: *MachO) void { self.lazy_bindings.deinit(gpa); } -fn freeAtom(self: *MachO, atom: *Atom) void { - log.debug("freeAtom {*}", .{atom}); +fn freeAtom(self: *MachO, atom_index: Atom.Index) void { + log.debug("freeAtom {d}", .{atom_index}); const gpa = self.base.allocator; // Remove any relocs and base relocs associated with this Atom - self.freeRelocationsForAtom(atom); + Atom.freeRelocations(self, atom_index); + const atom = self.getAtom(atom_index); const sect_id = atom.getSymbol(self).n_sect - 1; const free_list = &self.sections.items(.free_list)[sect_id]; var already_have_free_list_node = false; @@ -1793,45 +1819,46 @@ fn freeAtom(self: *MachO, atom: *Atom) void { var i: usize = 0; // TODO turn free_list into a hash map while (i < free_list.items.len) { - if (free_list.items[i] == atom) { + if (free_list.items[i] == atom_index) { _ = free_list.swapRemove(i); continue; } - if (free_list.items[i] == atom.prev) { + if (free_list.items[i] == atom.prev_index) { already_have_free_list_node = true; } i += 1; } } - const maybe_last_atom = &self.sections.items(.last_atom)[sect_id]; - if (maybe_last_atom.*) |last_atom| { - if (last_atom == atom) { - if (atom.prev) |prev| { + const maybe_last_atom_index = &self.sections.items(.last_atom_index)[sect_id]; + if (maybe_last_atom_index.*) |last_atom_index| { + if (last_atom_index == atom_index) { + if (atom.prev_index) |prev_index| { // TODO shrink the section size here - maybe_last_atom.* = prev; + maybe_last_atom_index.* = prev_index; } else { - maybe_last_atom.* = null; + maybe_last_atom_index.* = null; } } } - if (atom.prev) |prev| { - prev.next = atom.next; + if (atom.prev_index) |prev_index| { + const prev = self.getAtomPtr(prev_index); + prev.next_index = atom.next_index; - if (!already_have_free_list_node and prev.freeListEligible(self)) { + if (!already_have_free_list_node and prev.*.freeListEligible(self)) { // The free list is heuristics, it doesn't have to be perfect, so we can ignore // the OOM here. - free_list.append(gpa, prev) catch {}; + free_list.append(gpa, prev_index) catch {}; } } else { - atom.prev = null; + self.getAtomPtr(atom_index).prev_index = null; } - if (atom.next) |next| { - next.prev = atom.prev; + if (atom.next_index) |next_index| { + self.getAtomPtr(next_index).prev_index = atom.prev_index; } else { - atom.next = null; + self.getAtomPtr(atom_index).next_index = null; } // Appending to free lists is allowed to fail because the free lists are heuristics based anyway. @@ -1849,9 +1876,9 @@ fn freeAtom(self: *MachO, atom: *Atom) void { }; _ = self.got_entries_table.remove(got_target); - if (self.d_sym) |*d_sym| { - d_sym.swapRemoveRelocs(sym_index); - } + // if (self.d_sym) |*d_sym| { + // d_sym.swapRemoveRelocs(sym_index); + // } log.debug(" adding GOT index {d} to free list (target local@{d})", .{ got_index, sym_index }); } @@ -1859,27 +1886,28 @@ fn freeAtom(self: *MachO, atom: *Atom) void { self.locals.items[sym_index].n_type = 0; _ = self.atom_by_index_table.remove(sym_index); log.debug(" adding local symbol index {d} to free list", .{sym_index}); - atom.sym_index = 0; + self.getAtomPtr(atom_index).sym_index = 0; - if (self.d_sym) |*d_sym| { - d_sym.dwarf.freeAtom(&atom.dbg_info_atom); - } + // if (self.d_sym) |*d_sym| { + // d_sym.dwarf.freeAtom(&atom.dbg_info_atom); + // } } -fn shrinkAtom(self: *MachO, atom: *Atom, new_block_size: u64) void { +fn shrinkAtom(self: *MachO, atom_index: Atom.Index, new_block_size: u64) void { _ = self; - _ = atom; + _ = atom_index; _ = new_block_size; // TODO check the new capacity, and if it crosses the size threshold into a big enough // capacity, insert a free list node for it. } -fn growAtom(self: *MachO, atom: *Atom, new_atom_size: u64, alignment: u64) !u64 { +fn growAtom(self: *MachO, atom_index: Atom.Index, new_atom_size: u64, alignment: u64) !u64 { + const atom = self.getAtom(atom_index); const sym = atom.getSymbol(self); const align_ok = mem.alignBackwardGeneric(u64, sym.n_value, alignment) == sym.n_value; const need_realloc = !align_ok or new_atom_size > atom.capacity(self); if (!need_realloc) return sym.n_value; - return self.allocateAtom(atom, new_atom_size, alignment); + return self.allocateAtom(atom_index, new_atom_size, alignment); } pub fn allocateSymbol(self: *MachO) !u32 { @@ -1986,31 +2014,29 @@ pub fn updateFunc(self: *MachO, module: *Module, func: *Module.Fn, air: Air, liv const decl_index = func.owner_decl; const decl = module.declPtr(decl_index); - const atom = &decl.link.macho; - try atom.ensureInitialized(self); - const gop = try self.decls.getOrPut(self.base.allocator, decl_index); - if (gop.found_existing) { - self.freeUnnamedConsts(decl_index); - self.freeRelocationsForAtom(atom); - } else { - gop.value_ptr.* = null; - } + + const atom_index = try self.getOrCreateAtomForDecl(decl_index); + self.freeUnnamedConsts(decl_index); + Atom.freeRelocations(self, atom_index); + + const atom = self.getAtom(atom_index); + _ = atom; var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); - var decl_state = if (self.d_sym) |*d_sym| - try d_sym.dwarf.initDeclState(module, decl_index) - else - null; - defer if (decl_state) |*ds| ds.deinit(); + // var decl_state = if (self.d_sym) |*d_sym| + // try d_sym.dwarf.initDeclState(module, decl_index) + // else + // null; + // defer if (decl_state) |*ds| ds.deinit(); - const res = if (decl_state) |*ds| - try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .{ - .dwarf = ds, - }) - else - try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .none); + // const res = if (decl_state) |*ds| + // try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .{ + // .dwarf = ds, + // }) + // else + const res = try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .none); const code = switch (res) { .ok => code_buffer.items, @@ -2022,16 +2048,11 @@ pub fn updateFunc(self: *MachO, module: *Module, func: *Module.Fn, air: Air, liv }; const addr = try self.updateDeclCode(decl_index, code); + _ = addr; - if (decl_state) |*ds| { - try self.d_sym.?.dwarf.commitDeclState( - module, - decl_index, - addr, - decl.link.macho.size, - ds, - ); - } + // if (decl_state) |*ds| { + // try self.d_sym.?.dwarf.commitDeclState(module, decl_index, addr, atom.size, ds); + // } // Since we updated the vaddr and the size, each corresponding export symbol also // needs to be updated. @@ -2065,11 +2086,8 @@ pub fn lowerUnnamedConst(self: *MachO, typed_value: TypedValue, decl_index: Modu log.debug("allocating symbol indexes for {?s}", .{name}); - const atom = try gpa.create(Atom); - errdefer gpa.destroy(atom); - atom.* = Atom.empty; - try atom.ensureInitialized(self); - try self.managed_atoms.append(gpa, atom); + const atom_index = try self.createAtom(); + const atom = self.getAtomPtr(atom_index); const res = try codegen.generateSymbol(&self.base, decl.srcLoc(), typed_value, &code_buffer, .none, .{ .parent_atom_index = atom.getSymbolIndex().?, @@ -2088,21 +2106,21 @@ pub fn lowerUnnamedConst(self: *MachO, typed_value: TypedValue, decl_index: Modu atom.size = code.len; atom.alignment = required_alignment; // TODO: work out logic for disambiguating functions from function pointers - // const sect_id = self.getDeclOutputSection(decl); + // const sect_id = self.getDeclOutputSection(decl_index); const sect_id = self.data_const_section_index.?; const symbol = atom.getSymbolPtr(self); symbol.n_strx = name_str_index; symbol.n_type = macho.N_SECT; symbol.n_sect = sect_id + 1; - symbol.n_value = try self.allocateAtom(atom, code.len, required_alignment); - errdefer self.freeAtom(atom); + symbol.n_value = try self.allocateAtom(atom_index, code.len, required_alignment); + errdefer self.freeAtom(atom_index); - try unnamed_consts.append(gpa, atom); + try unnamed_consts.append(gpa, atom_index); log.debug("allocated atom for {?s} at 0x{x}", .{ name, symbol.n_value }); log.debug(" (required alignment 0x{x})", .{required_alignment}); - try self.writeAtom(atom, code); + try self.writeAtom(atom_index, code); return atom.getSymbolIndex().?; } @@ -2129,41 +2147,36 @@ pub fn updateDecl(self: *MachO, module: *Module, decl_index: Module.Decl.Index) } } - const atom = &decl.link.macho; - try atom.ensureInitialized(self); - const gop = try self.decls.getOrPut(self.base.allocator, decl_index); - if (gop.found_existing) { - self.freeRelocationsForAtom(atom); - } else { - gop.value_ptr.* = null; - } + const atom_index = try self.getOrCreateAtomForDecl(decl_index); + Atom.freeRelocations(self, atom_index); + const atom = self.getAtom(atom_index); var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); - var decl_state: ?Dwarf.DeclState = if (self.d_sym) |*d_sym| - try d_sym.dwarf.initDeclState(module, decl_index) - else - null; - defer if (decl_state) |*ds| ds.deinit(); + // var decl_state: ?Dwarf.DeclState = if (self.d_sym) |*d_sym| + // try d_sym.dwarf.initDeclState(module, decl_index) + // else + // null; + // defer if (decl_state) |*ds| ds.deinit(); const decl_val = if (decl.val.castTag(.variable)) |payload| payload.data.init else decl.val; - const res = if (decl_state) |*ds| - try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ - .ty = decl.ty, - .val = decl_val, - }, &code_buffer, .{ - .dwarf = ds, - }, .{ - .parent_atom_index = decl.link.macho.getSymbolIndex().?, - }) - else - try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ - .ty = decl.ty, - .val = decl_val, - }, &code_buffer, .none, .{ - .parent_atom_index = decl.link.macho.getSymbolIndex().?, - }); + // const res = if (decl_state) |*ds| + // try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ + // .ty = decl.ty, + // .val = decl_val, + // }, &code_buffer, .{ + // .dwarf = ds, + // }, .{ + // .parent_atom_index = atom.getSymbolIndex().?, + // }) + // else + const res = try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ + .ty = decl.ty, + .val = decl_val, + }, &code_buffer, .none, .{ + .parent_atom_index = atom.getSymbolIndex().?, + }); const code = switch (res) { .ok => code_buffer.items, @@ -2174,23 +2187,31 @@ pub fn updateDecl(self: *MachO, module: *Module, decl_index: Module.Decl.Index) }, }; const addr = try self.updateDeclCode(decl_index, code); + _ = addr; - if (decl_state) |*ds| { - try self.d_sym.?.dwarf.commitDeclState( - module, - decl_index, - addr, - decl.link.macho.size, - ds, - ); - } + // if (decl_state) |*ds| { + // try self.d_sym.?.dwarf.commitDeclState(module, decl_index, addr, atom.size, ds); + // } // Since we updated the vaddr and the size, each corresponding export symbol also // needs to be updated. try self.updateDeclExports(module, decl_index, module.getDeclExports(decl_index)); } -fn getDeclOutputSection(self: *MachO, decl: *Module.Decl) u8 { +pub fn getOrCreateAtomForDecl(self: *MachO, decl_index: Module.Decl.Index) !Atom.Index { + const gop = try self.decls.getOrPut(self.base.allocator, decl_index); + if (!gop.found_existing) { + gop.value_ptr.* = .{ + .atom = try self.createAtom(), + .section = self.getDeclOutputSection(decl_index), + .exports = .{}, + }; + } + return gop.value_ptr.atom; +} + +fn getDeclOutputSection(self: *MachO, decl_index: Module.Decl.Index) u8 { + const decl = self.base.options.module.?.declPtr(decl_index); const ty = decl.ty; const val = decl.val; const zig_ty = ty.zigTypeTag(); @@ -2341,13 +2362,11 @@ fn updateDeclCode(self: *MachO, decl_index: Module.Decl.Index, code: []const u8) const sym_name = try decl.getFullyQualifiedName(mod); defer self.base.allocator.free(sym_name); - const atom = &decl.link.macho; - const sym_index = atom.getSymbolIndex().?; // Atom was not initialized - const decl_ptr = self.decls.getPtr(decl_index).?; - if (decl_ptr.* == null) { - decl_ptr.* = self.getDeclOutputSection(decl); - } - const sect_id = decl_ptr.*.?; + const decl_metadata = self.decls.get(decl_index).?; + const atom_index = decl_metadata.atom; + const atom = self.getAtom(atom_index); + const sym_index = atom.getSymbolIndex().?; + const sect_id = decl_metadata.section; const code_len = code.len; if (atom.size != 0) { @@ -2357,11 +2376,11 @@ fn updateDeclCode(self: *MachO, decl_index: Module.Decl.Index, code: []const u8) sym.n_sect = sect_id + 1; sym.n_desc = 0; - const capacity = decl.link.macho.capacity(self); + const capacity = atom.capacity(self); const need_realloc = code_len > capacity or !mem.isAlignedGeneric(u64, sym.n_value, required_alignment); if (need_realloc) { - const vaddr = try self.growAtom(atom, code_len, required_alignment); + const vaddr = try self.growAtom(atom_index, code_len, required_alignment); log.debug("growing {s} and moving from 0x{x} to 0x{x}", .{ sym_name, sym.n_value, vaddr }); log.debug(" (required alignment 0x{x})", .{required_alignment}); @@ -2369,19 +2388,19 @@ fn updateDeclCode(self: *MachO, decl_index: Module.Decl.Index, code: []const u8) sym.n_value = vaddr; log.debug(" (updating GOT entry)", .{}); const got_target = SymbolWithLoc{ .sym_index = sym_index, .file = null }; - const got_atom = self.getGotAtomForSymbol(got_target).?; + const got_atom_index = self.getGotAtomIndexForSymbol(got_target).?; self.markRelocsDirtyByTarget(got_target); - try self.writePtrWidthAtom(got_atom); + try self.writePtrWidthAtom(got_atom_index); } } else if (code_len < atom.size) { - self.shrinkAtom(atom, code_len); - } else if (atom.next == null) { + self.shrinkAtom(atom_index, code_len); + } else if (atom.next_index == null) { const header = &self.sections.items(.header)[sect_id]; const segment = self.getSegment(sect_id); const needed_size = (sym.n_value + code_len) - segment.vmaddr; header.size = needed_size; } - atom.size = code_len; + self.getAtomPtr(atom_index).size = code_len; } else { const name_str_index = try self.strtab.insert(gpa, sym_name); const sym = atom.getSymbolPtr(self); @@ -2390,33 +2409,36 @@ fn updateDeclCode(self: *MachO, decl_index: Module.Decl.Index, code: []const u8) sym.n_sect = sect_id + 1; sym.n_desc = 0; - const vaddr = try self.allocateAtom(atom, code_len, required_alignment); - errdefer self.freeAtom(atom); + const vaddr = try self.allocateAtom(atom_index, code_len, required_alignment); + errdefer self.freeAtom(atom_index); log.debug("allocated atom for {s} at 0x{x}", .{ sym_name, vaddr }); log.debug(" (required alignment 0x{x})", .{required_alignment}); - atom.size = code_len; + self.getAtomPtr(atom_index).size = code_len; sym.n_value = vaddr; const got_target = SymbolWithLoc{ .sym_index = sym_index, .file = null }; const got_index = try self.allocateGotEntry(got_target); - const got_atom = try self.createGotAtom(got_target); + const got_atom_index = try self.createGotAtom(got_target); + const got_atom = self.getAtom(got_atom_index); self.got_entries.items[got_index].sym_index = got_atom.getSymbolIndex().?; - try self.writePtrWidthAtom(got_atom); + try self.writePtrWidthAtom(got_atom_index); } self.markRelocsDirtyByTarget(atom.getSymbolWithLoc()); - try self.writeAtom(atom, code); + try self.writeAtom(atom_index, code); return atom.getSymbol(self).n_value; } pub fn updateDeclLineNumber(self: *MachO, module: *Module, decl: *const Module.Decl) !void { + _ = decl; + _ = self; _ = module; - if (self.d_sym) |*d_sym| { - try d_sym.dwarf.updateDeclLineNumber(decl); - } + // if (self.d_sym) |*d_sym| { + // try d_sym.dwarf.updateDeclLineNumber(decl); + // } } pub fn updateDeclExports( @@ -2432,22 +2454,17 @@ pub fn updateDeclExports( if (self.llvm_object) |llvm_object| return llvm_object.updateDeclExports(module, decl_index, exports); } + const tracy = trace(@src()); defer tracy.end(); const gpa = self.base.allocator; const decl = module.declPtr(decl_index); - const atom = &decl.link.macho; - - if (atom.getSymbolIndex() == null) return; - - const gop = try self.decls.getOrPut(gpa, decl_index); - if (!gop.found_existing) { - gop.value_ptr.* = self.getDeclOutputSection(decl); - } - + const atom_index = try self.getOrCreateAtomForDecl(decl_index); + const atom = self.getAtom(atom_index); const decl_sym = atom.getSymbol(self); + const decl_metadata = self.decls.getPtr(decl_index).?; for (exports) |exp| { const exp_name = try std.fmt.allocPrint(gpa, "_{s}", .{exp.options.name}); @@ -2485,9 +2502,9 @@ pub fn updateDeclExports( continue; } - const sym_index = exp.link.macho.sym_index orelse blk: { + const sym_index = decl_metadata.getExport(self, exp_name) orelse blk: { const sym_index = try self.allocateSymbol(); - exp.link.macho.sym_index = sym_index; + try decl_metadata.exports.append(gpa, sym_index); break :blk sym_index; }; const sym_loc = SymbolWithLoc{ .sym_index = sym_index, .file = null }; @@ -2535,16 +2552,18 @@ pub fn updateDeclExports( } } -pub fn deleteExport(self: *MachO, exp: Export) void { +pub fn deleteDeclExport(self: *MachO, decl_index: Module.Decl.Index, name: []const u8) Allocator.Error!void { if (self.llvm_object) |_| return; - const sym_index = exp.sym_index orelse return; + const metadata = self.decls.getPtr(decl_index) orelse return; const gpa = self.base.allocator; + const exp_name = try std.fmt.allocPrint(gpa, "_{s}", .{name}); + defer gpa.free(exp_name); + const sym_index = metadata.getExportPtr(self, exp_name) orelse return; - const sym_loc = SymbolWithLoc{ .sym_index = sym_index, .file = null }; + const sym_loc = SymbolWithLoc{ .sym_index = sym_index.*, .file = null }; const sym = self.getSymbolPtr(sym_loc); - const sym_name = self.getSymbolName(sym_loc); - log.debug("deleting export '{s}'", .{sym_name}); + log.debug("deleting export '{s}'", .{exp_name}); assert(sym.sect() and sym.ext()); sym.* = .{ .n_strx = 0, @@ -2553,9 +2572,9 @@ pub fn deleteExport(self: *MachO, exp: Export) void { .n_desc = 0, .n_value = 0, }; - self.locals_free_list.append(gpa, sym_index) catch {}; + self.locals_free_list.append(gpa, sym_index.*) catch {}; - if (self.resolver.fetchRemove(sym_name)) |entry| { + if (self.resolver.fetchRemove(exp_name)) |entry| { defer gpa.free(entry.key); self.globals_free_list.append(gpa, entry.value) catch {}; self.globals.items[entry.value] = .{ @@ -2563,17 +2582,8 @@ pub fn deleteExport(self: *MachO, exp: Export) void { .file = null, }; } -} -fn freeRelocationsForAtom(self: *MachO, atom: *Atom) void { - var removed_relocs = self.relocs.fetchOrderedRemove(atom); - if (removed_relocs) |*relocs| relocs.value.deinit(self.base.allocator); - var removed_rebases = self.rebases.fetchOrderedRemove(atom); - if (removed_rebases) |*rebases| rebases.value.deinit(self.base.allocator); - var removed_bindings = self.bindings.fetchOrderedRemove(atom); - if (removed_bindings) |*bindings| bindings.value.deinit(self.base.allocator); - var removed_lazy_bindings = self.lazy_bindings.fetchOrderedRemove(atom); - if (removed_lazy_bindings) |*lazy_bindings| lazy_bindings.value.deinit(self.base.allocator); + sym_index.* = 0; } fn freeUnnamedConsts(self: *MachO, decl_index: Module.Decl.Index) void { @@ -2595,28 +2605,22 @@ pub fn freeDecl(self: *MachO, decl_index: Module.Decl.Index) void { log.debug("freeDecl {*}", .{decl}); if (self.decls.fetchSwapRemove(decl_index)) |kv| { - if (kv.value) |_| { - self.freeAtom(&decl.link.macho); - self.freeUnnamedConsts(decl_index); - } + self.freeAtom(kv.value.atom); + self.freeUnnamedConsts(decl_index); } - if (self.d_sym) |*d_sym| { - d_sym.dwarf.freeDecl(decl); - } + // if (self.d_sym) |*d_sym| { + // d_sym.dwarf.freeDecl(decl); + // } } pub fn getDeclVAddr(self: *MachO, decl_index: Module.Decl.Index, reloc_info: File.RelocInfo) !u64 { - const mod = self.base.options.module.?; - const decl = mod.declPtr(decl_index); - assert(self.llvm_object == null); - try decl.link.macho.ensureInitialized(self); - const sym_index = decl.link.macho.getSymbolIndex().?; - - const atom = self.getAtomForSymbol(.{ .sym_index = reloc_info.parent_atom_index, .file = null }).?; - try atom.addRelocation(self, .{ + const this_atom_index = try self.getOrCreateAtomForDecl(decl_index); + const sym_index = self.getAtom(this_atom_index).getSymbolIndex().?; + const atom_index = self.getAtomIndexForSymbol(.{ .sym_index = reloc_info.parent_atom_index, .file = null }).?; + try Atom.addRelocation(self, atom_index, .{ .type = switch (self.base.options.target.cpu.arch) { .aarch64 => @enumToInt(macho.reloc_type_arm64.ARM64_RELOC_UNSIGNED), .x86_64 => @enumToInt(macho.reloc_type_x86_64.X86_64_RELOC_UNSIGNED), @@ -2628,7 +2632,7 @@ pub fn getDeclVAddr(self: *MachO, decl_index: Module.Decl.Index, reloc_info: Fil .pcrel = false, .length = 3, }); - try atom.addRebase(self, @intCast(u32, reloc_info.offset)); + try Atom.addRebase(self, atom_index, @intCast(u32, reloc_info.offset)); return 0; } @@ -2860,34 +2864,36 @@ fn moveSectionInVirtualMemory(self: *MachO, sect_id: u8, needed_size: u64) !void // TODO: enforce order by increasing VM addresses in self.sections container. for (self.sections.items(.header)[sect_id + 1 ..]) |*next_header, next_sect_id| { const index = @intCast(u8, sect_id + 1 + next_sect_id); - const maybe_last_atom = &self.sections.items(.last_atom)[index]; const next_segment = self.getSegmentPtr(index); next_header.addr += diff; next_segment.vmaddr += diff; - if (maybe_last_atom.*) |last_atom| { - var atom = last_atom; + const maybe_last_atom_index = &self.sections.items(.last_atom_index)[index]; + if (maybe_last_atom_index.*) |last_atom_index| { + var atom_index = last_atom_index; while (true) { + const atom = self.getAtom(atom_index); const sym = atom.getSymbolPtr(self); sym.n_value += diff; - if (atom.prev) |prev| { - atom = prev; + if (atom.prev_index) |prev_index| { + atom_index = prev_index; } else break; } } } } -fn allocateAtom(self: *MachO, atom: *Atom, new_atom_size: u64, alignment: u64) !u64 { +fn allocateAtom(self: *MachO, atom_index: Atom.Index, new_atom_size: u64, alignment: u64) !u64 { const tracy = trace(@src()); defer tracy.end(); + const atom = self.getAtom(atom_index); const sect_id = atom.getSymbol(self).n_sect - 1; const segment = self.getSegmentPtr(sect_id); const header = &self.sections.items(.header)[sect_id]; const free_list = &self.sections.items(.free_list)[sect_id]; - const maybe_last_atom = &self.sections.items(.last_atom)[sect_id]; + const maybe_last_atom_index = &self.sections.items(.last_atom_index)[sect_id]; const requires_padding = blk: { if (!header.isCode()) break :blk false; if (header.isSymbolStubs()) break :blk false; @@ -2901,7 +2907,7 @@ fn allocateAtom(self: *MachO, atom: *Atom, new_atom_size: u64, alignment: u64) ! // It would be simpler to do it inside the for loop below, but that would cause a // problem if an error was returned later in the function. So this action // is actually carried out at the end of the function, when errors are no longer possible. - var atom_placement: ?*Atom = null; + var atom_placement: ?Atom.Index = null; var free_list_removal: ?usize = null; // First we look for an appropriately sized free list node. @@ -2909,7 +2915,8 @@ fn allocateAtom(self: *MachO, atom: *Atom, new_atom_size: u64, alignment: u64) ! var vaddr = blk: { var i: usize = 0; while (i < free_list.items.len) { - const big_atom = free_list.items[i]; + const big_atom_index = free_list.items[i]; + const big_atom = self.getAtom(big_atom_index); // We now have a pointer to a live atom that has too much capacity. // Is it enough that we could fit this new atom? const sym = big_atom.getSymbol(self); @@ -2937,30 +2944,35 @@ fn allocateAtom(self: *MachO, atom: *Atom, new_atom_size: u64, alignment: u64) ! const keep_free_list_node = remaining_capacity >= min_text_capacity; // Set up the metadata to be updated, after errors are no longer possible. - atom_placement = big_atom; + atom_placement = big_atom_index; if (!keep_free_list_node) { free_list_removal = i; } break :blk new_start_vaddr; - } else if (maybe_last_atom.*) |last| { + } else if (maybe_last_atom_index.*) |last_index| { + const last = self.getAtom(last_index); const last_symbol = last.getSymbol(self); const ideal_capacity = if (requires_padding) padToIdeal(last.size) else last.size; const ideal_capacity_end_vaddr = last_symbol.n_value + ideal_capacity; const new_start_vaddr = mem.alignForwardGeneric(u64, ideal_capacity_end_vaddr, alignment); - atom_placement = last; + atom_placement = last_index; break :blk new_start_vaddr; } else { break :blk mem.alignForwardGeneric(u64, segment.vmaddr, alignment); } }; - const expand_section = atom_placement == null or atom_placement.?.next == null; + const expand_section = if (atom_placement) |placement_index| + self.getAtom(placement_index).next_index == null + else + true; if (expand_section) { const sect_capacity = self.allocatedSize(header.offset); const needed_size = (vaddr + new_atom_size) - segment.vmaddr; if (needed_size > sect_capacity) { const new_offset = self.findFreeSpace(needed_size, self.page_size); - const current_size = if (maybe_last_atom.*) |last_atom| blk: { + const current_size = if (maybe_last_atom_index.*) |last_atom_index| blk: { + const last_atom = self.getAtom(last_atom_index); const sym = last_atom.getSymbol(self); break :blk (sym.n_value + last_atom.size) - segment.vmaddr; } else 0; @@ -2992,7 +3004,7 @@ fn allocateAtom(self: *MachO, atom: *Atom, new_atom_size: u64, alignment: u64) ! header.size = needed_size; segment.filesize = mem.alignForwardGeneric(u64, needed_size, self.page_size); segment.vmsize = mem.alignForwardGeneric(u64, needed_size, self.page_size); - maybe_last_atom.* = atom; + maybe_last_atom_index.* = atom_index; self.segment_table_dirty = true; } @@ -3002,20 +3014,25 @@ fn allocateAtom(self: *MachO, atom: *Atom, new_atom_size: u64, alignment: u64) ! header.@"align" = align_pow; } - if (atom.prev) |prev| { - prev.next = atom.next; + if (atom.prev_index) |prev_index| { + const prev = self.getAtomPtr(prev_index); + prev.next_index = atom.next_index; } - if (atom.next) |next| { - next.prev = atom.prev; + if (atom.next_index) |next_index| { + const next = self.getAtomPtr(next_index); + next.prev_index = atom.prev_index; } - if (atom_placement) |big_atom| { - atom.prev = big_atom; - atom.next = big_atom.next; - big_atom.next = atom; + if (atom_placement) |big_atom_index| { + const big_atom = self.getAtomPtr(big_atom_index); + const atom_ptr = self.getAtomPtr(atom_index); + atom_ptr.prev_index = big_atom_index; + atom_ptr.next_index = big_atom.next_index; + big_atom.next_index = atom_index; } else { - atom.prev = null; - atom.next = null; + const atom_ptr = self.getAtomPtr(atom_index); + atom_ptr.prev_index = null; + atom_ptr.next_index = null; } if (free_list_removal) |i| { _ = free_list.swapRemove(i); @@ -3155,7 +3172,8 @@ fn collectRebaseData(self: *MachO, rebase: *Rebase) !void { const gpa = self.base.allocator; const slice = self.sections.slice(); - for (self.rebases.keys()) |atom, i| { + for (self.rebases.keys()) |atom_index, i| { + const atom = self.getAtom(atom_index); log.debug(" ATOM(%{?d}, '{s}')", .{ atom.getSymbolIndex(), atom.getName(self) }); const sym = atom.getSymbol(self); @@ -3184,7 +3202,8 @@ fn collectBindData(self: *MachO, bind: anytype, raw_bindings: anytype) !void { const gpa = self.base.allocator; const slice = self.sections.slice(); - for (raw_bindings.keys()) |atom, i| { + for (raw_bindings.keys()) |atom_index, i| { + const atom = self.getAtom(atom_index); log.debug(" ATOM(%{?d}, '{s}')", .{ atom.getSymbolIndex(), atom.getName(self) }); const sym = atom.getSymbol(self); @@ -3359,7 +3378,7 @@ fn populateLazyBindOffsetsInStubHelper(self: *MachO, lazy_bind: LazyBind) !void if (lazy_bind.size() == 0) return; const stub_helper_section_index = self.stub_helper_section_index.?; - assert(self.stub_helper_preamble_atom != null); + assert(self.stub_helper_preamble_atom_index != null); const section = self.sections.get(stub_helper_section_index); @@ -3369,10 +3388,11 @@ fn populateLazyBindOffsetsInStubHelper(self: *MachO, lazy_bind: LazyBind) !void else => unreachable, }; const header = section.header; - var atom = section.last_atom.?; + var atom_index = section.last_atom_index.?; var index: usize = lazy_bind.offsets.items.len; while (index > 0) : (index -= 1) { + const atom = self.getAtom(atom_index); const sym = atom.getSymbol(self); const file_offset = header.offset + sym.n_value - header.addr + stub_offset; const bind_offset = lazy_bind.offsets.items[index - 1]; @@ -3385,7 +3405,7 @@ fn populateLazyBindOffsetsInStubHelper(self: *MachO, lazy_bind: LazyBind) !void try self.base.file.?.pwriteAll(mem.asBytes(&bind_offset), file_offset); - atom = atom.prev.?; + atom_index = atom.prev_index.?; } } @@ -3828,25 +3848,35 @@ pub fn getOrPutGlobalPtr(self: *MachO, name: []const u8) !GetOrPutGlobalPtrResul return GetOrPutGlobalPtrResult{ .found_existing = false, .value_ptr = ptr }; } +pub fn getAtom(self: *MachO, atom_index: Atom.Index) Atom { + assert(atom_index < self.atoms.items.len); + return self.atoms.items[atom_index]; +} + +pub fn getAtomPtr(self: *MachO, atom_index: Atom.Index) *Atom { + assert(atom_index < self.atoms.items.len); + return &self.atoms.items[atom_index]; +} + /// Returns atom if there is an atom referenced by the symbol described by `sym_with_loc` descriptor. /// Returns null on failure. -pub fn getAtomForSymbol(self: *MachO, sym_with_loc: SymbolWithLoc) ?*Atom { +pub fn getAtomIndexForSymbol(self: *MachO, sym_with_loc: SymbolWithLoc) ?Atom.Index { assert(sym_with_loc.file == null); return self.atom_by_index_table.get(sym_with_loc.sym_index); } /// Returns GOT atom that references `sym_with_loc` if one exists. /// Returns null otherwise. -pub fn getGotAtomForSymbol(self: *MachO, sym_with_loc: SymbolWithLoc) ?*Atom { +pub fn getGotAtomIndexForSymbol(self: *MachO, sym_with_loc: SymbolWithLoc) ?Atom.Index { const got_index = self.got_entries_table.get(sym_with_loc) orelse return null; - return self.got_entries.items[got_index].getAtom(self); + return self.got_entries.items[got_index].getAtomIndex(self); } /// Returns stubs atom that references `sym_with_loc` if one exists. /// Returns null otherwise. -pub fn getStubsAtomForSymbol(self: *MachO, sym_with_loc: SymbolWithLoc) ?*Atom { +pub fn getStubsAtomIndexForSymbol(self: *MachO, sym_with_loc: SymbolWithLoc) ?Atom.Index { const stubs_index = self.stubs_table.get(sym_with_loc) orelse return null; - return self.stubs.items[stubs_index].getAtom(self); + return self.stubs.items[stubs_index].getAtomIndex(self); } /// Returns symbol location corresponding to the set entrypoint. @@ -4232,26 +4262,31 @@ pub fn logAtoms(self: *MachO) void { log.debug("atoms:", .{}); const slice = self.sections.slice(); - for (slice.items(.last_atom)) |last, i| { - var atom = last orelse continue; + for (slice.items(.last_atom_index)) |last_atom_index, i| { + var atom_index = last_atom_index orelse continue; const header = slice.items(.header)[i]; - while (atom.prev) |prev| { - atom = prev; + while (true) { + const atom = self.getAtom(atom_index); + if (atom.prev_index) |prev_index| { + atom_index = prev_index; + } else break; } log.debug("{s},{s}", .{ header.segName(), header.sectName() }); while (true) { - self.logAtom(atom); - if (atom.next) |next| { - atom = next; + self.logAtom(atom_index); + const atom = self.getAtom(atom_index); + if (atom.next_index) |next_index| { + atom_index = next_index; } else break; } } } -pub fn logAtom(self: *MachO, atom: *const Atom) void { +pub fn logAtom(self: *MachO, atom_index: Atom.Index) void { + const atom = self.getAtom(atom_index); const sym = atom.getSymbol(self); const sym_name = atom.getName(self); log.debug(" ATOM(%{?d}, '{s}') @ {x} (sizeof({x}), alignof({x})) in object({?d}) in sect({d})", .{ diff --git a/src/link/MachO/Atom.zig b/src/link/MachO/Atom.zig index f15958b3df..da0115d069 100644 --- a/src/link/MachO/Atom.zig +++ b/src/link/MachO/Atom.zig @@ -39,11 +39,14 @@ size: u64, alignment: u32, /// Points to the previous and next neighbours -next: ?*Atom, -prev: ?*Atom, +/// TODO use the same trick as with symbols: reserve index 0 as null atom +next_index: ?Atom.Index, +prev_index: ?Atom.Index, dbg_info_atom: Dwarf.Atom, +pub const Index = u32; + pub const Binding = struct { target: SymbolWithLoc, offset: u64, @@ -54,22 +57,6 @@ pub const SymbolAtOffset = struct { offset: u64, }; -pub const empty = Atom{ - .sym_index = 0, - .file = null, - .size = 0, - .alignment = 0, - .prev = null, - .next = null, - .dbg_info_atom = undefined, -}; - -pub fn ensureInitialized(self: *Atom, macho_file: *MachO) !void { - if (self.getSymbolIndex() != null) return; // Already initialized - self.sym_index = try macho_file.allocateSymbol(); - try macho_file.atom_by_index_table.putNoClobber(macho_file.base.allocator, self.sym_index, self); -} - pub fn getSymbolIndex(self: Atom) ?u32 { if (self.sym_index == 0) return null; return self.sym_index; @@ -108,7 +95,8 @@ pub fn getName(self: Atom, macho_file: *MachO) []const u8 { /// this calculation. pub fn capacity(self: Atom, macho_file: *MachO) u64 { const self_sym = self.getSymbol(macho_file); - if (self.next) |next| { + if (self.next_index) |next_index| { + const next = macho_file.getAtom(next_index); const next_sym = next.getSymbol(macho_file); return next_sym.n_value - self_sym.n_value; } else { @@ -120,7 +108,8 @@ pub fn capacity(self: Atom, macho_file: *MachO) u64 { pub fn freeListEligible(self: Atom, macho_file: *MachO) bool { // No need to keep a free list node for the last atom. - const next = self.next orelse return false; + const next_index = self.next_index orelse return false; + const next = macho_file.getAtom(next_index); const self_sym = self.getSymbol(macho_file); const next_sym = next.getSymbol(macho_file); const cap = next_sym.n_value - self_sym.n_value; @@ -130,19 +119,19 @@ pub fn freeListEligible(self: Atom, macho_file: *MachO) bool { return surplus >= MachO.min_text_capacity; } -pub fn addRelocation(self: *Atom, macho_file: *MachO, reloc: Relocation) !void { - return self.addRelocations(macho_file, 1, .{reloc}); +pub fn addRelocation(macho_file: *MachO, atom_index: Atom.Index, reloc: Relocation) !void { + return addRelocations(macho_file, atom_index, 1, .{reloc}); } pub fn addRelocations( - self: *Atom, macho_file: *MachO, + atom_index: Atom.Index, comptime count: comptime_int, relocs: [count]Relocation, ) !void { const gpa = macho_file.base.allocator; const target = macho_file.base.options.target; - const gop = try macho_file.relocs.getOrPut(gpa, self); + const gop = try macho_file.relocs.getOrPut(gpa, atom_index); if (!gop.found_existing) { gop.value_ptr.* = .{}; } @@ -156,56 +145,72 @@ pub fn addRelocations( } } -pub fn addRebase(self: *Atom, macho_file: *MachO, offset: u32) !void { +pub fn addRebase(macho_file: *MachO, atom_index: Atom.Index, offset: u32) !void { const gpa = macho_file.base.allocator; - log.debug(" (adding rebase at offset 0x{x} in %{?d})", .{ offset, self.getSymbolIndex() }); - const gop = try macho_file.rebases.getOrPut(gpa, self); + const atom = macho_file.getAtom(atom_index); + log.debug(" (adding rebase at offset 0x{x} in %{?d})", .{ offset, atom.getSymbolIndex() }); + const gop = try macho_file.rebases.getOrPut(gpa, atom_index); if (!gop.found_existing) { gop.value_ptr.* = .{}; } try gop.value_ptr.append(gpa, offset); } -pub fn addBinding(self: *Atom, macho_file: *MachO, binding: Binding) !void { +pub fn addBinding(macho_file: *MachO, atom_index: Atom.Index, binding: Binding) !void { const gpa = macho_file.base.allocator; + const atom = macho_file.getAtom(atom_index); log.debug(" (adding binding to symbol {s} at offset 0x{x} in %{?d})", .{ macho_file.getSymbolName(binding.target), binding.offset, - self.getSymbolIndex(), + atom.getSymbolIndex(), }); - const gop = try macho_file.bindings.getOrPut(gpa, self); + const gop = try macho_file.bindings.getOrPut(gpa, atom_index); if (!gop.found_existing) { gop.value_ptr.* = .{}; } try gop.value_ptr.append(gpa, binding); } -pub fn addLazyBinding(self: *Atom, macho_file: *MachO, binding: Binding) !void { +pub fn addLazyBinding(macho_file: *MachO, atom_index: Atom.Index, binding: Binding) !void { const gpa = macho_file.base.allocator; + const atom = macho_file.getAtom(atom_index); log.debug(" (adding lazy binding to symbol {s} at offset 0x{x} in %{?d})", .{ macho_file.getSymbolName(binding.target), binding.offset, - self.getSymbolIndex(), + atom.getSymbolIndex(), }); - const gop = try macho_file.lazy_bindings.getOrPut(gpa, self); + const gop = try macho_file.lazy_bindings.getOrPut(gpa, atom_index); if (!gop.found_existing) { gop.value_ptr.* = .{}; } try gop.value_ptr.append(gpa, binding); } -pub fn resolveRelocations(self: *Atom, macho_file: *MachO) !void { - const relocs = macho_file.relocs.get(self) orelse return; - const source_sym = self.getSymbol(macho_file); +pub fn resolveRelocations(macho_file: *MachO, atom_index: Atom.Index) !void { + const atom = macho_file.getAtom(atom_index); + const relocs = macho_file.relocs.get(atom_index) orelse return; + const source_sym = atom.getSymbol(macho_file); const source_section = macho_file.sections.get(source_sym.n_sect - 1).header; const file_offset = source_section.offset + source_sym.n_value - source_section.addr; - log.debug("relocating '{s}'", .{self.getName(macho_file)}); + log.debug("relocating '{s}'", .{atom.getName(macho_file)}); for (relocs.items) |*reloc| { if (!reloc.dirty) continue; - try reloc.resolve(self, macho_file, file_offset); + try reloc.resolve(macho_file, atom_index, file_offset); reloc.dirty = false; } } + +pub fn freeRelocations(macho_file: *MachO, atom_index: Atom.Index) void { + const gpa = macho_file.base.allocator; + var removed_relocs = macho_file.relocs.fetchOrderedRemove(atom_index); + if (removed_relocs) |*relocs| relocs.value.deinit(gpa); + var removed_rebases = macho_file.rebases.fetchOrderedRemove(atom_index); + if (removed_rebases) |*rebases| rebases.value.deinit(gpa); + var removed_bindings = macho_file.bindings.fetchOrderedRemove(atom_index); + if (removed_bindings) |*bindings| bindings.value.deinit(gpa); + var removed_lazy_bindings = macho_file.lazy_bindings.fetchOrderedRemove(atom_index); + if (removed_lazy_bindings) |*lazy_bindings| lazy_bindings.value.deinit(gpa); +} diff --git a/src/link/MachO/Relocation.zig b/src/link/MachO/Relocation.zig index ca6bf9d681..07e5cf1aa2 100644 --- a/src/link/MachO/Relocation.zig +++ b/src/link/MachO/Relocation.zig @@ -29,33 +29,35 @@ pub fn fmtType(self: Relocation, target: std.Target) []const u8 { } } -pub fn getTargetAtom(self: Relocation, macho_file: *MachO) ?*Atom { +pub fn getTargetAtomIndex(self: Relocation, macho_file: *MachO) ?Atom.Index { switch (macho_file.base.options.target.cpu.arch) { .aarch64 => switch (@intToEnum(macho.reloc_type_arm64, self.type)) { .ARM64_RELOC_GOT_LOAD_PAGE21, .ARM64_RELOC_GOT_LOAD_PAGEOFF12, .ARM64_RELOC_POINTER_TO_GOT, - => return macho_file.getGotAtomForSymbol(self.target), + => return macho_file.getGotAtomIndexForSymbol(self.target), else => {}, }, .x86_64 => switch (@intToEnum(macho.reloc_type_x86_64, self.type)) { .X86_64_RELOC_GOT, .X86_64_RELOC_GOT_LOAD, - => return macho_file.getGotAtomForSymbol(self.target), + => return macho_file.getGotAtomIndexForSymbol(self.target), else => {}, }, else => unreachable, } - if (macho_file.getStubsAtomForSymbol(self.target)) |stubs_atom| return stubs_atom; - return macho_file.getAtomForSymbol(self.target); + if (macho_file.getStubsAtomIndexForSymbol(self.target)) |stubs_atom| return stubs_atom; + return macho_file.getAtomIndexForSymbol(self.target); } -pub fn resolve(self: Relocation, atom: *Atom, macho_file: *MachO, base_offset: u64) !void { +pub fn resolve(self: Relocation, macho_file: *MachO, atom_index: Atom.Index, base_offset: u64) !void { const arch = macho_file.base.options.target.cpu.arch; + const atom = macho_file.getAtom(atom_index); const source_sym = atom.getSymbol(macho_file); const source_addr = source_sym.n_value + self.offset; - const target_atom = self.getTargetAtom(macho_file) orelse return; + const target_atom_index = self.getTargetAtomIndex(macho_file) orelse return; + const target_atom = macho_file.getAtom(target_atom_index); const target_addr = @intCast(i64, target_atom.getSymbol(macho_file).n_value) + self.addend; log.debug(" ({x}: [() => 0x{x} ({s})) ({s})", .{ From 1f64432196e51785fe1dba442a0878c1b10f8b06 Mon Sep 17 00:00:00 2001 From: Techatrix <19954306+Techatrix@users.noreply.github.com> Date: Tue, 31 Jan 2023 00:59:18 +0100 Subject: [PATCH 37/84] wasm: correctly handle optional slices --- src/arch/wasm/CodeGen.zig | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/src/arch/wasm/CodeGen.zig b/src/arch/wasm/CodeGen.zig index 342d6b70cc..d0ff27a3e2 100644 --- a/src/arch/wasm/CodeGen.zig +++ b/src/arch/wasm/CodeGen.zig @@ -1706,9 +1706,11 @@ fn isByRef(ty: Type, target: std.Target) bool { return true; }, .Optional => { - if (ty.optionalReprIsPayload()) return false; + if (ty.isPtrLikeOptional()) return false; var buf: Type.Payload.ElemType = undefined; - return ty.optionalChild(&buf).hasRuntimeBitsIgnoreComptime(); + const pl_type = ty.optionalChild(&buf); + if (pl_type.zigTypeTag() == .ErrorSet) return false; + return pl_type.hasRuntimeBitsIgnoreComptime(); }, .Pointer => { // Slices act like struct and will be passed by reference @@ -3869,14 +3871,17 @@ fn airIsNull(func: *CodeGen, inst: Air.Inst.Index, opcode: wasm.Opcode, op_kind: /// NOTE: Leaves the result on the stack fn isNull(func: *CodeGen, operand: WValue, optional_ty: Type, opcode: wasm.Opcode) InnerError!WValue { try func.emitWValue(operand); + var buf: Type.Payload.ElemType = undefined; + const payload_ty = optional_ty.optionalChild(&buf); if (!optional_ty.optionalReprIsPayload()) { - var buf: Type.Payload.ElemType = undefined; - const payload_ty = optional_ty.optionalChild(&buf); // When payload is zero-bits, we can treat operand as a value, rather than // a pointer to the stack value if (payload_ty.hasRuntimeBitsIgnoreComptime()) { try func.addMemArg(.i32_load8_u, .{ .offset = operand.offset(), .alignment = 1 }); } + } else if (payload_ty.isSlice()) { + // move the ptr on top of the stack + _ = try func.load(operand, Type.usize, 0); } // Compare the null value with '0' From d6b430b520103fb6691b2c18ae06c2f2a360e806 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Mon, 30 Jan 2023 18:53:14 -0700 Subject: [PATCH 38/84] std.Target: remove workaround This was working around a stage1 compiler bug. --- lib/std/target.zig | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/lib/std/target.zig b/lib/std/target.zig index 4964e75852..8ae175aac8 100644 --- a/lib/std/target.zig +++ b/lib/std/target.zig @@ -697,9 +697,6 @@ pub const Target = struct { pub const ShiftInt = std.math.Log2Int(usize); pub const empty = Set{ .ints = [1]usize{0} ** usize_count }; - pub fn empty_workaround() Set { - return Set{ .ints = [1]usize{0} ** usize_count }; - } pub fn isEmpty(set: Set) bool { return for (set.ints) |x| { @@ -782,7 +779,7 @@ pub const Target = struct { return struct { /// Populates only the feature bits specified. pub fn featureSet(features: []const F) Set { - var x = Set.empty_workaround(); // TODO remove empty_workaround + var x = Set.empty; for (features) |feature| { x.addFeature(@enumToInt(feature)); } From 17404f8e6edea28fc70e074fd75101e1ed48b620 Mon Sep 17 00:00:00 2001 From: r00ster91 Date: Sun, 29 Jan 2023 23:25:31 +0100 Subject: [PATCH 39/84] Sema: emit compile error for comptime or inline call of function pointer --- src/Sema.zig | 7 ++++++- .../comptime_call_of_function_pointer.zig | 10 ++++++++++ 2 files changed, 16 insertions(+), 1 deletion(-) create mode 100644 test/cases/compile_errors/comptime_call_of_function_pointer.zig diff --git a/src/Sema.zig b/src/Sema.zig index 9c553a0092..7448fd149c 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -6446,7 +6446,12 @@ fn analyzeCall( .extern_fn => return sema.fail(block, call_src, "{s} call of extern function", .{ @as([]const u8, if (is_comptime_call) "comptime" else "inline"), }), - else => unreachable, + else => { + assert(callee_ty.isPtrAtRuntime()); + return sema.fail(block, call_src, "{s} call of function pointer", .{ + @as([]const u8, if (is_comptime_call) "comptime" else "inline"), + }); + }, }; if (func_ty_info.is_var_args) { return sema.fail(block, call_src, "{s} call of variadic function", .{ diff --git a/test/cases/compile_errors/comptime_call_of_function_pointer.zig b/test/cases/compile_errors/comptime_call_of_function_pointer.zig new file mode 100644 index 0000000000..cf01f5ea2c --- /dev/null +++ b/test/cases/compile_errors/comptime_call_of_function_pointer.zig @@ -0,0 +1,10 @@ +export fn entry() void { + const fn_ptr = @intToPtr(*align(1) fn () void, 0xffd2); + comptime fn_ptr(); +} + +// error +// backend=stage2 +// target=native +// +// :3:20: error: comptime call of function pointer From 47ff57ed7ddbf4c4a0f93208fc96851c9033b8b7 Mon Sep 17 00:00:00 2001 From: Techatrix <19954306+Techatrix@users.noreply.github.com> Date: Tue, 31 Jan 2023 17:01:56 +0100 Subject: [PATCH 40/84] wasm: apply request change --- src/arch/wasm/CodeGen.zig | 7 +++++-- test/behavior/cast.zig | 3 --- test/behavior/optional.zig | 2 -- 3 files changed, 5 insertions(+), 7 deletions(-) diff --git a/src/arch/wasm/CodeGen.zig b/src/arch/wasm/CodeGen.zig index d0ff27a3e2..c0d0c11b56 100644 --- a/src/arch/wasm/CodeGen.zig +++ b/src/arch/wasm/CodeGen.zig @@ -3880,8 +3880,11 @@ fn isNull(func: *CodeGen, operand: WValue, optional_ty: Type, opcode: wasm.Opcod try func.addMemArg(.i32_load8_u, .{ .offset = operand.offset(), .alignment = 1 }); } } else if (payload_ty.isSlice()) { - // move the ptr on top of the stack - _ = try func.load(operand, Type.usize, 0); + switch (func.arch()) { + .wasm32 => try func.addMemArg(.i32_load, .{ .offset = operand.offset(), .alignment = 4 }), + .wasm64 => try func.addMemArg(.i64_load, .{ .offset = operand.offset(), .alignment = 8 }), + else => unreachable, + } } // Compare the null value with '0' diff --git a/test/behavior/cast.zig b/test/behavior/cast.zig index 7c0746bfcd..dbb4c07f64 100644 --- a/test/behavior/cast.zig +++ b/test/behavior/cast.zig @@ -1179,7 +1179,6 @@ fn peerTypeEmptyArrayAndSlice(a: bool, slice: []const u8) []const u8 { test "implicitly cast from [N]T to ?[]const T" { if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; if (builtin.zig_backend == .stage2_arm) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_wasm) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_sparc64) return error.SkipZigTest; // TODO try expect(mem.eql(u8, castToOptionalSlice().?, "hi")); @@ -1264,7 +1263,6 @@ test "cast from array reference to fn: runtime fn ptr" { test "*const [N]null u8 to ?[]const u8" { if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; if (builtin.zig_backend == .stage2_arm) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_wasm) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_sparc64) return error.SkipZigTest; // TODO const S = struct { @@ -1413,7 +1411,6 @@ test "cast i8 fn call peers to i32 result" { test "cast compatible optional types" { if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_arm) return error.SkipZigTest; // TODO - if (builtin.zig_backend == .stage2_wasm) return error.SkipZigTest; // TODO if (builtin.zig_backend == .stage2_sparc64) return error.SkipZigTest; // TODO var a: ?[:0]const u8 = null; diff --git a/test/behavior/optional.zig b/test/behavior/optional.zig index 3e91c6807c..3a5b7b008b 100644 --- a/test/behavior/optional.zig +++ b/test/behavior/optional.zig @@ -439,7 +439,6 @@ test "Optional slice size is optimized" { if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; if (builtin.zig_backend == .stage2_arm) return error.SkipZigTest; if (builtin.zig_backend == .stage2_x86_64) return error.SkipZigTest; - if (builtin.zig_backend == .stage2_wasm) return error.SkipZigTest; if (builtin.zig_backend == .stage2_sparc64) return error.SkipZigTest; // TODO try expect(@sizeOf(?[]u8) == @sizeOf([]u8)); @@ -479,7 +478,6 @@ test "cast slice to const slice nested in error union and optional" { if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; if (builtin.zig_backend == .stage2_arm) return error.SkipZigTest; if (builtin.zig_backend == .stage2_x86_64) return error.SkipZigTest; - if (builtin.zig_backend == .stage2_wasm) return error.SkipZigTest; const S = struct { fn inner() !?[]u8 { From 4404c4d20094bb5021aac4a047cd33b6c24b9a9b Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Tue, 31 Jan 2023 17:54:12 +0100 Subject: [PATCH 41/84] link: make Elf atoms fully owned by the linker --- src/Module.zig | 6 +- src/Sema.zig | 2 +- src/arch/aarch64/CodeGen.zig | 13 +- src/arch/arm/CodeGen.zig | 15 +- src/arch/riscv64/CodeGen.zig | 14 +- src/arch/sparc64/CodeGen.zig | 12 +- src/arch/x86_64/CodeGen.zig | 13 +- src/link.zig | 4 +- src/link/Dwarf.zig | 26 +- src/link/Elf.zig | 1535 ++++++++++++++++++---------------- src/link/Elf/Atom.zig | 61 +- src/link/MachO.zig | 4 +- 12 files changed, 891 insertions(+), 814 deletions(-) diff --git a/src/Module.zig b/src/Module.zig index 8301505492..0695a2e98a 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -5275,7 +5275,7 @@ pub fn clearDecl( // and allow it to be variably sized. decl.link = switch (mod.comp.bin_file.tag) { .coff => .{ .coff = link.File.Coff.Atom.empty }, - .elf => .{ .elf = link.File.Elf.TextBlock.empty }, + .elf => .{ .elf = {} }, .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = link.File.Plan9.DeclBlock.empty }, .c => .{ .c = {} }, @@ -5381,7 +5381,7 @@ fn deleteDeclExports(mod: *Module, decl_index: Decl.Index) Allocator.Error!void } } if (mod.comp.bin_file.cast(link.File.Elf)) |elf| { - elf.deleteExport(exp.link.elf); + elf.deleteDeclExport(decl_index, exp.options.name); } if (mod.comp.bin_file.cast(link.File.MachO)) |macho| { try macho.deleteDeclExport(decl_index, exp.options.name); @@ -5695,7 +5695,7 @@ pub fn allocateNewDecl( .src_scope = src_scope, .link = switch (mod.comp.bin_file.tag) { .coff => .{ .coff = link.File.Coff.Atom.empty }, - .elf => .{ .elf = link.File.Elf.TextBlock.empty }, + .elf => .{ .elf = {} }, .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = link.File.Plan9.DeclBlock.empty }, .c => .{ .c = {} }, diff --git a/src/Sema.zig b/src/Sema.zig index 9083cc92ab..28d559f730 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -5566,7 +5566,7 @@ pub fn analyzeExport( .src = src, .link = switch (mod.comp.bin_file.tag) { .coff => .{ .coff = .{} }, - .elf => .{ .elf = .{} }, + .elf => .{ .elf = {} }, .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = null }, .c => .{ .c = {} }, diff --git a/src/arch/aarch64/CodeGen.zig b/src/arch/aarch64/CodeGen.zig index edbe7905a2..67197c35f8 100644 --- a/src/arch/aarch64/CodeGen.zig +++ b/src/arch/aarch64/CodeGen.zig @@ -4308,8 +4308,9 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier const fn_owner_decl = mod.declPtr(func.owner_decl); if (self.bin_file.cast(link.File.Elf)) |elf_file| { - try fn_owner_decl.link.elf.ensureInitialized(elf_file); - const got_addr = @intCast(u32, fn_owner_decl.link.elf.getOffsetTableAddress(elf_file)); + const atom_index = try elf_file.getOrCreateAtomForDecl(func.owner_decl); + const atom = elf_file.getAtom(atom_index); + const got_addr = @intCast(u32, atom.getOffsetTableAddress(elf_file)); try self.genSetReg(Type.initTag(.usize), .x30, .{ .memory = got_addr }); } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { const atom = try macho_file.getOrCreateAtomForDecl(func.owner_decl); @@ -6138,8 +6139,9 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne mod.markDeclAlive(decl); if (self.bin_file.cast(link.File.Elf)) |elf_file| { - try decl.link.elf.ensureInitialized(elf_file); - return MCValue{ .memory = decl.link.elf.getOffsetTableAddress(elf_file) }; + const atom_index = try elf_file.getOrCreateAtomForDecl(decl_index); + const atom = elf_file.getAtom(atom_index); + return MCValue{ .memory = atom.getOffsetTableAddress(elf_file) }; } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { const atom = try macho_file.getOrCreateAtomForDecl(decl_index); const sym_index = macho_file.getAtom(atom).getSymbolIndex().?; @@ -6168,8 +6170,7 @@ fn lowerUnnamedConst(self: *Self, tv: TypedValue) InnerError!MCValue { return self.fail("lowering unnamed constant failed: {s}", .{@errorName(err)}); }; if (self.bin_file.cast(link.File.Elf)) |elf_file| { - const vaddr = elf_file.local_symbols.items[local_sym_index].st_value; - return MCValue{ .memory = vaddr }; + return MCValue{ .memory = elf_file.getSymbol(local_sym_index).st_value }; } else if (self.bin_file.cast(link.File.MachO)) |_| { return MCValue{ .linker_load = .{ .type = .direct, diff --git a/src/arch/arm/CodeGen.zig b/src/arch/arm/CodeGen.zig index 49f979624d..c6ee960e51 100644 --- a/src/arch/arm/CodeGen.zig +++ b/src/arch/arm/CodeGen.zig @@ -4256,12 +4256,11 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier if (self.air.value(callee)) |func_value| { if (func_value.castTag(.function)) |func_payload| { const func = func_payload.data; - const mod = self.bin_file.options.module.?; - const fn_owner_decl = mod.declPtr(func.owner_decl); if (self.bin_file.cast(link.File.Elf)) |elf_file| { - try fn_owner_decl.link.elf.ensureInitialized(elf_file); - const got_addr = @intCast(u32, fn_owner_decl.link.elf.getOffsetTableAddress(elf_file)); + const atom_index = try elf_file.getOrCreateAtomForDecl(func.owner_decl); + const atom = elf_file.getAtom(atom_index); + const got_addr = @intCast(u32, atom.getOffsetTableAddress(elf_file)); try self.genSetReg(Type.initTag(.usize), .lr, .{ .memory = got_addr }); } else if (self.bin_file.cast(link.File.MachO)) |_| { unreachable; // unsupported architecture for MachO @@ -6084,8 +6083,9 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne mod.markDeclAlive(decl); if (self.bin_file.cast(link.File.Elf)) |elf_file| { - try decl.link.elf.ensureInitialized(elf_file); - return MCValue{ .memory = decl.link.elf.getOffsetTableAddress(elf_file) }; + const atom_index = try elf_file.getOrCreateAtomForDecl(decl_index); + const atom = elf_file.getAtom(atom_index); + return MCValue{ .memory = atom.getOffsetTableAddress(elf_file) }; } else if (self.bin_file.cast(link.File.MachO)) |_| { unreachable; // unsupported architecture for MachO } else if (self.bin_file.cast(link.File.Coff)) |_| { @@ -6106,8 +6106,7 @@ fn lowerUnnamedConst(self: *Self, tv: TypedValue) InnerError!MCValue { return self.fail("lowering unnamed constant failed: {s}", .{@errorName(err)}); }; if (self.bin_file.cast(link.File.Elf)) |elf_file| { - const vaddr = elf_file.local_symbols.items[local_sym_index].st_value; - return MCValue{ .memory = vaddr }; + return MCValue{ .memory = elf_file.getSymbol(local_sym_index).st_value }; } else if (self.bin_file.cast(link.File.MachO)) |_| { unreachable; } else if (self.bin_file.cast(link.File.Coff)) |_| { diff --git a/src/arch/riscv64/CodeGen.zig b/src/arch/riscv64/CodeGen.zig index 07a8dcd858..a0af1b3cce 100644 --- a/src/arch/riscv64/CodeGen.zig +++ b/src/arch/riscv64/CodeGen.zig @@ -1721,12 +1721,9 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier if (self.air.value(callee)) |func_value| { if (func_value.castTag(.function)) |func_payload| { const func = func_payload.data; - - const mod = self.bin_file.options.module.?; - const fn_owner_decl = mod.declPtr(func.owner_decl); - try fn_owner_decl.link.elf.ensureInitialized(elf_file); - const got_addr = @intCast(u32, fn_owner_decl.link.elf.getOffsetTableAddress(elf_file)); - + const atom_index = try elf_file.getOrCreateAtomForDecl(func.owner_decl); + const atom = elf_file.getAtom(atom_index); + const got_addr = @intCast(u32, atom.getOffsetTableAddress(elf_file)); try self.genSetReg(Type.initTag(.usize), .ra, .{ .memory = got_addr }); _ = try self.addInst(.{ .tag = .jalr, @@ -2553,8 +2550,9 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne const decl = mod.declPtr(decl_index); mod.markDeclAlive(decl); if (self.bin_file.cast(link.File.Elf)) |elf_file| { - try decl.link.elf.ensureInitialized(elf_file); - return MCValue{ .memory = decl.link.elf.getOffsetTableAddress(elf_file) }; + const atom_index = try elf_file.getOrCreateAtomForDecl(decl_index); + const atom = elf_file.getAtom(atom_index); + return MCValue{ .memory = atom.getOffsetTableAddress(elf_file) }; } else if (self.bin_file.cast(link.File.MachO)) |_| { unreachable; } else if (self.bin_file.cast(link.File.Coff)) |_| { diff --git a/src/arch/sparc64/CodeGen.zig b/src/arch/sparc64/CodeGen.zig index 5e9326d23b..e67244167e 100644 --- a/src/arch/sparc64/CodeGen.zig +++ b/src/arch/sparc64/CodeGen.zig @@ -1216,11 +1216,10 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier if (self.bin_file.tag == link.File.Elf.base_tag) { if (func_value.castTag(.function)) |func_payload| { const func = func_payload.data; - const mod = self.bin_file.options.module.?; - const fn_owner_decl = mod.declPtr(func.owner_decl); const got_addr = if (self.bin_file.cast(link.File.Elf)) |elf_file| blk: { - try fn_owner_decl.link.elf.ensureInitialized(elf_file); - break :blk @intCast(u32, fn_owner_decl.link.elf.getOffsetTableAddress(elf_file)); + const atom_index = try elf_file.getOrCreateAtomForDecl(func.owner_decl); + const atom = elf_file.getAtom(atom_index); + break :blk @intCast(u32, atom.getOffsetTableAddress(elf_file)); } else unreachable; try self.genSetReg(Type.initTag(.usize), .o7, .{ .memory = got_addr }); @@ -4205,8 +4204,9 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne mod.markDeclAlive(decl); if (self.bin_file.cast(link.File.Elf)) |elf_file| { - try decl.link.elf.ensureInitialized(elf_file); - return MCValue{ .memory = decl.link.elf.getOffsetTableAddress(elf_file) }; + const atom_index = try elf_file.getOrCreateAtomForDecl(decl_index); + const atom = elf_file.getAtom(atom_index); + return MCValue{ .memory = atom.getOffsetTableAddress(elf_file) }; } else { return self.fail("TODO codegen non-ELF const Decl pointer", .{}); } diff --git a/src/arch/x86_64/CodeGen.zig b/src/arch/x86_64/CodeGen.zig index fc244e3130..23d3ca5514 100644 --- a/src/arch/x86_64/CodeGen.zig +++ b/src/arch/x86_64/CodeGen.zig @@ -4000,8 +4000,9 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier const fn_owner_decl = mod.declPtr(func.owner_decl); if (self.bin_file.cast(link.File.Elf)) |elf_file| { - try fn_owner_decl.link.elf.ensureInitialized(elf_file); - const got_addr = @intCast(u32, fn_owner_decl.link.elf.getOffsetTableAddress(elf_file)); + const atom_index = try elf_file.getOrCreateAtomForDecl(func.owner_decl); + const atom = elf_file.getAtom(atom_index); + const got_addr = @intCast(u32, atom.getOffsetTableAddress(elf_file)); _ = try self.addInst(.{ .tag = .call, .ops = Mir.Inst.Ops.encode(.{ .flags = 0b01 }), @@ -6721,8 +6722,9 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne module.markDeclAlive(decl); if (self.bin_file.cast(link.File.Elf)) |elf_file| { - try decl.link.elf.ensureInitialized(elf_file); - return MCValue{ .memory = decl.link.elf.getOffsetTableAddress(elf_file) }; + const atom_index = try elf_file.getOrCreateAtomForDecl(decl_index); + const atom = elf_file.getAtom(atom_index); + return MCValue{ .memory = atom.getOffsetTableAddress(elf_file) }; } else if (self.bin_file.cast(link.File.MachO)) |macho_file| { const atom_index = try macho_file.getOrCreateAtomForDecl(decl_index); const sym_index = macho_file.getAtom(atom_index).getSymbolIndex().?; @@ -6751,8 +6753,7 @@ fn lowerUnnamedConst(self: *Self, tv: TypedValue) InnerError!MCValue { return self.fail("lowering unnamed constant failed: {s}", .{@errorName(err)}); }; if (self.bin_file.cast(link.File.Elf)) |elf_file| { - const vaddr = elf_file.local_symbols.items[local_sym_index].st_value; - return MCValue{ .memory = vaddr }; + return MCValue{ .memory = elf_file.getSymbol(local_sym_index).st_value }; } else if (self.bin_file.cast(link.File.MachO)) |_| { return MCValue{ .linker_load = .{ .type = .direct, diff --git a/src/link.zig b/src/link.zig index 2a96efe89d..09804add53 100644 --- a/src/link.zig +++ b/src/link.zig @@ -262,7 +262,7 @@ pub const File = struct { lock: ?Cache.Lock = null, pub const LinkBlock = union { - elf: Elf.TextBlock, + elf: void, coff: Coff.Atom, macho: void, plan9: Plan9.DeclBlock, @@ -284,7 +284,7 @@ pub const File = struct { }; pub const Export = union { - elf: Elf.Export, + elf: void, coff: Coff.Export, macho: void, plan9: Plan9.Export, diff --git a/src/link/Dwarf.zig b/src/link/Dwarf.zig index 2595cd8ba5..8278377095 100644 --- a/src/link/Dwarf.zig +++ b/src/link/Dwarf.zig @@ -1099,7 +1099,7 @@ pub fn commitDeclState( switch (self.bin_file.tag) { .elf => { const elf_file = self.bin_file.cast(File.Elf).?; - const debug_line_sect = &elf_file.sections.items[elf_file.debug_line_section_index.?]; + const debug_line_sect = &elf_file.sections.items(.shdr)[elf_file.debug_line_section_index.?]; const file_pos = debug_line_sect.sh_offset + src_fn.off; try pwriteDbgLineNops(elf_file.base.file.?, file_pos, 0, &[0]u8{}, src_fn.len); }, @@ -1152,7 +1152,7 @@ pub fn commitDeclState( const elf_file = self.bin_file.cast(File.Elf).?; const shdr_index = elf_file.debug_line_section_index.?; try elf_file.growNonAllocSection(shdr_index, needed_size, 1, true); - const debug_line_sect = elf_file.sections.items[shdr_index]; + const debug_line_sect = elf_file.sections.items(.shdr)[shdr_index]; const file_pos = debug_line_sect.sh_offset + src_fn.off; try pwriteDbgLineNops( elf_file.base.file.?, @@ -1332,7 +1332,7 @@ fn updateDeclDebugInfoAllocation(self: *Dwarf, atom: *Atom, len: u32) !void { switch (self.bin_file.tag) { .elf => { const elf_file = self.bin_file.cast(File.Elf).?; - const debug_info_sect = &elf_file.sections.items[elf_file.debug_info_section_index.?]; + const debug_info_sect = &elf_file.sections.items(.shdr)[elf_file.debug_info_section_index.?]; const file_pos = debug_info_sect.sh_offset + atom.off; try pwriteDbgInfoNops(elf_file.base.file.?, file_pos, 0, &[0]u8{}, atom.len, false); }, @@ -1399,7 +1399,7 @@ fn writeDeclDebugInfo(self: *Dwarf, atom: *Atom, dbg_info_buf: []const u8) !void const elf_file = self.bin_file.cast(File.Elf).?; const shdr_index = elf_file.debug_info_section_index.?; try elf_file.growNonAllocSection(shdr_index, needed_size, 1, true); - const debug_info_sect = elf_file.sections.items[shdr_index]; + const debug_info_sect = elf_file.sections.items(.shdr)[shdr_index]; const file_pos = debug_info_sect.sh_offset + atom.off; try pwriteDbgInfoNops( elf_file.base.file.?, @@ -1475,7 +1475,7 @@ pub fn updateDeclLineNumber(self: *Dwarf, decl: *const Module.Decl) !void { switch (self.bin_file.tag) { .elf => { const elf_file = self.bin_file.cast(File.Elf).?; - const shdr = elf_file.sections.items[elf_file.debug_line_section_index.?]; + const shdr = elf_file.sections.items(.shdr)[elf_file.debug_line_section_index.?]; const file_pos = shdr.sh_offset + decl.fn_link.elf.off + self.getRelocDbgLineOff(); try elf_file.base.file.?.pwriteAll(&data, file_pos); }, @@ -1690,7 +1690,7 @@ pub fn writeDbgAbbrev(self: *Dwarf) !void { const elf_file = self.bin_file.cast(File.Elf).?; const shdr_index = elf_file.debug_abbrev_section_index.?; try elf_file.growNonAllocSection(shdr_index, needed_size, 1, false); - const debug_abbrev_sect = elf_file.sections.items[shdr_index]; + const debug_abbrev_sect = elf_file.sections.items(.shdr)[shdr_index]; const file_pos = debug_abbrev_sect.sh_offset + abbrev_offset; try elf_file.base.file.?.pwriteAll(&abbrev_buf, file_pos); }, @@ -1805,7 +1805,7 @@ pub fn writeDbgInfoHeader(self: *Dwarf, module: *Module, low_pc: u64, high_pc: u switch (self.bin_file.tag) { .elf => { const elf_file = self.bin_file.cast(File.Elf).?; - const debug_info_sect = elf_file.sections.items[elf_file.debug_info_section_index.?]; + const debug_info_sect = elf_file.sections.items(.shdr)[elf_file.debug_info_section_index.?]; const file_pos = debug_info_sect.sh_offset; try pwriteDbgInfoNops(elf_file.base.file.?, file_pos, 0, di_buf.items, jmp_amt, false); }, @@ -2124,7 +2124,7 @@ pub fn writeDbgAranges(self: *Dwarf, addr: u64, size: u64) !void { const elf_file = self.bin_file.cast(File.Elf).?; const shdr_index = elf_file.debug_aranges_section_index.?; try elf_file.growNonAllocSection(shdr_index, needed_size, 16, false); - const debug_aranges_sect = elf_file.sections.items[shdr_index]; + const debug_aranges_sect = elf_file.sections.items(.shdr)[shdr_index]; const file_pos = debug_aranges_sect.sh_offset; try elf_file.base.file.?.pwriteAll(di_buf.items, file_pos); }, @@ -2285,9 +2285,9 @@ pub fn writeDbgLineHeader(self: *Dwarf) !void { .elf => { const elf_file = self.bin_file.cast(File.Elf).?; const shdr_index = elf_file.debug_line_section_index.?; - const needed_size = elf_file.sections.items[shdr_index].sh_size + delta; + const needed_size = elf_file.sections.items(.shdr)[shdr_index].sh_size + delta; try elf_file.growNonAllocSection(shdr_index, needed_size, 1, true); - const file_pos = elf_file.sections.items[shdr_index].sh_offset + src_fn.off; + const file_pos = elf_file.sections.items(.shdr)[shdr_index].sh_offset + src_fn.off; const amt = try elf_file.base.file.?.preadAll(buffer, file_pos); if (amt != buffer.len) return error.InputOutput; @@ -2346,7 +2346,7 @@ pub fn writeDbgLineHeader(self: *Dwarf) !void { switch (self.bin_file.tag) { .elf => { const elf_file = self.bin_file.cast(File.Elf).?; - const debug_line_sect = elf_file.sections.items[elf_file.debug_line_section_index.?]; + const debug_line_sect = elf_file.sections.items(.shdr)[elf_file.debug_line_section_index.?]; const file_pos = debug_line_sect.sh_offset; try pwriteDbgLineNops(elf_file.base.file.?, file_pos, 0, di_buf.items, jmp_amt); }, @@ -2487,7 +2487,7 @@ pub fn flushModule(self: *Dwarf, module: *Module) !void { switch (self.bin_file.tag) { .elf => { const elf_file = self.bin_file.cast(File.Elf).?; - const debug_info_sect = &elf_file.sections.items[elf_file.debug_info_section_index.?]; + const debug_info_sect = &elf_file.sections.items(.shdr)[elf_file.debug_info_section_index.?]; break :blk debug_info_sect.sh_offset; }, .macho => { @@ -2638,7 +2638,7 @@ fn addDbgInfoErrorSet( fn getDbgInfoAtom(tag: File.Tag, mod: *Module, decl_index: Module.Decl.Index) *Atom { const decl = mod.declPtr(decl_index); return switch (tag) { - .elf => &decl.link.elf.dbg_info_atom, + .elf => unreachable, .macho => unreachable, .wasm => &decl.link.wasm.dbg_info_atom, else => unreachable, diff --git a/src/link/Elf.zig b/src/link/Elf.zig index 2c55e55f83..0b8128aa33 100644 --- a/src/link/Elf.zig +++ b/src/link/Elf.zig @@ -1,43 +1,89 @@ const Elf = @This(); const std = @import("std"); +const build_options = @import("build_options"); const builtin = @import("builtin"); +const assert = std.debug.assert; +const elf = std.elf; +const fs = std.fs; +const log = std.log.scoped(.link); const math = std.math; const mem = std.mem; -const assert = std.debug.assert; -const Allocator = std.mem.Allocator; -const fs = std.fs; -const elf = std.elf; -const log = std.log.scoped(.link); -const Atom = @import("Elf/Atom.zig"); -const Module = @import("../Module.zig"); +const codegen = @import("../codegen.zig"); +const glibc = @import("../glibc.zig"); +const link = @import("../link.zig"); +const lldMain = @import("../main.zig").lldMain; +const musl = @import("../musl.zig"); +const target_util = @import("../target.zig"); +const trace = @import("../tracy.zig").trace; + +const Air = @import("../Air.zig"); +const Allocator = std.mem.Allocator; +pub const Atom = @import("Elf/Atom.zig"); +const Cache = @import("../Cache.zig"); const Compilation = @import("../Compilation.zig"); const Dwarf = @import("Dwarf.zig"); -const codegen = @import("../codegen.zig"); -const lldMain = @import("../main.zig").lldMain; -const trace = @import("../tracy.zig").trace; -const Package = @import("../Package.zig"); -const Value = @import("../value.zig").Value; -const Type = @import("../type.zig").Type; -const TypedValue = @import("../TypedValue.zig"); -const link = @import("../link.zig"); const File = link.File; -const build_options = @import("build_options"); -const target_util = @import("../target.zig"); -const glibc = @import("../glibc.zig"); -const musl = @import("../musl.zig"); -const Cache = @import("../Cache.zig"); -const Air = @import("../Air.zig"); const Liveness = @import("../Liveness.zig"); const LlvmObject = @import("../codegen/llvm.zig").Object; - -pub const TextBlock = Atom; +const Module = @import("../Module.zig"); +const Package = @import("../Package.zig"); +const StringTable = @import("strtab.zig").StringTable; +const Type = @import("../type.zig").Type; +const TypedValue = @import("../TypedValue.zig"); +const Value = @import("../value.zig").Value; const default_entry_addr = 0x8000000; pub const base_tag: File.Tag = .elf; +const Section = struct { + shdr: elf.Elf64_Shdr, + phdr_index: u16, + + /// Index of the last allocated atom in this section. + last_atom_index: ?Atom.Index = null, + + /// A list of atoms that have surplus capacity. This list can have false + /// positives, as functions grow and shrink over time, only sometimes being added + /// or removed from the freelist. + /// + /// An atom has surplus capacity when its overcapacity value is greater than + /// padToIdeal(minimum_atom_size). That is, when it has so + /// much extra capacity, that we could fit a small new symbol in it, itself with + /// ideal_capacity or more. + /// + /// Ideal capacity is defined by size + (size / ideal_factor) + /// + /// Overcapacity is measured by actual_capacity - ideal_capacity. Note that + /// overcapacity can be negative. A simple way to have negative overcapacity is to + /// allocate a fresh text block, which will have ideal capacity, and then grow it + /// by 1 byte. It will then have -1 overcapacity. + free_list: std.ArrayListUnmanaged(Atom.Index) = .{}, +}; + +const DeclMetadata = struct { + atom: Atom.Index, + shdr: u16, + /// A list of all exports aliases of this Decl. + exports: std.ArrayListUnmanaged(u32) = .{}, + + fn getExport(m: DeclMetadata, elf_file: *const Elf, name: []const u8) ?u32 { + for (m.exports.items) |exp| { + if (mem.eql(u8, name, elf_file.getSymbolName(exp))) return exp; + } + return null; + } + + fn getExportPtr(m: *DeclMetadata, elf_file: *Elf, name: []const u8) ?*u32 { + for (m.exports.items) |*exp| { + if (mem.eql(u8, name, elf_file.getSymbolName(exp.*))) return exp; + } + return null; + } +}; + base: File, dwarf: ?Dwarf = null, @@ -48,12 +94,12 @@ llvm_object: ?*LlvmObject = null, /// Stored in native-endian format, depending on target endianness needs to be bswapped on read/write. /// Same order as in the file. -sections: std.ArrayListUnmanaged(elf.Elf64_Shdr) = std.ArrayListUnmanaged(elf.Elf64_Shdr){}, +sections: std.MultiArrayList(Section) = .{}, shdr_table_offset: ?u64 = null, /// Stored in native-endian format, depending on target endianness needs to be bswapped on read/write. /// Same order as in the file. -program_headers: std.ArrayListUnmanaged(elf.Elf64_Phdr) = std.ArrayListUnmanaged(elf.Elf64_Phdr){}, +program_headers: std.ArrayListUnmanaged(elf.Elf64_Phdr) = .{}, phdr_table_offset: ?u64 = null, /// The index into the program headers of a PT_LOAD program header with Read and Execute flags phdr_load_re_index: ?u16 = null, @@ -65,12 +111,10 @@ phdr_load_ro_index: ?u16 = null, /// The index into the program headers of a PT_LOAD program header with Write flag phdr_load_rw_index: ?u16 = null, -phdr_shdr_table: std.AutoHashMapUnmanaged(u16, u16) = .{}, - entry_addr: ?u64 = null, page_size: u32, -shstrtab: std.ArrayListUnmanaged(u8) = std.ArrayListUnmanaged(u8){}, +shstrtab: StringTable(.strtab) = .{}, shstrtab_index: ?u16 = null, symtab_section_index: ?u16 = null, @@ -113,39 +157,14 @@ debug_line_header_dirty: bool = false, error_flags: File.ErrorFlags = File.ErrorFlags{}, -/// Pointer to the last allocated atom -atoms: std.AutoHashMapUnmanaged(u16, *TextBlock) = .{}, - -/// A list of text blocks that have surplus capacity. This list can have false -/// positives, as functions grow and shrink over time, only sometimes being added -/// or removed from the freelist. -/// -/// A text block has surplus capacity when its overcapacity value is greater than -/// padToIdeal(minimum_text_block_size). That is, when it has so -/// much extra capacity, that we could fit a small new symbol in it, itself with -/// ideal_capacity or more. -/// -/// Ideal capacity is defined by size + (size / ideal_factor) -/// -/// Overcapacity is measured by actual_capacity - ideal_capacity. Note that -/// overcapacity can be negative. A simple way to have negative overcapacity is to -/// allocate a fresh text block, which will have ideal capacity, and then grow it -/// by 1 byte. It will then have -1 overcapacity. -atom_free_lists: std.AutoHashMapUnmanaged(u16, std.ArrayListUnmanaged(*TextBlock)) = .{}, - -/// Table of Decls that are currently alive. -/// We store them here so that we can properly dispose of any allocated -/// memory within the atom in the incremental linker. -/// TODO consolidate this. -decls: std.AutoHashMapUnmanaged(Module.Decl.Index, ?u16) = .{}, +/// Table of tracked Decls. +decls: std.AutoHashMapUnmanaged(Module.Decl.Index, DeclMetadata) = .{}, /// List of atoms that are owned directly by the linker. -/// Currently these are only atoms that are the result of linking -/// object files. Atoms which take part in incremental linking are -/// at present owned by Module.Decl. -/// TODO consolidate this. -managed_atoms: std.ArrayListUnmanaged(*TextBlock) = .{}, -atom_by_index_table: std.AutoHashMapUnmanaged(u32, *TextBlock) = .{}, +atoms: std.ArrayListUnmanaged(Atom) = .{}, + +/// Table of atoms indexed by the symbol index. +atom_by_index_table: std.AutoHashMapUnmanaged(u32, Atom.Index) = .{}, /// Table of unnamed constants associated with a parent `Decl`. /// We store them here so that we can free the constants whenever the `Decl` @@ -173,15 +192,8 @@ unnamed_const_atoms: UnnamedConstTable = .{}, /// this will be a table indexed by index into the list of Atoms. relocs: RelocTable = .{}, -const Reloc = struct { - target: u32, - offset: u64, - addend: u32, - prev_vaddr: u64, -}; - -const RelocTable = std.AutoHashMapUnmanaged(*TextBlock, std.ArrayListUnmanaged(Reloc)); -const UnnamedConstTable = std.AutoHashMapUnmanaged(Module.Decl.Index, std.ArrayListUnmanaged(*TextBlock)); +const RelocTable = std.AutoHashMapUnmanaged(Atom.Index, std.ArrayListUnmanaged(Atom.Reloc)); +const UnnamedConstTable = std.AutoHashMapUnmanaged(Module.Decl.Index, std.ArrayListUnmanaged(Atom.Index)); /// When allocating, the ideal_capacity is calculated by /// actual_capacity + (actual_capacity / ideal_factor) @@ -190,15 +202,11 @@ const ideal_factor = 3; /// In order for a slice of bytes to be considered eligible to keep metadata pointing at /// it as a possible place to put new symbols, it must have enough room for this many bytes /// (plus extra for reserved capacity). -const minimum_text_block_size = 64; -pub const min_text_capacity = padToIdeal(minimum_text_block_size); +const minimum_atom_size = 64; +pub const min_text_capacity = padToIdeal(minimum_atom_size); pub const PtrWidth = enum { p32, p64 }; -pub const Export = struct { - sym_index: ?u32 = null, -}; - pub fn openPath(allocator: Allocator, sub_path: []const u8, options: link.Options) !*Elf { assert(options.target.ofmt == .elf); @@ -230,16 +238,19 @@ pub fn openPath(allocator: Allocator, sub_path: []const u8, options: link.Option // There must always be a null section in index 0 try self.sections.append(allocator, .{ - .sh_name = 0, - .sh_type = elf.SHT_NULL, - .sh_flags = 0, - .sh_addr = 0, - .sh_offset = 0, - .sh_size = 0, - .sh_link = 0, - .sh_info = 0, - .sh_addralign = 0, - .sh_entsize = 0, + .shdr = .{ + .sh_name = 0, + .sh_type = elf.SHT_NULL, + .sh_flags = 0, + .sh_addr = 0, + .sh_offset = 0, + .sh_size = 0, + .sh_link = 0, + .sh_info = 0, + .sh_addralign = 0, + .sh_entsize = 0, + }, + .phdr_index = undefined, }); try self.populateMissingMetadata(); @@ -286,75 +297,67 @@ pub fn createEmpty(gpa: Allocator, options: link.Options) !*Elf { } pub fn deinit(self: *Elf) void { + const gpa = self.base.allocator; + if (build_options.have_llvm) { - if (self.llvm_object) |llvm_object| llvm_object.destroy(self.base.allocator); + if (self.llvm_object) |llvm_object| llvm_object.destroy(gpa); } - self.sections.deinit(self.base.allocator); - self.program_headers.deinit(self.base.allocator); - self.shstrtab.deinit(self.base.allocator); - self.local_symbols.deinit(self.base.allocator); - self.global_symbols.deinit(self.base.allocator); - self.global_symbol_free_list.deinit(self.base.allocator); - self.local_symbol_free_list.deinit(self.base.allocator); - self.offset_table_free_list.deinit(self.base.allocator); - self.offset_table.deinit(self.base.allocator); - self.phdr_shdr_table.deinit(self.base.allocator); - self.decls.deinit(self.base.allocator); + for (self.sections.items(.free_list)) |*free_list| { + free_list.deinit(gpa); + } + self.sections.deinit(gpa); + + self.program_headers.deinit(gpa); + self.shstrtab.deinit(gpa); + self.local_symbols.deinit(gpa); + self.global_symbols.deinit(gpa); + self.global_symbol_free_list.deinit(gpa); + self.local_symbol_free_list.deinit(gpa); + self.offset_table_free_list.deinit(gpa); + self.offset_table.deinit(gpa); - self.atoms.deinit(self.base.allocator); { - var it = self.atom_free_lists.valueIterator(); - while (it.next()) |free_list| { - free_list.deinit(self.base.allocator); + var it = self.decls.iterator(); + while (it.next()) |entry| { + entry.value_ptr.exports.deinit(gpa); } - self.atom_free_lists.deinit(self.base.allocator); + self.decls.deinit(gpa); } - for (self.managed_atoms.items) |atom| { - self.base.allocator.destroy(atom); - } - self.managed_atoms.deinit(self.base.allocator); + self.atoms.deinit(gpa); + self.atom_by_index_table.deinit(gpa); { var it = self.unnamed_const_atoms.valueIterator(); while (it.next()) |atoms| { - atoms.deinit(self.base.allocator); + atoms.deinit(gpa); } - self.unnamed_const_atoms.deinit(self.base.allocator); + self.unnamed_const_atoms.deinit(gpa); } { var it = self.relocs.valueIterator(); while (it.next()) |relocs| { - relocs.deinit(self.base.allocator); + relocs.deinit(gpa); } - self.relocs.deinit(self.base.allocator); + self.relocs.deinit(gpa); } - self.atom_by_index_table.deinit(self.base.allocator); - - if (self.dwarf) |*dw| { - dw.deinit(); - } + // if (self.dwarf) |*dw| { + // dw.deinit(); + // } } pub fn getDeclVAddr(self: *Elf, decl_index: Module.Decl.Index, reloc_info: File.RelocInfo) !u64 { - const mod = self.base.options.module.?; - const decl = mod.declPtr(decl_index); - assert(self.llvm_object == null); - try decl.link.elf.ensureInitialized(self); - const target = decl.link.elf.getSymbolIndex().?; - - const vaddr = self.local_symbols.items[target].st_value; - const atom = self.atom_by_index_table.get(reloc_info.parent_atom_index).?; - const gop = try self.relocs.getOrPut(self.base.allocator, atom); - if (!gop.found_existing) { - gop.value_ptr.* = .{}; - } - try gop.value_ptr.append(self.base.allocator, .{ + const this_atom_index = try self.getOrCreateAtomForDecl(decl_index); + const this_atom = self.getAtom(this_atom_index); + const target = this_atom.getSymbolIndex().?; + const vaddr = this_atom.getSymbol(self).st_value; + const atom_index = self.getAtomIndexForSymbol(reloc_info.parent_atom_index).?; + try Atom.addRelocation(self, atom_index, .{ .target = target, .offset = reloc_info.offset, .addend = reloc_info.addend, @@ -375,7 +378,7 @@ fn detectAllocCollision(self: *Elf, start: u64, size: u64) ?u64 { if (self.shdr_table_offset) |off| { const shdr_size: u64 = if (small_ptr) @sizeOf(elf.Elf32_Shdr) else @sizeOf(elf.Elf64_Shdr); - const tight_size = self.sections.items.len * shdr_size; + const tight_size = self.sections.slice().len * shdr_size; const increased_size = padToIdeal(tight_size); const test_end = off + increased_size; if (end > off and start < test_end) { @@ -385,7 +388,7 @@ fn detectAllocCollision(self: *Elf, start: u64, size: u64) ?u64 { if (self.phdr_table_offset) |off| { const phdr_size: u64 = if (small_ptr) @sizeOf(elf.Elf32_Phdr) else @sizeOf(elf.Elf64_Phdr); - const tight_size = self.sections.items.len * phdr_size; + const tight_size = self.sections.slice().len * phdr_size; const increased_size = padToIdeal(tight_size); const test_end = off + increased_size; if (end > off and start < test_end) { @@ -393,7 +396,7 @@ fn detectAllocCollision(self: *Elf, start: u64, size: u64) ?u64 { } } - for (self.sections.items) |section| { + for (self.sections.items(.shdr)) |section| { const increased_size = padToIdeal(section.sh_size); const test_end = section.sh_offset + increased_size; if (end > section.sh_offset and start < test_end) { @@ -420,7 +423,7 @@ pub fn allocatedSize(self: *Elf, start: u64) u64 { if (self.phdr_table_offset) |off| { if (off > start and off < min_pos) min_pos = off; } - for (self.sections.items) |section| { + for (self.sections.items(.shdr)) |section| { if (section.sh_offset <= start) continue; if (section.sh_offset < min_pos) min_pos = section.sh_offset; } @@ -439,31 +442,10 @@ pub fn findFreeSpace(self: *Elf, object_size: u64, min_alignment: u32) u64 { return start; } -/// TODO Improve this to use a table. -fn makeString(self: *Elf, bytes: []const u8) !u32 { - try self.shstrtab.ensureUnusedCapacity(self.base.allocator, bytes.len + 1); - const result = self.shstrtab.items.len; - self.shstrtab.appendSliceAssumeCapacity(bytes); - self.shstrtab.appendAssumeCapacity(0); - return @intCast(u32, result); -} - -pub fn getString(self: Elf, str_off: u32) []const u8 { - assert(str_off < self.shstrtab.items.len); - return mem.sliceTo(@ptrCast([*:0]const u8, self.shstrtab.items.ptr + str_off), 0); -} - -fn updateString(self: *Elf, old_str_off: u32, new_name: []const u8) !u32 { - const existing_name = self.getString(old_str_off); - if (mem.eql(u8, existing_name, new_name)) { - return old_str_off; - } - return self.makeString(new_name); -} - pub fn populateMissingMetadata(self: *Elf) !void { assert(self.llvm_object == null); + const gpa = self.base.allocator; const small_ptr = switch (self.ptr_width) { .p32 => true, .p64 => false, @@ -477,7 +459,7 @@ pub fn populateMissingMetadata(self: *Elf) !void { const off = self.findFreeSpace(file_size, p_align); log.debug("found PT_LOAD RE free space 0x{x} to 0x{x}", .{ off, off + file_size }); const entry_addr: u64 = self.entry_addr orelse if (self.base.options.target.cpu.arch == .spu_2) @as(u64, 0) else default_entry_addr; - try self.program_headers.append(self.base.allocator, .{ + try self.program_headers.append(gpa, .{ .p_type = elf.PT_LOAD, .p_offset = off, .p_filesz = file_size, @@ -487,7 +469,6 @@ pub fn populateMissingMetadata(self: *Elf) !void { .p_align = p_align, .p_flags = elf.PF_X | elf.PF_R, }); - try self.atom_free_lists.putNoClobber(self.base.allocator, self.phdr_load_re_index.?, .{}); self.entry_addr = null; self.phdr_table_dirty = true; } @@ -504,7 +485,7 @@ pub fn populateMissingMetadata(self: *Elf) !void { // we'll need to re-use that function anyway, in case the GOT grows and overlaps something // else in virtual memory. const got_addr: u32 = if (self.base.options.target.cpu.arch.ptrBitWidth() >= 32) 0x4000000 else 0x8000; - try self.program_headers.append(self.base.allocator, .{ + try self.program_headers.append(gpa, .{ .p_type = elf.PT_LOAD, .p_offset = off, .p_filesz = file_size, @@ -527,7 +508,7 @@ pub fn populateMissingMetadata(self: *Elf) !void { log.debug("found PT_LOAD RO free space 0x{x} to 0x{x}", .{ off, off + file_size }); // TODO Same as for GOT const rodata_addr: u32 = if (self.base.options.target.cpu.arch.ptrBitWidth() >= 32) 0xc000000 else 0xa000; - try self.program_headers.append(self.base.allocator, .{ + try self.program_headers.append(gpa, .{ .p_type = elf.PT_LOAD, .p_offset = off, .p_filesz = file_size, @@ -537,7 +518,6 @@ pub fn populateMissingMetadata(self: *Elf) !void { .p_align = p_align, .p_flags = elf.PF_R, }); - try self.atom_free_lists.putNoClobber(self.base.allocator, self.phdr_load_ro_index.?, .{}); self.phdr_table_dirty = true; } @@ -551,7 +531,7 @@ pub fn populateMissingMetadata(self: *Elf) !void { log.debug("found PT_LOAD RW free space 0x{x} to 0x{x}", .{ off, off + file_size }); // TODO Same as for GOT const rwdata_addr: u32 = if (self.base.options.target.cpu.arch.ptrBitWidth() >= 32) 0x10000000 else 0xc000; - try self.program_headers.append(self.base.allocator, .{ + try self.program_headers.append(gpa, .{ .p_type = elf.PT_LOAD, .p_offset = off, .p_filesz = file_size, @@ -561,278 +541,290 @@ pub fn populateMissingMetadata(self: *Elf) !void { .p_align = p_align, .p_flags = elf.PF_R | elf.PF_W, }); - try self.atom_free_lists.putNoClobber(self.base.allocator, self.phdr_load_rw_index.?, .{}); self.phdr_table_dirty = true; } if (self.shstrtab_index == null) { - self.shstrtab_index = @intCast(u16, self.sections.items.len); - assert(self.shstrtab.items.len == 0); - try self.shstrtab.append(self.base.allocator, 0); // need a 0 at position 0 - const off = self.findFreeSpace(self.shstrtab.items.len, 1); - log.debug("found shstrtab free space 0x{x} to 0x{x}", .{ off, off + self.shstrtab.items.len }); - try self.sections.append(self.base.allocator, .{ - .sh_name = try self.makeString(".shstrtab"), - .sh_type = elf.SHT_STRTAB, - .sh_flags = 0, - .sh_addr = 0, - .sh_offset = off, - .sh_size = self.shstrtab.items.len, - .sh_link = 0, - .sh_info = 0, - .sh_addralign = 1, - .sh_entsize = 0, + self.shstrtab_index = @intCast(u16, self.sections.slice().len); + assert(self.shstrtab.buffer.items.len == 0); + try self.shstrtab.buffer.append(gpa, 0); // need a 0 at position 0 + const off = self.findFreeSpace(self.shstrtab.buffer.items.len, 1); + log.debug("found shstrtab free space 0x{x} to 0x{x}", .{ off, off + self.shstrtab.buffer.items.len }); + try self.sections.append(gpa, .{ + .shdr = .{ + .sh_name = try self.shstrtab.insert(gpa, ".shstrtab"), + .sh_type = elf.SHT_STRTAB, + .sh_flags = 0, + .sh_addr = 0, + .sh_offset = off, + .sh_size = self.shstrtab.buffer.items.len, + .sh_link = 0, + .sh_info = 0, + .sh_addralign = 1, + .sh_entsize = 0, + }, + .phdr_index = undefined, }); self.shstrtab_dirty = true; self.shdr_table_dirty = true; } if (self.text_section_index == null) { - self.text_section_index = @intCast(u16, self.sections.items.len); + self.text_section_index = @intCast(u16, self.sections.slice().len); const phdr = &self.program_headers.items[self.phdr_load_re_index.?]; - try self.sections.append(self.base.allocator, .{ - .sh_name = try self.makeString(".text"), - .sh_type = elf.SHT_PROGBITS, - .sh_flags = elf.SHF_ALLOC | elf.SHF_EXECINSTR, - .sh_addr = phdr.p_vaddr, - .sh_offset = phdr.p_offset, - .sh_size = phdr.p_filesz, - .sh_link = 0, - .sh_info = 0, - .sh_addralign = 1, - .sh_entsize = 0, + try self.sections.append(gpa, .{ + .shdr = .{ + .sh_name = try self.shstrtab.insert(gpa, ".text"), + .sh_type = elf.SHT_PROGBITS, + .sh_flags = elf.SHF_ALLOC | elf.SHF_EXECINSTR, + .sh_addr = phdr.p_vaddr, + .sh_offset = phdr.p_offset, + .sh_size = phdr.p_filesz, + .sh_link = 0, + .sh_info = 0, + .sh_addralign = 1, + .sh_entsize = 0, + }, + .phdr_index = self.phdr_load_re_index.?, }); - try self.phdr_shdr_table.putNoClobber( - self.base.allocator, - self.phdr_load_re_index.?, - self.text_section_index.?, - ); self.shdr_table_dirty = true; } if (self.got_section_index == null) { - self.got_section_index = @intCast(u16, self.sections.items.len); + self.got_section_index = @intCast(u16, self.sections.slice().len); const phdr = &self.program_headers.items[self.phdr_got_index.?]; - try self.sections.append(self.base.allocator, .{ - .sh_name = try self.makeString(".got"), - .sh_type = elf.SHT_PROGBITS, - .sh_flags = elf.SHF_ALLOC, - .sh_addr = phdr.p_vaddr, - .sh_offset = phdr.p_offset, - .sh_size = phdr.p_filesz, - .sh_link = 0, - .sh_info = 0, - .sh_addralign = @as(u16, ptr_size), - .sh_entsize = 0, + try self.sections.append(gpa, .{ + .shdr = .{ + .sh_name = try self.shstrtab.insert(gpa, ".got"), + .sh_type = elf.SHT_PROGBITS, + .sh_flags = elf.SHF_ALLOC, + .sh_addr = phdr.p_vaddr, + .sh_offset = phdr.p_offset, + .sh_size = phdr.p_filesz, + .sh_link = 0, + .sh_info = 0, + .sh_addralign = @as(u16, ptr_size), + .sh_entsize = 0, + }, + .phdr_index = self.phdr_got_index.?, }); - try self.phdr_shdr_table.putNoClobber( - self.base.allocator, - self.phdr_got_index.?, - self.got_section_index.?, - ); self.shdr_table_dirty = true; } if (self.rodata_section_index == null) { - self.rodata_section_index = @intCast(u16, self.sections.items.len); + self.rodata_section_index = @intCast(u16, self.sections.slice().len); const phdr = &self.program_headers.items[self.phdr_load_ro_index.?]; - try self.sections.append(self.base.allocator, .{ - .sh_name = try self.makeString(".rodata"), - .sh_type = elf.SHT_PROGBITS, - .sh_flags = elf.SHF_ALLOC, - .sh_addr = phdr.p_vaddr, - .sh_offset = phdr.p_offset, - .sh_size = phdr.p_filesz, - .sh_link = 0, - .sh_info = 0, - .sh_addralign = 1, - .sh_entsize = 0, + try self.sections.append(gpa, .{ + .shdr = .{ + .sh_name = try self.shstrtab.insert(gpa, ".rodata"), + .sh_type = elf.SHT_PROGBITS, + .sh_flags = elf.SHF_ALLOC, + .sh_addr = phdr.p_vaddr, + .sh_offset = phdr.p_offset, + .sh_size = phdr.p_filesz, + .sh_link = 0, + .sh_info = 0, + .sh_addralign = 1, + .sh_entsize = 0, + }, + .phdr_index = self.phdr_load_ro_index.?, }); - try self.phdr_shdr_table.putNoClobber( - self.base.allocator, - self.phdr_load_ro_index.?, - self.rodata_section_index.?, - ); self.shdr_table_dirty = true; } if (self.data_section_index == null) { - self.data_section_index = @intCast(u16, self.sections.items.len); + self.data_section_index = @intCast(u16, self.sections.slice().len); const phdr = &self.program_headers.items[self.phdr_load_rw_index.?]; - try self.sections.append(self.base.allocator, .{ - .sh_name = try self.makeString(".data"), - .sh_type = elf.SHT_PROGBITS, - .sh_flags = elf.SHF_WRITE | elf.SHF_ALLOC, - .sh_addr = phdr.p_vaddr, - .sh_offset = phdr.p_offset, - .sh_size = phdr.p_filesz, - .sh_link = 0, - .sh_info = 0, - .sh_addralign = @as(u16, ptr_size), - .sh_entsize = 0, + try self.sections.append(gpa, .{ + .shdr = .{ + .sh_name = try self.shstrtab.insert(gpa, ".data"), + .sh_type = elf.SHT_PROGBITS, + .sh_flags = elf.SHF_WRITE | elf.SHF_ALLOC, + .sh_addr = phdr.p_vaddr, + .sh_offset = phdr.p_offset, + .sh_size = phdr.p_filesz, + .sh_link = 0, + .sh_info = 0, + .sh_addralign = @as(u16, ptr_size), + .sh_entsize = 0, + }, + .phdr_index = self.phdr_load_rw_index.?, }); - try self.phdr_shdr_table.putNoClobber( - self.base.allocator, - self.phdr_load_rw_index.?, - self.data_section_index.?, - ); self.shdr_table_dirty = true; } if (self.symtab_section_index == null) { - self.symtab_section_index = @intCast(u16, self.sections.items.len); + self.symtab_section_index = @intCast(u16, self.sections.slice().len); const min_align: u16 = if (small_ptr) @alignOf(elf.Elf32_Sym) else @alignOf(elf.Elf64_Sym); const each_size: u64 = if (small_ptr) @sizeOf(elf.Elf32_Sym) else @sizeOf(elf.Elf64_Sym); const file_size = self.base.options.symbol_count_hint * each_size; const off = self.findFreeSpace(file_size, min_align); log.debug("found symtab free space 0x{x} to 0x{x}", .{ off, off + file_size }); - try self.sections.append(self.base.allocator, .{ - .sh_name = try self.makeString(".symtab"), - .sh_type = elf.SHT_SYMTAB, - .sh_flags = 0, - .sh_addr = 0, - .sh_offset = off, - .sh_size = file_size, - // The section header index of the associated string table. - .sh_link = self.shstrtab_index.?, - .sh_info = @intCast(u32, self.local_symbols.items.len), - .sh_addralign = min_align, - .sh_entsize = each_size, + try self.sections.append(gpa, .{ + .shdr = .{ + .sh_name = try self.shstrtab.insert(gpa, ".symtab"), + .sh_type = elf.SHT_SYMTAB, + .sh_flags = 0, + .sh_addr = 0, + .sh_offset = off, + .sh_size = file_size, + // The section header index of the associated string table. + .sh_link = self.shstrtab_index.?, + .sh_info = @intCast(u32, self.local_symbols.items.len), + .sh_addralign = min_align, + .sh_entsize = each_size, + }, + .phdr_index = undefined, }); self.shdr_table_dirty = true; try self.writeSymbol(0); } - if (self.dwarf) |*dw| { - if (self.debug_str_section_index == null) { - self.debug_str_section_index = @intCast(u16, self.sections.items.len); - assert(dw.strtab.items.len == 0); - try dw.strtab.append(self.base.allocator, 0); - try self.sections.append(self.base.allocator, .{ - .sh_name = try self.makeString(".debug_str"), - .sh_type = elf.SHT_PROGBITS, - .sh_flags = elf.SHF_MERGE | elf.SHF_STRINGS, - .sh_addr = 0, - .sh_offset = 0, - .sh_size = 0, - .sh_link = 0, - .sh_info = 0, - .sh_addralign = 1, - .sh_entsize = 1, - }); - self.debug_strtab_dirty = true; - self.shdr_table_dirty = true; - } + // if (self.dwarf) |*dw| { + // if (self.debug_str_section_index == null) { + // self.debug_str_section_index = @intCast(u16, self.sections.slice().len); + // assert(dw.strtab.items.len == 0); + // try dw.strtab.append(gpa, 0); + // try self.sections.append(gpa, .{ + // .shdr = .{ + // .sh_name = try self.shstrtab.insert(gpa, ".debug_str"), + // .sh_type = elf.SHT_PROGBITS, + // .sh_flags = elf.SHF_MERGE | elf.SHF_STRINGS, + // .sh_addr = 0, + // .sh_offset = 0, + // .sh_size = 0, + // .sh_link = 0, + // .sh_info = 0, + // .sh_addralign = 1, + // .sh_entsize = 1, + // }, + // .phdr_index = undefined, + // }); + // self.debug_strtab_dirty = true; + // self.shdr_table_dirty = true; + // } - if (self.debug_info_section_index == null) { - self.debug_info_section_index = @intCast(u16, self.sections.items.len); + // if (self.debug_info_section_index == null) { + // self.debug_info_section_index = @intCast(u16, self.sections.slice().len); - const file_size_hint = 200; - const p_align = 1; - const off = self.findFreeSpace(file_size_hint, p_align); - log.debug("found .debug_info free space 0x{x} to 0x{x}", .{ - off, - off + file_size_hint, - }); - try self.sections.append(self.base.allocator, .{ - .sh_name = try self.makeString(".debug_info"), - .sh_type = elf.SHT_PROGBITS, - .sh_flags = 0, - .sh_addr = 0, - .sh_offset = off, - .sh_size = file_size_hint, - .sh_link = 0, - .sh_info = 0, - .sh_addralign = p_align, - .sh_entsize = 0, - }); - self.shdr_table_dirty = true; - self.debug_info_header_dirty = true; - } + // const file_size_hint = 200; + // const p_align = 1; + // const off = self.findFreeSpace(file_size_hint, p_align); + // log.debug("found .debug_info free space 0x{x} to 0x{x}", .{ + // off, + // off + file_size_hint, + // }); + // try self.sections.append(gpa, .{ + // .shdr = .{ + // .sh_name = try self.shstrtab.insert(gpa, ".debug_info"), + // .sh_type = elf.SHT_PROGBITS, + // .sh_flags = 0, + // .sh_addr = 0, + // .sh_offset = off, + // .sh_size = file_size_hint, + // .sh_link = 0, + // .sh_info = 0, + // .sh_addralign = p_align, + // .sh_entsize = 0, + // }, + // .phdr_index = undefined, + // }); + // self.shdr_table_dirty = true; + // self.debug_info_header_dirty = true; + // } - if (self.debug_abbrev_section_index == null) { - self.debug_abbrev_section_index = @intCast(u16, self.sections.items.len); + // if (self.debug_abbrev_section_index == null) { + // self.debug_abbrev_section_index = @intCast(u16, self.sections.slice().len); - const file_size_hint = 128; - const p_align = 1; - const off = self.findFreeSpace(file_size_hint, p_align); - log.debug("found .debug_abbrev free space 0x{x} to 0x{x}", .{ - off, - off + file_size_hint, - }); - try self.sections.append(self.base.allocator, .{ - .sh_name = try self.makeString(".debug_abbrev"), - .sh_type = elf.SHT_PROGBITS, - .sh_flags = 0, - .sh_addr = 0, - .sh_offset = off, - .sh_size = file_size_hint, - .sh_link = 0, - .sh_info = 0, - .sh_addralign = p_align, - .sh_entsize = 0, - }); - self.shdr_table_dirty = true; - self.debug_abbrev_section_dirty = true; - } + // const file_size_hint = 128; + // const p_align = 1; + // const off = self.findFreeSpace(file_size_hint, p_align); + // log.debug("found .debug_abbrev free space 0x{x} to 0x{x}", .{ + // off, + // off + file_size_hint, + // }); + // try self.sections.append(gpa, .{ + // .shdr = .{ + // .sh_name = try self.shstrtab.insert(gpa, ".debug_abbrev"), + // .sh_type = elf.SHT_PROGBITS, + // .sh_flags = 0, + // .sh_addr = 0, + // .sh_offset = off, + // .sh_size = file_size_hint, + // .sh_link = 0, + // .sh_info = 0, + // .sh_addralign = p_align, + // .sh_entsize = 0, + // }, + // .phdr_index = undefined, + // }); + // self.shdr_table_dirty = true; + // self.debug_abbrev_section_dirty = true; + // } - if (self.debug_aranges_section_index == null) { - self.debug_aranges_section_index = @intCast(u16, self.sections.items.len); + // if (self.debug_aranges_section_index == null) { + // self.debug_aranges_section_index = @intCast(u16, self.sections.slice().len); - const file_size_hint = 160; - const p_align = 16; - const off = self.findFreeSpace(file_size_hint, p_align); - log.debug("found .debug_aranges free space 0x{x} to 0x{x}", .{ - off, - off + file_size_hint, - }); - try self.sections.append(self.base.allocator, .{ - .sh_name = try self.makeString(".debug_aranges"), - .sh_type = elf.SHT_PROGBITS, - .sh_flags = 0, - .sh_addr = 0, - .sh_offset = off, - .sh_size = file_size_hint, - .sh_link = 0, - .sh_info = 0, - .sh_addralign = p_align, - .sh_entsize = 0, - }); - self.shdr_table_dirty = true; - self.debug_aranges_section_dirty = true; - } + // const file_size_hint = 160; + // const p_align = 16; + // const off = self.findFreeSpace(file_size_hint, p_align); + // log.debug("found .debug_aranges free space 0x{x} to 0x{x}", .{ + // off, + // off + file_size_hint, + // }); + // try self.sections.append(gpa, .{ + // .shdr = .{ + // .sh_name = try self.shstrtab.insert(gpa, ".debug_aranges"), + // .sh_type = elf.SHT_PROGBITS, + // .sh_flags = 0, + // .sh_addr = 0, + // .sh_offset = off, + // .sh_size = file_size_hint, + // .sh_link = 0, + // .sh_info = 0, + // .sh_addralign = p_align, + // .sh_entsize = 0, + // }, + // .phdr_index = undefined, + // }); + // self.shdr_table_dirty = true; + // self.debug_aranges_section_dirty = true; + // } - if (self.debug_line_section_index == null) { - self.debug_line_section_index = @intCast(u16, self.sections.items.len); + // if (self.debug_line_section_index == null) { + // self.debug_line_section_index = @intCast(u16, self.sections.slice().len); - const file_size_hint = 250; - const p_align = 1; - const off = self.findFreeSpace(file_size_hint, p_align); - log.debug("found .debug_line free space 0x{x} to 0x{x}", .{ - off, - off + file_size_hint, - }); - try self.sections.append(self.base.allocator, .{ - .sh_name = try self.makeString(".debug_line"), - .sh_type = elf.SHT_PROGBITS, - .sh_flags = 0, - .sh_addr = 0, - .sh_offset = off, - .sh_size = file_size_hint, - .sh_link = 0, - .sh_info = 0, - .sh_addralign = p_align, - .sh_entsize = 0, - }); - self.shdr_table_dirty = true; - self.debug_line_header_dirty = true; - } - } + // const file_size_hint = 250; + // const p_align = 1; + // const off = self.findFreeSpace(file_size_hint, p_align); + // log.debug("found .debug_line free space 0x{x} to 0x{x}", .{ + // off, + // off + file_size_hint, + // }); + // try self.sections.append(gpa, .{ + // .shdr = .{ + // .sh_name = try self.shstrtab.insert(gpa, ".debug_line"), + // .sh_type = elf.SHT_PROGBITS, + // .sh_flags = 0, + // .sh_addr = 0, + // .sh_offset = off, + // .sh_size = file_size_hint, + // .sh_link = 0, + // .sh_info = 0, + // .sh_addralign = p_align, + // .sh_entsize = 0, + // }, + // .phdr_index = undefined, + // }); + // self.shdr_table_dirty = true; + // self.debug_line_header_dirty = true; + // } + // } const shsize: u64 = switch (self.ptr_width) { .p32 => @sizeOf(elf.Elf32_Shdr), @@ -843,7 +835,7 @@ pub fn populateMissingMetadata(self: *Elf) !void { .p64 => @alignOf(elf.Elf64_Shdr), }; if (self.shdr_table_offset == null) { - self.shdr_table_offset = self.findFreeSpace(self.sections.items.len * shsize, shalign); + self.shdr_table_offset = self.findFreeSpace(self.sections.slice().len * shsize, shalign); self.shdr_table_dirty = true; } @@ -874,7 +866,7 @@ pub fn populateMissingMetadata(self: *Elf) !void { // offset + it's filesize. var max_file_offset: u64 = 0; - for (self.sections.items) |shdr| { + for (self.sections.items(.shdr)) |shdr| { if (shdr.sh_offset + shdr.sh_size > max_file_offset) { max_file_offset = shdr.sh_offset + shdr.sh_size; } @@ -884,15 +876,18 @@ pub fn populateMissingMetadata(self: *Elf) !void { } } -fn growAllocSection(self: *Elf, shdr_index: u16, phdr_index: u16, needed_size: u64) !void { +fn growAllocSection(self: *Elf, shdr_index: u16, needed_size: u64) !void { // TODO Also detect virtual address collisions. - const shdr = &self.sections.items[shdr_index]; + const shdr = &self.sections.items(.shdr)[shdr_index]; + const phdr_index = self.sections.items(.phdr_index)[shdr_index]; const phdr = &self.program_headers.items[phdr_index]; + const maybe_last_atom_index = self.sections.items(.last_atom_index)[shdr_index]; if (needed_size > self.allocatedSize(shdr.sh_offset)) { // Must move the entire section. const new_offset = self.findFreeSpace(needed_size, self.page_size); - const existing_size = if (self.atoms.get(phdr_index)) |last| blk: { + const existing_size = if (maybe_last_atom_index) |last_atom_index| blk: { + const last = self.getAtom(last_atom_index); const sym = last.getSymbol(self); break :blk (sym.st_value + sym.st_size) - phdr.p_vaddr; } else if (shdr_index == self.got_section_index.?) blk: { @@ -900,8 +895,8 @@ fn growAllocSection(self: *Elf, shdr_index: u16, phdr_index: u16, needed_size: u } else 0; shdr.sh_size = 0; - log.debug("new '{s}' file offset 0x{x} to 0x{x}", .{ - self.getString(shdr.sh_name), + log.debug("new '{?s}' file offset 0x{x} to 0x{x}", .{ + self.shstrtab.get(shdr.sh_name), new_offset, new_offset + existing_size, }); @@ -927,7 +922,7 @@ pub fn growNonAllocSection( min_alignment: u32, requires_file_copy: bool, ) !void { - const shdr = &self.sections.items[shdr_index]; + const shdr = &self.sections.items(.shdr)[shdr_index]; if (needed_size > self.allocatedSize(shdr.sh_offset)) { const existing_size = if (self.symtab_section_index.? == shdr_index) blk: { @@ -940,7 +935,7 @@ pub fn growNonAllocSection( shdr.sh_size = 0; // Move all the symbols to a new file location. const new_offset = self.findFreeSpace(needed_size, min_alignment); - log.debug("moving '{s}' from 0x{x} to 0x{x}", .{ self.getString(shdr.sh_name), shdr.sh_offset, new_offset }); + log.debug("moving '{?s}' from 0x{x} to 0x{x}", .{ self.shstrtab.get(shdr.sh_name), shdr.sh_offset, new_offset }); if (requires_file_copy) { const amt = try self.base.file.?.copyRangeAll( @@ -961,25 +956,26 @@ pub fn growNonAllocSection( } pub fn markDirty(self: *Elf, shdr_index: u16, phdr_index: ?u16) void { + _ = shdr_index; self.shdr_table_dirty = true; // TODO look into only writing one section if (phdr_index) |_| { self.phdr_table_dirty = true; // TODO look into making only the one program header dirty } - if (self.dwarf) |_| { - if (self.debug_info_section_index.? == shdr_index) { - self.debug_info_header_dirty = true; - } else if (self.debug_line_section_index.? == shdr_index) { - self.debug_line_header_dirty = true; - } else if (self.debug_abbrev_section_index.? == shdr_index) { - self.debug_abbrev_section_dirty = true; - } else if (self.debug_str_section_index.? == shdr_index) { - self.debug_strtab_dirty = true; - } else if (self.debug_aranges_section_index.? == shdr_index) { - self.debug_aranges_section_dirty = true; - } - } + // if (self.dwarf) |_| { + // if (self.debug_info_section_index.? == shdr_index) { + // self.debug_info_header_dirty = true; + // } else if (self.debug_line_section_index.? == shdr_index) { + // self.debug_line_header_dirty = true; + // } else if (self.debug_abbrev_section_index.? == shdr_index) { + // self.debug_abbrev_section_dirty = true; + // } else if (self.debug_str_section_index.? == shdr_index) { + // self.debug_strtab_dirty = true; + // } else if (self.debug_aranges_section_index.? == shdr_index) { + // self.debug_aranges_section_dirty = true; + // } + // } } pub fn flush(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node) link.File.FlushError!void { @@ -1011,6 +1007,7 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node } } + const gpa = self.base.allocator; var sub_prog_node = prog_node.start("ELF Flush", 0); sub_prog_node.activate(); defer sub_prog_node.end(); @@ -1018,23 +1015,25 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node // TODO This linker code currently assumes there is only 1 compilation unit and it // corresponds to the Zig source code. const module = self.base.options.module orelse return error.LinkingWithoutZigSourceUnimplemented; + _ = module; const target_endian = self.base.options.target.cpu.arch.endian(); const foreign_endian = target_endian != builtin.cpu.arch.endian(); - if (self.dwarf) |*dw| { - try dw.flushModule(module); - } + // if (self.dwarf) |*dw| { + // try dw.flushModule(module); + // } { var it = self.relocs.iterator(); while (it.next()) |entry| { - const atom = entry.key_ptr.*; + const atom_index = entry.key_ptr.*; const relocs = entry.value_ptr.*; + const atom = self.getAtom(atom_index); const source_sym = atom.getSymbol(self); - const source_shdr = self.sections.items[source_sym.st_shndx]; + const source_shdr = self.sections.items(.shdr)[source_sym.st_shndx]; - log.debug("relocating '{s}'", .{self.getString(source_sym.st_name)}); + log.debug("relocating '{?s}'", .{self.shstrtab.get(source_sym.st_name)}); for (relocs.items) |*reloc| { const target_sym = self.local_symbols.items[reloc.target]; @@ -1045,10 +1044,10 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node const section_offset = (source_sym.st_value + reloc.offset) - source_shdr.sh_addr; const file_offset = source_shdr.sh_offset + section_offset; - log.debug(" ({x}: [() => 0x{x}] ({s}))", .{ + log.debug(" ({x}: [() => 0x{x}] ({?s}))", .{ reloc.offset, target_vaddr, - self.getString(target_sym.st_name), + self.shstrtab.get(target_sym.st_name), }); switch (self.ptr_width) { @@ -1069,43 +1068,43 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node self.logSymtab(); } - if (self.dwarf) |*dw| { - if (self.debug_abbrev_section_dirty) { - try dw.writeDbgAbbrev(); - if (!self.shdr_table_dirty) { - // Then it won't get written with the others and we need to do it. - try self.writeSectHeader(self.debug_abbrev_section_index.?); - } - self.debug_abbrev_section_dirty = false; - } + // if (self.dwarf) |*dw| { + // if (self.debug_abbrev_section_dirty) { + // try dw.writeDbgAbbrev(); + // if (!self.shdr_table_dirty) { + // // Then it won't get written with the others and we need to do it. + // try self.writeSectHeader(self.debug_abbrev_section_index.?); + // } + // self.debug_abbrev_section_dirty = false; + // } - if (self.debug_info_header_dirty) { - // Currently only one compilation unit is supported, so the address range is simply - // identical to the main program header virtual address and memory size. - const text_phdr = &self.program_headers.items[self.phdr_load_re_index.?]; - const low_pc = text_phdr.p_vaddr; - const high_pc = text_phdr.p_vaddr + text_phdr.p_memsz; - try dw.writeDbgInfoHeader(module, low_pc, high_pc); - self.debug_info_header_dirty = false; - } + // if (self.debug_info_header_dirty) { + // // Currently only one compilation unit is supported, so the address range is simply + // // identical to the main program header virtual address and memory size. + // const text_phdr = &self.program_headers.items[self.phdr_load_re_index.?]; + // const low_pc = text_phdr.p_vaddr; + // const high_pc = text_phdr.p_vaddr + text_phdr.p_memsz; + // try dw.writeDbgInfoHeader(module, low_pc, high_pc); + // self.debug_info_header_dirty = false; + // } - if (self.debug_aranges_section_dirty) { - // Currently only one compilation unit is supported, so the address range is simply - // identical to the main program header virtual address and memory size. - const text_phdr = &self.program_headers.items[self.phdr_load_re_index.?]; - try dw.writeDbgAranges(text_phdr.p_vaddr, text_phdr.p_memsz); - if (!self.shdr_table_dirty) { - // Then it won't get written with the others and we need to do it. - try self.writeSectHeader(self.debug_aranges_section_index.?); - } - self.debug_aranges_section_dirty = false; - } + // if (self.debug_aranges_section_dirty) { + // // Currently only one compilation unit is supported, so the address range is simply + // // identical to the main program header virtual address and memory size. + // const text_phdr = &self.program_headers.items[self.phdr_load_re_index.?]; + // try dw.writeDbgAranges(text_phdr.p_vaddr, text_phdr.p_memsz); + // if (!self.shdr_table_dirty) { + // // Then it won't get written with the others and we need to do it. + // try self.writeSectHeader(self.debug_aranges_section_index.?); + // } + // self.debug_aranges_section_dirty = false; + // } - if (self.debug_line_header_dirty) { - try dw.writeDbgLineHeader(); - self.debug_line_header_dirty = false; - } - } + // if (self.debug_line_header_dirty) { + // try dw.writeDbgLineHeader(); + // self.debug_line_header_dirty = false; + // } + // } if (self.phdr_table_dirty) { const phsize: u64 = switch (self.ptr_width) { @@ -1126,8 +1125,8 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node switch (self.ptr_width) { .p32 => { - const buf = try self.base.allocator.alloc(elf.Elf32_Phdr, self.program_headers.items.len); - defer self.base.allocator.free(buf); + const buf = try gpa.alloc(elf.Elf32_Phdr, self.program_headers.items.len); + defer gpa.free(buf); for (buf) |*phdr, i| { phdr.* = progHeaderTo32(self.program_headers.items[i]); @@ -1138,8 +1137,8 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node try self.base.file.?.pwriteAll(mem.sliceAsBytes(buf), self.phdr_table_offset.?); }, .p64 => { - const buf = try self.base.allocator.alloc(elf.Elf64_Phdr, self.program_headers.items.len); - defer self.base.allocator.free(buf); + const buf = try gpa.alloc(elf.Elf64_Phdr, self.program_headers.items.len); + defer gpa.free(buf); for (buf) |*phdr, i| { phdr.* = self.program_headers.items[i]; @@ -1155,23 +1154,23 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node { const shdr_index = self.shstrtab_index.?; - if (self.shstrtab_dirty or self.shstrtab.items.len != self.sections.items[shdr_index].sh_size) { - try self.growNonAllocSection(shdr_index, self.shstrtab.items.len, 1, false); - const shstrtab_sect = self.sections.items[shdr_index]; - try self.base.file.?.pwriteAll(self.shstrtab.items, shstrtab_sect.sh_offset); + if (self.shstrtab_dirty or self.shstrtab.buffer.items.len != self.sections.items(.shdr)[shdr_index].sh_size) { + try self.growNonAllocSection(shdr_index, self.shstrtab.buffer.items.len, 1, false); + const shstrtab_sect = self.sections.items(.shdr)[shdr_index]; + try self.base.file.?.pwriteAll(self.shstrtab.buffer.items, shstrtab_sect.sh_offset); self.shstrtab_dirty = false; } } - if (self.dwarf) |dwarf| { - const shdr_index = self.debug_str_section_index.?; - if (self.debug_strtab_dirty or dwarf.strtab.items.len != self.sections.items[shdr_index].sh_size) { - try self.growNonAllocSection(shdr_index, dwarf.strtab.items.len, 1, false); - const debug_strtab_sect = self.sections.items[shdr_index]; - try self.base.file.?.pwriteAll(dwarf.strtab.items, debug_strtab_sect.sh_offset); - self.debug_strtab_dirty = false; - } - } + // if (self.dwarf) |dwarf| { + // const shdr_index = self.debug_str_section_index.?; + // if (self.debug_strtab_dirty or dwarf.strtab.items.len != self.sections.items(.shdr)[shdr_index].sh_size) { + // try self.growNonAllocSection(shdr_index, dwarf.strtab.items.len, 1, false); + // const debug_strtab_sect = self.sections.items(.shdr)[shdr_index]; + // try self.base.file.?.pwriteAll(dwarf.strtab.items, debug_strtab_sect.sh_offset); + // self.debug_strtab_dirty = false; + // } + // } if (self.shdr_table_dirty) { const shsize: u64 = switch (self.ptr_width) { @@ -1183,7 +1182,7 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node .p64 => @alignOf(elf.Elf64_Shdr), }; const allocated_size = self.allocatedSize(self.shdr_table_offset.?); - const needed_size = self.sections.items.len * shsize; + const needed_size = self.sections.slice().len * shsize; if (needed_size > allocated_size) { self.shdr_table_offset = null; // free the space @@ -1192,12 +1191,13 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node switch (self.ptr_width) { .p32 => { - const buf = try self.base.allocator.alloc(elf.Elf32_Shdr, self.sections.items.len); - defer self.base.allocator.free(buf); + const slice = self.sections.slice(); + const buf = try gpa.alloc(elf.Elf32_Shdr, slice.len); + defer gpa.free(buf); for (buf) |*shdr, i| { - shdr.* = sectHeaderTo32(self.sections.items[i]); - log.debug("writing section {s}: {}", .{ self.getString(shdr.sh_name), shdr.* }); + shdr.* = sectHeaderTo32(slice.items(.shdr)[i]); + log.debug("writing section {?s}: {}", .{ self.shstrtab.get(shdr.sh_name), shdr.* }); if (foreign_endian) { mem.byteSwapAllFields(elf.Elf32_Shdr, shdr); } @@ -1205,12 +1205,13 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node try self.base.file.?.pwriteAll(mem.sliceAsBytes(buf), self.shdr_table_offset.?); }, .p64 => { - const buf = try self.base.allocator.alloc(elf.Elf64_Shdr, self.sections.items.len); - defer self.base.allocator.free(buf); + const slice = self.sections.slice(); + const buf = try gpa.alloc(elf.Elf64_Shdr, slice.len); + defer gpa.free(buf); for (buf) |*shdr, i| { - shdr.* = self.sections.items[i]; - log.debug("writing section {s}: {}", .{ self.getString(shdr.sh_name), shdr.* }); + shdr.* = slice.items(.shdr)[i]; + log.debug("writing section {?s}: {}", .{ self.shstrtab.get(shdr.sh_name), shdr.* }); if (foreign_endian) { mem.byteSwapAllFields(elf.Elf64_Shdr, shdr); } @@ -2021,7 +2022,7 @@ fn writeElfHeader(self: *Elf) !void { mem.writeInt(u16, hdr_buf[index..][0..2], e_shentsize, endian); index += 2; - const e_shnum = @intCast(u16, self.sections.items.len); + const e_shnum = @intCast(u16, self.sections.slice().len); mem.writeInt(u16, hdr_buf[index..][0..2], e_shnum, endian); index += 2; @@ -2033,124 +2034,150 @@ fn writeElfHeader(self: *Elf) !void { try self.base.file.?.pwriteAll(hdr_buf[0..index], 0); } -fn freeTextBlock(self: *Elf, text_block: *TextBlock, phdr_index: u16) void { - const local_sym = text_block.getSymbol(self); - const name_str_index = local_sym.st_name; - const name = self.getString(name_str_index); - log.debug("freeTextBlock {*} ({s})", .{ text_block, name }); +fn freeAtom(self: *Elf, atom_index: Atom.Index) void { + const atom = self.getAtom(atom_index); + log.debug("freeAtom {d} ({s})", .{ atom_index, atom.getName(self) }); - self.freeRelocationsForTextBlock(text_block); + Atom.freeRelocations(self, atom_index); - const free_list = self.atom_free_lists.getPtr(phdr_index).?; + const gpa = self.base.allocator; + const shndx = atom.getSymbol(self).st_shndx; + const free_list = &self.sections.items(.free_list)[shndx]; var already_have_free_list_node = false; { var i: usize = 0; // TODO turn free_list into a hash map while (i < free_list.items.len) { - if (free_list.items[i] == text_block) { + if (free_list.items[i] == atom_index) { _ = free_list.swapRemove(i); continue; } - if (free_list.items[i] == text_block.prev) { + if (free_list.items[i] == atom.prev_index) { already_have_free_list_node = true; } i += 1; } } - if (self.atoms.getPtr(phdr_index)) |last_block| { - if (last_block.* == text_block) { - if (text_block.prev) |prev| { + const maybe_last_atom_index = &self.sections.items(.last_atom_index)[shndx]; + if (maybe_last_atom_index.*) |last_atom_index| { + if (last_atom_index == atom_index) { + if (atom.prev_index) |prev_index| { // TODO shrink the section size here - last_block.* = prev; + maybe_last_atom_index.* = prev_index; } else { - _ = self.atoms.fetchRemove(phdr_index); + maybe_last_atom_index.* = null; } } } - if (text_block.prev) |prev| { - prev.next = text_block.next; + if (atom.prev_index) |prev_index| { + const prev = self.getAtomPtr(prev_index); + prev.next_index = atom.next_index; - if (!already_have_free_list_node and prev.freeListEligible(self)) { + if (!already_have_free_list_node and prev.*.freeListEligible(self)) { // The free list is heuristics, it doesn't have to be perfect, so we can // ignore the OOM here. - free_list.append(self.base.allocator, prev) catch {}; + free_list.append(gpa, prev_index) catch {}; } } else { - text_block.prev = null; + self.getAtomPtr(atom_index).prev_index = null; } - if (text_block.next) |next| { - next.prev = text_block.prev; + if (atom.next_index) |next_index| { + self.getAtomPtr(next_index).prev_index = atom.prev_index; } else { - text_block.next = null; + self.getAtomPtr(atom_index).next_index = null; } // Appending to free lists is allowed to fail because the free lists are heuristics based anyway. - const local_sym_index = text_block.getSymbolIndex().?; - self.local_symbol_free_list.append(self.base.allocator, local_sym_index) catch {}; + const local_sym_index = atom.getSymbolIndex().?; + + self.local_symbol_free_list.append(gpa, local_sym_index) catch {}; self.local_symbols.items[local_sym_index].st_info = 0; + self.local_symbols.items[local_sym_index].st_shndx = 0; _ = self.atom_by_index_table.remove(local_sym_index); - text_block.local_sym_index = 0; + self.getAtomPtr(atom_index).local_sym_index = 0; - self.offset_table_free_list.append(self.base.allocator, text_block.offset_table_index) catch {}; + self.offset_table_free_list.append(self.base.allocator, atom.offset_table_index) catch {}; - if (self.dwarf) |*dw| { - dw.freeAtom(&text_block.dbg_info_atom); - } + // if (self.dwarf) |*dw| { + // dw.freeAtom(&atom.dbg_info_atom); + // } } -fn shrinkTextBlock(self: *Elf, text_block: *TextBlock, new_block_size: u64, phdr_index: u16) void { +fn shrinkAtom(self: *Elf, atom_index: Atom.Index, new_block_size: u64) void { _ = self; - _ = text_block; + _ = atom_index; _ = new_block_size; - _ = phdr_index; } -fn growTextBlock(self: *Elf, text_block: *TextBlock, new_block_size: u64, alignment: u64, phdr_index: u16) !u64 { - const sym = text_block.getSymbol(self); +fn growAtom(self: *Elf, atom_index: Atom.Index, new_block_size: u64, alignment: u64) !u64 { + const atom = self.getAtom(atom_index); + const sym = atom.getSymbol(self); const align_ok = mem.alignBackwardGeneric(u64, sym.st_value, alignment) == sym.st_value; - const need_realloc = !align_ok or new_block_size > text_block.capacity(self); + const need_realloc = !align_ok or new_block_size > atom.capacity(self); if (!need_realloc) return sym.st_value; - return self.allocateTextBlock(text_block, new_block_size, alignment, phdr_index); + return self.allocateAtom(atom_index, new_block_size, alignment); } -fn allocateTextBlock(self: *Elf, text_block: *TextBlock, new_block_size: u64, alignment: u64, phdr_index: u16) !u64 { - const shdr_index = self.phdr_shdr_table.get(phdr_index).?; - const phdr = &self.program_headers.items[phdr_index]; - const shdr = &self.sections.items[shdr_index]; - const new_block_ideal_capacity = padToIdeal(new_block_size); +pub fn createAtom(self: *Elf) !Atom.Index { + const gpa = self.base.allocator; + const atom_index = @intCast(Atom.Index, self.atoms.items.len); + const atom = try self.atoms.addOne(gpa); + const local_sym_index = try self.allocateLocalSymbol(); + const offset_table_index = try self.allocateGotOffset(); + try self.atom_by_index_table.putNoClobber(gpa, local_sym_index, atom_index); + atom.* = .{ + .local_sym_index = local_sym_index, + .offset_table_index = offset_table_index, + .prev_index = null, + .next_index = null, + .dbg_info_atom = undefined, + }; + log.debug("creating ATOM(%{d}) at index {d}", .{ local_sym_index, atom_index }); + return atom_index; +} - // We use these to indicate our intention to update metadata, placing the new block, +fn allocateAtom(self: *Elf, atom_index: Atom.Index, new_block_size: u64, alignment: u64) !u64 { + const atom = self.getAtom(atom_index); + const sym = atom.getSymbol(self); + const phdr_index = self.sections.items(.phdr_index)[sym.st_shndx]; + const phdr = &self.program_headers.items[phdr_index]; + const shdr = &self.sections.items(.shdr)[sym.st_shndx]; + const free_list = &self.sections.items(.free_list)[sym.st_shndx]; + const maybe_last_atom_index = &self.sections.items(.last_atom_index)[sym.st_shndx]; + const new_atom_ideal_capacity = padToIdeal(new_block_size); + + // We use these to indicate our intention to update metadata, placing the new atom, // and possibly removing a free list node. // It would be simpler to do it inside the for loop below, but that would cause a // problem if an error was returned later in the function. So this action // is actually carried out at the end of the function, when errors are no longer possible. - var block_placement: ?*TextBlock = null; + var atom_placement: ?Atom.Index = null; var free_list_removal: ?usize = null; - var free_list = self.atom_free_lists.get(phdr_index).?; // First we look for an appropriately sized free list node. // The list is unordered. We'll just take the first thing that works. const vaddr = blk: { var i: usize = 0; while (i < free_list.items.len) { - const big_block = free_list.items[i]; - // We now have a pointer to a live text block that has too much capacity. - // Is it enough that we could fit this new text block? - const sym = big_block.getSymbol(self); - const capacity = big_block.capacity(self); + const big_atom_index = free_list.items[i]; + const big_atom = self.getAtom(big_atom_index); + // We now have a pointer to a live atom that has too much capacity. + // Is it enough that we could fit this new atom? + const big_atom_sym = big_atom.getSymbol(self); + const capacity = big_atom.capacity(self); const ideal_capacity = padToIdeal(capacity); - const ideal_capacity_end_vaddr = std.math.add(u64, sym.st_value, ideal_capacity) catch ideal_capacity; - const capacity_end_vaddr = sym.st_value + capacity; - const new_start_vaddr_unaligned = capacity_end_vaddr - new_block_ideal_capacity; + const ideal_capacity_end_vaddr = std.math.add(u64, big_atom_sym.st_value, ideal_capacity) catch ideal_capacity; + const capacity_end_vaddr = big_atom_sym.st_value + capacity; + const new_start_vaddr_unaligned = capacity_end_vaddr - new_atom_ideal_capacity; const new_start_vaddr = mem.alignBackwardGeneric(u64, new_start_vaddr_unaligned, alignment); if (new_start_vaddr < ideal_capacity_end_vaddr) { // Additional bookkeeping here to notice if this free list node // should be deleted because the block that it points to has grown to take up // more of the extra capacity. - if (!big_block.freeListEligible(self)) { + if (!big_atom.freeListEligible(self)) { _ = free_list.swapRemove(i); } else { i += 1; @@ -2164,60 +2191,69 @@ fn allocateTextBlock(self: *Elf, text_block: *TextBlock, new_block_size: u64, al const keep_free_list_node = remaining_capacity >= min_text_capacity; // Set up the metadata to be updated, after errors are no longer possible. - block_placement = big_block; + atom_placement = big_atom_index; if (!keep_free_list_node) { free_list_removal = i; } break :blk new_start_vaddr; - } else if (self.atoms.get(phdr_index)) |last| { - const sym = last.getSymbol(self); - const ideal_capacity = padToIdeal(sym.st_size); - const ideal_capacity_end_vaddr = sym.st_value + ideal_capacity; + } else if (maybe_last_atom_index.*) |last_index| { + const last = self.getAtom(last_index); + const last_sym = last.getSymbol(self); + const ideal_capacity = padToIdeal(last_sym.st_size); + const ideal_capacity_end_vaddr = last_sym.st_value + ideal_capacity; const new_start_vaddr = mem.alignForwardGeneric(u64, ideal_capacity_end_vaddr, alignment); // Set up the metadata to be updated, after errors are no longer possible. - block_placement = last; + atom_placement = last_index; break :blk new_start_vaddr; } else { break :blk phdr.p_vaddr; } }; - const expand_text_section = block_placement == null or block_placement.?.next == null; - if (expand_text_section) { + const expand_section = if (atom_placement) |placement_index| + self.getAtom(placement_index).next_index == null + else + true; + if (expand_section) { const needed_size = (vaddr + new_block_size) - phdr.p_vaddr; - try self.growAllocSection(shdr_index, phdr_index, needed_size); - _ = try self.atoms.put(self.base.allocator, phdr_index, text_block); + try self.growAllocSection(sym.st_shndx, needed_size); + maybe_last_atom_index.* = atom_index; - if (self.dwarf) |_| { - // The .debug_info section has `low_pc` and `high_pc` values which is the virtual address - // range of the compilation unit. When we expand the text section, this range changes, - // so the DW_TAG.compile_unit tag of the .debug_info section becomes dirty. - self.debug_info_header_dirty = true; - // This becomes dirty for the same reason. We could potentially make this more - // fine-grained with the addition of support for more compilation units. It is planned to - // model each package as a different compilation unit. - self.debug_aranges_section_dirty = true; - } + // if (self.dwarf) |_| { + // // The .debug_info section has `low_pc` and `high_pc` values which is the virtual address + // // range of the compilation unit. When we expand the text section, this range changes, + // // so the DW_TAG.compile_unit tag of the .debug_info section becomes dirty. + // self.debug_info_header_dirty = true; + // // This becomes dirty for the same reason. We could potentially make this more + // // fine-grained with the addition of support for more compilation units. It is planned to + // // model each package as a different compilation unit. + // self.debug_aranges_section_dirty = true; + // } } shdr.sh_addralign = math.max(shdr.sh_addralign, alignment); - // This function can also reallocate a text block. + // This function can also reallocate an atom. // In this case we need to "unplug" it from its previous location before // plugging it in to its new location. - if (text_block.prev) |prev| { - prev.next = text_block.next; + if (atom.prev_index) |prev_index| { + const prev = self.getAtomPtr(prev_index); + prev.next_index = atom.next_index; } - if (text_block.next) |next| { - next.prev = text_block.prev; + if (atom.next_index) |next_index| { + const next = self.getAtomPtr(next_index); + next.prev_index = atom.prev_index; } - if (block_placement) |big_block| { - text_block.prev = big_block; - text_block.next = big_block.next; - big_block.next = text_block; + if (atom_placement) |big_atom_index| { + const big_atom = self.getAtomPtr(big_atom_index); + const atom_ptr = self.getAtomPtr(atom_index); + atom_ptr.prev_index = big_atom_index; + atom_ptr.next_index = big_atom.next_index; + big_atom.next_index = atom_index; } else { - text_block.prev = null; - text_block.next = null; + const atom_ptr = self.getAtomPtr(atom_index); + atom_ptr.prev_index = null; + atom_ptr.next_index = null; } if (free_list_removal) |i| { _ = free_list.swapRemove(i); @@ -2272,15 +2308,10 @@ pub fn allocateGotOffset(self: *Elf) !u32 { return index; } -fn freeRelocationsForTextBlock(self: *Elf, text_block: *TextBlock) void { - var removed_relocs = self.relocs.fetchRemove(text_block); - if (removed_relocs) |*relocs| relocs.value.deinit(self.base.allocator); -} - fn freeUnnamedConsts(self: *Elf, decl_index: Module.Decl.Index) void { const unnamed_consts = self.unnamed_const_atoms.getPtr(decl_index) orelse return; for (unnamed_consts.items) |atom| { - self.freeTextBlock(atom, self.phdr_load_ro_index.?); + self.freeAtom(atom); } unnamed_consts.clearAndFree(self.base.allocator); } @@ -2295,43 +2326,57 @@ pub fn freeDecl(self: *Elf, decl_index: Module.Decl.Index) void { log.debug("freeDecl {*}", .{decl}); - if (self.decls.fetchRemove(decl_index)) |kv| { - if (kv.value) |index| { - self.freeTextBlock(&decl.link.elf, index); - self.freeUnnamedConsts(decl_index); - } + if (self.decls.fetchRemove(decl_index)) |const_kv| { + var kv = const_kv; + self.freeAtom(kv.value.atom); + self.freeUnnamedConsts(decl_index); + kv.value.exports.deinit(self.base.allocator); } - if (self.dwarf) |*dw| { - dw.freeDecl(decl); - } + // if (self.dwarf) |*dw| { + // dw.freeDecl(decl); + // } } -fn getDeclPhdrIndex(self: *Elf, decl: *Module.Decl) !u16 { +pub fn getOrCreateAtomForDecl(self: *Elf, decl_index: Module.Decl.Index) !Atom.Index { + const gop = try self.decls.getOrPut(self.base.allocator, decl_index); + if (!gop.found_existing) { + gop.value_ptr.* = .{ + .atom = try self.createAtom(), + .shdr = self.getDeclShdrIndex(decl_index), + .exports = .{}, + }; + } + return gop.value_ptr.atom; +} + +fn getDeclShdrIndex(self: *Elf, decl_index: Module.Decl.Index) u16 { + const decl = self.base.options.module.?.declPtr(decl_index); const ty = decl.ty; const zig_ty = ty.zigTypeTag(); const val = decl.val; - const phdr_index: u16 = blk: { + const shdr_index: u16 = blk: { if (val.isUndefDeep()) { // TODO in release-fast and release-small, we should put undef in .bss - break :blk self.phdr_load_rw_index.?; + break :blk self.data_section_index.?; } switch (zig_ty) { // TODO: what if this is a function pointer? - .Fn => break :blk self.phdr_load_re_index.?, + .Fn => break :blk self.text_section_index.?, else => { if (val.castTag(.variable)) |_| { - break :blk self.phdr_load_rw_index.?; + break :blk self.data_section_index.?; } - break :blk self.phdr_load_ro_index.?; + break :blk self.rodata_section_index.?; }, } }; - return phdr_index; + return shdr_index; } fn updateDeclCode(self: *Elf, decl_index: Module.Decl.Index, code: []const u8, stt_bits: u8) !*elf.Elf64_Sym { + const gpa = self.base.allocator; const mod = self.base.options.module.?; const decl = mod.declPtr(decl_index); @@ -2341,60 +2386,65 @@ fn updateDeclCode(self: *Elf, decl_index: Module.Decl.Index, code: []const u8, s log.debug("updateDeclCode {s}{*}", .{ decl_name, decl }); const required_alignment = decl.getAlignment(self.base.options.target); - const decl_ptr = self.decls.getPtr(decl_index).?; - if (decl_ptr.* == null) { - decl_ptr.* = try self.getDeclPhdrIndex(decl); - } - const phdr_index = decl_ptr.*.?; - const shdr_index = self.phdr_shdr_table.get(phdr_index).?; + const decl_metadata = self.decls.get(decl_index).?; + const atom_index = decl_metadata.atom; + const atom = self.getAtom(atom_index); - const local_sym = decl.link.elf.getSymbolPtr(self); - if (local_sym.st_size != 0) { - const capacity = decl.link.elf.capacity(self); + const shdr_index = decl_metadata.shdr; + if (atom.getSymbol(self).st_size != 0) { + const local_sym = atom.getSymbolPtr(self); + local_sym.st_name = try self.shstrtab.insert(gpa, decl_name); + local_sym.st_info = (elf.STB_LOCAL << 4) | stt_bits; + local_sym.st_other = 0; + local_sym.st_shndx = shdr_index; + + const capacity = atom.capacity(self); const need_realloc = code.len > capacity or !mem.isAlignedGeneric(u64, local_sym.st_value, required_alignment); + if (need_realloc) { - const vaddr = try self.growTextBlock(&decl.link.elf, code.len, required_alignment, phdr_index); + const vaddr = try self.growAtom(atom_index, code.len, required_alignment); log.debug("growing {s} from 0x{x} to 0x{x}", .{ decl_name, local_sym.st_value, vaddr }); if (vaddr != local_sym.st_value) { local_sym.st_value = vaddr; log.debug(" (writing new offset table entry)", .{}); - self.offset_table.items[decl.link.elf.offset_table_index] = vaddr; - try self.writeOffsetTableEntry(decl.link.elf.offset_table_index); + self.offset_table.items[atom.offset_table_index] = vaddr; + try self.writeOffsetTableEntry(atom.offset_table_index); } } else if (code.len < local_sym.st_size) { - self.shrinkTextBlock(&decl.link.elf, code.len, phdr_index); + self.shrinkAtom(atom_index, code.len); } local_sym.st_size = code.len; - local_sym.st_name = try self.updateString(local_sym.st_name, decl_name); - local_sym.st_info = (elf.STB_LOCAL << 4) | stt_bits; - local_sym.st_other = 0; - local_sym.st_shndx = shdr_index; - // TODO this write could be avoided if no fields of the symbol were changed. - try self.writeSymbol(decl.link.elf.getSymbolIndex().?); - } else { - const name_str_index = try self.makeString(decl_name); - const vaddr = try self.allocateTextBlock(&decl.link.elf, code.len, required_alignment, phdr_index); - errdefer self.freeTextBlock(&decl.link.elf, phdr_index); - log.debug("allocated text block for {s} at 0x{x}", .{ decl_name, vaddr }); + // TODO this write could be avoided if no fields of the symbol were changed. + try self.writeSymbol(atom.getSymbolIndex().?); + } else { + const local_sym = atom.getSymbolPtr(self); local_sym.* = .{ - .st_name = name_str_index, + .st_name = try self.shstrtab.insert(gpa, decl_name), .st_info = (elf.STB_LOCAL << 4) | stt_bits, .st_other = 0, .st_shndx = shdr_index, - .st_value = vaddr, - .st_size = code.len, + .st_value = 0, + .st_size = 0, }; - self.offset_table.items[decl.link.elf.offset_table_index] = vaddr; + const vaddr = try self.allocateAtom(atom_index, code.len, required_alignment); + errdefer self.freeAtom(atom_index); + log.debug("allocated text block for {s} at 0x{x}", .{ decl_name, vaddr }); - try self.writeSymbol(decl.link.elf.getSymbolIndex().?); - try self.writeOffsetTableEntry(decl.link.elf.offset_table_index); + self.offset_table.items[atom.offset_table_index] = vaddr; + local_sym.st_value = vaddr; + local_sym.st_size = code.len; + + try self.writeSymbol(atom.getSymbolIndex().?); + try self.writeOffsetTableEntry(atom.offset_table_index); } + const local_sym = atom.getSymbolPtr(self); + const phdr_index = self.sections.items(.phdr_index)[shdr_index]; const section_offset = local_sym.st_value - self.program_headers.items[phdr_index].p_vaddr; - const file_offset = self.sections.items[shdr_index].sh_offset + section_offset; + const file_offset = self.sections.items(.shdr)[shdr_index].sh_offset + section_offset; try self.base.file.?.pwriteAll(code, file_offset); return local_sym; @@ -2413,28 +2463,23 @@ pub fn updateFunc(self: *Elf, module: *Module, func: *Module.Fn, air: Air, liven const decl_index = func.owner_decl; const decl = module.declPtr(decl_index); - const atom = &decl.link.elf; - try atom.ensureInitialized(self); - const gop = try self.decls.getOrPut(self.base.allocator, decl_index); - if (gop.found_existing) { - self.freeUnnamedConsts(decl_index); - self.freeRelocationsForTextBlock(atom); - } else { - gop.value_ptr.* = null; - } + + const atom_index = try self.getOrCreateAtomForDecl(decl_index); + self.freeUnnamedConsts(decl_index); + Atom.freeRelocations(self, atom_index); var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); - var decl_state: ?Dwarf.DeclState = if (self.dwarf) |*dw| try dw.initDeclState(module, decl_index) else null; - defer if (decl_state) |*ds| ds.deinit(); + // var decl_state: ?Dwarf.DeclState = if (self.dwarf) |*dw| try dw.initDeclState(module, decl_index) else null; + // defer if (decl_state) |*ds| ds.deinit(); - const res = if (decl_state) |*ds| - try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .{ - .dwarf = ds, - }) - else - try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .none); + // const res = if (decl_state) |*ds| + // try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .{ + // .dwarf = ds, + // }) + // else + const res = try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .none); const code = switch (res) { .ok => code_buffer.items, @@ -2445,15 +2490,16 @@ pub fn updateFunc(self: *Elf, module: *Module, func: *Module.Fn, air: Air, liven }, }; const local_sym = try self.updateDeclCode(decl_index, code, elf.STT_FUNC); - if (decl_state) |*ds| { - try self.dwarf.?.commitDeclState( - module, - decl_index, - local_sym.st_value, - local_sym.st_size, - ds, - ); - } + _ = local_sym; + // if (decl_state) |*ds| { + // try self.dwarf.?.commitDeclState( + // module, + // decl_index, + // local_sym.st_value, + // local_sym.st_size, + // ds, + // ); + // } // Since we updated the vaddr and the size, each corresponding export // symbol also needs to be updated. @@ -2483,41 +2529,34 @@ pub fn updateDecl(self: *Elf, module: *Module, decl_index: Module.Decl.Index) !v } } - assert(!self.unnamed_const_atoms.contains(decl_index)); - - const atom = &decl.link.elf; - try atom.ensureInitialized(self); - const gop = try self.decls.getOrPut(self.base.allocator, decl_index); - if (gop.found_existing) { - self.freeRelocationsForTextBlock(atom); - } else { - gop.value_ptr.* = null; - } + const atom_index = try self.getOrCreateAtomForDecl(decl_index); + Atom.freeRelocations(self, atom_index); + const atom = self.getAtom(atom_index); var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); - var decl_state: ?Dwarf.DeclState = if (self.dwarf) |*dw| try dw.initDeclState(module, decl_index) else null; - defer if (decl_state) |*ds| ds.deinit(); + // var decl_state: ?Dwarf.DeclState = if (self.dwarf) |*dw| try dw.initDeclState(module, decl_index) else null; + // defer if (decl_state) |*ds| ds.deinit(); // TODO implement .debug_info for global variables const decl_val = if (decl.val.castTag(.variable)) |payload| payload.data.init else decl.val; - const res = if (decl_state) |*ds| - try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ - .ty = decl.ty, - .val = decl_val, - }, &code_buffer, .{ - .dwarf = ds, - }, .{ - .parent_atom_index = decl.link.elf.getSymbolIndex().?, - }) - else - try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ - .ty = decl.ty, - .val = decl_val, - }, &code_buffer, .none, .{ - .parent_atom_index = decl.link.elf.getSymbolIndex().?, - }); + // const res = if (decl_state) |*ds| + // try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ + // .ty = decl.ty, + // .val = decl_val, + // }, &code_buffer, .{ + // .dwarf = ds, + // }, .{ + // .parent_atom_index = atom.getSymbolIndex().?, + // }) + // else + const res = try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ + .ty = decl.ty, + .val = decl_val, + }, &code_buffer, .none, .{ + .parent_atom_index = atom.getSymbolIndex().?, + }); const code = switch (res) { .ok => code_buffer.items, @@ -2529,15 +2568,16 @@ pub fn updateDecl(self: *Elf, module: *Module, decl_index: Module.Decl.Index) !v }; const local_sym = try self.updateDeclCode(decl_index, code, elf.STT_OBJECT); - if (decl_state) |*ds| { - try self.dwarf.?.commitDeclState( - module, - decl_index, - local_sym.st_value, - local_sym.st_size, - ds, - ); - } + _ = local_sym; + // if (decl_state) |*ds| { + // try self.dwarf.?.commitDeclState( + // module, + // decl_index, + // local_sym.st_value, + // local_sym.st_size, + // ds, + // ); + // } // Since we updated the vaddr and the size, each corresponding export // symbol also needs to be updated. @@ -2545,36 +2585,31 @@ pub fn updateDecl(self: *Elf, module: *Module, decl_index: Module.Decl.Index) !v } pub fn lowerUnnamedConst(self: *Elf, typed_value: TypedValue, decl_index: Module.Decl.Index) !u32 { - var code_buffer = std.ArrayList(u8).init(self.base.allocator); + const gpa = self.base.allocator; + + var code_buffer = std.ArrayList(u8).init(gpa); defer code_buffer.deinit(); const mod = self.base.options.module.?; - const decl = mod.declPtr(decl_index); - - const gop = try self.unnamed_const_atoms.getOrPut(self.base.allocator, decl_index); + const gop = try self.unnamed_const_atoms.getOrPut(gpa, decl_index); if (!gop.found_existing) { gop.value_ptr.* = .{}; } const unnamed_consts = gop.value_ptr; - const atom = try self.base.allocator.create(TextBlock); - errdefer self.base.allocator.destroy(atom); - atom.* = TextBlock.empty; - // TODO for unnamed consts we don't need GOT offset/entry allocated - try atom.ensureInitialized(self); - try self.managed_atoms.append(self.base.allocator, atom); - + const decl = mod.declPtr(decl_index); const name_str_index = blk: { const decl_name = try decl.getFullyQualifiedName(mod); - defer self.base.allocator.free(decl_name); - + defer gpa.free(decl_name); const index = unnamed_consts.items.len; - const name = try std.fmt.allocPrint(self.base.allocator, "__unnamed_{s}_{d}", .{ decl_name, index }); - defer self.base.allocator.free(name); - - break :blk try self.makeString(name); + const name = try std.fmt.allocPrint(gpa, "__unnamed_{s}_{d}", .{ decl_name, index }); + defer gpa.free(name); + break :blk try self.shstrtab.insert(gpa, name); }; - const name = self.getString(name_str_index); + const name = self.shstrtab.get(name_str_index).?; + + const atom_index = try self.createAtom(); + const atom = self.getAtomPtr(atom_index); const res = try codegen.generateSymbol(&self.base, decl.srcLoc(), typed_value, &code_buffer, .{ .none = {}, @@ -2592,28 +2627,24 @@ pub fn lowerUnnamedConst(self: *Elf, typed_value: TypedValue, decl_index: Module }; const required_alignment = typed_value.ty.abiAlignment(self.base.options.target); - const phdr_index = self.phdr_load_ro_index.?; - const shdr_index = self.phdr_shdr_table.get(phdr_index).?; - const vaddr = try self.allocateTextBlock(atom, code.len, required_alignment, phdr_index); - errdefer self.freeTextBlock(atom, phdr_index); - - log.debug("allocated text block for {s} at 0x{x}", .{ name, vaddr }); - + const shdr_index = self.rodata_section_index.?; + const phdr_index = self.sections.items(.phdr_index)[shdr_index]; const local_sym = atom.getSymbolPtr(self); - local_sym.* = .{ - .st_name = name_str_index, - .st_info = (elf.STB_LOCAL << 4) | elf.STT_OBJECT, - .st_other = 0, - .st_shndx = shdr_index, - .st_value = vaddr, - .st_size = code.len, - }; + local_sym.st_name = name_str_index; + local_sym.st_info = (elf.STB_LOCAL << 4) | elf.STT_OBJECT; + local_sym.st_other = 0; + local_sym.st_shndx = shdr_index; + local_sym.st_size = code.len; + local_sym.st_value = try self.allocateAtom(atom_index, code.len, required_alignment); + errdefer self.freeAtom(atom_index); + + log.debug("allocated text block for {s} at 0x{x}", .{ name, local_sym.st_value }); try self.writeSymbol(atom.getSymbolIndex().?); - try unnamed_consts.append(self.base.allocator, atom); + try unnamed_consts.append(gpa, atom_index); const section_offset = local_sym.st_value - self.program_headers.items[phdr_index].p_vaddr; - const file_offset = self.sections.items[shdr_index].sh_offset + section_offset; + const file_offset = self.sections.items(.shdr)[shdr_index].sh_offset + section_offset; try self.base.file.?.pwriteAll(code, file_offset); return atom.getSymbolIndex().?; @@ -2635,20 +2666,16 @@ pub fn updateDeclExports( const tracy = trace(@src()); defer tracy.end(); + const gpa = self.base.allocator; + const decl = module.declPtr(decl_index); - const atom = &decl.link.elf; - - if (atom.getSymbolIndex() == null) return; - + const atom_index = try self.getOrCreateAtomForDecl(decl_index); + const atom = self.getAtom(atom_index); const decl_sym = atom.getSymbol(self); - try self.global_symbols.ensureUnusedCapacity(self.base.allocator, exports.len); + const decl_metadata = self.decls.getPtr(decl_index).?; + const shdr_index = decl_metadata.shdr; - const gop = try self.decls.getOrPut(self.base.allocator, decl_index); - if (!gop.found_existing) { - gop.value_ptr.* = try self.getDeclPhdrIndex(decl); - } - const phdr_index = gop.value_ptr.*.?; - const shdr_index = self.phdr_shdr_table.get(phdr_index).?; + try self.global_symbols.ensureUnusedCapacity(gpa, exports.len); for (exports) |exp| { if (exp.options.section) |section_name| { @@ -2681,10 +2708,10 @@ pub fn updateDeclExports( }, }; const stt_bits: u8 = @truncate(u4, decl_sym.st_info); - if (exp.link.elf.sym_index) |i| { + if (decl_metadata.getExport(self, exp.options.name)) |i| { const sym = &self.global_symbols.items[i]; sym.* = .{ - .st_name = try self.updateString(sym.st_name, exp.options.name), + .st_name = try self.shstrtab.insert(gpa, exp.options.name), .st_info = (stb_bits << 4) | stt_bits, .st_other = 0, .st_shndx = shdr_index, @@ -2692,21 +2719,19 @@ pub fn updateDeclExports( .st_size = decl_sym.st_size, }; } else { - const name = try self.makeString(exp.options.name); const i = if (self.global_symbol_free_list.popOrNull()) |i| i else blk: { _ = self.global_symbols.addOneAssumeCapacity(); break :blk self.global_symbols.items.len - 1; }; + try decl_metadata.exports.append(gpa, @intCast(u32, i)); self.global_symbols.items[i] = .{ - .st_name = name, + .st_name = try self.shstrtab.insert(gpa, exp.options.name), .st_info = (stb_bits << 4) | stt_bits, .st_other = 0, .st_shndx = shdr_index, .st_value = decl_sym.st_value, .st_size = decl_sym.st_size, }; - - exp.link.elf.sym_index = @intCast(u32, i); } } } @@ -2722,17 +2747,19 @@ pub fn updateDeclLineNumber(self: *Elf, mod: *Module, decl: *const Module.Decl) log.debug("updateDeclLineNumber {s}{*}", .{ decl_name, decl }); if (self.llvm_object) |_| return; - if (self.dwarf) |*dw| { - try dw.updateDeclLineNumber(decl); - } + // if (self.dwarf) |*dw| { + // try dw.updateDeclLineNumber(decl); + // } } -pub fn deleteExport(self: *Elf, exp: Export) void { +pub fn deleteDeclExport(self: *Elf, decl_index: Module.Decl.Index, name: []const u8) void { if (self.llvm_object) |_| return; - - const sym_index = exp.sym_index orelse return; - self.global_symbol_free_list.append(self.base.allocator, sym_index) catch {}; - self.global_symbols.items[sym_index].st_info = 0; + const metadata = self.decls.getPtr(decl_index) orelse return; + const sym_index = metadata.getExportPtr(self, name) orelse return; + log.debug("deleting export '{s}'", .{name}); + self.global_symbol_free_list.append(self.base.allocator, sym_index.*) catch {}; + self.global_symbols.items[sym_index.*].st_info = 0; + sym_index.* = 0; } fn writeProgHeader(self: *Elf, index: usize) !void { @@ -2761,7 +2788,7 @@ fn writeSectHeader(self: *Elf, index: usize) !void { switch (self.ptr_width) { .p32 => { var shdr: [1]elf.Elf32_Shdr = undefined; - shdr[0] = sectHeaderTo32(self.sections.items[index]); + shdr[0] = sectHeaderTo32(self.sections.items(.shdr)[index]); if (foreign_endian) { mem.byteSwapAllFields(elf.Elf32_Shdr, &shdr[0]); } @@ -2769,7 +2796,7 @@ fn writeSectHeader(self: *Elf, index: usize) !void { return self.base.file.?.pwriteAll(mem.sliceAsBytes(&shdr), offset); }, .p64 => { - var shdr = [1]elf.Elf64_Shdr{self.sections.items[index]}; + var shdr = [1]elf.Elf64_Shdr{self.sections.items(.shdr)[index]}; if (foreign_endian) { mem.byteSwapAllFields(elf.Elf64_Shdr, &shdr[0]); } @@ -2783,11 +2810,11 @@ fn writeOffsetTableEntry(self: *Elf, index: usize) !void { const entry_size: u16 = self.archPtrWidthBytes(); if (self.offset_table_count_dirty) { const needed_size = self.offset_table.items.len * entry_size; - try self.growAllocSection(self.got_section_index.?, self.phdr_got_index.?, needed_size); + try self.growAllocSection(self.got_section_index.?, needed_size); self.offset_table_count_dirty = false; } const endian = self.base.options.target.cpu.arch.endian(); - const shdr = &self.sections.items[self.got_section_index.?]; + const shdr = &self.sections.items(.shdr)[self.got_section_index.?]; const off = shdr.sh_offset + @as(u64, entry_size) * index; switch (entry_size) { 2 => { @@ -2813,7 +2840,7 @@ fn writeSymbol(self: *Elf, index: usize) !void { const tracy = trace(@src()); defer tracy.end(); - const syms_sect = &self.sections.items[self.symtab_section_index.?]; + const syms_sect = &self.sections.items(.shdr)[self.symtab_section_index.?]; // Make sure we are not pointlessly writing symbol data that will have to get relocated // due to running out of space. if (self.local_symbols.items.len != syms_sect.sh_info) { @@ -2835,7 +2862,7 @@ fn writeSymbol(self: *Elf, index: usize) !void { .p64 => syms_sect.sh_offset + @sizeOf(elf.Elf64_Sym) * index, }; const local = self.local_symbols.items[index]; - log.debug("writing symbol {d}, '{s}' at 0x{x}", .{ index, self.getString(local.st_name), off }); + log.debug("writing symbol {d}, '{?s}' at 0x{x}", .{ index, self.shstrtab.get(local.st_name), off }); log.debug(" ({})", .{local}); switch (self.ptr_width) { .p32 => { @@ -2865,7 +2892,7 @@ fn writeSymbol(self: *Elf, index: usize) !void { } fn writeAllGlobalSymbols(self: *Elf) !void { - const syms_sect = &self.sections.items[self.symtab_section_index.?]; + const syms_sect = &self.sections.items(.shdr)[self.symtab_section_index.?]; const sym_size: u64 = switch (self.ptr_width) { .p32 => @sizeOf(elf.Elf32_Sym), .p64 => @sizeOf(elf.Elf64_Sym), @@ -3215,10 +3242,52 @@ const CsuObjects = struct { fn logSymtab(self: Elf) void { log.debug("locals:", .{}); for (self.local_symbols.items) |sym, id| { - log.debug(" {d}: {s}: @{x} in {d}", .{ id, self.getString(sym.st_name), sym.st_value, sym.st_shndx }); + log.debug(" {d}: {?s}: @{x} in {d}", .{ id, self.shstrtab.get(sym.st_name), sym.st_value, sym.st_shndx }); } log.debug("globals:", .{}); for (self.global_symbols.items) |sym, id| { - log.debug(" {d}: {s}: @{x} in {d}", .{ id, self.getString(sym.st_name), sym.st_value, sym.st_shndx }); + log.debug(" {d}: {?s}: @{x} in {d}", .{ id, self.shstrtab.get(sym.st_name), sym.st_value, sym.st_shndx }); } } + +pub fn getProgramHeader(self: *const Elf, shdr_index: u16) elf.Elf64_Phdr { + const index = self.sections.items(.phdr_index)[shdr_index]; + return self.program_headers.items[index]; +} + +pub fn getProgramHeaderPtr(self: *Elf, shdr_index: u16) *elf.Elf64_Phdr { + const index = self.sections.items(.phdr_index)[shdr_index]; + return &self.program_headers.items[index]; +} + +/// Returns pointer-to-symbol described at sym_index. +pub fn getSymbolPtr(self: *Elf, sym_index: u32) *elf.Elf64_Sym { + return &self.local_symbols.items[sym_index]; +} + +/// Returns symbol at sym_index. +pub fn getSymbol(self: *const Elf, sym_index: u32) elf.Elf64_Sym { + return self.local_symbols.items[sym_index]; +} + +/// Returns name of the symbol at sym_index. +pub fn getSymbolName(self: *const Elf, sym_index: u32) []const u8 { + const sym = self.local_symbols.items[sym_index]; + return self.shstrtab.get(sym.st_name).?; +} + +pub fn getAtom(self: *const Elf, atom_index: Atom.Index) Atom { + assert(atom_index < self.atoms.items.len); + return self.atoms.items[atom_index]; +} + +pub fn getAtomPtr(self: *Elf, atom_index: Atom.Index) *Atom { + assert(atom_index < self.atoms.items.len); + return &self.atoms.items[atom_index]; +} + +/// Returns atom if there is an atom referenced by the symbol. +/// Returns null on failure. +pub fn getAtomIndexForSymbol(self: *Elf, sym_index: u32) ?Atom.Index { + return self.atom_by_index_table.get(sym_index); +} diff --git a/src/link/Elf/Atom.zig b/src/link/Elf/Atom.zig index caeb3bfbc5..79b699636f 100644 --- a/src/link/Elf/Atom.zig +++ b/src/link/Elf/Atom.zig @@ -20,44 +20,35 @@ offset_table_index: u32, /// Points to the previous and next neighbors, based on the `text_offset`. /// This can be used to find, for example, the capacity of this `TextBlock`. -prev: ?*Atom, -next: ?*Atom, +prev_index: ?Atom.Index, +next_index: ?Atom.Index, dbg_info_atom: Dwarf.Atom, -pub const empty = Atom{ - .local_sym_index = 0, - .offset_table_index = undefined, - .prev = null, - .next = null, - .dbg_info_atom = undefined, -}; +pub const Index = u32; -pub fn ensureInitialized(self: *Atom, elf_file: *Elf) !void { - if (self.getSymbolIndex() != null) return; // Already initialized - self.local_sym_index = try elf_file.allocateLocalSymbol(); - self.offset_table_index = try elf_file.allocateGotOffset(); - try elf_file.atom_by_index_table.putNoClobber(elf_file.base.allocator, self.local_sym_index, self); -} +pub const Reloc = struct { + target: u32, + offset: u64, + addend: u32, + prev_vaddr: u64, +}; pub fn getSymbolIndex(self: Atom) ?u32 { if (self.local_sym_index == 0) return null; return self.local_sym_index; } -pub fn getSymbol(self: Atom, elf_file: *Elf) elf.Elf64_Sym { - const sym_index = self.getSymbolIndex().?; - return elf_file.local_symbols.items[sym_index]; +pub fn getSymbol(self: Atom, elf_file: *const Elf) elf.Elf64_Sym { + return elf_file.getSymbol(self.getSymbolIndex().?); } pub fn getSymbolPtr(self: Atom, elf_file: *Elf) *elf.Elf64_Sym { - const sym_index = self.getSymbolIndex().?; - return &elf_file.local_symbols.items[sym_index]; + return elf_file.getSymbolPtr(self.getSymbolIndex().?); } -pub fn getName(self: Atom, elf_file: *Elf) []const u8 { - const sym = self.getSymbol(); - return elf_file.getString(sym.st_name); +pub fn getName(self: Atom, elf_file: *const Elf) []const u8 { + return elf_file.getSymbolName(self.getSymbolIndex().?); } pub fn getOffsetTableAddress(self: Atom, elf_file: *Elf) u64 { @@ -72,9 +63,10 @@ pub fn getOffsetTableAddress(self: Atom, elf_file: *Elf) u64 { /// Returns how much room there is to grow in virtual address space. /// File offset relocation happens transparently, so it is not included in /// this calculation. -pub fn capacity(self: Atom, elf_file: *Elf) u64 { +pub fn capacity(self: Atom, elf_file: *const Elf) u64 { const self_sym = self.getSymbol(elf_file); - if (self.next) |next| { + if (self.next_index) |next_index| { + const next = elf_file.getAtom(next_index); const next_sym = next.getSymbol(elf_file); return next_sym.st_value - self_sym.st_value; } else { @@ -83,9 +75,10 @@ pub fn capacity(self: Atom, elf_file: *Elf) u64 { } } -pub fn freeListEligible(self: Atom, elf_file: *Elf) bool { +pub fn freeListEligible(self: Atom, elf_file: *const Elf) bool { // No need to keep a free list node for the last block. - const next = self.next orelse return false; + const next_index = self.next_index orelse return false; + const next = elf_file.getAtom(next_index); const self_sym = self.getSymbol(elf_file); const next_sym = next.getSymbol(elf_file); const cap = next_sym.st_value - self_sym.st_value; @@ -94,3 +87,17 @@ pub fn freeListEligible(self: Atom, elf_file: *Elf) bool { const surplus = cap - ideal_cap; return surplus >= Elf.min_text_capacity; } + +pub fn addRelocation(elf_file: *Elf, atom_index: Index, reloc: Reloc) !void { + const gpa = elf_file.base.allocator; + const gop = try elf_file.relocs.getOrPut(gpa, atom_index); + if (!gop.found_existing) { + gop.value_ptr.* = .{}; + } + try gop.value_ptr.append(gpa, reloc); +} + +pub fn freeRelocations(elf_file: *Elf, atom_index: Index) void { + var removed_relocs = elf_file.relocs.fetchRemove(atom_index); + if (removed_relocs) |*relocs| relocs.value.deinit(elf_file.base.allocator); +} diff --git a/src/link/MachO.zig b/src/link/MachO.zig index 29aed25b31..11a1119449 100644 --- a/src/link/MachO.zig +++ b/src/link/MachO.zig @@ -2604,9 +2604,11 @@ pub fn freeDecl(self: *MachO, decl_index: Module.Decl.Index) void { log.debug("freeDecl {*}", .{decl}); - if (self.decls.fetchSwapRemove(decl_index)) |kv| { + if (self.decls.fetchSwapRemove(decl_index)) |const_kv| { + var kv = const_kv; self.freeAtom(kv.value.atom); self.freeUnnamedConsts(decl_index); + kv.value.exports.deinit(self.base.allocator); } // if (self.d_sym) |*d_sym| { From ef8f694d777029caaa48c50c28ff805c058ccccb Mon Sep 17 00:00:00 2001 From: leap123 Date: Wed, 1 Feb 2023 01:08:30 +0700 Subject: [PATCH 42/84] std.os.uefi: fix shift in pool allocator (again) (#14497) --- lib/std/os/uefi/pool_allocator.zig | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lib/std/os/uefi/pool_allocator.zig b/lib/std/os/uefi/pool_allocator.zig index 8e2d9fe3fc..8f26aac32c 100644 --- a/lib/std/os/uefi/pool_allocator.zig +++ b/lib/std/os/uefi/pool_allocator.zig @@ -22,7 +22,7 @@ const UefiPoolAllocator = struct { assert(len > 0); - const ptr_align = @as(usize, 1) << @as(Allocator.Log2Align, log2_ptr_align); + const ptr_align = @as(usize, 1) << @intCast(Allocator.Log2Align, log2_ptr_align); const metadata_len = mem.alignForward(@sizeOf(usize), ptr_align); From c430e9afa7b050400b9703360a0af4ab824335ce Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Tue, 31 Jan 2023 20:27:17 +0100 Subject: [PATCH 43/84] link: make Coff atoms fully owned by the linker --- src/Module.zig | 6 +- src/Sema.zig | 2 +- src/arch/aarch64/CodeGen.zig | 42 ++-- src/arch/aarch64/Emit.zig | 6 +- src/arch/x86_64/CodeGen.zig | 16 +- src/arch/x86_64/Emit.zig | 8 +- src/link.zig | 4 +- src/link/Coff.zig | 466 +++++++++++++++++++---------------- src/link/Coff/Atom.zig | 46 ++-- src/link/Coff/Relocation.zig | 18 +- src/link/Elf.zig | 10 +- src/link/MachO.zig | 5 + 12 files changed, 352 insertions(+), 277 deletions(-) diff --git a/src/Module.zig b/src/Module.zig index 0695a2e98a..b39fd2bab2 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -5274,7 +5274,7 @@ pub fn clearDecl( // TODO instead of a union, put this memory trailing Decl objects, // and allow it to be variably sized. decl.link = switch (mod.comp.bin_file.tag) { - .coff => .{ .coff = link.File.Coff.Atom.empty }, + .coff => .{ .coff = {} }, .elf => .{ .elf = {} }, .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = link.File.Plan9.DeclBlock.empty }, @@ -5390,7 +5390,7 @@ fn deleteDeclExports(mod: *Module, decl_index: Decl.Index) Allocator.Error!void wasm.deleteExport(exp.link.wasm); } if (mod.comp.bin_file.cast(link.File.Coff)) |coff| { - coff.deleteExport(exp.link.coff); + coff.deleteDeclExport(decl_index, exp.options.name); } if (mod.failed_exports.fetchSwapRemove(exp)) |failed_kv| { failed_kv.value.destroy(mod.gpa); @@ -5694,7 +5694,7 @@ pub fn allocateNewDecl( .zir_decl_index = 0, .src_scope = src_scope, .link = switch (mod.comp.bin_file.tag) { - .coff => .{ .coff = link.File.Coff.Atom.empty }, + .coff => .{ .coff = {} }, .elf => .{ .elf = {} }, .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = link.File.Plan9.DeclBlock.empty }, diff --git a/src/Sema.zig b/src/Sema.zig index 28d559f730..82321ef545 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -5565,7 +5565,7 @@ pub fn analyzeExport( }, .src = src, .link = switch (mod.comp.bin_file.tag) { - .coff => .{ .coff = .{} }, + .coff => .{ .coff = {} }, .elf => .{ .elf = {} }, .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = null }, diff --git a/src/arch/aarch64/CodeGen.zig b/src/arch/aarch64/CodeGen.zig index 67197c35f8..d0fba2fd0e 100644 --- a/src/arch/aarch64/CodeGen.zig +++ b/src/arch/aarch64/CodeGen.zig @@ -4019,15 +4019,17 @@ fn store(self: *Self, ptr: MCValue, value: MCValue, ptr_ty: Type, value_ty: Type .direct => .load_memory_ptr_direct, .import => unreachable, }; - const mod = self.bin_file.options.module.?; - const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { .macho => blk: { const macho_file = self.bin_file.cast(link.File.MachO).?; const atom = try macho_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); break :blk macho_file.getAtom(atom).getSymbolIndex().?; }, - .coff => owner_decl.link.coff.getSymbolIndex().?, + .coff => blk: { + const coff_file = self.bin_file.cast(link.File.Coff).?; + const atom = try coff_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); + break :blk coff_file.getAtom(atom).getSymbolIndex().?; + }, else => unreachable, // unsupported target format }; _ = try self.addInst(.{ @@ -4322,11 +4324,12 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier }, }); } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { - try fn_owner_decl.link.coff.ensureInitialized(coff_file); + const atom = try coff_file.getOrCreateAtomForDecl(func.owner_decl); + const sym_index = coff_file.getAtom(atom).getSymbolIndex().?; try self.genSetReg(Type.initTag(.u64), .x30, .{ .linker_load = .{ .type = .got, - .sym_index = fn_owner_decl.link.coff.getSymbolIndex().?, + .sym_index = sym_index, }, }); } else if (self.bin_file.cast(link.File.Plan9)) |p9| { @@ -5496,15 +5499,17 @@ fn genSetStack(self: *Self, ty: Type, stack_offset: u32, mcv: MCValue) InnerErro .direct => .load_memory_ptr_direct, .import => unreachable, }; - const mod = self.bin_file.options.module.?; - const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { .macho => blk: { const macho_file = self.bin_file.cast(link.File.MachO).?; const atom = try macho_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); break :blk macho_file.getAtom(atom).getSymbolIndex().?; }, - .coff => owner_decl.link.coff.getSymbolIndex().?, + .coff => blk: { + const coff_file = self.bin_file.cast(link.File.Coff).?; + const atom = try coff_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); + break :blk coff_file.getAtom(atom).getSymbolIndex().?; + }, else => unreachable, // unsupported target format }; _ = try self.addInst(.{ @@ -5614,15 +5619,17 @@ fn genSetReg(self: *Self, ty: Type, reg: Register, mcv: MCValue) InnerError!void .direct => .load_memory_direct, .import => .load_memory_import, }; - const mod = self.bin_file.options.module.?; - const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { .macho => blk: { const macho_file = self.bin_file.cast(link.File.MachO).?; const atom = try macho_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); break :blk macho_file.getAtom(atom).getSymbolIndex().?; }, - .coff => owner_decl.link.coff.getSymbolIndex().?, + .coff => blk: { + const coff_file = self.bin_file.cast(link.File.Coff).?; + const atom = try coff_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); + break :blk coff_file.getAtom(atom).getSymbolIndex().?; + }, else => unreachable, // unsupported target format }; _ = try self.addInst(.{ @@ -5812,15 +5819,17 @@ fn genSetStackArgument(self: *Self, ty: Type, stack_offset: u32, mcv: MCValue) I .direct => .load_memory_ptr_direct, .import => unreachable, }; - const mod = self.bin_file.options.module.?; - const owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = switch (self.bin_file.tag) { .macho => blk: { const macho_file = self.bin_file.cast(link.File.MachO).?; const atom = try macho_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); break :blk macho_file.getAtom(atom).getSymbolIndex().?; }, - .coff => owner_decl.link.coff.getSymbolIndex().?, + .coff => blk: { + const coff_file = self.bin_file.cast(link.File.Coff).?; + const atom = try coff_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); + break :blk coff_file.getAtom(atom).getSymbolIndex().?; + }, else => unreachable, // unsupported target format }; _ = try self.addInst(.{ @@ -6150,10 +6159,11 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne .sym_index = sym_index, } }; } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { - try decl.link.coff.ensureInitialized(coff_file); + const atom_index = try coff_file.getOrCreateAtomForDecl(decl_index); + const sym_index = coff_file.getAtom(atom_index).getSymbolIndex().?; return MCValue{ .linker_load = .{ .type = .got, - .sym_index = decl.link.coff.getSymbolIndex().?, + .sym_index = sym_index, } }; } else if (self.bin_file.cast(link.File.Plan9)) |p9| { try p9.seeDecl(decl_index); diff --git a/src/arch/aarch64/Emit.zig b/src/arch/aarch64/Emit.zig index f348fb70e3..3c2a81d5d1 100644 --- a/src/arch/aarch64/Emit.zig +++ b/src/arch/aarch64/Emit.zig @@ -919,7 +919,7 @@ fn mirLoadMemoryPie(emit: *Emit, inst: Mir.Inst.Index) !void { }, }); } else if (emit.bin_file.cast(link.File.Coff)) |coff_file| { - const atom = coff_file.getAtomForSymbol(.{ .sym_index = data.atom_index, .file = null }).?; + const atom_index = coff_file.getAtomIndexForSymbol(.{ .sym_index = data.atom_index, .file = null }).?; const target = switch (tag) { .load_memory_got, .load_memory_ptr_got, @@ -929,7 +929,7 @@ fn mirLoadMemoryPie(emit: *Emit, inst: Mir.Inst.Index) !void { .load_memory_import => coff_file.getGlobalByIndex(data.sym_index), else => unreachable, }; - try atom.addRelocation(coff_file, .{ + try link.File.Coff.Atom.addRelocation(coff_file, atom_index, .{ .target = target, .offset = offset, .addend = 0, @@ -946,7 +946,7 @@ fn mirLoadMemoryPie(emit: *Emit, inst: Mir.Inst.Index) !void { else => unreachable, }, }); - try atom.addRelocation(coff_file, .{ + try link.File.Coff.Atom.addRelocation(coff_file, atom_index, .{ .target = target, .offset = offset + 4, .addend = 0, diff --git a/src/arch/x86_64/CodeGen.zig b/src/arch/x86_64/CodeGen.zig index 23d3ca5514..b41973ea97 100644 --- a/src/arch/x86_64/CodeGen.zig +++ b/src/arch/x86_64/CodeGen.zig @@ -2668,13 +2668,12 @@ fn loadMemPtrIntoRegister(self: *Self, reg: Register, ptr_ty: Type, ptr: MCValue switch (ptr) { .linker_load => |load_struct| { const abi_size = @intCast(u32, ptr_ty.abiSize(self.target.*)); - const mod = self.bin_file.options.module.?; - const fn_owner_decl = mod.declPtr(self.mod_fn.owner_decl); const atom_index = if (self.bin_file.cast(link.File.MachO)) |macho_file| blk: { const atom = try macho_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); break :blk macho_file.getAtom(atom).getSymbolIndex().?; - } else if (self.bin_file.cast(link.File.Coff)) |_| blk: { - break :blk fn_owner_decl.link.coff.getSymbolIndex().?; + } else if (self.bin_file.cast(link.File.Coff)) |coff_file| blk: { + const atom = try coff_file.getOrCreateAtomForDecl(self.mod_fn.owner_decl); + break :blk coff_file.getAtom(atom).getSymbolIndex().?; } else unreachable; const flags: u2 = switch (load_struct.type) { .got => 0b00, @@ -4009,8 +4008,8 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier .data = .{ .imm = got_addr }, }); } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { - try fn_owner_decl.link.coff.ensureInitialized(coff_file); - const sym_index = fn_owner_decl.link.coff.getSymbolIndex().?; + const atom_index = try coff_file.getOrCreateAtomForDecl(func.owner_decl); + const sym_index = coff_file.getAtom(atom_index).getSymbolIndex().?; try self.genSetReg(Type.initTag(.usize), .rax, .{ .linker_load = .{ .type = .got, @@ -6733,10 +6732,11 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne .sym_index = sym_index, } }; } else if (self.bin_file.cast(link.File.Coff)) |coff_file| { - try decl.link.coff.ensureInitialized(coff_file); + const atom_index = try coff_file.getOrCreateAtomForDecl(decl_index); + const sym_index = coff_file.getAtom(atom_index).getSymbolIndex().?; return MCValue{ .linker_load = .{ .type = .got, - .sym_index = decl.link.coff.getSymbolIndex().?, + .sym_index = sym_index, } }; } else if (self.bin_file.cast(link.File.Plan9)) |p9| { try p9.seeDecl(decl_index); diff --git a/src/arch/x86_64/Emit.zig b/src/arch/x86_64/Emit.zig index 980dbfd41e..c4f9b4eb42 100644 --- a/src/arch/x86_64/Emit.zig +++ b/src/arch/x86_64/Emit.zig @@ -1011,8 +1011,8 @@ fn mirLeaPic(emit: *Emit, inst: Mir.Inst.Index) InnerError!void { .length = 2, }); } else if (emit.bin_file.cast(link.File.Coff)) |coff_file| { - const atom = coff_file.getAtomForSymbol(.{ .sym_index = relocation.atom_index, .file = null }).?; - try atom.addRelocation(coff_file, .{ + const atom_index = coff_file.getAtomIndexForSymbol(.{ .sym_index = relocation.atom_index, .file = null }).?; + try link.File.Coff.Atom.addRelocation(coff_file, atom_index, .{ .type = switch (ops.flags) { 0b00 => .got, 0b01 => .direct, @@ -1152,9 +1152,9 @@ fn mirCallExtern(emit: *Emit, inst: Mir.Inst.Index) InnerError!void { }); } else if (emit.bin_file.cast(link.File.Coff)) |coff_file| { // Add relocation to the decl. - const atom = coff_file.getAtomForSymbol(.{ .sym_index = relocation.atom_index, .file = null }).?; + const atom_index = coff_file.getAtomIndexForSymbol(.{ .sym_index = relocation.atom_index, .file = null }).?; const target = coff_file.getGlobalByIndex(relocation.sym_index); - try atom.addRelocation(coff_file, .{ + try link.File.Coff.Atom.addRelocation(coff_file, atom_index, .{ .type = .direct, .target = target, .offset = offset, diff --git a/src/link.zig b/src/link.zig index 09804add53..eb74615492 100644 --- a/src/link.zig +++ b/src/link.zig @@ -263,7 +263,7 @@ pub const File = struct { pub const LinkBlock = union { elf: void, - coff: Coff.Atom, + coff: void, macho: void, plan9: Plan9.DeclBlock, c: void, @@ -285,7 +285,7 @@ pub const File = struct { pub const Export = union { elf: void, - coff: Coff.Export, + coff: void, macho: void, plan9: Plan9.Export, c: void, diff --git a/src/link/Coff.zig b/src/link/Coff.zig index dee3c7c381..c062276b73 100644 --- a/src/link/Coff.zig +++ b/src/link/Coff.zig @@ -79,13 +79,13 @@ entry_addr: ?u32 = null, /// We store them here so that we can properly dispose of any allocated /// memory within the atom in the incremental linker. /// TODO consolidate this. -decls: std.AutoHashMapUnmanaged(Module.Decl.Index, ?u16) = .{}, +decls: std.AutoHashMapUnmanaged(Module.Decl.Index, DeclMetadata) = .{}, /// List of atoms that are either synthetic or map directly to the Zig source program. -managed_atoms: std.ArrayListUnmanaged(*Atom) = .{}, +atoms: std.ArrayListUnmanaged(Atom) = .{}, /// Table of atoms indexed by the symbol index. -atom_by_index_table: std.AutoHashMapUnmanaged(u32, *Atom) = .{}, +atom_by_index_table: std.AutoHashMapUnmanaged(u32, Atom.Index) = .{}, /// Table of unnamed constants associated with a parent `Decl`. /// We store them here so that we can free the constants whenever the `Decl` @@ -124,9 +124,9 @@ const Entry = struct { sym_index: u32, }; -const RelocTable = std.AutoHashMapUnmanaged(*Atom, std.ArrayListUnmanaged(Relocation)); -const BaseRelocationTable = std.AutoHashMapUnmanaged(*Atom, std.ArrayListUnmanaged(u32)); -const UnnamedConstTable = std.AutoHashMapUnmanaged(Module.Decl.Index, std.ArrayListUnmanaged(*Atom)); +const RelocTable = std.AutoHashMapUnmanaged(Atom.Index, std.ArrayListUnmanaged(Relocation)); +const BaseRelocationTable = std.AutoHashMapUnmanaged(Atom.Index, std.ArrayListUnmanaged(u32)); +const UnnamedConstTable = std.AutoHashMapUnmanaged(Module.Decl.Index, std.ArrayListUnmanaged(Atom.Index)); const default_file_alignment: u16 = 0x200; const default_size_of_stack_reserve: u32 = 0x1000000; @@ -137,7 +137,7 @@ const default_size_of_heap_commit: u32 = 0x1000; const Section = struct { header: coff.SectionHeader, - last_atom: ?*Atom = null, + last_atom_index: ?Atom.Index = null, /// A list of atoms that have surplus capacity. This list can have false /// positives, as functions grow and shrink over time, only sometimes being added @@ -154,7 +154,34 @@ const Section = struct { /// overcapacity can be negative. A simple way to have negative overcapacity is to /// allocate a fresh atom, which will have ideal capacity, and then grow it /// by 1 byte. It will then have -1 overcapacity. - free_list: std.ArrayListUnmanaged(*Atom) = .{}, + free_list: std.ArrayListUnmanaged(Atom.Index) = .{}, +}; + +const DeclMetadata = struct { + atom: Atom.Index, + section: u16, + /// A list of all exports aliases of this Decl. + exports: std.ArrayListUnmanaged(u32) = .{}, + + fn getExport(m: DeclMetadata, coff_file: *const Coff, name: []const u8) ?u32 { + for (m.exports.items) |exp| { + if (mem.eql(u8, name, coff_file.getSymbolName(.{ + .sym_index = exp, + .file = null, + }))) return exp; + } + return null; + } + + fn getExportPtr(m: *DeclMetadata, coff_file: *Coff, name: []const u8) ?*u32 { + for (m.exports.items) |*exp| { + if (mem.eql(u8, name, coff_file.getSymbolName(.{ + .sym_index = exp.*, + .file = null, + }))) return exp; + } + return null; + } }; pub const PtrWidth = enum { @@ -170,10 +197,6 @@ pub const PtrWidth = enum { }; pub const SrcFn = void; -pub const Export = struct { - sym_index: ?u32 = null, -}; - pub const SymbolWithLoc = struct { // Index into the respective symbol table. sym_index: u32, @@ -271,11 +294,7 @@ pub fn deinit(self: *Coff) void { } self.sections.deinit(gpa); - for (self.managed_atoms.items) |atom| { - gpa.destroy(atom); - } - self.managed_atoms.deinit(gpa); - + self.atoms.deinit(gpa); self.locals.deinit(gpa); self.globals.deinit(gpa); @@ -297,7 +316,15 @@ pub fn deinit(self: *Coff) void { self.imports.deinit(gpa); self.imports_free_list.deinit(gpa); self.imports_table.deinit(gpa); - self.decls.deinit(gpa); + + { + var it = self.decls.iterator(); + while (it.next()) |entry| { + entry.value_ptr.exports.deinit(gpa); + } + self.decls.deinit(gpa); + } + self.atom_by_index_table.deinit(gpa); { @@ -461,17 +488,18 @@ fn growSectionVM(self: *Coff, sect_id: u32, needed_size: u32) !void { // TODO: enforce order by increasing VM addresses in self.sections container. // This is required by the loader anyhow as far as I can tell. for (self.sections.items(.header)[sect_id + 1 ..]) |*next_header, next_sect_id| { - const maybe_last_atom = &self.sections.items(.last_atom)[sect_id + 1 + next_sect_id]; + const maybe_last_atom_index = self.sections.items(.last_atom_index)[sect_id + 1 + next_sect_id]; next_header.virtual_address += diff; - if (maybe_last_atom.*) |last_atom| { - var atom = last_atom; + if (maybe_last_atom_index) |last_atom_index| { + var atom_index = last_atom_index; while (true) { + const atom = self.getAtom(atom_index); const sym = atom.getSymbolPtr(self); sym.value += diff; - if (atom.prev) |prev| { - atom = prev; + if (atom.prev_index) |prev_index| { + atom_index = prev_index; } else break; } } @@ -480,14 +508,15 @@ fn growSectionVM(self: *Coff, sect_id: u32, needed_size: u32) !void { header.virtual_size = increased_size; } -fn allocateAtom(self: *Coff, atom: *Atom, new_atom_size: u32, alignment: u32) !u32 { +fn allocateAtom(self: *Coff, atom_index: Atom.Index, new_atom_size: u32, alignment: u32) !u32 { const tracy = trace(@src()); defer tracy.end(); + const atom = self.getAtom(atom_index); const sect_id = @enumToInt(atom.getSymbol(self).section_number) - 1; const header = &self.sections.items(.header)[sect_id]; const free_list = &self.sections.items(.free_list)[sect_id]; - const maybe_last_atom = &self.sections.items(.last_atom)[sect_id]; + const maybe_last_atom_index = &self.sections.items(.last_atom_index)[sect_id]; const new_atom_ideal_capacity = if (header.isCode()) padToIdeal(new_atom_size) else new_atom_size; // We use these to indicate our intention to update metadata, placing the new atom, @@ -495,7 +524,7 @@ fn allocateAtom(self: *Coff, atom: *Atom, new_atom_size: u32, alignment: u32) !u // It would be simpler to do it inside the for loop below, but that would cause a // problem if an error was returned later in the function. So this action // is actually carried out at the end of the function, when errors are no longer possible. - var atom_placement: ?*Atom = null; + var atom_placement: ?Atom.Index = null; var free_list_removal: ?usize = null; // First we look for an appropriately sized free list node. @@ -503,7 +532,8 @@ fn allocateAtom(self: *Coff, atom: *Atom, new_atom_size: u32, alignment: u32) !u var vaddr = blk: { var i: usize = 0; while (i < free_list.items.len) { - const big_atom = free_list.items[i]; + const big_atom_index = free_list.items[i]; + const big_atom = self.getAtom(big_atom_index); // We now have a pointer to a live atom that has too much capacity. // Is it enough that we could fit this new atom? const sym = big_atom.getSymbol(self); @@ -531,34 +561,43 @@ fn allocateAtom(self: *Coff, atom: *Atom, new_atom_size: u32, alignment: u32) !u const keep_free_list_node = remaining_capacity >= min_text_capacity; // Set up the metadata to be updated, after errors are no longer possible. - atom_placement = big_atom; + atom_placement = big_atom_index; if (!keep_free_list_node) { free_list_removal = i; } break :blk new_start_vaddr; - } else if (maybe_last_atom.*) |last| { + } else if (maybe_last_atom_index.*) |last_index| { + const last = self.getAtom(last_index); const last_symbol = last.getSymbol(self); const ideal_capacity = if (header.isCode()) padToIdeal(last.size) else last.size; const ideal_capacity_end_vaddr = last_symbol.value + ideal_capacity; const new_start_vaddr = mem.alignForwardGeneric(u32, ideal_capacity_end_vaddr, alignment); - atom_placement = last; + atom_placement = last_index; break :blk new_start_vaddr; } else { break :blk mem.alignForwardGeneric(u32, header.virtual_address, alignment); } }; - const expand_section = atom_placement == null or atom_placement.?.next == null; + const expand_section = if (atom_placement) |placement_index| + self.getAtom(placement_index).next_index == null + else + true; if (expand_section) { const sect_capacity = self.allocatedSize(header.pointer_to_raw_data); const needed_size: u32 = (vaddr + new_atom_size) - header.virtual_address; if (needed_size > sect_capacity) { const new_offset = self.findFreeSpace(needed_size, default_file_alignment); - const current_size = if (maybe_last_atom.*) |last_atom| blk: { + const current_size = if (maybe_last_atom_index.*) |last_atom_index| blk: { + const last_atom = self.getAtom(last_atom_index); const sym = last_atom.getSymbol(self); break :blk (sym.value + last_atom.size) - header.virtual_address; } else 0; - log.debug("moving {s} from 0x{x} to 0x{x}", .{ self.getSectionName(header), header.pointer_to_raw_data, new_offset }); + log.debug("moving {s} from 0x{x} to 0x{x}", .{ + self.getSectionName(header), + header.pointer_to_raw_data, + new_offset, + }); const amt = try self.base.file.?.copyRangeAll( header.pointer_to_raw_data, self.base.file.?, @@ -577,26 +616,34 @@ fn allocateAtom(self: *Coff, atom: *Atom, new_atom_size: u32, alignment: u32) !u header.virtual_size = @max(header.virtual_size, needed_size); header.size_of_raw_data = needed_size; - maybe_last_atom.* = atom; + maybe_last_atom_index.* = atom_index; } - atom.size = new_atom_size; - atom.alignment = alignment; - - if (atom.prev) |prev| { - prev.next = atom.next; - } - if (atom.next) |next| { - next.prev = atom.prev; + { + const atom_ptr = self.getAtomPtr(atom_index); + atom_ptr.size = new_atom_size; + atom_ptr.alignment = alignment; } - if (atom_placement) |big_atom| { - atom.prev = big_atom; - atom.next = big_atom.next; - big_atom.next = atom; + if (atom.prev_index) |prev_index| { + const prev = self.getAtomPtr(prev_index); + prev.next_index = atom.next_index; + } + if (atom.next_index) |next_index| { + const next = self.getAtomPtr(next_index); + next.prev_index = atom.prev_index; + } + + if (atom_placement) |big_atom_index| { + const big_atom = self.getAtomPtr(big_atom_index); + const atom_ptr = self.getAtomPtr(atom_index); + atom_ptr.prev_index = big_atom_index; + atom_ptr.next_index = big_atom.next_index; + big_atom.next_index = atom_index; } else { - atom.prev = null; - atom.next = null; + const atom_ptr = self.getAtomPtr(atom_index); + atom_ptr.prev_index = null; + atom_ptr.next_index = null; } if (free_list_removal) |i| { _ = free_list.swapRemove(i); @@ -701,24 +748,37 @@ pub fn allocateImportEntry(self: *Coff, target: SymbolWithLoc) !u32 { return index; } -fn createGotAtom(self: *Coff, target: SymbolWithLoc) !*Atom { +pub fn createAtom(self: *Coff) !Atom.Index { const gpa = self.base.allocator; - const atom = try gpa.create(Atom); - errdefer gpa.destroy(atom); - atom.* = Atom.empty; - try atom.ensureInitialized(self); + const atom_index = @intCast(Atom.Index, self.atoms.items.len); + const atom = try self.atoms.addOne(gpa); + const sym_index = try self.allocateSymbol(); + try self.atom_by_index_table.putNoClobber(gpa, sym_index, atom_index); + atom.* = .{ + .sym_index = sym_index, + .file = null, + .size = 0, + .alignment = 0, + .prev_index = null, + .next_index = null, + }; + log.debug("creating ATOM(%{d}) at index {d}", .{ sym_index, atom_index }); + return atom_index; +} + +fn createGotAtom(self: *Coff, target: SymbolWithLoc) !Atom.Index { + const atom_index = try self.createAtom(); + const atom = self.getAtomPtr(atom_index); atom.size = @sizeOf(u64); atom.alignment = @alignOf(u64); - try self.managed_atoms.append(gpa, atom); - const sym = atom.getSymbolPtr(self); sym.section_number = @intToEnum(coff.SectionNumber, self.got_section_index.? + 1); - sym.value = try self.allocateAtom(atom, atom.size, atom.alignment); + sym.value = try self.allocateAtom(atom_index, atom.size, atom.alignment); log.debug("allocated GOT atom at 0x{x}", .{sym.value}); - try atom.addRelocation(self, .{ + try Atom.addRelocation(self, atom_index, .{ .type = .direct, .target = target, .offset = 0, @@ -732,49 +792,46 @@ fn createGotAtom(self: *Coff, target: SymbolWithLoc) !*Atom { .UNDEFINED => @panic("TODO generate a binding for undefined GOT target"), .ABSOLUTE => {}, .DEBUG => unreachable, // not possible - else => try atom.addBaseRelocation(self, 0), + else => try Atom.addBaseRelocation(self, atom_index, 0), } - return atom; + return atom_index; } -fn createImportAtom(self: *Coff) !*Atom { - const gpa = self.base.allocator; - const atom = try gpa.create(Atom); - errdefer gpa.destroy(atom); - atom.* = Atom.empty; - try atom.ensureInitialized(self); +fn createImportAtom(self: *Coff) !Atom.Index { + const atom_index = try self.createAtom(); + const atom = self.getAtomPtr(atom_index); atom.size = @sizeOf(u64); atom.alignment = @alignOf(u64); - try self.managed_atoms.append(gpa, atom); - const sym = atom.getSymbolPtr(self); sym.section_number = @intToEnum(coff.SectionNumber, self.idata_section_index.? + 1); - sym.value = try self.allocateAtom(atom, atom.size, atom.alignment); + sym.value = try self.allocateAtom(atom_index, atom.size, atom.alignment); log.debug("allocated import atom at 0x{x}", .{sym.value}); - return atom; + return atom_index; } -fn growAtom(self: *Coff, atom: *Atom, new_atom_size: u32, alignment: u32) !u32 { +fn growAtom(self: *Coff, atom_index: Atom.Index, new_atom_size: u32, alignment: u32) !u32 { + const atom = self.getAtom(atom_index); const sym = atom.getSymbol(self); const align_ok = mem.alignBackwardGeneric(u32, sym.value, alignment) == sym.value; const need_realloc = !align_ok or new_atom_size > atom.capacity(self); if (!need_realloc) return sym.value; - return self.allocateAtom(atom, new_atom_size, alignment); + return self.allocateAtom(atom_index, new_atom_size, alignment); } -fn shrinkAtom(self: *Coff, atom: *Atom, new_block_size: u32) void { +fn shrinkAtom(self: *Coff, atom_index: Atom.Index, new_block_size: u32) void { _ = self; - _ = atom; + _ = atom_index; _ = new_block_size; // TODO check the new capacity, and if it crosses the size threshold into a big enough // capacity, insert a free list node for it. } -fn writeAtom(self: *Coff, atom: *Atom, code: []const u8) !void { +fn writeAtom(self: *Coff, atom_index: Atom.Index, code: []const u8) !void { + const atom = self.getAtom(atom_index); const sym = atom.getSymbol(self); const section = self.sections.get(@enumToInt(sym.section_number) - 1); const file_offset = section.header.pointer_to_raw_data + sym.value - section.header.virtual_address; @@ -784,18 +841,18 @@ fn writeAtom(self: *Coff, atom: *Atom, code: []const u8) !void { file_offset + code.len, }); try self.base.file.?.pwriteAll(code, file_offset); - try self.resolveRelocs(atom); + try self.resolveRelocs(atom_index); } -fn writePtrWidthAtom(self: *Coff, atom: *Atom) !void { +fn writePtrWidthAtom(self: *Coff, atom_index: Atom.Index) !void { switch (self.ptr_width) { .p32 => { var buffer: [@sizeOf(u32)]u8 = [_]u8{0} ** @sizeOf(u32); - try self.writeAtom(atom, &buffer); + try self.writeAtom(atom_index, &buffer); }, .p64 => { var buffer: [@sizeOf(u64)]u8 = [_]u8{0} ** @sizeOf(u64); - try self.writeAtom(atom, &buffer); + try self.writeAtom(atom_index, &buffer); }, } } @@ -815,7 +872,8 @@ fn markRelocsDirtyByAddress(self: *Coff, addr: u32) void { var it = self.relocs.valueIterator(); while (it.next()) |relocs| { for (relocs.items) |*reloc| { - const target_atom = reloc.getTargetAtom(self) orelse continue; + const target_atom_index = reloc.getTargetAtomIndex(self) orelse continue; + const target_atom = self.getAtom(target_atom_index); const target_sym = target_atom.getSymbol(self); if (target_sym.value < addr) continue; reloc.dirty = true; @@ -823,24 +881,26 @@ fn markRelocsDirtyByAddress(self: *Coff, addr: u32) void { } } -fn resolveRelocs(self: *Coff, atom: *Atom) !void { - const relocs = self.relocs.get(atom) orelse return; +fn resolveRelocs(self: *Coff, atom_index: Atom.Index) !void { + const relocs = self.relocs.get(atom_index) orelse return; - log.debug("relocating '{s}'", .{atom.getName(self)}); + log.debug("relocating '{s}'", .{self.getAtom(atom_index).getName(self)}); for (relocs.items) |*reloc| { if (!reloc.dirty) continue; - try reloc.resolve(atom, self); + try reloc.resolve(atom_index, self); } } -fn freeAtom(self: *Coff, atom: *Atom) void { - log.debug("freeAtom {*}", .{atom}); - - // Remove any relocs and base relocs associated with this Atom - self.freeRelocationsForAtom(atom); +fn freeAtom(self: *Coff, atom_index: Atom.Index) void { + log.debug("freeAtom {d}", .{atom_index}); const gpa = self.base.allocator; + + // Remove any relocs and base relocs associated with this Atom + Atom.freeRelocations(self, atom_index); + + const atom = self.getAtom(atom_index); const sym = atom.getSymbol(self); const sect_id = @enumToInt(sym.section_number) - 1; const free_list = &self.sections.items(.free_list)[sect_id]; @@ -849,45 +909,46 @@ fn freeAtom(self: *Coff, atom: *Atom) void { var i: usize = 0; // TODO turn free_list into a hash map while (i < free_list.items.len) { - if (free_list.items[i] == atom) { + if (free_list.items[i] == atom_index) { _ = free_list.swapRemove(i); continue; } - if (free_list.items[i] == atom.prev) { + if (free_list.items[i] == atom.prev_index) { already_have_free_list_node = true; } i += 1; } } - const maybe_last_atom = &self.sections.items(.last_atom)[sect_id]; - if (maybe_last_atom.*) |last_atom| { - if (last_atom == atom) { - if (atom.prev) |prev| { + const maybe_last_atom_index = &self.sections.items(.last_atom_index)[sect_id]; + if (maybe_last_atom_index.*) |last_atom_index| { + if (last_atom_index == atom_index) { + if (atom.prev_index) |prev_index| { // TODO shrink the section size here - maybe_last_atom.* = prev; + maybe_last_atom_index.* = prev_index; } else { - maybe_last_atom.* = null; + maybe_last_atom_index.* = null; } } } - if (atom.prev) |prev| { - prev.next = atom.next; + if (atom.prev_index) |prev_index| { + const prev = self.getAtomPtr(prev_index); + prev.next_index = atom.next_index; - if (!already_have_free_list_node and prev.freeListEligible(self)) { + if (!already_have_free_list_node and prev.*.freeListEligible(self)) { // The free list is heuristics, it doesn't have to be perfect, so we can // ignore the OOM here. - free_list.append(gpa, prev) catch {}; + free_list.append(gpa, prev_index) catch {}; } } else { - atom.prev = null; + self.getAtomPtr(atom_index).prev_index = null; } - if (atom.next) |next| { - next.prev = atom.prev; + if (atom.next_index) |next_index| { + self.getAtomPtr(next_index).prev_index = atom.prev_index; } else { - atom.next = null; + self.getAtomPtr(atom_index).next_index = null; } // Appending to free lists is allowed to fail because the free lists are heuristics based anyway. @@ -910,7 +971,7 @@ fn freeAtom(self: *Coff, atom: *Atom) void { self.locals.items[sym_index].section_number = .UNDEFINED; _ = self.atom_by_index_table.remove(sym_index); log.debug(" adding local symbol index {d} to free list", .{sym_index}); - atom.sym_index = 0; + self.getAtomPtr(atom_index).sym_index = 0; } pub fn updateFunc(self: *Coff, module: *Module, func: *Module.Fn, air: Air, liveness: Liveness) !void { @@ -927,15 +988,10 @@ pub fn updateFunc(self: *Coff, module: *Module, func: *Module.Fn, air: Air, live const decl_index = func.owner_decl; const decl = module.declPtr(decl_index); - const atom = &decl.link.coff; - try atom.ensureInitialized(self); - const gop = try self.decls.getOrPut(self.base.allocator, decl_index); - if (gop.found_existing) { - self.freeUnnamedConsts(decl_index); - self.freeRelocationsForAtom(&decl.link.coff); - } else { - gop.value_ptr.* = null; - } + + const atom_index = try self.getOrCreateAtomForDecl(decl_index); + self.freeUnnamedConsts(decl_index); + Atom.freeRelocations(self, atom_index); var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); @@ -979,11 +1035,8 @@ pub fn lowerUnnamedConst(self: *Coff, tv: TypedValue, decl_index: Module.Decl.In } const unnamed_consts = gop.value_ptr; - const atom = try gpa.create(Atom); - errdefer gpa.destroy(atom); - atom.* = Atom.empty; - try atom.ensureInitialized(self); - try self.managed_atoms.append(gpa, atom); + const atom_index = try self.createAtom(); + const atom = self.getAtomPtr(atom_index); const sym_name = blk: { const decl_name = try decl.getFullyQualifiedName(mod); @@ -1012,15 +1065,15 @@ pub fn lowerUnnamedConst(self: *Coff, tv: TypedValue, decl_index: Module.Decl.In const required_alignment = tv.ty.abiAlignment(self.base.options.target); atom.alignment = required_alignment; atom.size = @intCast(u32, code.len); - atom.getSymbolPtr(self).value = try self.allocateAtom(atom, atom.size, atom.alignment); - errdefer self.freeAtom(atom); + atom.getSymbolPtr(self).value = try self.allocateAtom(atom_index, atom.size, atom.alignment); + errdefer self.freeAtom(atom_index); - try unnamed_consts.append(gpa, atom); + try unnamed_consts.append(gpa, atom_index); log.debug("allocated atom for {s} at 0x{x}", .{ sym_name, atom.getSymbol(self).value }); log.debug(" (required alignment 0x{x})", .{required_alignment}); - try self.writeAtom(atom, code); + try self.writeAtom(atom_index, code); return atom.getSymbolIndex().?; } @@ -1047,14 +1100,9 @@ pub fn updateDecl(self: *Coff, module: *Module, decl_index: Module.Decl.Index) ! } } - const atom = &decl.link.coff; - try atom.ensureInitialized(self); - const gop = try self.decls.getOrPut(self.base.allocator, decl_index); - if (gop.found_existing) { - self.freeRelocationsForAtom(atom); - } else { - gop.value_ptr.* = null; - } + const atom_index = try self.getOrCreateAtomForDecl(decl_index); + Atom.freeRelocations(self, atom_index); + const atom = self.getAtom(atom_index); var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); @@ -1064,7 +1112,7 @@ pub fn updateDecl(self: *Coff, module: *Module, decl_index: Module.Decl.Index) ! .ty = decl.ty, .val = decl_val, }, &code_buffer, .none, .{ - .parent_atom_index = decl.link.coff.getSymbolIndex().?, + .parent_atom_index = atom.getSymbolIndex().?, }); const code = switch (res) { .ok => code_buffer.items, @@ -1082,7 +1130,20 @@ pub fn updateDecl(self: *Coff, module: *Module, decl_index: Module.Decl.Index) ! return self.updateDeclExports(module, decl_index, module.getDeclExports(decl_index)); } -fn getDeclOutputSection(self: *Coff, decl: *Module.Decl) u16 { +pub fn getOrCreateAtomForDecl(self: *Coff, decl_index: Module.Decl.Index) !Atom.Index { + const gop = try self.decls.getOrPut(self.base.allocator, decl_index); + if (!gop.found_existing) { + gop.value_ptr.* = .{ + .atom = try self.createAtom(), + .section = self.getDeclOutputSection(decl_index), + .exports = .{}, + }; + } + return gop.value_ptr.atom; +} + +fn getDeclOutputSection(self: *Coff, decl_index: Module.Decl.Index) u16 { + const decl = self.base.options.module.?.declPtr(decl_index); const ty = decl.ty; const zig_ty = ty.zigTypeTag(); const val = decl.val; @@ -1117,14 +1178,11 @@ fn updateDeclCode(self: *Coff, decl_index: Module.Decl.Index, code: []const u8, log.debug("updateDeclCode {s}{*}", .{ decl_name, decl }); const required_alignment = decl.getAlignment(self.base.options.target); - const decl_ptr = self.decls.getPtr(decl_index).?; - if (decl_ptr.* == null) { - decl_ptr.* = self.getDeclOutputSection(decl); - } - const sect_index = decl_ptr.*.?; - + const decl_metadata = self.decls.get(decl_index).?; + const atom_index = decl_metadata.atom; + const atom = self.getAtom(atom_index); + const sect_index = decl_metadata.section; const code_len = @intCast(u32, code.len); - const atom = &decl.link.coff; if (atom.size != 0) { const sym = atom.getSymbolPtr(self); @@ -1135,7 +1193,7 @@ fn updateDeclCode(self: *Coff, decl_index: Module.Decl.Index, code: []const u8, const capacity = atom.capacity(self); const need_realloc = code.len > capacity or !mem.isAlignedGeneric(u64, sym.value, required_alignment); if (need_realloc) { - const vaddr = try self.growAtom(atom, code_len, required_alignment); + const vaddr = try self.growAtom(atom_index, code_len, required_alignment); log.debug("growing {s} from 0x{x} to 0x{x}", .{ decl_name, sym.value, vaddr }); log.debug(" (required alignment 0x{x}", .{required_alignment}); @@ -1143,49 +1201,43 @@ fn updateDeclCode(self: *Coff, decl_index: Module.Decl.Index, code: []const u8, sym.value = vaddr; log.debug(" (updating GOT entry)", .{}); const got_target = SymbolWithLoc{ .sym_index = atom.getSymbolIndex().?, .file = null }; - const got_atom = self.getGotAtomForSymbol(got_target).?; + const got_atom_index = self.getGotAtomIndexForSymbol(got_target).?; self.markRelocsDirtyByTarget(got_target); - try self.writePtrWidthAtom(got_atom); + try self.writePtrWidthAtom(got_atom_index); } } else if (code_len < atom.size) { - self.shrinkAtom(atom, code_len); + self.shrinkAtom(atom_index, code_len); } - atom.size = code_len; + self.getAtomPtr(atom_index).size = code_len; } else { const sym = atom.getSymbolPtr(self); try self.setSymbolName(sym, decl_name); sym.section_number = @intToEnum(coff.SectionNumber, sect_index + 1); sym.type = .{ .complex_type = complex_type, .base_type = .NULL }; - const vaddr = try self.allocateAtom(atom, code_len, required_alignment); - errdefer self.freeAtom(atom); + const vaddr = try self.allocateAtom(atom_index, code_len, required_alignment); + errdefer self.freeAtom(atom_index); log.debug("allocated atom for {s} at 0x{x}", .{ decl_name, vaddr }); - atom.size = code_len; + self.getAtomPtr(atom_index).size = code_len; sym.value = vaddr; const got_target = SymbolWithLoc{ .sym_index = atom.getSymbolIndex().?, .file = null }; const got_index = try self.allocateGotEntry(got_target); - const got_atom = try self.createGotAtom(got_target); + const got_atom_index = try self.createGotAtom(got_target); + const got_atom = self.getAtom(got_atom_index); self.got_entries.items[got_index].sym_index = got_atom.getSymbolIndex().?; - try self.writePtrWidthAtom(got_atom); + try self.writePtrWidthAtom(got_atom_index); } self.markRelocsDirtyByTarget(atom.getSymbolWithLoc()); - try self.writeAtom(atom, code); -} - -fn freeRelocationsForAtom(self: *Coff, atom: *Atom) void { - var removed_relocs = self.relocs.fetchRemove(atom); - if (removed_relocs) |*relocs| relocs.value.deinit(self.base.allocator); - var removed_base_relocs = self.base_relocs.fetchRemove(atom); - if (removed_base_relocs) |*base_relocs| base_relocs.value.deinit(self.base.allocator); + try self.writeAtom(atom_index, code); } fn freeUnnamedConsts(self: *Coff, decl_index: Module.Decl.Index) void { const gpa = self.base.allocator; const unnamed_consts = self.unnamed_const_atoms.getPtr(decl_index) orelse return; - for (unnamed_consts.items) |atom| { - self.freeAtom(atom); + for (unnamed_consts.items) |atom_index| { + self.freeAtom(atom_index); } unnamed_consts.clearAndFree(gpa); } @@ -1200,11 +1252,11 @@ pub fn freeDecl(self: *Coff, decl_index: Module.Decl.Index) void { log.debug("freeDecl {*}", .{decl}); - if (self.decls.fetchRemove(decl_index)) |kv| { - if (kv.value) |_| { - self.freeAtom(&decl.link.coff); - self.freeUnnamedConsts(decl_index); - } + if (self.decls.fetchRemove(decl_index)) |const_kv| { + var kv = const_kv; + self.freeAtom(kv.value.atom); + self.freeUnnamedConsts(decl_index); + kv.value.exports.deinit(self.base.allocator); } } @@ -1257,16 +1309,10 @@ pub fn updateDeclExports( const gpa = self.base.allocator; const decl = module.declPtr(decl_index); - const atom = &decl.link.coff; - - if (atom.getSymbolIndex() == null) return; - - const gop = try self.decls.getOrPut(gpa, decl_index); - if (!gop.found_existing) { - gop.value_ptr.* = self.getDeclOutputSection(decl); - } - + const atom_index = try self.getOrCreateAtomForDecl(decl_index); + const atom = self.getAtom(atom_index); const decl_sym = atom.getSymbol(self); + const decl_metadata = self.decls.getPtr(decl_index).?; for (exports) |exp| { log.debug("adding new export '{s}'", .{exp.options.name}); @@ -1301,9 +1347,9 @@ pub fn updateDeclExports( continue; } - const sym_index = exp.link.coff.sym_index orelse blk: { + const sym_index = decl_metadata.getExport(self, exp.options.name) orelse blk: { const sym_index = try self.allocateSymbol(); - exp.link.coff.sym_index = sym_index; + try decl_metadata.exports.append(gpa, sym_index); break :blk sym_index; }; const sym_loc = SymbolWithLoc{ .sym_index = sym_index, .file = null }; @@ -1326,16 +1372,15 @@ pub fn updateDeclExports( } } -pub fn deleteExport(self: *Coff, exp: Export) void { +pub fn deleteDeclExport(self: *Coff, decl_index: Module.Decl.Index, name: []const u8) void { if (self.llvm_object) |_| return; - const sym_index = exp.sym_index orelse return; + const metadata = self.decls.getPtr(decl_index) orelse return; + const sym_index = metadata.getExportPtr(self, name) orelse return; const gpa = self.base.allocator; - - const sym_loc = SymbolWithLoc{ .sym_index = sym_index, .file = null }; + const sym_loc = SymbolWithLoc{ .sym_index = sym_index.*, .file = null }; const sym = self.getSymbolPtr(sym_loc); - const sym_name = self.getSymbolName(sym_loc); - log.debug("deleting export '{s}'", .{sym_name}); + log.debug("deleting export '{s}'", .{name}); assert(sym.storage_class == .EXTERNAL and sym.section_number != .UNDEFINED); sym.* = .{ .name = [_]u8{0} ** 8, @@ -1345,9 +1390,9 @@ pub fn deleteExport(self: *Coff, exp: Export) void { .storage_class = .NULL, .number_of_aux_symbols = 0, }; - self.locals_free_list.append(gpa, sym_index) catch {}; + self.locals_free_list.append(gpa, sym_index.*) catch {}; - if (self.resolver.fetchRemove(sym_name)) |entry| { + if (self.resolver.fetchRemove(name)) |entry| { defer gpa.free(entry.key); self.globals_free_list.append(gpa, entry.value) catch {}; self.globals.items[entry.value] = .{ @@ -1355,6 +1400,8 @@ pub fn deleteExport(self: *Coff, exp: Export) void { .file = null, }; } + + sym_index.* = 0; } fn resolveGlobalSymbol(self: *Coff, current: SymbolWithLoc) !void { @@ -1419,9 +1466,10 @@ pub fn flushModule(self: *Coff, comp: *Compilation, prog_node: *std.Progress.Nod if (self.imports_table.contains(global)) continue; const import_index = try self.allocateImportEntry(global); - const import_atom = try self.createImportAtom(); + const import_atom_index = try self.createImportAtom(); + const import_atom = self.getAtom(import_atom_index); self.imports.items[import_index].sym_index = import_atom.getSymbolIndex().?; - try self.writePtrWidthAtom(import_atom); + try self.writePtrWidthAtom(import_atom_index); } if (build_options.enable_logging) { @@ -1455,22 +1503,14 @@ pub fn flushModule(self: *Coff, comp: *Compilation, prog_node: *std.Progress.Nod } } -pub fn getDeclVAddr( - self: *Coff, - decl_index: Module.Decl.Index, - reloc_info: link.File.RelocInfo, -) !u64 { - const mod = self.base.options.module.?; - const decl = mod.declPtr(decl_index); - +pub fn getDeclVAddr(self: *Coff, decl_index: Module.Decl.Index, reloc_info: link.File.RelocInfo) !u64 { assert(self.llvm_object == null); - try decl.link.coff.ensureInitialized(self); - const sym_index = decl.link.coff.getSymbolIndex().?; - - const atom = self.getAtomForSymbol(.{ .sym_index = reloc_info.parent_atom_index, .file = null }).?; + const this_atom_index = try self.getOrCreateAtomForDecl(decl_index); + const sym_index = self.getAtom(this_atom_index).getSymbolIndex().?; + const atom_index = self.getAtomIndexForSymbol(.{ .sym_index = reloc_info.parent_atom_index, .file = null }).?; const target = SymbolWithLoc{ .sym_index = sym_index, .file = null }; - try atom.addRelocation(self, .{ + try Atom.addRelocation(self, atom_index, .{ .type = .direct, .target = target, .offset = @intCast(u32, reloc_info.offset), @@ -1478,7 +1518,7 @@ pub fn getDeclVAddr( .pcrel = false, .length = 3, }); - try atom.addBaseRelocation(self, @intCast(u32, reloc_info.offset)); + try Atom.addBaseRelocation(self, atom_index, @intCast(u32, reloc_info.offset)); return 0; } @@ -1529,7 +1569,8 @@ fn writeBaseRelocations(self: *Coff) !void { var it = self.base_relocs.iterator(); while (it.next()) |entry| { - const atom = entry.key_ptr.*; + const atom_index = entry.key_ptr.*; + const atom = self.getAtom(atom_index); const offsets = entry.value_ptr.*; for (offsets.items) |offset| { @@ -1613,7 +1654,8 @@ fn writeImportTable(self: *Coff) !void { const gpa = self.base.allocator; const section = self.sections.get(self.idata_section_index.?); - const last_atom = section.last_atom orelse return; + const last_atom_index = section.last_atom_index orelse return; + const last_atom = self.getAtom(last_atom_index); const iat_rva = section.header.virtual_address; const iat_size = last_atom.getSymbol(self).value + last_atom.size * 2 - iat_rva; // account for sentinel zero pointer @@ -2051,27 +2093,37 @@ pub fn getOrPutGlobalPtr(self: *Coff, name: []const u8) !GetOrPutGlobalPtrResult return GetOrPutGlobalPtrResult{ .found_existing = false, .value_ptr = ptr }; } +pub fn getAtom(self: *const Coff, atom_index: Atom.Index) Atom { + assert(atom_index < self.atoms.items.len); + return self.atoms.items[atom_index]; +} + +pub fn getAtomPtr(self: *Coff, atom_index: Atom.Index) *Atom { + assert(atom_index < self.atoms.items.len); + return &self.atoms.items[atom_index]; +} + /// Returns atom if there is an atom referenced by the symbol described by `sym_loc` descriptor. /// Returns null on failure. -pub fn getAtomForSymbol(self: *Coff, sym_loc: SymbolWithLoc) ?*Atom { +pub fn getAtomIndexForSymbol(self: *const Coff, sym_loc: SymbolWithLoc) ?Atom.Index { assert(sym_loc.file == null); // TODO linking with object files return self.atom_by_index_table.get(sym_loc.sym_index); } /// Returns GOT atom that references `sym_loc` if one exists. /// Returns null otherwise. -pub fn getGotAtomForSymbol(self: *Coff, sym_loc: SymbolWithLoc) ?*Atom { +pub fn getGotAtomIndexForSymbol(self: *const Coff, sym_loc: SymbolWithLoc) ?Atom.Index { const got_index = self.got_entries_table.get(sym_loc) orelse return null; const got_entry = self.got_entries.items[got_index]; - return self.getAtomForSymbol(.{ .sym_index = got_entry.sym_index, .file = null }); + return self.getAtomIndexForSymbol(.{ .sym_index = got_entry.sym_index, .file = null }); } /// Returns import atom that references `sym_loc` if one exists. /// Returns null otherwise. -pub fn getImportAtomForSymbol(self: *Coff, sym_loc: SymbolWithLoc) ?*Atom { +pub fn getImportAtomIndexForSymbol(self: *const Coff, sym_loc: SymbolWithLoc) ?Atom.Index { const imports_index = self.imports_table.get(sym_loc) orelse return null; const imports_entry = self.imports.items[imports_index]; - return self.getAtomForSymbol(.{ .sym_index = imports_entry.sym_index, .file = null }); + return self.getAtomIndexForSymbol(.{ .sym_index = imports_entry.sym_index, .file = null }); } fn setSectionName(self: *Coff, header: *coff.SectionHeader, name: []const u8) !void { diff --git a/src/link/Coff/Atom.zig b/src/link/Coff/Atom.zig index 78824eac1d..1ee31cccaa 100644 --- a/src/link/Coff/Atom.zig +++ b/src/link/Coff/Atom.zig @@ -27,23 +27,10 @@ alignment: u32, /// Points to the previous and next neighbors, based on the `text_offset`. /// This can be used to find, for example, the capacity of this `Atom`. -prev: ?*Atom, -next: ?*Atom, +prev_index: ?Index, +next_index: ?Index, -pub const empty = Atom{ - .sym_index = 0, - .file = null, - .size = 0, - .alignment = 0, - .prev = null, - .next = null, -}; - -pub fn ensureInitialized(self: *Atom, coff_file: *Coff) !void { - if (self.getSymbolIndex() != null) return; // Already initialized - self.sym_index = try coff_file.allocateSymbol(); - try coff_file.atom_by_index_table.putNoClobber(coff_file.base.allocator, self.sym_index, self); -} +pub const Index = u32; pub fn getSymbolIndex(self: Atom) ?u32 { if (self.sym_index == 0) return null; @@ -85,7 +72,8 @@ pub fn getName(self: Atom, coff_file: *const Coff) []const u8 { /// Returns how much room there is to grow in virtual address space. pub fn capacity(self: Atom, coff_file: *const Coff) u32 { const self_sym = self.getSymbol(coff_file); - if (self.next) |next| { + if (self.next_index) |next_index| { + const next = coff_file.getAtom(next_index); const next_sym = next.getSymbol(coff_file); return next_sym.value - self_sym.value; } else { @@ -97,7 +85,8 @@ pub fn capacity(self: Atom, coff_file: *const Coff) u32 { pub fn freeListEligible(self: Atom, coff_file: *const Coff) bool { // No need to keep a free list node for the last atom. - const next = self.next orelse return false; + const next_index = self.next_index orelse return false; + const next = coff_file.getAtom(next_index); const self_sym = self.getSymbol(coff_file); const next_sym = next.getSymbol(coff_file); const cap = next_sym.value - self_sym.value; @@ -107,22 +96,33 @@ pub fn freeListEligible(self: Atom, coff_file: *const Coff) bool { return surplus >= Coff.min_text_capacity; } -pub fn addRelocation(self: *Atom, coff_file: *Coff, reloc: Relocation) !void { +pub fn addRelocation(coff_file: *Coff, atom_index: Index, reloc: Relocation) !void { const gpa = coff_file.base.allocator; log.debug(" (adding reloc of type {s} to target %{d})", .{ @tagName(reloc.type), reloc.target.sym_index }); - const gop = try coff_file.relocs.getOrPut(gpa, self); + const gop = try coff_file.relocs.getOrPut(gpa, atom_index); if (!gop.found_existing) { gop.value_ptr.* = .{}; } try gop.value_ptr.append(gpa, reloc); } -pub fn addBaseRelocation(self: *Atom, coff_file: *Coff, offset: u32) !void { +pub fn addBaseRelocation(coff_file: *Coff, atom_index: Index, offset: u32) !void { const gpa = coff_file.base.allocator; - log.debug(" (adding base relocation at offset 0x{x} in %{d})", .{ offset, self.sym_index }); - const gop = try coff_file.base_relocs.getOrPut(gpa, self); + log.debug(" (adding base relocation at offset 0x{x} in %{d})", .{ + offset, + coff_file.getAtom(atom_index).getSymbolIndex().?, + }); + const gop = try coff_file.base_relocs.getOrPut(gpa, atom_index); if (!gop.found_existing) { gop.value_ptr.* = .{}; } try gop.value_ptr.append(gpa, offset); } + +pub fn freeRelocations(coff_file: *Coff, atom_index: Atom.Index) void { + const gpa = coff_file.base.allocator; + var removed_relocs = coff_file.relocs.fetchRemove(atom_index); + if (removed_relocs) |*relocs| relocs.value.deinit(gpa); + var removed_base_relocs = coff_file.base_relocs.fetchRemove(atom_index); + if (removed_base_relocs) |*base_relocs| base_relocs.value.deinit(gpa); +} diff --git a/src/link/Coff/Relocation.zig b/src/link/Coff/Relocation.zig index 12a34b332d..1ba1d7a1c1 100644 --- a/src/link/Coff/Relocation.zig +++ b/src/link/Coff/Relocation.zig @@ -46,33 +46,35 @@ length: u2, dirty: bool = true, /// Returns an Atom which is the target node of this relocation edge (if any). -pub fn getTargetAtom(self: Relocation, coff_file: *Coff) ?*Atom { +pub fn getTargetAtomIndex(self: Relocation, coff_file: *const Coff) ?Atom.Index { switch (self.type) { .got, .got_page, .got_pageoff, - => return coff_file.getGotAtomForSymbol(self.target), + => return coff_file.getGotAtomIndexForSymbol(self.target), .direct, .page, .pageoff, - => return coff_file.getAtomForSymbol(self.target), + => return coff_file.getAtomIndexForSymbol(self.target), .import, .import_page, .import_pageoff, - => return coff_file.getImportAtomForSymbol(self.target), + => return coff_file.getImportAtomIndexForSymbol(self.target), } } -pub fn resolve(self: *Relocation, atom: *Atom, coff_file: *Coff) !void { +pub fn resolve(self: *Relocation, atom_index: Atom.Index, coff_file: *Coff) !void { + const atom = coff_file.getAtom(atom_index); const source_sym = atom.getSymbol(coff_file); const source_section = coff_file.sections.get(@enumToInt(source_sym.section_number) - 1).header; const source_vaddr = source_sym.value + self.offset; const file_offset = source_section.pointer_to_raw_data + source_sym.value - source_section.virtual_address; - const target_atom = self.getTargetAtom(coff_file) orelse return; + const target_atom_index = self.getTargetAtomIndex(coff_file) orelse return; + const target_atom = coff_file.getAtom(target_atom_index); const target_vaddr = target_atom.getSymbol(coff_file).value; const target_vaddr_with_addend = target_vaddr + self.addend; @@ -107,7 +109,7 @@ const Context = struct { image_base: u64, }; -fn resolveAarch64(self: *Relocation, ctx: Context, coff_file: *Coff) !void { +fn resolveAarch64(self: Relocation, ctx: Context, coff_file: *Coff) !void { var buffer: [@sizeOf(u64)]u8 = undefined; switch (self.length) { 2 => { @@ -197,7 +199,7 @@ fn resolveAarch64(self: *Relocation, ctx: Context, coff_file: *Coff) !void { } } -fn resolveX86(self: *Relocation, ctx: Context, coff_file: *Coff) !void { +fn resolveX86(self: Relocation, ctx: Context, coff_file: *Coff) !void { switch (self.type) { .got_page => unreachable, .got_pageoff => unreachable, diff --git a/src/link/Elf.zig b/src/link/Elf.zig index 0b8128aa33..747120ac5d 100644 --- a/src/link/Elf.zig +++ b/src/link/Elf.zig @@ -71,14 +71,14 @@ const DeclMetadata = struct { fn getExport(m: DeclMetadata, elf_file: *const Elf, name: []const u8) ?u32 { for (m.exports.items) |exp| { - if (mem.eql(u8, name, elf_file.getSymbolName(exp))) return exp; + if (mem.eql(u8, name, elf_file.getGlobalName(exp))) return exp; } return null; } fn getExportPtr(m: *DeclMetadata, elf_file: *Elf, name: []const u8) ?*u32 { for (m.exports.items) |*exp| { - if (mem.eql(u8, name, elf_file.getSymbolName(exp.*))) return exp; + if (mem.eql(u8, name, elf_file.getGlobalName(exp.*))) return exp; } return null; } @@ -3276,6 +3276,12 @@ pub fn getSymbolName(self: *const Elf, sym_index: u32) []const u8 { return self.shstrtab.get(sym.st_name).?; } +/// Returns name of the global symbol at index. +pub fn getGlobalName(self: *const Elf, index: u32) []const u8 { + const sym = self.global_symbols.items[index]; + return self.shstrtab.get(sym.st_name).?; +} + pub fn getAtom(self: *const Elf, atom_index: Atom.Index) Atom { assert(atom_index < self.atoms.items.len); return self.atoms.items[atom_index]; diff --git a/src/link/MachO.zig b/src/link/MachO.zig index 11a1119449..42aaa3a275 100644 --- a/src/link/MachO.zig +++ b/src/link/MachO.zig @@ -3015,6 +3015,11 @@ fn allocateAtom(self: *MachO, atom_index: Atom.Index, new_atom_size: u64, alignm if (header.@"align" < align_pow) { header.@"align" = align_pow; } + { + const atom_ptr = self.getAtomPtr(atom_index); + atom_ptr.size = new_atom_size; + atom_ptr.alignment = @intCast(u32, alignment); + } if (atom.prev_index) |prev_index| { const prev = self.getAtomPtr(prev_index); From 063888afff75f9d91fd221d84e1b74b111304ac3 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Fri, 27 Jan 2023 19:46:45 -0700 Subject: [PATCH 44/84] std.build: implement passing options to dependency packages * introduce the concept of maps to user input options, but don't implement it for command line arg parsing yet. * remove setPreferredReleaseMode and standardReleaseOptions in favor of standardOptimizeOption which has a future-proof options parameter. --- lib/std/build.zig | 209 ++++++++++++++++++++------------ lib/std/build/LibExeObjStep.zig | 35 +----- 2 files changed, 135 insertions(+), 109 deletions(-) diff --git a/lib/std/build.zig b/lib/std/build.zig index 8137b76846..f1b60f1469 100644 --- a/lib/std/build.zig +++ b/lib/std/build.zig @@ -73,8 +73,6 @@ pub const Builder = struct { build_root: []const u8, cache_root: []const u8, global_cache_root: []const u8, - release_mode: ?std.builtin.Mode, - is_release: bool, /// zig lib dir override_lib_dir: ?[]const u8, vcpkg_root: VcpkgRoot = .unattempted, @@ -150,6 +148,7 @@ pub const Builder = struct { flag: void, scalar: []const u8, list: ArrayList([]const u8), + map: StringHashMap(*const UserValue), }; const TypeId = enum { @@ -223,8 +222,6 @@ pub const Builder = struct { .step = Step.init(.top_level, "uninstall", allocator, makeUninstall), .description = "Remove build artifacts from prefix path", }, - .release_mode = null, - .is_release = false, .override_lib_dir = null, .install_path = undefined, .args = null, @@ -291,8 +288,6 @@ pub const Builder = struct { .build_root = build_root, .cache_root = parent.cache_root, .global_cache_root = parent.global_cache_root, - .release_mode = parent.release_mode, - .is_release = parent.is_release, .override_lib_dir = parent.override_lib_dir, .debug_log_scopes = parent.debug_log_scopes, .debug_compile_errors = parent.debug_compile_errors, @@ -312,10 +307,55 @@ pub const Builder = struct { } fn applyArgs(b: *Builder, args: anytype) !void { - // TODO this function is the way that a build.zig file communicates - // options to its dependencies. It is the programmatic way to give - // command line arguments to a build.zig script. - _ = args; + inline for (@typeInfo(@TypeOf(args)).Struct.fields) |field| { + const v = @field(args, field.name); + const T = @TypeOf(v); + switch (T) { + CrossTarget => { + try b.user_input_options.put(field.name, .{ + .name = field.name, + .value = .{ .scalar = try v.zigTriple(b.allocator) }, + .used = false, + }); + try b.user_input_options.put("cpu", .{ + .name = "cpu", + .value = .{ .scalar = try serializeCpu(b.allocator, v.getCpu()) }, + .used = false, + }); + }, + []const u8 => { + try b.user_input_options.put(field.name, .{ + .name = field.name, + .value = .{ .scalar = v }, + .used = false, + }); + }, + else => switch (@typeInfo(T)) { + .Bool => { + try b.user_input_options.put(field.name, .{ + .name = field.name, + .value = .{ .scalar = if (v) "true" else "false" }, + .used = false, + }); + }, + .Enum => { + try b.user_input_options.put(field.name, .{ + .name = field.name, + .value = .{ .scalar = @tagName(v) }, + .used = false, + }); + }, + .Int => { + try b.user_input_options.put(field.name, .{ + .name = field.name, + .value = .{ .scalar = try std.fmt.allocPrint(b.allocator, "{d}", .{v}) }, + .used = false, + }); + }, + else => @compileError("option '" ++ field.name ++ "' has unsupported type: " ++ @typeName(T)), + }, + } + } const Hasher = std.crypto.auth.siphash.SipHash128(1, 3); // Random bytes to make unique. Refresh this with new random bytes when // implementation is modified in a non-backwards-compatible way. @@ -679,15 +719,19 @@ pub const Builder = struct { return null; } }, - .list => { - log.err("Expected -D{s} to be a boolean, but received a list.\n", .{name}); + .list, .map => { + log.err("Expected -D{s} to be a boolean, but received a {s}.\n", .{ + name, @tagName(option_ptr.value), + }); self.markInvalidUserInput(); return null; }, }, .int => switch (option_ptr.value) { - .flag => { - log.err("Expected -D{s} to be an integer, but received a boolean.\n", .{name}); + .flag, .list, .map => { + log.err("Expected -D{s} to be an integer, but received a {s}.\n", .{ + name, @tagName(option_ptr.value), + }); self.markInvalidUserInput(); return null; }, @@ -706,15 +750,12 @@ pub const Builder = struct { }; return n; }, - .list => { - log.err("Expected -D{s} to be an integer, but received a list.\n", .{name}); - self.markInvalidUserInput(); - return null; - }, }, .float => switch (option_ptr.value) { - .flag => { - log.err("Expected -D{s} to be a float, but received a boolean.\n", .{name}); + .flag, .map, .list => { + log.err("Expected -D{s} to be a float, but received a {s}.\n", .{ + name, @tagName(option_ptr.value), + }); self.markInvalidUserInput(); return null; }, @@ -726,15 +767,12 @@ pub const Builder = struct { }; return n; }, - .list => { - log.err("Expected -D{s} to be a float, but received a list.\n", .{name}); - self.markInvalidUserInput(); - return null; - }, }, .@"enum" => switch (option_ptr.value) { - .flag => { - log.err("Expected -D{s} to be a string, but received a boolean.\n", .{name}); + .flag, .map, .list => { + log.err("Expected -D{s} to be an enum, but received a {s}.\n", .{ + name, @tagName(option_ptr.value), + }); self.markInvalidUserInput(); return null; }, @@ -747,28 +785,22 @@ pub const Builder = struct { return null; } }, - .list => { - log.err("Expected -D{s} to be a string, but received a list.\n", .{name}); - self.markInvalidUserInput(); - return null; - }, }, .string => switch (option_ptr.value) { - .flag => { - log.err("Expected -D{s} to be a string, but received a boolean.\n", .{name}); - self.markInvalidUserInput(); - return null; - }, - .list => { - log.err("Expected -D{s} to be a string, but received a list.\n", .{name}); + .flag, .list, .map => { + log.err("Expected -D{s} to be a string, but received a {s}.\n", .{ + name, @tagName(option_ptr.value), + }); self.markInvalidUserInput(); return null; }, .scalar => |s| return s, }, .list => switch (option_ptr.value) { - .flag => { - log.err("Expected -D{s} to be a list, but received a boolean.\n", .{name}); + .flag, .map => { + log.err("Expected -D{s} to be a list, but received a {s}.\n", .{ + name, @tagName(option_ptr.value), + }); self.markInvalidUserInput(); return null; }, @@ -790,41 +822,24 @@ pub const Builder = struct { return &step_info.step; } - /// This provides the -Drelease option to the build user and does not give them the choice. - pub fn setPreferredReleaseMode(self: *Builder, mode: std.builtin.Mode) void { - if (self.release_mode != null) { - @panic("setPreferredReleaseMode must be called before standardReleaseOptions and may not be called twice"); + pub const StandardOptimizeOptionOptions = struct { + preferred_optimize_mode: ?std.builtin.Mode = null, + }; + + pub fn standardOptimizeOption(self: *Builder, options: StandardOptimizeOptionOptions) std.builtin.Mode { + if (options.preferred_optimize_mode) |mode| { + if (self.option(bool, "release", "optimize for end users") orelse false) { + return mode; + } else { + return .Debug; + } + } else { + return self.option( + std.builtin.Mode, + "optimize", + "prioritize performance, safety, or binary size (-O flag)", + ) orelse .Debug; } - const description = self.fmt("Create a release build ({s})", .{@tagName(mode)}); - self.is_release = self.option(bool, "release", description) orelse false; - self.release_mode = if (self.is_release) mode else std.builtin.Mode.Debug; - } - - /// If you call this without first calling `setPreferredReleaseMode` then it gives the build user - /// the choice of what kind of release. - pub fn standardReleaseOptions(self: *Builder) std.builtin.Mode { - if (self.release_mode) |mode| return mode; - - const release_safe = self.option(bool, "release-safe", "Optimizations on and safety on") orelse false; - const release_fast = self.option(bool, "release-fast", "Optimizations on and safety off") orelse false; - const release_small = self.option(bool, "release-small", "Size optimizations on and safety off") orelse false; - - const mode = if (release_safe and !release_fast and !release_small) - std.builtin.Mode.ReleaseSafe - else if (release_fast and !release_safe and !release_small) - std.builtin.Mode.ReleaseFast - else if (release_small and !release_fast and !release_safe) - std.builtin.Mode.ReleaseSmall - else if (!release_fast and !release_safe and !release_small) - std.builtin.Mode.Debug - else x: { - log.err("Multiple release modes (of -Drelease-safe, -Drelease-fast and -Drelease-small)\n", .{}); - self.markInvalidUserInput(); - break :x std.builtin.Mode.Debug; - }; - self.is_release = mode != .Debug; - self.release_mode = mode; - return mode; } pub const StandardTargetOptionsArgs = struct { @@ -1004,6 +1019,11 @@ pub const Builder = struct { log.warn("Option '-D{s}={s}' conflicts with flag '-D{s}'.", .{ name, value, name }); return true; }, + .map => |*map| { + _ = map; + log.warn("TODO maps as command line arguments is not implemented yet.", .{}); + return true; + }, } return false; } @@ -1026,7 +1046,7 @@ pub const Builder = struct { log.err("Flag '-D{s}' conflicts with option '-D{s}={s}'.", .{ name, name, s }); return true; }, - .list => { + .list, .map => { log.err("Flag '-D{s}' conflicts with multiple options of the same name.", .{name}); return true; }, @@ -1058,7 +1078,7 @@ pub const Builder = struct { var it = self.user_input_options.iterator(); while (it.next()) |entry| { if (!entry.value_ptr.used) { - log.err("Invalid option: -D{s}\n", .{entry.key_ptr.*}); + log.err("Invalid option: -D{s}", .{entry.key_ptr.*}); self.markInvalidUserInput(); } } @@ -1456,6 +1476,11 @@ pub const Builder = struct { ) *Dependency { const sub_builder = b.createChild(name, build_root, args) catch unreachable; sub_builder.runBuild(build_zig) catch unreachable; + + if (sub_builder.validateUserInputDidItFail()) { + std.debug.dumpCurrentStackTrace(@returnAddress()); + } + const dep = b.allocator.create(Dependency) catch unreachable; dep.* = .{ .builder = sub_builder }; return dep; @@ -1718,6 +1743,34 @@ pub const InstalledFile = struct { } }; +pub fn serializeCpu(allocator: Allocator, cpu: std.Target.Cpu) ![]const u8 { + // TODO this logic can disappear if cpu model + features becomes part of the target triple + const all_features = cpu.arch.allFeaturesList(); + var populated_cpu_features = cpu.model.features; + populated_cpu_features.populateDependencies(all_features); + + if (populated_cpu_features.eql(cpu.features)) { + // The CPU name alone is sufficient. + return cpu.model.name; + } else { + var mcpu_buffer = ArrayList(u8).init(allocator); + try mcpu_buffer.appendSlice(cpu.model.name); + + for (all_features) |feature, i_usize| { + const i = @intCast(std.Target.Cpu.Feature.Set.Index, i_usize); + const in_cpu_set = populated_cpu_features.isEnabled(i); + const in_actual_set = cpu.features.isEnabled(i); + if (in_cpu_set and !in_actual_set) { + try mcpu_buffer.writer().print("-{s}", .{feature.name}); + } else if (!in_cpu_set and in_actual_set) { + try mcpu_buffer.writer().print("+{s}", .{feature.name}); + } + } + + return try mcpu_buffer.toOwnedSlice(); + } +} + test "dupePkg()" { if (builtin.os.tag == .wasi) return error.SkipZigTest; diff --git a/lib/std/build/LibExeObjStep.zig b/lib/std/build/LibExeObjStep.zig index cb37b24885..b1e6f3bdac 100644 --- a/lib/std/build/LibExeObjStep.zig +++ b/lib/std/build/LibExeObjStep.zig @@ -1495,37 +1495,10 @@ fn make(step: *Step) !void { } if (!self.target.isNative()) { - try zig_args.append("-target"); - try zig_args.append(try self.target.zigTriple(builder.allocator)); - - // TODO this logic can disappear if cpu model + features becomes part of the target triple - const cross = self.target.toTarget(); - const all_features = cross.cpu.arch.allFeaturesList(); - var populated_cpu_features = cross.cpu.model.features; - populated_cpu_features.populateDependencies(all_features); - - if (populated_cpu_features.eql(cross.cpu.features)) { - // The CPU name alone is sufficient. - try zig_args.append("-mcpu"); - try zig_args.append(cross.cpu.model.name); - } else { - var mcpu_buffer = ArrayList(u8).init(builder.allocator); - - try mcpu_buffer.writer().print("-mcpu={s}", .{cross.cpu.model.name}); - - for (all_features) |feature, i_usize| { - const i = @intCast(std.Target.Cpu.Feature.Set.Index, i_usize); - const in_cpu_set = populated_cpu_features.isEnabled(i); - const in_actual_set = cross.cpu.features.isEnabled(i); - if (in_cpu_set and !in_actual_set) { - try mcpu_buffer.writer().print("-{s}", .{feature.name}); - } else if (!in_cpu_set and in_actual_set) { - try mcpu_buffer.writer().print("+{s}", .{feature.name}); - } - } - - try zig_args.append(try mcpu_buffer.toOwnedSlice()); - } + try zig_args.appendSlice(&.{ + "-target", try self.target.zigTriple(builder.allocator), + "-mcpu", try build.serializeCpu(builder.allocator, self.target.getCpu()), + }); if (self.target.dynamic_linker.get()) |dynamic_linker| { try zig_args.append("--dynamic-linker"); From 71ff60f1265da83e619b1b6b2488ecb448fdfd36 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Sat, 28 Jan 2023 17:14:06 -0700 Subject: [PATCH 45/84] std.build: eliminate setTarget and setBuildMode This is a breaking change that makes the API for creating build artifacts no longer have any period of time where the target and optimization mode are not set. --- lib/std/build.zig | 170 +++++++++++++++++++------------- lib/std/build/LibExeObjStep.zig | 81 +++++---------- 2 files changed, 122 insertions(+), 129 deletions(-) diff --git a/lib/std/build.zig b/lib/std/build.zig index f1b60f1469..a4ad599d93 100644 --- a/lib/std/build.zig +++ b/lib/std/build.zig @@ -414,82 +414,123 @@ pub const Builder = struct { self.h_dir = self.pathJoin(&h_list); } - fn convertOptionalPathToFileSource(path: ?[]const u8) ?FileSource { - return if (path) |p| - FileSource{ .path = p } - else - null; - } - - pub fn addExecutable(self: *Builder, name: []const u8, root_src: ?[]const u8) *LibExeObjStep { - return addExecutableSource(self, name, convertOptionalPathToFileSource(root_src)); - } - - pub fn addExecutableSource(builder: *Builder, name: []const u8, root_src: ?FileSource) *LibExeObjStep { - return LibExeObjStep.createExecutable(builder, name, root_src); - } - pub fn addOptions(self: *Builder) *OptionsStep { return OptionsStep.create(self); } - pub fn addObject(self: *Builder, name: []const u8, root_src: ?[]const u8) *LibExeObjStep { - return addObjectSource(self, name, convertOptionalPathToFileSource(root_src)); - } - - pub fn addObjectSource(builder: *Builder, name: []const u8, root_src: ?FileSource) *LibExeObjStep { - return LibExeObjStep.createObject(builder, name, root_src); - } - - pub fn addSharedLibrary( - self: *Builder, + pub const ExecutableOptions = struct { name: []const u8, - root_src: ?[]const u8, - kind: LibExeObjStep.SharedLibKind, - ) *LibExeObjStep { - return addSharedLibrarySource(self, name, convertOptionalPathToFileSource(root_src), kind); + root_source_file: ?FileSource, + version: ?std.builtin.Version = null, + target: CrossTarget, + optimize: std.builtin.Mode, + linkage: ?LibExeObjStep.Linkage = null, + }; + + pub fn addExecutable(b: *Builder, options: ExecutableOptions) *LibExeObjStep { + return LibExeObjStep.create(b, .{ + .name = options.name, + .root_source_file = options.root_source_file, + .version = options.version, + .target = options.target, + .optimize = options.optimize, + .kind = .exe, + .linkage = options.linkage, + .version = options.version, + }); } - pub fn addSharedLibrarySource( - self: *Builder, + pub const ObjectOptions = struct { name: []const u8, - root_src: ?FileSource, - kind: LibExeObjStep.SharedLibKind, - ) *LibExeObjStep { - return LibExeObjStep.createSharedLibrary(self, name, root_src, kind); + root_source_file: ?FileSource, + target: CrossTarget, + optimize: std.builtin.Mode, + }; + + pub fn addObject(b: *Builder, options: ObjectOptions) *LibExeObjStep { + return LibExeObjStep.create(b, .{ + .name = options.name, + .root_source_file = options.root_source_file, + .target = options.target, + .optimize = options.optimize, + .kind = .obj, + }); } - pub fn addStaticLibrary(self: *Builder, name: []const u8, root_src: ?[]const u8) *LibExeObjStep { - return addStaticLibrarySource(self, name, convertOptionalPathToFileSource(root_src)); + pub const SharedLibraryOptions = struct { + name: []const u8, + root_source_file: ?FileSource, + version: ?std.builtin.Version = null, + target: CrossTarget, + optimize: std.builtin.Mode, + }; + + pub fn addSharedLibrary(b: *Builder, options: SharedLibraryOptions) *LibExeObjStep { + return LibExeObjStep.create(b, .{ + .name = options.name, + .root_source_file = options.root_source_file, + .kind = .lib, + .linkage = .dynamic, + .version = options.version, + .target = options.target, + .optimize = options.optimize, + }); } - pub fn addStaticLibrarySource(self: *Builder, name: []const u8, root_src: ?FileSource) *LibExeObjStep { - return LibExeObjStep.createStaticLibrary(self, name, root_src); + pub const StaticLibraryOptions = struct { + name: []const u8, + root_source_file: ?FileSource = null, + target: CrossTarget, + optimize: std.builtin.Mode, + version: ?std.builtin.Version = null, + }; + + pub fn addStaticLibrary(b: *Builder, options: StaticLibraryOptions) *LibExeObjStep { + return LibExeObjStep.create(b, .{ + .name = options.name, + .root_source_file = options.root_source_file, + .kind = .lib, + .linkage = .static, + .version = options.version, + .target = options.target, + .optimize = options.optimize, + }); } - pub fn addTest(self: *Builder, root_src: []const u8) *LibExeObjStep { - return LibExeObjStep.createTest(self, "test", .{ .path = root_src }); + pub const TestOptions = struct { + name: []const u8 = "test", + kind: LibExeObjStep.Kind = .@"test", + root_source_file: FileSource, + target: CrossTarget, + optimize: std.builtin.Mode, + version: ?std.builtin.Version = null, + }; + + pub fn addTest(b: *Builder, options: TestOptions) *LibExeObjStep { + return LibExeObjStep.create(b, .{ + .name = options.name, + .kind = options.kind, + .root_source_file = options.root_source_file, + .target = options.target, + .optimize = options.optimize, + }); } - pub fn addTestSource(self: *Builder, root_src: FileSource) *LibExeObjStep { - return LibExeObjStep.createTest(self, "test", root_src.dupe(self)); - } + pub const AssemblyOptions = struct { + name: []const u8, + source_file: FileSource, + target: CrossTarget, + optimize: std.builtin.Mode, + }; - pub fn addTestExe(self: *Builder, name: []const u8, root_src: []const u8) *LibExeObjStep { - return LibExeObjStep.createTestExe(self, name, .{ .path = root_src }); - } - - pub fn addTestExeSource(self: *Builder, name: []const u8, root_src: FileSource) *LibExeObjStep { - return LibExeObjStep.createTestExe(self, name, root_src.dupe(self)); - } - - pub fn addAssemble(self: *Builder, name: []const u8, src: []const u8) *LibExeObjStep { - return addAssembleSource(self, name, .{ .path = src }); - } - - pub fn addAssembleSource(self: *Builder, name: []const u8, src: FileSource) *LibExeObjStep { - const obj_step = LibExeObjStep.createObject(self, name, null); - obj_step.addAssemblyFileSource(src.dupe(self)); + pub fn addAssembly(b: *Builder, options: AssemblyOptions) *LibExeObjStep { + const obj_step = LibExeObjStep.create(b, .{ + .name = options.name, + .root_source_file = null, + .target = options.target, + .optimize = options.optimize, + }); + obj_step.addAssemblyFileSource(options.source_file.dupe(b)); return obj_step; } @@ -593,17 +634,6 @@ pub const Builder = struct { return TranslateCStep.create(self, source.dupe(self)); } - pub fn version(self: *const Builder, major: u32, minor: u32, patch: u32) LibExeObjStep.SharedLibKind { - _ = self; - return .{ - .versioned = .{ - .major = major, - .minor = minor, - .patch = patch, - }, - }; - } - pub fn make(self: *Builder, step_names: []const []const u8) !void { try self.makePath(self.cache_root); diff --git a/lib/std/build/LibExeObjStep.zig b/lib/std/build/LibExeObjStep.zig index b1e6f3bdac..6ee5205b50 100644 --- a/lib/std/build/LibExeObjStep.zig +++ b/lib/std/build/LibExeObjStep.zig @@ -36,14 +36,14 @@ pub const base_id = .lib_exe_obj; step: Step, builder: *Builder, name: []const u8, -target: CrossTarget = CrossTarget{}, +target: CrossTarget, target_info: NativeTargetInfo, +optimize: std.builtin.Mode, linker_script: ?FileSource = null, version_script: ?[]const u8 = null, out_filename: []const u8, linkage: ?Linkage = null, version: ?std.builtin.Version, -build_mode: std.builtin.Mode, kind: Kind, major_only_filename: ?[]const u8, name_only_filename: ?[]const u8, @@ -271,6 +271,16 @@ pub const IncludeDir = union(enum) { config_header_step: *ConfigHeaderStep, }; +pub const Options = struct { + name: []const u8, + root_source_file: ?FileSource = null, + target: CrossTarget, + optimize: std.builtin.Mode, + kind: Kind, + linkage: ?Linkage = null, + version: ?std.builtin.Version = null, +}; + pub const Kind = enum { exe, lib, @@ -279,11 +289,6 @@ pub const Kind = enum { test_exe, }; -pub const SharedLibKind = union(enum) { - versioned: std.builtin.Version, - unversioned: void, -}; - pub const Linkage = enum { dynamic, static }; pub const EmitOption = union(enum) { @@ -302,43 +307,9 @@ pub const EmitOption = union(enum) { } }; -pub fn createSharedLibrary(builder: *Builder, name: []const u8, root_src: ?FileSource, kind: SharedLibKind) *LibExeObjStep { - return initExtraArgs(builder, name, root_src, .lib, .dynamic, switch (kind) { - .versioned => |ver| ver, - .unversioned => null, - }); -} - -pub fn createStaticLibrary(builder: *Builder, name: []const u8, root_src: ?FileSource) *LibExeObjStep { - return initExtraArgs(builder, name, root_src, .lib, .static, null); -} - -pub fn createObject(builder: *Builder, name: []const u8, root_src: ?FileSource) *LibExeObjStep { - return initExtraArgs(builder, name, root_src, .obj, null, null); -} - -pub fn createExecutable(builder: *Builder, name: []const u8, root_src: ?FileSource) *LibExeObjStep { - return initExtraArgs(builder, name, root_src, .exe, null, null); -} - -pub fn createTest(builder: *Builder, name: []const u8, root_src: FileSource) *LibExeObjStep { - return initExtraArgs(builder, name, root_src, .@"test", null, null); -} - -pub fn createTestExe(builder: *Builder, name: []const u8, root_src: FileSource) *LibExeObjStep { - return initExtraArgs(builder, name, root_src, .test_exe, null, null); -} - -fn initExtraArgs( - builder: *Builder, - name_raw: []const u8, - root_src_raw: ?FileSource, - kind: Kind, - linkage: ?Linkage, - ver: ?std.builtin.Version, -) *LibExeObjStep { - const name = builder.dupe(name_raw); - const root_src: ?FileSource = if (root_src_raw) |rsrc| rsrc.dupe(builder) else null; +pub fn create(builder: *Builder, options: Options) *LibExeObjStep { + const name = builder.dupe(options.name); + const root_src: ?FileSource = if (options.root_source_file) |rsrc| rsrc.dupe(builder) else null; if (mem.indexOf(u8, name, "/") != null or mem.indexOf(u8, name, "\\") != null) { panic("invalid name: '{s}'. It looks like a file path, but it is supposed to be the library or application name.", .{name}); } @@ -350,14 +321,15 @@ fn initExtraArgs( .builder = builder, .verbose_link = false, .verbose_cc = false, - .build_mode = std.builtin.Mode.Debug, - .linkage = linkage, - .kind = kind, + .optimize = options.optimize, + .target = options.target, + .linkage = options.linkage, + .kind = options.kind, .root_src = root_src, .name = name, .frameworks = StringHashMap(FrameworkLinkInfo).init(builder.allocator), .step = Step.init(base_id, name, builder.allocator, make), - .version = ver, + .version = options.version, .out_filename = undefined, .out_h_filename = builder.fmt("{s}.h", .{name}), .out_lib_filename = undefined, @@ -457,11 +429,6 @@ fn computeOutFileNames(self: *LibExeObjStep) void { } } -pub fn setTarget(self: *LibExeObjStep, target: CrossTarget) void { - self.target = target; - self.computeOutFileNames(); -} - pub fn setOutputDir(self: *LibExeObjStep, dir: []const u8) void { self.output_dir = self.builder.dupePath(dir); } @@ -889,10 +856,6 @@ pub fn setVerboseCC(self: *LibExeObjStep, value: bool) void { self.verbose_cc = value; } -pub fn setBuildMode(self: *LibExeObjStep, mode: std.builtin.Mode) void { - self.build_mode = mode; -} - pub fn overrideZigLibDir(self: *LibExeObjStep, dir_path: []const u8) void { self.override_lib_dir = self.builder.dupePath(dir_path); } @@ -1376,9 +1339,9 @@ fn make(step: *Step) !void { try zig_args.append(libc_file); } - switch (self.build_mode) { + switch (self.optimize) { .Debug => {}, // Skip since it's the default. - else => zig_args.append(builder.fmt("-O{s}", .{@tagName(self.build_mode)})) catch unreachable, + else => zig_args.append(builder.fmt("-O{s}", .{@tagName(self.optimize)})) catch unreachable, } try zig_args.append("--cache-dir"); From 73cf7b64291ed8b5dcb4cb52df103be08f15a347 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Mon, 30 Jan 2023 21:39:43 -0700 Subject: [PATCH 46/84] update build.zig API usage --- build.zig | 72 ++++---- doc/langref.html.in | 42 +++-- lib/init-exe/build.zig | 51 +++++- lib/init-lib/build.zig | 41 ++++- lib/std/build.zig | 19 +-- lib/std/build/TranslateCStep.zig | 40 ++++- lib/std/builtin.zig | 5 +- src/link/MachO/zld.zig | 11 +- test/link/bss/build.zig | 9 +- test/link/common_symbols/build.zig | 15 +- test/link/common_symbols_alignment/build.zig | 17 +- .../interdependent_static_c_libs/build.zig | 24 ++- test/link/macho/bugs/13056/build.zig | 8 +- test/link/macho/bugs/13457/build.zig | 11 +- test/link/macho/dead_strip/build.zig | 16 +- test/link/macho/dead_strip_dylibs/build.zig | 14 +- test/link/macho/dylib/build.zig | 19 ++- test/link/macho/empty/build.zig | 10 +- test/link/macho/entry/build.zig | 10 +- test/link/macho/headerpad/build.zig | 18 +- test/link/macho/linksection/build.zig | 13 +- test/link/macho/needed_framework/build.zig | 8 +- test/link/macho/needed_library/build.zig | 19 ++- test/link/macho/objc/build.zig | 8 +- test/link/macho/objcpp/build.zig | 8 +- test/link/macho/pagezero/build.zig | 18 +- test/link/macho/search_strategy/build.zig | 33 ++-- test/link/macho/stack_size/build.zig | 10 +- test/link/macho/strict_validation/build.zig | 11 +- test/link/macho/tls/build.zig | 19 ++- test/link/macho/unwind_info/build.zig | 20 ++- test/link/macho/uuid/build.zig | 17 +- test/link/macho/weak_framework/build.zig | 8 +- test/link/macho/weak_library/build.zig | 19 ++- test/link/static_lib_as_system_lib/build.zig | 17 +- test/link/wasm/archive/build.zig | 11 +- test/link/wasm/basic-features/build.zig | 18 +- test/link/wasm/bss/build.zig | 11 +- test/link/wasm/export-data/build.zig | 9 +- test/link/wasm/export/build.zig | 29 ++-- test/link/wasm/extern-mangle/build.zig | 11 +- test/link/wasm/extern/build.zig | 10 +- test/link/wasm/function-table/build.zig | 29 ++-- test/link/wasm/infer-features/build.zig | 29 +++- test/link/wasm/producers/build.zig | 11 +- test/link/wasm/segments/build.zig | 11 +- test/link/wasm/stack_pointer/build.zig | 11 +- test/link/wasm/type/build.zig | 11 +- test/src/compare_output.zig | 31 +++- test/src/run_translated_c.zig | 9 +- test/src/translate_c.zig | 7 +- test/standalone/brace_expansion/build.zig | 6 +- test/standalone/c_compiler/build.zig | 18 +- test/standalone/emit_asm_and_bin/build.zig | 6 +- test/standalone/empty_env/build.zig | 7 +- test/standalone/global_linkage/build.zig | 24 ++- test/standalone/install_raw_hex/build.zig | 11 +- test/standalone/issue_11595/build.zig | 11 +- test/standalone/issue_12588/build.zig | 11 +- test/standalone/issue_12706/build.zig | 11 +- test/standalone/issue_13030/build.zig | 12 +- test/standalone/issue_339/build.zig | 7 +- test/standalone/issue_5825/build.zig | 19 ++- test/standalone/issue_7030/build.zig | 11 +- test/standalone/issue_794/build.zig | 4 +- test/standalone/issue_8550/build.zig | 11 +- test/standalone/issue_9812/build.zig | 8 +- .../standalone/load_dynamic_library/build.zig | 20 ++- test/standalone/main_pkg_path/build.zig | 4 +- test/standalone/mix_c_files/build.zig | 11 +- test/standalone/mix_o_files/build.zig | 14 +- test/standalone/options/build.zig | 10 +- test/standalone/pie/build.zig | 6 +- test/standalone/pkg_import/build.zig | 13 +- test/standalone/shared_library/build.zig | 17 +- test/standalone/static_c_lib/build.zig | 15 +- test/standalone/test_runner_path/build.zig | 5 +- test/standalone/use_alias/build.zig | 6 +- test/standalone/windows_spawn/build.zig | 17 +- test/tests.zig | 156 ++++++++++-------- 80 files changed, 905 insertions(+), 494 deletions(-) diff --git a/build.zig b/build.zig index 3a7468243f..98da9f31ee 100644 --- a/build.zig +++ b/build.zig @@ -23,7 +23,7 @@ pub fn build(b: *Builder) !void { } break :t b.standardTargetOptions(.{ .default_target = default_target }); }; - const mode: std.builtin.Mode = if (release) switch (target.getCpuArch()) { + const optimize: std.builtin.OptimizeMode = if (release) switch (target.getCpuArch()) { .wasm32 => .ReleaseSmall, else => .ReleaseFast, } else .Debug; @@ -33,7 +33,12 @@ pub fn build(b: *Builder) !void { const test_step = b.step("test", "Run all the tests"); - const docgen_exe = b.addExecutable("docgen", "doc/docgen.zig"); + const docgen_exe = b.addExecutable(.{ + .name = "docgen", + .root_source_file = .{ .path = "doc/docgen.zig" }, + .target = .{}, + .optimize = .Debug, + }); docgen_exe.single_threaded = single_threaded; const rel_zig_exe = try fs.path.relative(b.allocator, b.build_root, b.zig_exe); @@ -53,10 +58,12 @@ pub fn build(b: *Builder) !void { const docs_step = b.step("docs", "Build documentation"); docs_step.dependOn(&docgen_cmd.step); - const test_cases = b.addTest("src/test.zig"); + const test_cases = b.addTest(.{ + .root_source_file = .{ .path = "src/test.zig" }, + .optimize = optimize, + }); test_cases.main_pkg_path = "."; test_cases.stack_size = stack_size; - test_cases.setBuildMode(mode); test_cases.single_threaded = single_threaded; const fmt_build_zig = b.addFmt(&[_][]const u8{"build.zig"}); @@ -149,17 +156,15 @@ pub fn build(b: *Builder) !void { const mem_leak_frames: u32 = b.option(u32, "mem-leak-frames", "How many stack frames to print when a memory leak occurs. Tests get 2x this amount.") orelse blk: { if (strip == true) break :blk @as(u32, 0); - if (mode != .Debug) break :blk 0; + if (optimize != .Debug) break :blk 0; break :blk 4; }; - const exe = addCompilerStep(b); + const exe = addCompilerStep(b, optimize, target); exe.strip = strip; exe.sanitize_thread = sanitize_thread; exe.build_id = b.option(bool, "build-id", "Include a build id note") orelse false; exe.install(); - exe.setBuildMode(mode); - exe.setTarget(target); const compile_step = b.step("compile", "Build the self-hosted compiler"); compile_step.dependOn(&exe.step); @@ -195,7 +200,7 @@ pub fn build(b: *Builder) !void { test_cases.linkLibC(); } - const is_debug = mode == .Debug; + const is_debug = optimize == .Debug; const enable_logging = b.option(bool, "log", "Enable debug logging with --debug-log") orelse is_debug; const enable_link_snapshots = b.option(bool, "link-snapshot", "Whether to enable linker state snapshots") orelse false; @@ -360,25 +365,25 @@ pub fn build(b: *Builder) !void { test_step.dependOn(test_cases_step); } - var chosen_modes: [4]builtin.Mode = undefined; + var chosen_opt_modes_buf: [4]builtin.Mode = undefined; var chosen_mode_index: usize = 0; if (!skip_debug) { - chosen_modes[chosen_mode_index] = builtin.Mode.Debug; + chosen_opt_modes_buf[chosen_mode_index] = builtin.Mode.Debug; chosen_mode_index += 1; } if (!skip_release_safe) { - chosen_modes[chosen_mode_index] = builtin.Mode.ReleaseSafe; + chosen_opt_modes_buf[chosen_mode_index] = builtin.Mode.ReleaseSafe; chosen_mode_index += 1; } if (!skip_release_fast) { - chosen_modes[chosen_mode_index] = builtin.Mode.ReleaseFast; + chosen_opt_modes_buf[chosen_mode_index] = builtin.Mode.ReleaseFast; chosen_mode_index += 1; } if (!skip_release_small) { - chosen_modes[chosen_mode_index] = builtin.Mode.ReleaseSmall; + chosen_opt_modes_buf[chosen_mode_index] = builtin.Mode.ReleaseSmall; chosen_mode_index += 1; } - const modes = chosen_modes[0..chosen_mode_index]; + const optimization_modes = chosen_opt_modes_buf[0..chosen_mode_index]; // run stage1 `zig fmt` on this build.zig file just to make sure it works test_step.dependOn(&fmt_build_zig.step); @@ -391,7 +396,7 @@ pub fn build(b: *Builder) !void { "test/behavior.zig", "behavior", "Run the behavior tests", - modes, + optimization_modes, skip_single_threaded, skip_non_native, skip_libc, @@ -405,7 +410,7 @@ pub fn build(b: *Builder) !void { "lib/compiler_rt.zig", "compiler-rt", "Run the compiler_rt tests", - modes, + optimization_modes, true, // skip_single_threaded skip_non_native, true, // skip_libc @@ -419,7 +424,7 @@ pub fn build(b: *Builder) !void { "lib/c.zig", "universal-libc", "Run the universal libc tests", - modes, + optimization_modes, true, // skip_single_threaded skip_non_native, true, // skip_libc @@ -427,11 +432,11 @@ pub fn build(b: *Builder) !void { skip_stage2_tests or true, // TODO get these all passing )); - test_step.dependOn(tests.addCompareOutputTests(b, test_filter, modes)); + test_step.dependOn(tests.addCompareOutputTests(b, test_filter, optimization_modes)); test_step.dependOn(tests.addStandaloneTests( b, test_filter, - modes, + optimization_modes, skip_non_native, enable_macos_sdk, target, @@ -444,10 +449,10 @@ pub fn build(b: *Builder) !void { enable_symlinks_windows, )); test_step.dependOn(tests.addCAbiTests(b, skip_non_native, skip_release)); - test_step.dependOn(tests.addLinkTests(b, test_filter, modes, enable_macos_sdk, skip_stage2_tests, enable_symlinks_windows)); - test_step.dependOn(tests.addStackTraceTests(b, test_filter, modes)); - test_step.dependOn(tests.addCliTests(b, test_filter, modes)); - test_step.dependOn(tests.addAssembleAndLinkTests(b, test_filter, modes)); + test_step.dependOn(tests.addLinkTests(b, test_filter, optimization_modes, enable_macos_sdk, skip_stage2_tests, enable_symlinks_windows)); + test_step.dependOn(tests.addStackTraceTests(b, test_filter, optimization_modes)); + test_step.dependOn(tests.addCliTests(b, test_filter, optimization_modes)); + test_step.dependOn(tests.addAssembleAndLinkTests(b, test_filter, optimization_modes)); test_step.dependOn(tests.addTranslateCTests(b, test_filter)); if (!skip_run_translated_c) { test_step.dependOn(tests.addRunTranslatedCTests(b, test_filter, target)); @@ -461,7 +466,7 @@ pub fn build(b: *Builder) !void { "lib/std/std.zig", "std", "Run the standard library tests", - modes, + optimization_modes, skip_single_threaded, skip_non_native, skip_libc, @@ -481,9 +486,7 @@ fn addWasiUpdateStep(b: *Builder, version: [:0]const u8) !void { }; target.cpu_features_add.addFeature(@enumToInt(std.Target.wasm.Feature.bulk_memory)); - const exe = addCompilerStep(b); - exe.setBuildMode(.ReleaseSmall); - exe.setTarget(target); + const exe = addCompilerStep(b, .ReleaseSmall, target); const exe_options = b.addOptions(); exe.addOptions("build_options", exe_options); @@ -510,8 +513,17 @@ fn addWasiUpdateStep(b: *Builder, version: [:0]const u8) !void { update_zig1_step.dependOn(&run_opt.step); } -fn addCompilerStep(b: *Builder) *std.build.LibExeObjStep { - const exe = b.addExecutable("zig", "src/main.zig"); +fn addCompilerStep( + b: *Builder, + optimize: std.builtin.OptimizeMode, + target: std.zig.CrossTarget, +) *std.build.LibExeObjStep { + const exe = b.addExecutable(.{ + .name = "zig", + .root_source_file = .{ .path = "src/main.zig" }, + .target = target, + .optimize = optimize, + }); exe.stack_size = stack_size; return exe; } diff --git a/doc/langref.html.in b/doc/langref.html.in index fd4aa8ae76..c008149f41 100644 --- a/doc/langref.html.in +++ b/doc/langref.html.in @@ -9531,8 +9531,12 @@ fn foo(comptime T: type, ptr: *T) T { const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const exe = b.addExecutable("example", "example.zig"); - exe.setBuildMode(b.standardReleaseOptions()); + const optimize = b.standardOptimizeOption(.{}); + const exe = b.addExecutable(.{ + .name = "example", + .root_source_file = .{ .path = "example.zig" }, + .optimize = optimize, + }); b.default_step.dependOn(&exe.step); } {#code_end#} @@ -10558,11 +10562,14 @@ pub fn build(b: *Builder) void { // Standard release options allow the person running `zig build` to select // between Debug, ReleaseSafe, ReleaseFast, and ReleaseSmall. - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); - const exe = b.addExecutable("example", "src/main.zig"); - exe.setTarget(target); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "example", + .root_source_file = .{ .path = "src/main.zig" }, + .target = target, + .optimize = optimize, + }); exe.install(); const run_cmd = exe.run(); @@ -10584,13 +10591,18 @@ pub fn build(b: *Builder) void { const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); - const lib = b.addStaticLibrary("example", "src/main.zig"); - lib.setBuildMode(mode); + const optimize = b.standardOptimizeOption(.{}); + const lib = b.addStaticLibrary(.{ + .name = "example", + .root_source_file = .{ .path = "src/main.zig" }, + .optimize = optimize, + }); lib.install(); - var main_tests = b.addTest("src/main.zig"); - main_tests.setBuildMode(mode); + const main_tests = b.addTest(.{ + .root_source_file = .{ .path = "src/main.zig" }, + .optimize = optimize, + }); const test_step = b.step("test", "Run library tests"); test_step.dependOn(&main_tests.step); @@ -10954,7 +10966,9 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { const lib = b.addSharedLibrary("mathtest", "mathtest.zig", b.version(1, 0, 0)); - const exe = b.addExecutable("test", null); + const exe = b.addExecutable(.{ + .name = "test", + }); exe.addCSourceFile("test.c", &[_][]const u8{"-std=c99"}); exe.linkLibrary(lib); exe.linkSystemLibrary("c"); @@ -11016,7 +11030,9 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { const obj = b.addObject("base64", "base64.zig"); - const exe = b.addExecutable("test", null); + const exe = b.addExecutable(.{ + .name = "test", + }); exe.addCSourceFile("test.c", &[_][]const u8{"-std=c99"}); exe.addObject(obj); exe.linkSystemLibrary("c"); diff --git a/lib/init-exe/build.zig b/lib/init-exe/build.zig index 29b50b5cc4..36e5feddec 100644 --- a/lib/init-exe/build.zig +++ b/lib/init-exe/build.zig @@ -1,5 +1,8 @@ const std = @import("std"); +// Although this function looks imperative, note that its job is to +// declaratively construct a build graph that will be executed by an external +// runner. pub fn build(b: *std.build.Builder) void { // Standard target options allows the person running `zig build` to choose // what target to build for. Here we do not override the defaults, which @@ -7,28 +10,58 @@ pub fn build(b: *std.build.Builder) void { // for restricting supported target set are available. const target = b.standardTargetOptions(.{}); - // Standard release options allow the person running `zig build` to select - // between Debug, ReleaseSafe, ReleaseFast, and ReleaseSmall. - const mode = b.standardReleaseOptions(); + // Standard optimization options allow the person running `zig build` to select + // between Debug, ReleaseSafe, ReleaseFast, and ReleaseSmall. Here we do not + // set a preferred release mode, allowing the user to decide how to optimize. + const optimize = b.standardOptimizeOption(); - const exe = b.addExecutable("$", "src/main.zig"); - exe.setTarget(target); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "$", + // In this case the main source file is merely a path, however, in more + // complicated build scripts, this could be a generated file. + .root_source_file = .{ .path = "src/main.zig" }, + .target = target, + .optimize = optimize, + }); + + // This declares intent for the executable to be installed into the + // standard location when the user invokes the "install" step (the default + // step when running `zig build`). exe.install(); + // This *creates* a RunStep in the build graph, to be executed when another + // step is evaluated that depends on it. The next line below will establish + // such a dependency. const run_cmd = exe.run(); + + // By making the run step depend on the install step, it will be run from the + // installation directory rather than directly from within the cache directory. + // This is not necessary, however, if the application depends on other installed + // files, this ensures they will be present and in the expected location. run_cmd.step.dependOn(b.getInstallStep()); + + // This allows the user to pass arguments to the application in the build + // command itself, like this: `zig build run -- arg1 arg2 etc` if (b.args) |args| { run_cmd.addArgs(args); } + // This creates a build step. It will be visible in the `zig build --help` menu, + // and can be selected like this: `zig build run` + // This will evaluate the `run` step rather than the default, which is "install". const run_step = b.step("run", "Run the app"); run_step.dependOn(&run_cmd.step); - const exe_tests = b.addTest("src/main.zig"); - exe_tests.setTarget(target); - exe_tests.setBuildMode(mode); + // Creates a step for unit testing. + const exe_tests = b.addTest(.{ + .root_source_file = .{ .path = "src/main.zig" }, + .target = target, + .optimize = optimize, + }); + // Similar to creating the run step earlier, this exposes a `test` step to + // the `zig build --help` menu, providing a way for the user to request + // running the unit tests. const test_step = b.step("test", "Run unit tests"); test_step.dependOn(&exe_tests.step); } diff --git a/lib/init-lib/build.zig b/lib/init-lib/build.zig index b3876691a2..4a7b700dc2 100644 --- a/lib/init-lib/build.zig +++ b/lib/init-lib/build.zig @@ -1,17 +1,44 @@ const std = @import("std"); +// Although this function looks imperative, note that its job is to +// declaratively construct a build graph that will be executed by an external +// runner. pub fn build(b: *std.build.Builder) void { - // Standard release options allow the person running `zig build` to select - // between Debug, ReleaseSafe, ReleaseFast, and ReleaseSmall. - const mode = b.standardReleaseOptions(); + // Standard target options allows the person running `zig build` to choose + // what target to build for. Here we do not override the defaults, which + // means any target is allowed, and the default is native. Other options + // for restricting supported target set are available. + const target = b.standardTargetOptions(.{}); - const lib = b.addStaticLibrary("$", "src/main.zig"); - lib.setBuildMode(mode); + // Standard optimization options allow the person running `zig build` to select + // between Debug, ReleaseSafe, ReleaseFast, and ReleaseSmall. Here we do not + // set a preferred release mode, allowing the user to decide how to optimize. + const optimize = b.standardOptimizeOption(); + + const lib = b.addStaticLibrary(.{ + .name = "$", + // In this case the main source file is merely a path, however, in more + // complicated build scripts, this could be a generated file. + .root_source_file = .{ .path = "src/main.zig" }, + .target = target, + .optimize = optimize, + }); + + // This declares intent for the library to be installed into the standard + // location when the user invokes the "install" step (the default step when + // running `zig build`). lib.install(); - const main_tests = b.addTest("src/main.zig"); - main_tests.setBuildMode(mode); + // Creates a step for unit testing. + const main_tests = b.addTest(.{ + .root_source_file = .{ .path = "src/main.zig" }, + .target = target, + .optimize = optimize, + }); + // This creates a build step. It will be visible in the `zig build --help` menu, + // and can be selected like this: `zig build test` + // This will evaluate the `test` step rather than the default, which is "install". const test_step = b.step("test", "Run library tests"); test_step.dependOn(&main_tests.step); } diff --git a/lib/std/build.zig b/lib/std/build.zig index a4ad599d93..4ee00a4710 100644 --- a/lib/std/build.zig +++ b/lib/std/build.zig @@ -420,10 +420,10 @@ pub const Builder = struct { pub const ExecutableOptions = struct { name: []const u8, - root_source_file: ?FileSource, + root_source_file: ?FileSource = null, version: ?std.builtin.Version = null, - target: CrossTarget, - optimize: std.builtin.Mode, + target: CrossTarget = .{}, + optimize: std.builtin.Mode = .Debug, linkage: ?LibExeObjStep.Linkage = null, }; @@ -436,13 +436,12 @@ pub const Builder = struct { .optimize = options.optimize, .kind = .exe, .linkage = options.linkage, - .version = options.version, }); } pub const ObjectOptions = struct { name: []const u8, - root_source_file: ?FileSource, + root_source_file: ?FileSource = null, target: CrossTarget, optimize: std.builtin.Mode, }; @@ -459,7 +458,7 @@ pub const Builder = struct { pub const SharedLibraryOptions = struct { name: []const u8, - root_source_file: ?FileSource, + root_source_file: ?FileSource = null, version: ?std.builtin.Version = null, target: CrossTarget, optimize: std.builtin.Mode, @@ -501,8 +500,8 @@ pub const Builder = struct { name: []const u8 = "test", kind: LibExeObjStep.Kind = .@"test", root_source_file: FileSource, - target: CrossTarget, - optimize: std.builtin.Mode, + target: CrossTarget = .{}, + optimize: std.builtin.Mode = .Debug, version: ?std.builtin.Version = null, }; @@ -630,8 +629,8 @@ pub const Builder = struct { return FmtStep.create(self, paths); } - pub fn addTranslateC(self: *Builder, source: FileSource) *TranslateCStep { - return TranslateCStep.create(self, source.dupe(self)); + pub fn addTranslateC(self: *Builder, options: TranslateCStep.Options) *TranslateCStep { + return TranslateCStep.create(self, options); } pub fn make(self: *Builder, step_names: []const []const u8) !void { diff --git a/lib/std/build/TranslateCStep.zig b/lib/std/build/TranslateCStep.zig index 1f9bee463c..9f45d606a1 100644 --- a/lib/std/build/TranslateCStep.zig +++ b/lib/std/build/TranslateCStep.zig @@ -19,11 +19,19 @@ include_dirs: std.ArrayList([]const u8), c_macros: std.ArrayList([]const u8), output_dir: ?[]const u8, out_basename: []const u8, -target: CrossTarget = CrossTarget{}, +target: CrossTarget, +optimize: std.builtin.OptimizeMode, output_file: build.GeneratedFile, -pub fn create(builder: *Builder, source: build.FileSource) *TranslateCStep { +pub const Options = struct { + source_file: build.FileSource, + target: CrossTarget, + optimize: std.builtin.OptimizeMode, +}; + +pub fn create(builder: *Builder, options: Options) *TranslateCStep { const self = builder.allocator.create(TranslateCStep) catch unreachable; + const source = options.source_file.dupe(builder); self.* = TranslateCStep{ .step = Step.init(.translate_c, "translate-c", builder.allocator, make), .builder = builder, @@ -32,19 +40,32 @@ pub fn create(builder: *Builder, source: build.FileSource) *TranslateCStep { .c_macros = std.ArrayList([]const u8).init(builder.allocator), .output_dir = null, .out_basename = undefined, + .target = options.target, + .optimize = options.optimize, .output_file = build.GeneratedFile{ .step = &self.step }, }; source.addStepDependencies(&self.step); return self; } -pub fn setTarget(self: *TranslateCStep, target: CrossTarget) void { - self.target = target; -} +pub const AddExecutableOptions = struct { + name: ?[]const u8 = null, + version: ?std.builtin.Version = null, + target: ?CrossTarget = null, + optimize: ?std.builtin.Mode = null, + linkage: ?LibExeObjStep.Linkage = null, +}; /// Creates a step to build an executable from the translated source. -pub fn addExecutable(self: *TranslateCStep) *LibExeObjStep { - return self.builder.addExecutableSource("translated_c", build.FileSource{ .generated = &self.output_file }); +pub fn addExecutable(self: *TranslateCStep, options: AddExecutableOptions) *LibExeObjStep { + return self.builder.addExecutable(.{ + .root_source_file = .{ .generated = &self.output_file }, + .name = options.name orelse "translated_c", + .version = options.version, + .target = options.target orelse self.target, + .optimize = options.optimize orelse self.optimize, + .linkage = options.linkage, + }); } pub fn addIncludeDir(self: *TranslateCStep, include_dir: []const u8) void { @@ -82,6 +103,11 @@ fn make(step: *Step) !void { try argv_list.append(try self.target.zigTriple(self.builder.allocator)); } + switch (self.optimize) { + .Debug => {}, // Skip since it's the default. + else => try argv_list.append(self.builder.fmt("-O{s}", .{@tagName(self.optimize)})), + } + for (self.include_dirs.items) |include_dir| { try argv_list.append("-I"); try argv_list.append(include_dir); diff --git a/lib/std/builtin.zig b/lib/std/builtin.zig index 4d949946d8..74c61d229b 100644 --- a/lib/std/builtin.zig +++ b/lib/std/builtin.zig @@ -131,13 +131,16 @@ pub const CodeModel = enum { /// This data structure is used by the Zig language code generation and /// therefore must be kept in sync with the compiler implementation. -pub const Mode = enum { +pub const OptimizeMode = enum { Debug, ReleaseSafe, ReleaseFast, ReleaseSmall, }; +/// Deprecated; use OptimizeMode. +pub const Mode = OptimizeMode; + /// This data structure is used by the Zig language code generation and /// therefore must be kept in sync with the compiler implementation. pub const CallingConvention = enum { diff --git a/src/link/MachO/zld.zig b/src/link/MachO/zld.zig index 4cb346aa47..81fae399ef 100644 --- a/src/link/MachO/zld.zig +++ b/src/link/MachO/zld.zig @@ -3596,7 +3596,8 @@ pub fn linkWithZld(macho_file: *MachO, comp: *Compilation, prog_node: *std.Progr man.hash.addOptionalBytes(options.sysroot); try man.addOptionalFile(options.entitlements); - // We don't actually care whether it's a cache hit or miss; we just need the digest and the lock. + // We don't actually care whether it's a cache hit or miss; we just + // need the digest and the lock. _ = try man.hit(); digest = man.final(); @@ -4177,9 +4178,11 @@ pub fn linkWithZld(macho_file: *MachO, comp: *Compilation, prog_node: *std.Progr log.debug("failed to save linking hash digest file: {s}", .{@errorName(err)}); }; // Again failure here only means an unnecessary cache miss. - man.writeManifest() catch |err| { - log.debug("failed to write cache manifest when linking: {s}", .{@errorName(err)}); - }; + if (man.have_exclusive_lock) { + man.writeManifest() catch |err| { + log.debug("failed to write cache manifest when linking: {s}", .{@errorName(err)}); + }; + } // We hang on to this lock so that the output file path can be used without // other processes clobbering it. macho_file.base.lock = man.toOwnedLock(); diff --git a/test/link/bss/build.zig b/test/link/bss/build.zig index 76e9bdb305..c31fa7faf5 100644 --- a/test/link/bss/build.zig +++ b/test/link/bss/build.zig @@ -1,12 +1,15 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test"); - const exe = b.addExecutable("bss", "main.zig"); + const exe = b.addExecutable(.{ + .name = "bss", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + }); b.default_step.dependOn(&exe.step); - exe.setBuildMode(mode); const run = exe.run(); run.expectStdOutEqual("0, 1, 0\n"); diff --git a/test/link/common_symbols/build.zig b/test/link/common_symbols/build.zig index 2f9f892e86..068c3f9c57 100644 --- a/test/link/common_symbols/build.zig +++ b/test/link/common_symbols/build.zig @@ -1,14 +1,19 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); - const lib_a = b.addStaticLibrary("a", null); + const lib_a = b.addStaticLibrary(.{ + .name = "a", + .optimize = optimize, + .target = .{}, + }); lib_a.addCSourceFiles(&.{ "c.c", "a.c", "b.c" }, &.{"-fcommon"}); - lib_a.setBuildMode(mode); - const test_exe = b.addTest("main.zig"); - test_exe.setBuildMode(mode); + const test_exe = b.addTest(.{ + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + }); test_exe.linkLibrary(lib_a); const test_step = b.step("test", "Test it"); diff --git a/test/link/common_symbols_alignment/build.zig b/test/link/common_symbols_alignment/build.zig index a62d86af4f..b6dd39801c 100644 --- a/test/link/common_symbols_alignment/build.zig +++ b/test/link/common_symbols_alignment/build.zig @@ -1,14 +1,21 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); + const target = b.standardTargetOptions(.{}); - const lib_a = b.addStaticLibrary("a", null); + const lib_a = b.addStaticLibrary(.{ + .name = "a", + .optimize = optimize, + .target = target, + }); lib_a.addCSourceFiles(&.{"a.c"}, &.{"-fcommon"}); - lib_a.setBuildMode(mode); - const test_exe = b.addTest("main.zig"); - test_exe.setBuildMode(mode); + const test_exe = b.addTest(.{ + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = target, + }); test_exe.linkLibrary(lib_a); const test_step = b.step("test", "Test it"); diff --git a/test/link/interdependent_static_c_libs/build.zig b/test/link/interdependent_static_c_libs/build.zig index bd1b6100da..50a214490d 100644 --- a/test/link/interdependent_static_c_libs/build.zig +++ b/test/link/interdependent_static_c_libs/build.zig @@ -1,20 +1,30 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); + const target = b.standardTargetOptions(.{}); - const lib_a = b.addStaticLibrary("a", null); + const lib_a = b.addStaticLibrary(.{ + .name = "a", + .optimize = optimize, + .target = target, + }); lib_a.addCSourceFile("a.c", &[_][]const u8{}); - lib_a.setBuildMode(mode); lib_a.addIncludePath("."); - const lib_b = b.addStaticLibrary("b", null); + const lib_b = b.addStaticLibrary(.{ + .name = "b", + .optimize = optimize, + .target = target, + }); lib_b.addCSourceFile("b.c", &[_][]const u8{}); - lib_b.setBuildMode(mode); lib_b.addIncludePath("."); - const test_exe = b.addTest("main.zig"); - test_exe.setBuildMode(mode); + const test_exe = b.addTest(.{ + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = target, + }); test_exe.linkLibrary(lib_a); test_exe.linkLibrary(lib_b); test_exe.addIncludePath("."); diff --git a/test/link/macho/bugs/13056/build.zig b/test/link/macho/bugs/13056/build.zig index 751a7c4db6..a65cd60766 100644 --- a/test/link/macho/bugs/13056/build.zig +++ b/test/link/macho/bugs/13056/build.zig @@ -2,7 +2,7 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; const target_info = std.zig.system.NativeTargetInfo.detect(target) catch unreachable; @@ -11,7 +11,10 @@ pub fn build(b: *Builder) void { const test_step = b.step("test", "Test the program"); - const exe = b.addExecutable("test", null); + const exe = b.addExecutable(.{ + .name = "test", + .optimize = optimize, + }); b.default_step.dependOn(&exe.step); exe.addIncludePath(std.fs.path.join(b.allocator, &.{ sdk.path, "/usr/include" }) catch unreachable); exe.addIncludePath(std.fs.path.join(b.allocator, &.{ sdk.path, "/usr/include/c++/v1" }) catch unreachable); @@ -20,7 +23,6 @@ pub fn build(b: *Builder) void { "-nostdinc++", }); exe.addObjectFile(std.fs.path.join(b.allocator, &.{ sdk.path, "/usr/lib/libc++.tbd" }) catch unreachable); - exe.setBuildMode(mode); const run_cmd = exe.run(); run_cmd.expectStdErrEqual("x: 5\n"); diff --git a/test/link/macho/bugs/13457/build.zig b/test/link/macho/bugs/13457/build.zig index 2de8c01c6a..4c1ce89261 100644 --- a/test/link/macho/bugs/13457/build.zig +++ b/test/link/macho/bugs/13457/build.zig @@ -3,14 +3,17 @@ const Builder = std.build.Builder; const LibExeObjectStep = std.build.LibExeObjStep; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; const test_step = b.step("test", "Test the program"); - const exe = b.addExecutable("test", "main.zig"); - exe.setBuildMode(mode); - exe.setTarget(target); + const exe = b.addExecutable(.{ + .name = "test", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = target, + }); const run = exe.runEmulatable(); test_step.dependOn(&run.step); diff --git a/test/link/macho/dead_strip/build.zig b/test/link/macho/dead_strip/build.zig index 25759f5619..a4c3575e45 100644 --- a/test/link/macho/dead_strip/build.zig +++ b/test/link/macho/dead_strip/build.zig @@ -3,7 +3,7 @@ const Builder = std.build.Builder; const LibExeObjectStep = std.build.LibExeObjStep; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; const test_step = b.step("test", "Test the program"); @@ -11,7 +11,7 @@ pub fn build(b: *Builder) void { { // Without -dead_strip, we expect `iAmUnused` symbol present - const exe = createScenario(b, mode, target); + const exe = createScenario(b, optimize, target); const check = exe.checkObject(.macho); check.checkInSymtab(); @@ -24,7 +24,7 @@ pub fn build(b: *Builder) void { { // With -dead_strip, no `iAmUnused` symbol should be present - const exe = createScenario(b, mode, target); + const exe = createScenario(b, optimize, target); exe.link_gc_sections = true; const check = exe.checkObject(.macho); @@ -37,11 +37,13 @@ pub fn build(b: *Builder) void { } } -fn createScenario(b: *Builder, mode: std.builtin.Mode, target: std.zig.CrossTarget) *LibExeObjectStep { - const exe = b.addExecutable("test", null); +fn createScenario(b: *Builder, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { + const exe = b.addExecutable(.{ + .name = "test", + .optimize = optimize, + .target = target, + }); exe.addCSourceFile("main.c", &[0][]const u8{}); - exe.setBuildMode(mode); - exe.setTarget(target); exe.linkLibC(); return exe; } diff --git a/test/link/macho/dead_strip_dylibs/build.zig b/test/link/macho/dead_strip_dylibs/build.zig index efdaf191bd..0127b575fc 100644 --- a/test/link/macho/dead_strip_dylibs/build.zig +++ b/test/link/macho/dead_strip_dylibs/build.zig @@ -3,14 +3,14 @@ const Builder = std.build.Builder; const LibExeObjectStep = std.build.LibExeObjStep; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test the program"); test_step.dependOn(b.getInstallStep()); { // Without -dead_strip_dylibs we expect `-la` to include liba.dylib in the final executable - const exe = createScenario(b, mode); + const exe = createScenario(b, optimize); const check = exe.checkObject(.macho); check.checkStart("cmd LOAD_DYLIB"); @@ -27,7 +27,7 @@ pub fn build(b: *Builder) void { { // With -dead_strip_dylibs, we should include liba.dylib as it's unreachable - const exe = createScenario(b, mode); + const exe = createScenario(b, optimize); exe.dead_strip_dylibs = true; const run_cmd = exe.run(); @@ -36,10 +36,12 @@ pub fn build(b: *Builder) void { } } -fn createScenario(b: *Builder, mode: std.builtin.Mode) *LibExeObjectStep { - const exe = b.addExecutable("test", null); +fn createScenario(b: *Builder, optimize: std.builtin.OptimizeMode) *LibExeObjectStep { + const exe = b.addExecutable(.{ + .name = "test", + .optimize = optimize, + }); exe.addCSourceFile("main.c", &[0][]const u8{}); - exe.setBuildMode(mode); exe.linkLibC(); exe.linkFramework("Cocoa"); return exe; diff --git a/test/link/macho/dylib/build.zig b/test/link/macho/dylib/build.zig index a5baf255c6..acd27a507f 100644 --- a/test/link/macho/dylib/build.zig +++ b/test/link/macho/dylib/build.zig @@ -2,15 +2,18 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); - const dylib = b.addSharedLibrary("a", null, b.version(1, 0, 0)); - dylib.setBuildMode(mode); - dylib.setTarget(target); + const dylib = b.addSharedLibrary(.{ + .name = "a", + .version = .{ .major = 1, .minor = 0 }, + .optimize = optimize, + .target = target, + }); dylib.addCSourceFile("a.c", &.{}); dylib.linkLibC(); dylib.install(); @@ -24,9 +27,11 @@ pub fn build(b: *Builder) void { test_step.dependOn(&check_dylib.step); - const exe = b.addExecutable("main", null); - exe.setTarget(target); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "main", + .optimize = optimize, + .target = target, + }); exe.addCSourceFile("main.c", &.{}); exe.linkSystemLibrary("a"); exe.linkLibC(); diff --git a/test/link/macho/empty/build.zig b/test/link/macho/empty/build.zig index ab016fd4bd..8b2d047371 100644 --- a/test/link/macho/empty/build.zig +++ b/test/link/macho/empty/build.zig @@ -2,17 +2,19 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; const test_step = b.step("test", "Test the program"); test_step.dependOn(b.getInstallStep()); - const exe = b.addExecutable("test", null); + const exe = b.addExecutable(.{ + .name = "test", + .optimize = optimize, + .target = target, + }); exe.addCSourceFile("main.c", &[0][]const u8{}); exe.addCSourceFile("empty.c", &[0][]const u8{}); - exe.setBuildMode(mode); - exe.setTarget(target); exe.linkLibC(); const run_cmd = std.build.EmulatableRunStep.create(b, "run", exe); diff --git a/test/link/macho/entry/build.zig b/test/link/macho/entry/build.zig index 0ecca14aa2..87e4d1b5da 100644 --- a/test/link/macho/entry/build.zig +++ b/test/link/macho/entry/build.zig @@ -2,14 +2,16 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); - const exe = b.addExecutable("main", null); - exe.setTarget(.{ .os_tag = .macos }); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "main", + .optimize = optimize, + .target = .{ .os_tag = .macos }, + }); exe.addCSourceFile("main.c", &.{}); exe.linkLibC(); exe.entry_symbol_name = "_non_main"; diff --git a/test/link/macho/headerpad/build.zig b/test/link/macho/headerpad/build.zig index 0730a01d44..74efb5d580 100644 --- a/test/link/macho/headerpad/build.zig +++ b/test/link/macho/headerpad/build.zig @@ -4,14 +4,14 @@ const Builder = std.build.Builder; const LibExeObjectStep = std.build.LibExeObjStep; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); { // Test -headerpad_max_install_names - const exe = simpleExe(b, mode); + const exe = simpleExe(b, optimize); exe.headerpad_max_install_names = true; const check = exe.checkObject(.macho); @@ -36,7 +36,7 @@ pub fn build(b: *Builder) void { { // Test -headerpad - const exe = simpleExe(b, mode); + const exe = simpleExe(b, optimize); exe.headerpad_size = 0x10000; const check = exe.checkObject(.macho); @@ -52,7 +52,7 @@ pub fn build(b: *Builder) void { { // Test both flags with -headerpad overriding -headerpad_max_install_names - const exe = simpleExe(b, mode); + const exe = simpleExe(b, optimize); exe.headerpad_max_install_names = true; exe.headerpad_size = 0x10000; @@ -69,7 +69,7 @@ pub fn build(b: *Builder) void { { // Test both flags with -headerpad_max_install_names overriding -headerpad - const exe = simpleExe(b, mode); + const exe = simpleExe(b, optimize); exe.headerpad_size = 0x1000; exe.headerpad_max_install_names = true; @@ -94,9 +94,11 @@ pub fn build(b: *Builder) void { } } -fn simpleExe(b: *Builder, mode: std.builtin.Mode) *LibExeObjectStep { - const exe = b.addExecutable("main", null); - exe.setBuildMode(mode); +fn simpleExe(b: *Builder, optimize: std.builtin.OptimizeMode) *LibExeObjectStep { + const exe = b.addExecutable(.{ + .name = "main", + .optimize = optimize, + }); exe.addCSourceFile("main.c", &.{}); exe.linkLibC(); exe.linkFramework("CoreFoundation"); diff --git a/test/link/macho/linksection/build.zig b/test/link/macho/linksection/build.zig index 9204499803..eebb31a21e 100644 --- a/test/link/macho/linksection/build.zig +++ b/test/link/macho/linksection/build.zig @@ -1,15 +1,18 @@ const std = @import("std"); pub fn build(b: *std.build.Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target = std.zig.CrossTarget{ .os_tag = .macos }; const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); - const obj = b.addObject("test", "main.zig"); - obj.setBuildMode(mode); - obj.setTarget(target); + const obj = b.addObject(.{ + .name = "test", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = target, + }); const check = obj.checkObject(.macho); @@ -19,7 +22,7 @@ pub fn build(b: *std.build.Builder) void { check.checkInSymtab(); check.checkNext("{*} (__TEXT,__TestFn) external _testFn"); - if (mode == .Debug) { + if (optimize == .Debug) { check.checkInSymtab(); check.checkNext("{*} (__TEXT,__TestGenFnA) _main.testGenericFn__anon_{*}"); } diff --git a/test/link/macho/needed_framework/build.zig b/test/link/macho/needed_framework/build.zig index 4315935941..33965a9272 100644 --- a/test/link/macho/needed_framework/build.zig +++ b/test/link/macho/needed_framework/build.zig @@ -3,16 +3,18 @@ const Builder = std.build.Builder; const LibExeObjectStep = std.build.LibExeObjStep; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test the program"); test_step.dependOn(b.getInstallStep()); // -dead_strip_dylibs // -needed_framework Cocoa - const exe = b.addExecutable("test", null); + const exe = b.addExecutable(.{ + .name = "test", + .optimize = optimize, + }); exe.addCSourceFile("main.c", &[0][]const u8{}); - exe.setBuildMode(mode); exe.linkLibC(); exe.linkFrameworkNeeded("Cocoa"); exe.dead_strip_dylibs = true; diff --git a/test/link/macho/needed_library/build.zig b/test/link/macho/needed_library/build.zig index a314fd2201..137239d292 100644 --- a/test/link/macho/needed_library/build.zig +++ b/test/link/macho/needed_library/build.zig @@ -3,25 +3,30 @@ const Builder = std.build.Builder; const LibExeObjectStep = std.build.LibExeObjStep; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; const test_step = b.step("test", "Test the program"); test_step.dependOn(b.getInstallStep()); - const dylib = b.addSharedLibrary("a", null, b.version(1, 0, 0)); - dylib.setTarget(target); - dylib.setBuildMode(mode); + const dylib = b.addSharedLibrary(.{ + .name = "a", + .version = .{ .major = 1, .minor = 0 }, + .optimize = optimize, + .target = target, + }); dylib.addCSourceFile("a.c", &.{}); dylib.linkLibC(); dylib.install(); // -dead_strip_dylibs // -needed-la - const exe = b.addExecutable("test", null); + const exe = b.addExecutable(.{ + .name = "test", + .optimize = optimize, + .target = target, + }); exe.addCSourceFile("main.c", &[0][]const u8{}); - exe.setBuildMode(mode); - exe.setTarget(target); exe.linkLibC(); exe.linkSystemLibraryNeeded("a"); exe.addLibraryPath(b.pathFromRoot("zig-out/lib")); diff --git a/test/link/macho/objc/build.zig b/test/link/macho/objc/build.zig index d7fd872f77..9c38739a5c 100644 --- a/test/link/macho/objc/build.zig +++ b/test/link/macho/objc/build.zig @@ -2,15 +2,17 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test the program"); - const exe = b.addExecutable("test", null); + const exe = b.addExecutable(.{ + .name = "test", + .optimize = optimize, + }); exe.addIncludePath("."); exe.addCSourceFile("Foo.m", &[0][]const u8{}); exe.addCSourceFile("test.m", &[0][]const u8{}); - exe.setBuildMode(mode); exe.linkLibC(); // TODO when we figure out how to ship framework stubs for cross-compilation, // populate paths to the sysroot here. diff --git a/test/link/macho/objcpp/build.zig b/test/link/macho/objcpp/build.zig index 767578e225..f4c88b2862 100644 --- a/test/link/macho/objcpp/build.zig +++ b/test/link/macho/objcpp/build.zig @@ -2,16 +2,18 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test the program"); - const exe = b.addExecutable("test", null); + const exe = b.addExecutable(.{ + .name = "test", + .optimize = optimize, + }); b.default_step.dependOn(&exe.step); exe.addIncludePath("."); exe.addCSourceFile("Foo.mm", &[0][]const u8{}); exe.addCSourceFile("test.mm", &[0][]const u8{}); - exe.setBuildMode(mode); exe.linkLibCpp(); // TODO when we figure out how to ship framework stubs for cross-compilation, // populate paths to the sysroot here. diff --git a/test/link/macho/pagezero/build.zig b/test/link/macho/pagezero/build.zig index 5a7044d960..f61aa34a93 100644 --- a/test/link/macho/pagezero/build.zig +++ b/test/link/macho/pagezero/build.zig @@ -2,16 +2,18 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); { - const exe = b.addExecutable("pagezero", null); - exe.setTarget(target); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "pagezero", + .optimize = optimize, + .target = target, + }); exe.addCSourceFile("main.c", &.{}); exe.linkLibC(); exe.pagezero_size = 0x4000; @@ -29,9 +31,11 @@ pub fn build(b: *Builder) void { } { - const exe = b.addExecutable("no_pagezero", null); - exe.setTarget(target); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "no_pagezero", + .optimize = optimize, + .target = target, + }); exe.addCSourceFile("main.c", &.{}); exe.linkLibC(); exe.pagezero_size = 0; diff --git a/test/link/macho/search_strategy/build.zig b/test/link/macho/search_strategy/build.zig index e556b5bb23..db894b6ae3 100644 --- a/test/link/macho/search_strategy/build.zig +++ b/test/link/macho/search_strategy/build.zig @@ -3,7 +3,7 @@ const Builder = std.build.Builder; const LibExeObjectStep = std.build.LibExeObjStep; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; const test_step = b.step("test", "Test"); @@ -11,7 +11,7 @@ pub fn build(b: *Builder) void { { // -search_dylibs_first - const exe = createScenario(b, mode, target); + const exe = createScenario(b, optimize, target); exe.search_strategy = .dylibs_first; const check = exe.checkObject(.macho); @@ -26,7 +26,7 @@ pub fn build(b: *Builder) void { { // -search_paths_first - const exe = createScenario(b, mode, target); + const exe = createScenario(b, optimize, target); exe.search_strategy = .paths_first; const run = std.build.EmulatableRunStep.create(b, "run", exe); @@ -36,10 +36,12 @@ pub fn build(b: *Builder) void { } } -fn createScenario(b: *Builder, mode: std.builtin.Mode, target: std.zig.CrossTarget) *LibExeObjectStep { - const static = b.addStaticLibrary("a", null); - static.setTarget(target); - static.setBuildMode(mode); +fn createScenario(b: *Builder, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { + const static = b.addStaticLibrary(.{ + .name = "a", + .optimize = optimize, + .target = target, + }); static.addCSourceFile("a.c", &.{}); static.linkLibC(); static.override_dest_dir = std.build.InstallDir{ @@ -47,9 +49,12 @@ fn createScenario(b: *Builder, mode: std.builtin.Mode, target: std.zig.CrossTarg }; static.install(); - const dylib = b.addSharedLibrary("a", null, b.version(1, 0, 0)); - dylib.setTarget(target); - dylib.setBuildMode(mode); + const dylib = b.addSharedLibrary(.{ + .name = "a", + .version = .{ .major = 1, .minor = 0 }, + .optimize = optimize, + .target = target, + }); dylib.addCSourceFile("a.c", &.{}); dylib.linkLibC(); dylib.override_dest_dir = std.build.InstallDir{ @@ -57,9 +62,11 @@ fn createScenario(b: *Builder, mode: std.builtin.Mode, target: std.zig.CrossTarg }; dylib.install(); - const exe = b.addExecutable("main", null); - exe.setTarget(target); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "main", + .optimize = optimize, + .target = target, + }); exe.addCSourceFile("main.c", &.{}); exe.linkSystemLibraryName("a"); exe.linkLibC(); diff --git a/test/link/macho/stack_size/build.zig b/test/link/macho/stack_size/build.zig index 91c44baf52..74e9a86e94 100644 --- a/test/link/macho/stack_size/build.zig +++ b/test/link/macho/stack_size/build.zig @@ -2,15 +2,17 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); - const exe = b.addExecutable("main", null); - exe.setTarget(target); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "main", + .optimize = optimize, + .target = target, + }); exe.addCSourceFile("main.c", &.{}); exe.linkLibC(); exe.stack_size = 0x100000000; diff --git a/test/link/macho/strict_validation/build.zig b/test/link/macho/strict_validation/build.zig index 0ea150252c..b6baf63c11 100644 --- a/test/link/macho/strict_validation/build.zig +++ b/test/link/macho/strict_validation/build.zig @@ -4,15 +4,18 @@ const Builder = std.build.Builder; const LibExeObjectStep = std.build.LibExeObjStep; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); - const exe = b.addExecutable("main", "main.zig"); - exe.setBuildMode(mode); - exe.setTarget(target); + const exe = b.addExecutable(.{ + .name = "main", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = target, + }); exe.linkLibC(); const check_exe = exe.checkObject(.macho); diff --git a/test/link/macho/tls/build.zig b/test/link/macho/tls/build.zig index 031a05cedf..9b2fe952bf 100644 --- a/test/link/macho/tls/build.zig +++ b/test/link/macho/tls/build.zig @@ -2,18 +2,23 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; - const lib = b.addSharedLibrary("a", null, b.version(1, 0, 0)); - lib.setBuildMode(mode); - lib.setTarget(target); + const lib = b.addSharedLibrary(.{ + .name = "a", + .version = .{ .major = 1, .minor = 0 }, + .optimize = optimize, + .target = target, + }); lib.addCSourceFile("a.c", &.{}); lib.linkLibC(); - const test_exe = b.addTest("main.zig"); - test_exe.setBuildMode(mode); - test_exe.setTarget(target); + const test_exe = b.addTest(.{ + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = target, + }); test_exe.linkLibrary(lib); test_exe.linkLibC(); diff --git a/test/link/macho/unwind_info/build.zig b/test/link/macho/unwind_info/build.zig index cc00854465..dbbdbb3e51 100644 --- a/test/link/macho/unwind_info/build.zig +++ b/test/link/macho/unwind_info/build.zig @@ -4,23 +4,23 @@ const Builder = std.build.Builder; const LibExeObjectStep = std.build.LibExeObjStep; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; const test_step = b.step("test", "Test the program"); - testUnwindInfo(b, test_step, mode, target, false); - testUnwindInfo(b, test_step, mode, target, true); + testUnwindInfo(b, test_step, optimize, target, false); + testUnwindInfo(b, test_step, optimize, target, true); } fn testUnwindInfo( b: *Builder, test_step: *std.build.Step, - mode: std.builtin.Mode, + optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget, dead_strip: bool, ) void { - const exe = createScenario(b, mode, target); + const exe = createScenario(b, optimize, target); exe.link_gc_sections = dead_strip; const check = exe.checkObject(.macho); @@ -52,8 +52,12 @@ fn testUnwindInfo( test_step.dependOn(&run_cmd.step); } -fn createScenario(b: *Builder, mode: std.builtin.Mode, target: std.zig.CrossTarget) *LibExeObjectStep { - const exe = b.addExecutable("test", null); +fn createScenario(b: *Builder, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { + const exe = b.addExecutable(.{ + .name = "test", + .optimize = optimize, + .target = target, + }); b.default_step.dependOn(&exe.step); exe.addIncludePath("."); exe.addCSourceFiles(&[_][]const u8{ @@ -61,8 +65,6 @@ fn createScenario(b: *Builder, mode: std.builtin.Mode, target: std.zig.CrossTarg "simple_string.cpp", "simple_string_owner.cpp", }, &[0][]const u8{}); - exe.setBuildMode(mode); - exe.setTarget(target); exe.linkLibCpp(); return exe; } diff --git a/test/link/macho/uuid/build.zig b/test/link/macho/uuid/build.zig index 314febdb20..86ff99e8b1 100644 --- a/test/link/macho/uuid/build.zig +++ b/test/link/macho/uuid/build.zig @@ -29,21 +29,21 @@ pub fn build(b: *Builder) void { fn testUuid( b: *Builder, test_step: *std.build.Step, - mode: std.builtin.Mode, + optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget, comptime exp: []const u8, ) void { // The calculated UUID value is independent of debug info and so it should // stay the same across builds. { - const dylib = simpleDylib(b, mode, target); + const dylib = simpleDylib(b, optimize, target); const check_dylib = dylib.checkObject(.macho); check_dylib.checkStart("cmd UUID"); check_dylib.checkNext("uuid " ++ exp); test_step.dependOn(&check_dylib.step); } { - const dylib = simpleDylib(b, mode, target); + const dylib = simpleDylib(b, optimize, target); dylib.strip = true; const check_dylib = dylib.checkObject(.macho); check_dylib.checkStart("cmd UUID"); @@ -52,10 +52,13 @@ fn testUuid( } } -fn simpleDylib(b: *Builder, mode: std.builtin.Mode, target: std.zig.CrossTarget) *LibExeObjectStep { - const dylib = b.addSharedLibrary("test", null, b.version(1, 0, 0)); - dylib.setTarget(target); - dylib.setBuildMode(mode); +fn simpleDylib(b: *Builder, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { + const dylib = b.addSharedLibrary(.{ + .name = "test", + .version = .{ .major = 1, .minor = 0 }, + .optimize = optimize, + .target = target, + }); dylib.addCSourceFile("test.c", &.{}); dylib.linkLibC(); return dylib; diff --git a/test/link/macho/weak_framework/build.zig b/test/link/macho/weak_framework/build.zig index 44675a15f8..f8460c4e82 100644 --- a/test/link/macho/weak_framework/build.zig +++ b/test/link/macho/weak_framework/build.zig @@ -3,14 +3,16 @@ const Builder = std.build.Builder; const LibExeObjectStep = std.build.LibExeObjStep; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test the program"); test_step.dependOn(b.getInstallStep()); - const exe = b.addExecutable("test", null); + const exe = b.addExecutable(.{ + .name = "test", + .optimize = optimize, + }); exe.addCSourceFile("main.c", &[0][]const u8{}); - exe.setBuildMode(mode); exe.linkLibC(); exe.linkFrameworkWeak("Cocoa"); diff --git a/test/link/macho/weak_library/build.zig b/test/link/macho/weak_library/build.zig index 79f67bd7df..229d965e48 100644 --- a/test/link/macho/weak_library/build.zig +++ b/test/link/macho/weak_library/build.zig @@ -3,23 +3,28 @@ const Builder = std.build.Builder; const LibExeObjectStep = std.build.LibExeObjStep; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; const test_step = b.step("test", "Test the program"); test_step.dependOn(b.getInstallStep()); - const dylib = b.addSharedLibrary("a", null, b.version(1, 0, 0)); - dylib.setTarget(target); - dylib.setBuildMode(mode); + const dylib = b.addSharedLibrary(.{ + .name = "a", + .version = .{ .major = 1, .minor = 0, .patch = 0 }, + .target = target, + .optimize = optimize, + }); dylib.addCSourceFile("a.c", &.{}); dylib.linkLibC(); dylib.install(); - const exe = b.addExecutable("test", null); + const exe = b.addExecutable(.{ + .name = "test", + .target = target, + .optimize = optimize, + }); exe.addCSourceFile("main.c", &[0][]const u8{}); - exe.setTarget(target); - exe.setBuildMode(mode); exe.linkLibC(); exe.linkSystemLibraryWeak("a"); exe.addLibraryPath(b.pathFromRoot("zig-out/lib")); diff --git a/test/link/static_lib_as_system_lib/build.zig b/test/link/static_lib_as_system_lib/build.zig index f39f3fac2a..895cdcf316 100644 --- a/test/link/static_lib_as_system_lib/build.zig +++ b/test/link/static_lib_as_system_lib/build.zig @@ -2,16 +2,23 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); + const target = b.standardTargetOptions(.{}); - const lib_a = b.addStaticLibrary("a", null); + const lib_a = b.addStaticLibrary(.{ + .name = "a", + .optimize = optimize, + .target = target, + }); lib_a.addCSourceFile("a.c", &[_][]const u8{}); - lib_a.setBuildMode(mode); lib_a.addIncludePath("."); lib_a.install(); - const test_exe = b.addTest("main.zig"); - test_exe.setBuildMode(mode); + const test_exe = b.addTest(.{ + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = target, + }); test_exe.linkSystemLibrary("a"); // force linking liba.a as -la test_exe.addSystemIncludePath("."); const search_path = std.fs.path.join(b.allocator, &[_][]const u8{ b.install_path, "lib" }) catch unreachable; diff --git a/test/link/wasm/archive/build.zig b/test/link/wasm/archive/build.zig index 7efa88999a..7401ba22dc 100644 --- a/test/link/wasm/archive/build.zig +++ b/test/link/wasm/archive/build.zig @@ -2,16 +2,17 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); - const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); // The code in question will pull-in compiler-rt, // and therefore link with its archive file. - const lib = b.addSharedLibrary("main", "main.zig", .unversioned); - lib.setBuildMode(mode); - lib.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); + const lib = b.addSharedLibrary(.{ + .name = "main", + .root_source_file = .{ .path = "main.zig" }, + .optimize = b.standardOptimizeOption(.{}), + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + }); lib.use_llvm = false; lib.use_lld = false; lib.strip = false; diff --git a/test/link/wasm/basic-features/build.zig b/test/link/wasm/basic-features/build.zig index 2c565f9263..69e88aefae 100644 --- a/test/link/wasm/basic-features/build.zig +++ b/test/link/wasm/basic-features/build.zig @@ -1,14 +1,18 @@ const std = @import("std"); pub fn build(b: *std.build.Builder) void { - const mode = b.standardReleaseOptions(); - // Library with explicitly set cpu features - const lib = b.addSharedLibrary("lib", "main.zig", .unversioned); - lib.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); - lib.target.cpu_model = .{ .explicit = &std.Target.wasm.cpu.mvp }; - lib.target.cpu_features_add.addFeature(0); // index 0 == atomics (see std.Target.wasm.Features) - lib.setBuildMode(mode); + const lib = b.addSharedLibrary(.{ + .name = "lib", + .root_source_file = .{ .path = "main.zig" }, + .optimize = b.standardOptimizeOption(.{}), + .target = .{ + .cpu_arch = .wasm32, + .cpu_model = .{ .explicit = &std.Target.wasm.cpu.mvp }, + .cpu_features_add = std.Target.wasm.featureSet(&.{.atomics}), + .os_tag = .freestanding, + }, + }); lib.use_llvm = false; lib.use_lld = false; diff --git a/test/link/wasm/bss/build.zig b/test/link/wasm/bss/build.zig index e234a3f402..6b29fd0dc3 100644 --- a/test/link/wasm/bss/build.zig +++ b/test/link/wasm/bss/build.zig @@ -2,14 +2,15 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); - const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); - const lib = b.addSharedLibrary("lib", "lib.zig", .unversioned); - lib.setBuildMode(mode); - lib.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); + const lib = b.addSharedLibrary(.{ + .name = "lib", + .root_source_file = .{ .path = "lib.zig" }, + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + .optimize = b.standardOptimizeOption(.{}), + }); lib.use_llvm = false; lib.use_lld = false; lib.strip = false; diff --git a/test/link/wasm/export-data/build.zig b/test/link/wasm/export-data/build.zig index 283566dab3..8eab283ec2 100644 --- a/test/link/wasm/export-data/build.zig +++ b/test/link/wasm/export-data/build.zig @@ -5,9 +5,12 @@ pub fn build(b: *Builder) void { const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); - const lib = b.addSharedLibrary("lib", "lib.zig", .unversioned); - lib.setBuildMode(.ReleaseSafe); // to make the output deterministic in address positions - lib.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); + const lib = b.addSharedLibrary(.{ + .name = "lib", + .root_source_file = .{ .path = "lib.zig" }, + .optimize = .ReleaseSafe, // to make the output deterministic in address positions + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + }); lib.use_lld = false; lib.export_symbol_names = &.{ "foo", "bar" }; lib.global_base = 0; // put data section at address 0 to make data symbols easier to parse diff --git a/test/link/wasm/export/build.zig b/test/link/wasm/export/build.zig index 181e77e296..2b9a91d728 100644 --- a/test/link/wasm/export/build.zig +++ b/test/link/wasm/export/build.zig @@ -1,24 +1,33 @@ const std = @import("std"); pub fn build(b: *std.build.Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); - const no_export = b.addSharedLibrary("no-export", "main.zig", .unversioned); - no_export.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); - no_export.setBuildMode(mode); + const no_export = b.addSharedLibrary(.{ + .name = "no-export", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + }); no_export.use_llvm = false; no_export.use_lld = false; - const dynamic_export = b.addSharedLibrary("dynamic", "main.zig", .unversioned); - dynamic_export.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); - dynamic_export.setBuildMode(mode); + const dynamic_export = b.addSharedLibrary(.{ + .name = "dynamic", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + }); dynamic_export.rdynamic = true; dynamic_export.use_llvm = false; dynamic_export.use_lld = false; - const force_export = b.addSharedLibrary("force", "main.zig", .unversioned); - force_export.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); - force_export.setBuildMode(mode); + const force_export = b.addSharedLibrary(.{ + .name = "force", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + }); force_export.export_symbol_names = &.{"foo"}; force_export.use_llvm = false; force_export.use_lld = false; diff --git a/test/link/wasm/extern-mangle/build.zig b/test/link/wasm/extern-mangle/build.zig index ae46117f18..71bb986dff 100644 --- a/test/link/wasm/extern-mangle/build.zig +++ b/test/link/wasm/extern-mangle/build.zig @@ -2,14 +2,15 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); - const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); - const lib = b.addSharedLibrary("lib", "lib.zig", .unversioned); - lib.setBuildMode(mode); - lib.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); + const lib = b.addSharedLibrary(.{ + .name = "lib", + .root_source_file = .{ .path = "lib.zig" }, + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + .optimize = b.standardOptimizeOption(.{}), + }); lib.import_symbols = true; // import `a` and `b` lib.rdynamic = true; // export `foo` lib.install(); diff --git a/test/link/wasm/extern/build.zig b/test/link/wasm/extern/build.zig index 88cce88d98..800c76a31c 100644 --- a/test/link/wasm/extern/build.zig +++ b/test/link/wasm/extern/build.zig @@ -1,10 +1,12 @@ const std = @import("std"); pub fn build(b: *std.build.Builder) void { - const mode = b.standardReleaseOptions(); - const exe = b.addExecutable("extern", "main.zig"); - exe.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .wasi }); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "extern", + .root_source_file = .{ .path = "main.zig" }, + .optimize = b.standardOptimizeOption(.{}), + .target = .{ .cpu_arch = .wasm32, .os_tag = .wasi }, + }); exe.addCSourceFile("foo.c", &.{}); exe.use_llvm = false; exe.use_lld = false; diff --git a/test/link/wasm/function-table/build.zig b/test/link/wasm/function-table/build.zig index f7572bd6b1..804aaf0b09 100644 --- a/test/link/wasm/function-table/build.zig +++ b/test/link/wasm/function-table/build.zig @@ -2,28 +2,37 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); - const import_table = b.addSharedLibrary("lib", "lib.zig", .unversioned); - import_table.setBuildMode(mode); - import_table.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); + const import_table = b.addSharedLibrary(.{ + .name = "lib", + .root_source_file = .{ .path = "lib.zig" }, + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + .optimize = optimize, + }); import_table.use_llvm = false; import_table.use_lld = false; import_table.import_table = true; - const export_table = b.addSharedLibrary("lib", "lib.zig", .unversioned); - export_table.setBuildMode(mode); - export_table.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); + const export_table = b.addSharedLibrary(.{ + .name = "lib", + .root_source_file = .{ .path = "lib.zig" }, + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + .optimize = optimize, + }); export_table.use_llvm = false; export_table.use_lld = false; export_table.export_table = true; - const regular_table = b.addSharedLibrary("lib", "lib.zig", .unversioned); - regular_table.setBuildMode(mode); - regular_table.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); + const regular_table = b.addSharedLibrary(.{ + .name = "lib", + .root_source_file = .{ .path = "lib.zig" }, + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + .optimize = optimize, + }); regular_table.use_llvm = false; regular_table.use_lld = false; diff --git a/test/link/wasm/infer-features/build.zig b/test/link/wasm/infer-features/build.zig index b50caf7264..147fb55fda 100644 --- a/test/link/wasm/infer-features/build.zig +++ b/test/link/wasm/infer-features/build.zig @@ -1,21 +1,32 @@ const std = @import("std"); pub fn build(b: *std.build.Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); // Wasm Object file which we will use to infer the features from - const c_obj = b.addObject("c_obj", null); - c_obj.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); - c_obj.target.cpu_model = .{ .explicit = &std.Target.wasm.cpu.bleeding_edge }; + const c_obj = b.addObject(.{ + .name = "c_obj", + .optimize = optimize, + .target = .{ + .cpu_arch = .wasm32, + .cpu_model = .{ .explicit = &std.Target.wasm.cpu.bleeding_edge }, + .os_tag = .freestanding, + }, + }); c_obj.addCSourceFile("foo.c", &.{}); - c_obj.setBuildMode(mode); // Wasm library that doesn't have any features specified. This will // infer its featureset from other linked object files. - const lib = b.addSharedLibrary("lib", "main.zig", .unversioned); - lib.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); - lib.target.cpu_model = .{ .explicit = &std.Target.wasm.cpu.mvp }; - lib.setBuildMode(mode); + const lib = b.addSharedLibrary(.{ + .name = "lib", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = .{ + .cpu_arch = .wasm32, + .cpu_model = .{ .explicit = &std.Target.wasm.cpu.mvp }, + .os_tag = .freestanding, + }, + }); lib.use_llvm = false; lib.use_lld = false; lib.addObject(c_obj); diff --git a/test/link/wasm/producers/build.zig b/test/link/wasm/producers/build.zig index 7557b4fa41..57ee6acd18 100644 --- a/test/link/wasm/producers/build.zig +++ b/test/link/wasm/producers/build.zig @@ -3,14 +3,15 @@ const builtin = @import("builtin"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); - const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); - const lib = b.addSharedLibrary("lib", "lib.zig", .unversioned); - lib.setBuildMode(mode); - lib.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); + const lib = b.addSharedLibrary(.{ + .name = "lib", + .root_source_file = .{ .path = "lib.zig" }, + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + .optimize = b.standardOptimizeOption(.{}), + }); lib.use_llvm = false; lib.use_lld = false; lib.strip = false; diff --git a/test/link/wasm/segments/build.zig b/test/link/wasm/segments/build.zig index 1b2cdf87ab..8f7d9e0583 100644 --- a/test/link/wasm/segments/build.zig +++ b/test/link/wasm/segments/build.zig @@ -2,14 +2,15 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); - const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); - const lib = b.addSharedLibrary("lib", "lib.zig", .unversioned); - lib.setBuildMode(mode); - lib.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); + const lib = b.addSharedLibrary(.{ + .name = "lib", + .root_source_file = .{ .path = "lib.zig" }, + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + .optimize = b.standardOptimizeOption(.{}), + }); lib.use_llvm = false; lib.use_lld = false; lib.strip = false; diff --git a/test/link/wasm/stack_pointer/build.zig b/test/link/wasm/stack_pointer/build.zig index 5b67c3caa3..42971c607d 100644 --- a/test/link/wasm/stack_pointer/build.zig +++ b/test/link/wasm/stack_pointer/build.zig @@ -2,14 +2,15 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); - const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); - const lib = b.addSharedLibrary("lib", "lib.zig", .unversioned); - lib.setBuildMode(mode); - lib.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); + const lib = b.addSharedLibrary(.{ + .name = "lib", + .root_source_file = .{ .path = "lib.zig" }, + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + .optimize = b.standardOptimizeOption(.{}), + }); lib.use_llvm = false; lib.use_lld = false; lib.strip = false; diff --git a/test/link/wasm/type/build.zig b/test/link/wasm/type/build.zig index fbae6dc741..7fa3849083 100644 --- a/test/link/wasm/type/build.zig +++ b/test/link/wasm/type/build.zig @@ -2,14 +2,15 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); - const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); - const lib = b.addSharedLibrary("lib", "lib.zig", .unversioned); - lib.setBuildMode(mode); - lib.setTarget(.{ .cpu_arch = .wasm32, .os_tag = .freestanding }); + const lib = b.addSharedLibrary(.{ + .name = "lib", + .root_source_file = .{ .path = "lib.zig" }, + .target = .{ .cpu_arch = .wasm32, .os_tag = .freestanding }, + .optimize = b.standardOptimizeOption(.{}), + }); lib.use_llvm = false; lib.use_lld = false; lib.strip = false; diff --git a/test/src/compare_output.zig b/test/src/compare_output.zig index 538e4023f0..a885faaadf 100644 --- a/test/src/compare_output.zig +++ b/test/src/compare_output.zig @@ -6,14 +6,14 @@ const ArrayList = std.ArrayList; const fmt = std.fmt; const mem = std.mem; const fs = std.fs; -const Mode = std.builtin.Mode; +const OptimizeMode = std.builtin.OptimizeMode; pub const CompareOutputContext = struct { b: *build.Builder, step: *build.Step, test_index: usize, test_filter: ?[]const u8, - modes: []const Mode, + optimize_modes: []const OptimizeMode, const Special = enum { None, @@ -102,7 +102,11 @@ pub const CompareOutputContext = struct { if (mem.indexOf(u8, annotated_case_name, filter) == null) return; } - const exe = b.addExecutable("test", null); + const exe = b.addExecutable(.{ + .name = "test", + .target = .{}, + .optimize = .Debug, + }); exe.addAssemblyFileSource(write_src.getFileSource(case.sources.items[0].filename).?); const run = exe.run(); @@ -113,19 +117,23 @@ pub const CompareOutputContext = struct { self.step.dependOn(&run.step); }, Special.None => { - for (self.modes) |mode| { + for (self.optimize_modes) |optimize| { const annotated_case_name = fmt.allocPrint(self.b.allocator, "{s} {s} ({s})", .{ "compare-output", case.name, - @tagName(mode), + @tagName(optimize), }) catch unreachable; if (self.test_filter) |filter| { if (mem.indexOf(u8, annotated_case_name, filter) == null) continue; } const basename = case.sources.items[0].filename; - const exe = b.addExecutableSource("test", write_src.getFileSource(basename).?); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "test", + .root_source_file = write_src.getFileSource(basename).?, + .optimize = optimize, + .target = .{}, + }); if (case.link_libc) { exe.linkSystemLibrary("c"); } @@ -139,13 +147,20 @@ pub const CompareOutputContext = struct { } }, Special.RuntimeSafety => { + // TODO iterate over self.optimize_modes and test this in both + // debug and release safe mode const annotated_case_name = fmt.allocPrint(self.b.allocator, "safety {s}", .{case.name}) catch unreachable; if (self.test_filter) |filter| { if (mem.indexOf(u8, annotated_case_name, filter) == null) return; } const basename = case.sources.items[0].filename; - const exe = b.addExecutableSource("test", write_src.getFileSource(basename).?); + const exe = b.addExecutable(.{ + .name = "test", + .root_source_file = write_src.getFileSource(basename).?, + .target = .{}, + .optimize = .Debug, + }); if (case.link_libc) { exe.linkSystemLibrary("c"); } diff --git a/test/src/run_translated_c.zig b/test/src/run_translated_c.zig index 0204272f97..0c54655b32 100644 --- a/test/src/run_translated_c.zig +++ b/test/src/run_translated_c.zig @@ -85,11 +85,14 @@ pub const RunTranslatedCContext = struct { for (case.sources.items) |src_file| { write_src.add(src_file.filename, src_file.source); } - const translate_c = b.addTranslateC(write_src.getFileSource(case.sources.items[0].filename).?); + const translate_c = b.addTranslateC(.{ + .source_file = write_src.getFileSource(case.sources.items[0].filename).?, + .target = .{}, + .optimize = .Debug, + }); translate_c.step.name = b.fmt("{s} translate-c", .{annotated_case_name}); - const exe = translate_c.addExecutable(); - exe.setTarget(self.target); + const exe = translate_c.addExecutable(.{}); exe.step.name = b.fmt("{s} build-exe", .{annotated_case_name}); exe.linkLibC(); const run = exe.run(); diff --git a/test/src/translate_c.zig b/test/src/translate_c.zig index f0f6f30c57..ad5fbb7091 100644 --- a/test/src/translate_c.zig +++ b/test/src/translate_c.zig @@ -108,10 +108,13 @@ pub const TranslateCContext = struct { write_src.add(src_file.filename, src_file.source); } - const translate_c = b.addTranslateC(write_src.getFileSource(case.sources.items[0].filename).?); + const translate_c = b.addTranslateC(.{ + .source_file = write_src.getFileSource(case.sources.items[0].filename).?, + .target = case.target, + .optimize = .Debug, + }); translate_c.step.name = annotated_case_name; - translate_c.setTarget(case.target); const check_file = translate_c.addCheckFile(case.expected_lines.items); diff --git a/test/standalone/brace_expansion/build.zig b/test/standalone/brace_expansion/build.zig index 64f3c08583..89250ff96f 100644 --- a/test/standalone/brace_expansion/build.zig +++ b/test/standalone/brace_expansion/build.zig @@ -1,8 +1,10 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const main = b.addTest("main.zig"); - main.setBuildMode(b.standardReleaseOptions()); + const main = b.addTest(.{ + .root_source_file = .{ .path = "main.zig" }, + .optimize = b.standardOptimizeOption(.{}), + }); const test_step = b.step("test", "Test it"); test_step.dependOn(&main.step); diff --git a/test/standalone/c_compiler/build.zig b/test/standalone/c_compiler/build.zig index 240d535182..6959f810d6 100644 --- a/test/standalone/c_compiler/build.zig +++ b/test/standalone/c_compiler/build.zig @@ -12,23 +12,27 @@ fn isRunnableTarget(t: CrossTarget) bool { } pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); const test_step = b.step("test", "Test the program"); - const exe_c = b.addExecutable("test_c", null); + const exe_c = b.addExecutable(.{ + .name = "test_c", + .optimize = optimize, + .target = target, + }); b.default_step.dependOn(&exe_c.step); exe_c.addCSourceFile("test.c", &[0][]const u8{}); - exe_c.setBuildMode(mode); - exe_c.setTarget(target); exe_c.linkLibC(); - const exe_cpp = b.addExecutable("test_cpp", null); + const exe_cpp = b.addExecutable(.{ + .name = "test_cpp", + .optimize = optimize, + .target = target, + }); b.default_step.dependOn(&exe_cpp.step); exe_cpp.addCSourceFile("test.cpp", &[0][]const u8{}); - exe_cpp.setBuildMode(mode); - exe_cpp.setTarget(target); exe_cpp.linkLibCpp(); switch (target.getOsTag()) { diff --git a/test/standalone/emit_asm_and_bin/build.zig b/test/standalone/emit_asm_and_bin/build.zig index 43b7bb791d..b8cbd5fc17 100644 --- a/test/standalone/emit_asm_and_bin/build.zig +++ b/test/standalone/emit_asm_and_bin/build.zig @@ -1,8 +1,10 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const main = b.addTest("main.zig"); - main.setBuildMode(b.standardReleaseOptions()); + const main = b.addTest(.{ + .root_source_file = .{ .path = "main.zig" }, + .optimize = b.standardOptimizeOption(.{}), + }); main.emit_asm = .{ .emit_to = b.pathFromRoot("main.s") }; main.emit_bin = .{ .emit_to = b.pathFromRoot("main") }; diff --git a/test/standalone/empty_env/build.zig b/test/standalone/empty_env/build.zig index 2a184dcd2e..ecdd74aa90 100644 --- a/test/standalone/empty_env/build.zig +++ b/test/standalone/empty_env/build.zig @@ -1,8 +1,11 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const main = b.addExecutable("main", "main.zig"); - main.setBuildMode(b.standardReleaseOptions()); + const main = b.addExecutable(.{ + .name = "main", + .root_source_file = .{ .path = "main.zig" }, + .optimize = b.standardOptimizeOption(.{}), + }); const run = main.run(); run.clearEnvironment(); diff --git a/test/standalone/global_linkage/build.zig b/test/standalone/global_linkage/build.zig index e13c0e8873..3064c6cc08 100644 --- a/test/standalone/global_linkage/build.zig +++ b/test/standalone/global_linkage/build.zig @@ -1,16 +1,26 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); - const obj1 = b.addStaticLibrary("obj1", "obj1.zig"); - obj1.setBuildMode(mode); + const obj1 = b.addStaticLibrary(.{ + .name = "obj1", + .root_source_file = .{ .path = "obj1.zig" }, + .optimize = optimize, + .target = .{}, + }); - const obj2 = b.addStaticLibrary("obj2", "obj2.zig"); - obj2.setBuildMode(mode); + const obj2 = b.addStaticLibrary(.{ + .name = "obj2", + .root_source_file = .{ .path = "obj2.zig" }, + .optimize = optimize, + .target = .{}, + }); - const main = b.addTest("main.zig"); - main.setBuildMode(mode); + const main = b.addTest(.{ + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + }); main.linkLibrary(obj1); main.linkLibrary(obj2); diff --git a/test/standalone/install_raw_hex/build.zig b/test/standalone/install_raw_hex/build.zig index 0038c4c298..94016b1d74 100644 --- a/test/standalone/install_raw_hex/build.zig +++ b/test/standalone/install_raw_hex/build.zig @@ -10,11 +10,14 @@ pub fn build(b: *std.build.Builder) void { .abi = .gnueabihf, }; - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); - const elf = b.addExecutable("zig-nrf52-blink.elf", "main.zig"); - elf.setTarget(target); - elf.setBuildMode(mode); + const elf = b.addExecutable(.{ + .name = "zig-nrf52-blink.elf", + .root_source_file = .{ .path = "main.zig" }, + .target = target, + .optimize = optimize, + }); const test_step = b.step("test", "Test the program"); b.default_step.dependOn(test_step); diff --git a/test/standalone/issue_11595/build.zig b/test/standalone/issue_11595/build.zig index d636f63ebc..b0310947f6 100644 --- a/test/standalone/issue_11595/build.zig +++ b/test/standalone/issue_11595/build.zig @@ -12,11 +12,15 @@ fn isRunnableTarget(t: CrossTarget) bool { } pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); - const exe = b.addExecutable("zigtest", "main.zig"); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "zigtest", + .root_source_file = .{ .path = "main.zig" }, + .target = target, + .optimize = optimize, + }); exe.install(); const c_sources = [_][]const u8{ @@ -39,7 +43,6 @@ pub fn build(b: *Builder) void { exe.defineCMacro("QUX", "\"Q\" \"UX\""); exe.defineCMacro("QUUX", "\"QU\\\"UX\""); - exe.setTarget(target); b.default_step.dependOn(&exe.step); const test_step = b.step("test", "Test the program"); diff --git a/test/standalone/issue_12588/build.zig b/test/standalone/issue_12588/build.zig index 02fa5e1680..27a23d5a76 100644 --- a/test/standalone/issue_12588/build.zig +++ b/test/standalone/issue_12588/build.zig @@ -2,12 +2,15 @@ const std = @import("std"); const Builder = std.build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); - const obj = b.addObject("main", "main.zig"); - obj.setBuildMode(mode); - obj.setTarget(target); + const obj = b.addObject(.{ + .name = "main", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = target, + }); obj.emit_llvm_ir = .{ .emit_to = b.pathFromRoot("main.ll") }; obj.emit_llvm_bc = .{ .emit_to = b.pathFromRoot("main.bc") }; obj.emit_bin = .no_emit; diff --git a/test/standalone/issue_12706/build.zig b/test/standalone/issue_12706/build.zig index d84160a4f4..e3c40d34c6 100644 --- a/test/standalone/issue_12706/build.zig +++ b/test/standalone/issue_12706/build.zig @@ -12,11 +12,15 @@ fn isRunnableTarget(t: CrossTarget) bool { } pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); - const exe = b.addExecutable("main", "main.zig"); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "main", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = target, + }); exe.install(); const c_sources = [_][]const u8{ @@ -26,7 +30,6 @@ pub fn build(b: *Builder) void { exe.addCSourceFiles(&c_sources, &.{}); exe.linkLibC(); - exe.setTarget(target); b.default_step.dependOn(&exe.step); const test_step = b.step("test", "Test the program"); diff --git a/test/standalone/issue_13030/build.zig b/test/standalone/issue_13030/build.zig index 8c05e47cf6..510c7610d9 100644 --- a/test/standalone/issue_13030/build.zig +++ b/test/standalone/issue_13030/build.zig @@ -4,13 +4,15 @@ const Builder = std.build.Builder; const CrossTarget = std.zig.CrossTarget; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); - const obj = b.addObject("main", "main.zig"); - obj.setBuildMode(mode); - - obj.setTarget(target); + const obj = b.addObject(.{ + .name = "main", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = target, + }); b.default_step.dependOn(&obj.step); const test_step = b.step("test", "Test the program"); diff --git a/test/standalone/issue_339/build.zig b/test/standalone/issue_339/build.zig index 733b3729c1..34c555cfdb 100644 --- a/test/standalone/issue_339/build.zig +++ b/test/standalone/issue_339/build.zig @@ -1,7 +1,12 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const obj = b.addObject("test", "test.zig"); + const obj = b.addObject(.{ + .name = "test", + .root_source_file = .{ .path = "test.zig" }, + .target = b.standardTargetOptions(.{}), + .optimize = b.standardOptimizeOption(.{}), + }); const test_step = b.step("test", "Test the program"); test_step.dependOn(&obj.step); diff --git a/test/standalone/issue_5825/build.zig b/test/standalone/issue_5825/build.zig index 8f43ae1358..8d7acc3e9a 100644 --- a/test/standalone/issue_5825/build.zig +++ b/test/standalone/issue_5825/build.zig @@ -6,17 +6,22 @@ pub fn build(b: *Builder) void { .os_tag = .windows, .abi = .msvc, }; - const mode = b.standardReleaseOptions(); - const obj = b.addObject("issue_5825", "main.zig"); - obj.setTarget(target); - obj.setBuildMode(mode); + const optimize = b.standardOptimizeOption(.{}); + const obj = b.addObject(.{ + .name = "issue_5825", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = target, + }); - const exe = b.addExecutable("issue_5825", null); + const exe = b.addExecutable(.{ + .name = "issue_5825", + .optimize = optimize, + .target = target, + }); exe.subsystem = .Console; exe.linkSystemLibrary("kernel32"); exe.linkSystemLibrary("ntdll"); - exe.setTarget(target); - exe.setBuildMode(mode); exe.addObject(obj); const test_step = b.step("test", "Test the program"); diff --git a/test/standalone/issue_7030/build.zig b/test/standalone/issue_7030/build.zig index ab3677370a..41a646abe8 100644 --- a/test/standalone/issue_7030/build.zig +++ b/test/standalone/issue_7030/build.zig @@ -1,10 +1,13 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const exe = b.addExecutable("issue_7030", "main.zig"); - exe.setTarget(.{ - .cpu_arch = .wasm32, - .os_tag = .freestanding, + const exe = b.addExecutable(.{ + .name = "issue_7030", + .root_source_file = .{ .path = "main.zig" }, + .target = .{ + .cpu_arch = .wasm32, + .os_tag = .freestanding, + }, }); exe.install(); b.default_step.dependOn(&exe.step); diff --git a/test/standalone/issue_794/build.zig b/test/standalone/issue_794/build.zig index ece74f0e98..59ff7ea9ab 100644 --- a/test/standalone/issue_794/build.zig +++ b/test/standalone/issue_794/build.zig @@ -1,7 +1,9 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const test_artifact = b.addTest("main.zig"); + const test_artifact = b.addTest(.{ + .root_source_file = .{ .path = "main.zig" }, + }); test_artifact.addIncludePath("a_directory"); b.default_step.dependOn(&test_artifact.step); diff --git a/test/standalone/issue_8550/build.zig b/test/standalone/issue_8550/build.zig index 03e8d04bfb..233f701661 100644 --- a/test/standalone/issue_8550/build.zig +++ b/test/standalone/issue_8550/build.zig @@ -8,12 +8,15 @@ pub fn build(b: *std.build.Builder) !void { .explicit = &std.Target.arm.cpu.arm1176jz_s, }, }; - const mode = b.standardReleaseOptions(); - const kernel = b.addExecutable("kernel", "./main.zig"); + const optimize = b.standardOptimizeOption(.{}); + const kernel = b.addExecutable(.{ + .name = "kernel", + .root_source_file = .{ .path = "./main.zig" }, + .optimize = optimize, + .target = target, + }); kernel.addObjectFile("./boot.S"); kernel.setLinkerScriptPath(.{ .path = "./linker.ld" }); - kernel.setBuildMode(mode); - kernel.setTarget(target); kernel.install(); const test_step = b.step("test", "Test it"); diff --git a/test/standalone/issue_9812/build.zig b/test/standalone/issue_9812/build.zig index 677c589a84..50eefe846c 100644 --- a/test/standalone/issue_9812/build.zig +++ b/test/standalone/issue_9812/build.zig @@ -1,9 +1,11 @@ const std = @import("std"); pub fn build(b: *std.build.Builder) !void { - const mode = b.standardReleaseOptions(); - const zip_add = b.addTest("main.zig"); - zip_add.setBuildMode(mode); + const optimize = b.standardOptimizeOption(.{}); + const zip_add = b.addTest(.{ + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + }); zip_add.addCSourceFile("vendor/kuba-zip/zip.c", &[_][]const u8{ "-std=c99", "-fno-sanitize=undefined", diff --git a/test/standalone/load_dynamic_library/build.zig b/test/standalone/load_dynamic_library/build.zig index 109c742c6f..1aca02bc71 100644 --- a/test/standalone/load_dynamic_library/build.zig +++ b/test/standalone/load_dynamic_library/build.zig @@ -1,13 +1,23 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const opts = b.standardReleaseOptions(); + const target = b.standardTargetOptions(.{}); + const optimize = b.standardOptimizeOption(.{}); - const lib = b.addSharedLibrary("add", "add.zig", b.version(1, 0, 0)); - lib.setBuildMode(opts); + const lib = b.addSharedLibrary(.{ + .name = "add", + .root_source_file = .{ .path = "add.zig" }, + .version = .{ .major = 1, .minor = 0 }, + .optimize = optimize, + .target = target, + }); - const main = b.addExecutable("main", "main.zig"); - main.setBuildMode(opts); + const main = b.addExecutable(.{ + .name = "main", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = target, + }); const run = main.run(); run.addArtifactArg(lib); diff --git a/test/standalone/main_pkg_path/build.zig b/test/standalone/main_pkg_path/build.zig index c4ac18f967..baee74052e 100644 --- a/test/standalone/main_pkg_path/build.zig +++ b/test/standalone/main_pkg_path/build.zig @@ -1,7 +1,9 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const test_exe = b.addTest("a/test.zig"); + const test_exe = b.addTest(.{ + .root_source_file = .{ .path = "a/test.zig" }, + }); test_exe.setMainPkgPath("."); const test_step = b.step("test", "Test the program"); diff --git a/test/standalone/mix_c_files/build.zig b/test/standalone/mix_c_files/build.zig index 68486ea18d..ad69f05ff6 100644 --- a/test/standalone/mix_c_files/build.zig +++ b/test/standalone/mix_c_files/build.zig @@ -12,14 +12,17 @@ fn isRunnableTarget(t: CrossTarget) bool { } pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); - const exe = b.addExecutable("test", "main.zig"); + const exe = b.addExecutable(.{ + .name = "test", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + .target = target, + }); exe.addCSourceFile("test.c", &[_][]const u8{"-std=c11"}); - exe.setBuildMode(mode); exe.linkLibC(); - exe.setTarget(target); b.default_step.dependOn(&exe.step); const test_step = b.step("test", "Test the program"); diff --git a/test/standalone/mix_o_files/build.zig b/test/standalone/mix_o_files/build.zig index d498e2e20a..de37265388 100644 --- a/test/standalone/mix_o_files/build.zig +++ b/test/standalone/mix_o_files/build.zig @@ -1,9 +1,19 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const obj = b.addObject("base64", "base64.zig"); + const optimize = b.standardOptimizeOption(.{}); - const exe = b.addExecutable("test", null); + const obj = b.addObject(.{ + .name = "base64", + .root_source_file = .{ .path = "base64.zig" }, + .optimize = optimize, + .target = .{}, + }); + + const exe = b.addExecutable(.{ + .name = "test", + .optimize = optimize, + }); exe.addCSourceFile("test.c", &[_][]const u8{"-std=c99"}); exe.addObject(obj); exe.linkSystemLibrary("c"); diff --git a/test/standalone/options/build.zig b/test/standalone/options/build.zig index 087aceff01..87a584a887 100644 --- a/test/standalone/options/build.zig +++ b/test/standalone/options/build.zig @@ -2,11 +2,13 @@ const std = @import("std"); pub fn build(b: *std.build.Builder) void { const target = b.standardTargetOptions(.{}); - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); - const main = b.addTest("src/main.zig"); - main.setTarget(target); - main.setBuildMode(mode); + const main = b.addTest(.{ + .root_source_file = .{ .path = "src/main.zig" }, + .target = target, + .optimize = optimize, + }); const options = b.addOptions(); main.addOptions("build_options", options); diff --git a/test/standalone/pie/build.zig b/test/standalone/pie/build.zig index d008fd31c9..3f0b8b9f2f 100644 --- a/test/standalone/pie/build.zig +++ b/test/standalone/pie/build.zig @@ -1,8 +1,10 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const main = b.addTest("main.zig"); - main.setBuildMode(b.standardReleaseOptions()); + const main = b.addTest(.{ + .root_source_file = .{ .path = "main.zig" }, + .optimize = b.standardOptimizeOption(.{}), + }); main.pie = true; const test_step = b.step("test", "Test the program"); diff --git a/test/standalone/pkg_import/build.zig b/test/standalone/pkg_import/build.zig index 7529d106f9..8dcfaeded0 100644 --- a/test/standalone/pkg_import/build.zig +++ b/test/standalone/pkg_import/build.zig @@ -1,13 +1,14 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const exe = b.addExecutable("test", "test.zig"); - exe.addPackagePath("my_pkg", "pkg.zig"); + const optimize = b.standardOptimizeOption(.{}); - // This is duplicated to test that you are allowed to call - // b.standardReleaseOptions() twice. - exe.setBuildMode(b.standardReleaseOptions()); - exe.setBuildMode(b.standardReleaseOptions()); + const exe = b.addExecutable(.{ + .name = "test", + .root_source_file = .{ .path = "test.zig" }, + .optimize = optimize, + }); + exe.addPackagePath("my_pkg", "pkg.zig"); const run = exe.run(); diff --git a/test/standalone/shared_library/build.zig b/test/standalone/shared_library/build.zig index 18188311c7..135be095bc 100644 --- a/test/standalone/shared_library/build.zig +++ b/test/standalone/shared_library/build.zig @@ -1,12 +1,21 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { + const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); - const lib = b.addSharedLibrary("mathtest", "mathtest.zig", b.version(1, 0, 0)); - lib.setTarget(target); + const lib = b.addSharedLibrary(.{ + .name = "mathtest", + .root_source_file = .{ .path = "mathtest.zig" }, + .version = .{ .major = 1, .minor = 0 }, + .target = target, + .optimize = optimize, + }); - const exe = b.addExecutable("test", null); - exe.setTarget(target); + const exe = b.addExecutable(.{ + .name = "test", + .target = target, + .optimize = optimize, + }); exe.addCSourceFile("test.c", &[_][]const u8{"-std=c99"}); exe.linkLibrary(lib); exe.linkSystemLibrary("c"); diff --git a/test/standalone/static_c_lib/build.zig b/test/standalone/static_c_lib/build.zig index c64ae48dba..81b4349e20 100644 --- a/test/standalone/static_c_lib/build.zig +++ b/test/standalone/static_c_lib/build.zig @@ -1,15 +1,20 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); - const foo = b.addStaticLibrary("foo", null); + const foo = b.addStaticLibrary(.{ + .name = "foo", + .optimize = optimize, + .target = .{}, + }); foo.addCSourceFile("foo.c", &[_][]const u8{}); - foo.setBuildMode(mode); foo.addIncludePath("."); - const test_exe = b.addTest("foo.zig"); - test_exe.setBuildMode(mode); + const test_exe = b.addTest(.{ + .root_source_file = .{ .path = "foo.zig" }, + .optimize = optimize, + }); test_exe.linkLibrary(foo); test_exe.addIncludePath("."); diff --git a/test/standalone/test_runner_path/build.zig b/test/standalone/test_runner_path/build.zig index 738cac9783..9b02da50c1 100644 --- a/test/standalone/test_runner_path/build.zig +++ b/test/standalone/test_runner_path/build.zig @@ -1,7 +1,10 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const test_exe = b.addTestExe("test", "test.zig"); + const test_exe = b.addTest(.{ + .root_source_file = .{ .path = "test.zig" }, + .kind = .test_exe, + }); test_exe.test_runner = "test_runner.zig"; const test_run = test_exe.run(); diff --git a/test/standalone/use_alias/build.zig b/test/standalone/use_alias/build.zig index da4e8bef4b..d2ca90f3ab 100644 --- a/test/standalone/use_alias/build.zig +++ b/test/standalone/use_alias/build.zig @@ -1,8 +1,10 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const main = b.addTest("main.zig"); - main.setBuildMode(b.standardReleaseOptions()); + const main = b.addTest(.{ + .root_source_file = .{ .path = "main.zig" }, + .optimize = b.standardOptimizeOption(.{}), + }); main.addIncludePath("."); const test_step = b.step("test", "Test it"); diff --git a/test/standalone/windows_spawn/build.zig b/test/standalone/windows_spawn/build.zig index 10a1132d3a..de58a602c3 100644 --- a/test/standalone/windows_spawn/build.zig +++ b/test/standalone/windows_spawn/build.zig @@ -1,13 +1,20 @@ const Builder = @import("std").build.Builder; pub fn build(b: *Builder) void { - const mode = b.standardReleaseOptions(); + const optimize = b.standardOptimizeOption(.{}); - const hello = b.addExecutable("hello", "hello.zig"); - hello.setBuildMode(mode); + const hello = b.addExecutable(.{ + .name = "hello", + .root_source_file = .{ .path = "hello.zig" }, + .optimize = optimize, + }); + + const main = b.addExecutable(.{ + .name = "main", + .root_source_file = .{ .path = "main.zig" }, + .optimize = optimize, + }); - const main = b.addExecutable("main", "main.zig"); - main.setBuildMode(mode); const run = main.run(); run.addArtifactArg(hello); diff --git a/test/tests.zig b/test/tests.zig index 8e972b9ba6..575550be02 100644 --- a/test/tests.zig +++ b/test/tests.zig @@ -8,7 +8,7 @@ const fs = std.fs; const mem = std.mem; const fmt = std.fmt; const ArrayList = std.ArrayList; -const Mode = std.builtin.Mode; +const OptimizeMode = std.builtin.OptimizeMode; const LibExeObjStep = build.LibExeObjStep; const Allocator = mem.Allocator; const ExecError = build.Builder.ExecError; @@ -30,7 +30,7 @@ pub const CompareOutputContext = @import("src/compare_output.zig").CompareOutput const TestTarget = struct { target: CrossTarget = @as(CrossTarget, .{}), - mode: std.builtin.Mode = .Debug, + optimize_mode: std.builtin.OptimizeMode = .Debug, link_libc: bool = false, single_threaded: bool = false, disable_native: bool = false, @@ -423,38 +423,38 @@ const test_targets = blk: { // Do the release tests last because they take a long time .{ - .mode = .ReleaseFast, + .optimize_mode = .ReleaseFast, }, .{ .link_libc = true, - .mode = .ReleaseFast, + .optimize_mode = .ReleaseFast, }, .{ - .mode = .ReleaseFast, + .optimize_mode = .ReleaseFast, .single_threaded = true, }, .{ - .mode = .ReleaseSafe, + .optimize_mode = .ReleaseSafe, }, .{ .link_libc = true, - .mode = .ReleaseSafe, + .optimize_mode = .ReleaseSafe, }, .{ - .mode = .ReleaseSafe, + .optimize_mode = .ReleaseSafe, .single_threaded = true, }, .{ - .mode = .ReleaseSmall, + .optimize_mode = .ReleaseSmall, }, .{ .link_libc = true, - .mode = .ReleaseSmall, + .optimize_mode = .ReleaseSmall, }, .{ - .mode = .ReleaseSmall, + .optimize_mode = .ReleaseSmall, .single_threaded = true, }, }; @@ -462,14 +462,14 @@ const test_targets = blk: { const max_stdout_size = 1 * 1024 * 1024; // 1 MB -pub fn addCompareOutputTests(b: *build.Builder, test_filter: ?[]const u8, modes: []const Mode) *build.Step { +pub fn addCompareOutputTests(b: *build.Builder, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode) *build.Step { const cases = b.allocator.create(CompareOutputContext) catch unreachable; cases.* = CompareOutputContext{ .b = b, .step = b.step("test-compare-output", "Run the compare output tests"), .test_index = 0, .test_filter = test_filter, - .modes = modes, + .optimize_modes = optimize_modes, }; compare_output.addCases(cases); @@ -477,14 +477,14 @@ pub fn addCompareOutputTests(b: *build.Builder, test_filter: ?[]const u8, modes: return cases.step; } -pub fn addStackTraceTests(b: *build.Builder, test_filter: ?[]const u8, modes: []const Mode) *build.Step { +pub fn addStackTraceTests(b: *build.Builder, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode) *build.Step { const cases = b.allocator.create(StackTracesContext) catch unreachable; cases.* = StackTracesContext{ .b = b, .step = b.step("test-stack-traces", "Run the stack trace tests"), .test_index = 0, .test_filter = test_filter, - .modes = modes, + .optimize_modes = optimize_modes, }; stack_traces.addCases(cases); @@ -495,7 +495,7 @@ pub fn addStackTraceTests(b: *build.Builder, test_filter: ?[]const u8, modes: [] pub fn addStandaloneTests( b: *build.Builder, test_filter: ?[]const u8, - modes: []const Mode, + optimize_modes: []const OptimizeMode, skip_non_native: bool, enable_macos_sdk: bool, target: std.zig.CrossTarget, @@ -513,7 +513,7 @@ pub fn addStandaloneTests( .step = b.step("test-standalone", "Run the standalone tests"), .test_index = 0, .test_filter = test_filter, - .modes = modes, + .optimize_modes = optimize_modes, .skip_non_native = skip_non_native, .enable_macos_sdk = enable_macos_sdk, .target = target, @@ -534,7 +534,7 @@ pub fn addStandaloneTests( pub fn addLinkTests( b: *build.Builder, test_filter: ?[]const u8, - modes: []const Mode, + optimize_modes: []const OptimizeMode, enable_macos_sdk: bool, omit_stage2: bool, enable_symlinks_windows: bool, @@ -545,7 +545,7 @@ pub fn addLinkTests( .step = b.step("test-link", "Run the linker tests"), .test_index = 0, .test_filter = test_filter, - .modes = modes, + .optimize_modes = optimize_modes, .skip_non_native = true, .enable_macos_sdk = enable_macos_sdk, .target = .{}, @@ -556,12 +556,17 @@ pub fn addLinkTests( return cases.step; } -pub fn addCliTests(b: *build.Builder, test_filter: ?[]const u8, modes: []const Mode) *build.Step { +pub fn addCliTests(b: *build.Builder, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode) *build.Step { _ = test_filter; - _ = modes; + _ = optimize_modes; const step = b.step("test-cli", "Test the command line interface"); - const exe = b.addExecutable("test-cli", "test/cli.zig"); + const exe = b.addExecutable(.{ + .name = "test-cli", + .root_source_file = .{ .path = "test/cli.zig" }, + .target = .{}, + .optimize = .Debug, + }); const run_cmd = exe.run(); run_cmd.addArgs(&[_][]const u8{ fs.realpathAlloc(b.allocator, b.zig_exe) catch unreachable, @@ -572,14 +577,14 @@ pub fn addCliTests(b: *build.Builder, test_filter: ?[]const u8, modes: []const M return step; } -pub fn addAssembleAndLinkTests(b: *build.Builder, test_filter: ?[]const u8, modes: []const Mode) *build.Step { +pub fn addAssembleAndLinkTests(b: *build.Builder, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode) *build.Step { const cases = b.allocator.create(CompareOutputContext) catch unreachable; cases.* = CompareOutputContext{ .b = b, .step = b.step("test-asm-link", "Run the assemble and link tests"), .test_index = 0, .test_filter = test_filter, - .modes = modes, + .optimize_modes = optimize_modes, }; assemble_and_link.addCases(cases); @@ -640,7 +645,7 @@ pub fn addPkgTests( root_src: []const u8, name: []const u8, desc: []const u8, - modes: []const Mode, + optimize_modes: []const OptimizeMode, skip_single_threaded: bool, skip_non_native: bool, skip_libc: bool, @@ -677,8 +682,8 @@ pub fn addPkgTests( else => if (skip_stage2) continue, }; - const want_this_mode = for (modes) |m| { - if (m == test_target.mode) break true; + const want_this_mode = for (optimize_modes) |m| { + if (m == test_target.optimize_mode) break true; } else false; if (!want_this_mode) continue; @@ -691,21 +696,23 @@ pub fn addPkgTests( const triple_prefix = test_target.target.zigTriple(b.allocator) catch unreachable; - const these_tests = b.addTest(root_src); + const these_tests = b.addTest(.{ + .root_source_file = .{ .path = root_src }, + .optimize = test_target.optimize_mode, + .target = test_target.target, + }); const single_threaded_txt = if (test_target.single_threaded) "single" else "multi"; const backend_txt = if (test_target.backend) |backend| @tagName(backend) else "default"; these_tests.setNamePrefix(b.fmt("{s}-{s}-{s}-{s}-{s}-{s} ", .{ name, triple_prefix, - @tagName(test_target.mode), + @tagName(test_target.optimize_mode), libc_prefix, single_threaded_txt, backend_txt, })); these_tests.single_threaded = test_target.single_threaded; these_tests.setFilter(test_filter); - these_tests.setBuildMode(test_target.mode); - these_tests.setTarget(test_target.target); if (test_target.link_libc) { these_tests.linkSystemLibrary("c"); } @@ -739,9 +746,9 @@ pub const StackTracesContext = struct { step: *build.Step, test_index: usize, test_filter: ?[]const u8, - modes: []const Mode, + optimize_modes: []const OptimizeMode, - const Expect = [@typeInfo(Mode).Enum.fields.len][]const u8; + const Expect = [@typeInfo(OptimizeMode).Enum.fields.len][]const u8; pub fn addCase(self: *StackTracesContext, config: anytype) void { if (@hasField(@TypeOf(config), "exclude")) { @@ -755,26 +762,26 @@ pub const StackTracesContext = struct { const exclude_os: []const std.Target.Os.Tag = &config.exclude_os; for (exclude_os) |os| if (os == builtin.os.tag) return; } - for (self.modes) |mode| { - switch (mode) { + for (self.optimize_modes) |optimize_mode| { + switch (optimize_mode) { .Debug => { if (@hasField(@TypeOf(config), "Debug")) { - self.addExpect(config.name, config.source, mode, config.Debug); + self.addExpect(config.name, config.source, optimize_mode, config.Debug); } }, .ReleaseSafe => { if (@hasField(@TypeOf(config), "ReleaseSafe")) { - self.addExpect(config.name, config.source, mode, config.ReleaseSafe); + self.addExpect(config.name, config.source, optimize_mode, config.ReleaseSafe); } }, .ReleaseFast => { if (@hasField(@TypeOf(config), "ReleaseFast")) { - self.addExpect(config.name, config.source, mode, config.ReleaseFast); + self.addExpect(config.name, config.source, optimize_mode, config.ReleaseFast); } }, .ReleaseSmall => { if (@hasField(@TypeOf(config), "ReleaseSmall")) { - self.addExpect(config.name, config.source, mode, config.ReleaseSmall); + self.addExpect(config.name, config.source, optimize_mode, config.ReleaseSmall); } }, } @@ -785,7 +792,7 @@ pub const StackTracesContext = struct { self: *StackTracesContext, name: []const u8, source: []const u8, - mode: Mode, + optimize_mode: OptimizeMode, mode_config: anytype, ) void { if (@hasField(@TypeOf(mode_config), "exclude")) { @@ -803,7 +810,7 @@ pub const StackTracesContext = struct { const annotated_case_name = fmt.allocPrint(self.b.allocator, "{s} {s} ({s})", .{ "stack-trace", name, - @tagName(mode), + @tagName(optimize_mode), }) catch unreachable; if (self.test_filter) |filter| { if (mem.indexOf(u8, annotated_case_name, filter) == null) return; @@ -812,14 +819,18 @@ pub const StackTracesContext = struct { const b = self.b; const src_basename = "source.zig"; const write_src = b.addWriteFile(src_basename, source); - const exe = b.addExecutableSource("test", write_src.getFileSource(src_basename).?); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "test", + .root_source_file = write_src.getFileSource(src_basename).?, + .optimize = optimize_mode, + .target = .{}, + }); const run_and_compare = RunAndCompareStep.create( self, exe, annotated_case_name, - mode, + optimize_mode, mode_config.expect, ); @@ -833,7 +844,7 @@ pub const StackTracesContext = struct { context: *StackTracesContext, exe: *LibExeObjStep, name: []const u8, - mode: Mode, + optimize_mode: OptimizeMode, expect_output: []const u8, test_index: usize, @@ -841,7 +852,7 @@ pub const StackTracesContext = struct { context: *StackTracesContext, exe: *LibExeObjStep, name: []const u8, - mode: Mode, + optimize_mode: OptimizeMode, expect_output: []const u8, ) *RunAndCompareStep { const allocator = context.b.allocator; @@ -851,7 +862,7 @@ pub const StackTracesContext = struct { .context = context, .exe = exe, .name = name, - .mode = mode, + .optimize_mode = optimize_mode, .expect_output = expect_output, .test_index = context.test_index, }; @@ -932,7 +943,7 @@ pub const StackTracesContext = struct { // process result // - keep only basename of source file path // - replace address with symbolic string - // - replace function name with symbolic string when mode != .Debug + // - replace function name with symbolic string when optimize_mode != .Debug // - skip empty lines const got: []const u8 = got_result: { var buf = ArrayList(u8).init(b.allocator); @@ -968,7 +979,7 @@ pub const StackTracesContext = struct { // emit substituted line try buf.appendSlice(line[pos + 1 .. marks[2] + delims[2].len]); try buf.appendSlice(" [address]"); - if (self.mode == .Debug) { + if (self.optimize_mode == .Debug) { // On certain platforms (windows) or possibly depending on how we choose to link main // the object file extension may be present so we simply strip any extension. if (mem.indexOfScalar(u8, line[marks[4]..marks[5]], '.')) |idot| { @@ -1007,7 +1018,7 @@ pub const StandaloneContext = struct { step: *build.Step, test_index: usize, test_filter: ?[]const u8, - modes: []const Mode, + optimize_modes: []const OptimizeMode, skip_non_native: bool, enable_macos_sdk: bool, target: std.zig.CrossTarget, @@ -1087,13 +1098,13 @@ pub const StandaloneContext = struct { } } - const modes = if (features.build_modes) self.modes else &[1]Mode{.Debug}; - for (modes) |mode| { - const arg = switch (mode) { + const optimize_modes = if (features.build_modes) self.optimize_modes else &[1]OptimizeMode{.Debug}; + for (optimize_modes) |optimize_mode| { + const arg = switch (optimize_mode) { .Debug => "", - .ReleaseFast => "-Drelease-fast", - .ReleaseSafe => "-Drelease-safe", - .ReleaseSmall => "-Drelease-small", + .ReleaseFast => "-Doptimize=ReleaseFast", + .ReleaseSafe => "-Doptimize=ReleaseSafe", + .ReleaseSmall => "-Doptimize=ReleaseSmall", }; const zig_args_base_len = zig_args.items.len; if (arg.len > 0) @@ -1101,7 +1112,7 @@ pub const StandaloneContext = struct { defer zig_args.resize(zig_args_base_len) catch unreachable; const run_cmd = b.addSystemCommand(zig_args.items); - const log_step = b.addLog("PASS {s} ({s})", .{ annotated_case_name, @tagName(mode) }); + const log_step = b.addLog("PASS {s} ({s})", .{ annotated_case_name, @tagName(optimize_mode) }); log_step.step.dependOn(&run_cmd.step); self.step.dependOn(&log_step.step); @@ -1111,17 +1122,21 @@ pub const StandaloneContext = struct { pub fn addAllArgs(self: *StandaloneContext, root_src: []const u8, link_libc: bool) void { const b = self.b; - for (self.modes) |mode| { + for (self.optimize_modes) |optimize| { const annotated_case_name = fmt.allocPrint(self.b.allocator, "build {s} ({s})", .{ root_src, - @tagName(mode), + @tagName(optimize), }) catch unreachable; if (self.test_filter) |filter| { if (mem.indexOf(u8, annotated_case_name, filter) == null) continue; } - const exe = b.addExecutable("test", root_src); - exe.setBuildMode(mode); + const exe = b.addExecutable(.{ + .name = "test", + .root_source_file = .{ .path = root_src }, + .optimize = optimize, + .target = .{}, + }); if (link_libc) { exe.linkSystemLibrary("c"); } @@ -1247,8 +1262,8 @@ pub const GenHContext = struct { pub fn addCase(self: *GenHContext, case: *const TestCase) void { const b = self.b; - const mode = std.builtin.Mode.Debug; - const annotated_case_name = fmt.allocPrint(self.b.allocator, "gen-h {s} ({s})", .{ case.name, @tagName(mode) }) catch unreachable; + const optimize_mode = std.builtin.OptimizeMode.Debug; + const annotated_case_name = fmt.allocPrint(self.b.allocator, "gen-h {s} ({s})", .{ case.name, @tagName(optimize_mode) }) catch unreachable; if (self.test_filter) |filter| { if (mem.indexOf(u8, annotated_case_name, filter) == null) return; } @@ -1259,7 +1274,7 @@ pub const GenHContext = struct { } const obj = b.addObjectFromWriteFileStep("test", write_src, case.sources.items[0].filename); - obj.setBuildMode(mode); + obj.setBuildMode(optimize_mode); const cmp_h = GenHCmpOutputStep.create(self, obj, annotated_case_name, case); @@ -1336,14 +1351,16 @@ const c_abi_targets = [_]CrossTarget{ pub fn addCAbiTests(b: *build.Builder, skip_non_native: bool, skip_release: bool) *build.Step { const step = b.step("test-c-abi", "Run the C ABI tests"); - const modes: [2]Mode = .{ .Debug, .ReleaseFast }; + const optimize_modes: [2]OptimizeMode = .{ .Debug, .ReleaseFast }; - for (modes[0 .. @as(u8, 1) + @boolToInt(!skip_release)]) |mode| for (c_abi_targets) |c_abi_target| { + for (optimize_modes[0 .. @as(u8, 1) + @boolToInt(!skip_release)]) |optimize_mode| for (c_abi_targets) |c_abi_target| { if (skip_non_native and !c_abi_target.isNative()) continue; - const test_step = b.addTest("test/c_abi/main.zig"); - test_step.setTarget(c_abi_target); + const test_step = b.addTest(.{ + .root_source_file = .{ .path = "test/c_abi/main.zig" }, + .optimize = optimize_mode, + }); if (c_abi_target.abi != null and c_abi_target.abi.?.isMusl()) { // TODO NativeTargetInfo insists on dynamically linking musl // for some reason? @@ -1351,7 +1368,6 @@ pub fn addCAbiTests(b: *build.Builder, skip_non_native: bool, skip_release: bool } test_step.linkLibC(); test_step.addCSourceFile("test/c_abi/cfuncs.c", &.{"-std=c99"}); - test_step.setBuildMode(mode); if (c_abi_target.isWindows() and (c_abi_target.getCpuArch() == .x86 or builtin.target.os.tag == .linux)) { // LTO currently incorrectly strips stdcall name-mangled functions @@ -1363,7 +1379,7 @@ pub fn addCAbiTests(b: *build.Builder, skip_non_native: bool, skip_release: bool test_step.setNamePrefix(b.fmt("{s}-{s}-{s} ", .{ "test-c-abi", triple_prefix, - @tagName(mode), + @tagName(optimize_mode), })); step.dependOn(&test_step.step); From 36e2d992dd8c45ca89a51d508c6c413cff5ad2cd Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 31 Jan 2023 00:19:51 -0700 Subject: [PATCH 47/84] combine std.build and std.build.Builder into std.Build I've been wanting to do this for along time. --- build.zig | 31 +- doc/langref.html.in | 20 +- lib/build_runner.zig | 9 +- lib/init-exe/build.zig | 2 +- lib/init-lib/build.zig | 2 +- lib/std/Build.zig | 1771 ++++++++++++++++ lib/std/{build => Build}/CheckFileStep.zig | 12 +- lib/std/{build => Build}/CheckObjectStep.zig | 18 +- lib/std/{build => Build}/ConfigHeaderStep.zig | 9 +- .../{build => Build}/EmulatableRunStep.zig | 12 +- lib/std/{build => Build}/FmtStep.zig | 11 +- .../{build => Build}/InstallArtifactStep.zig | 21 +- lib/std/{build => Build}/InstallDirStep.zig | 14 +- lib/std/{build => Build}/InstallFileStep.zig | 14 +- lib/std/{build => Build}/InstallRawStep.zig | 24 +- lib/std/{build => Build}/LibExeObjStep.zig | 62 +- lib/std/{build => Build}/LogStep.zig | 8 +- lib/std/{build => Build}/OptionsStep.zig | 18 +- lib/std/{build => Build}/RemoveDirStep.zig | 8 +- lib/std/{build => Build}/RunStep.zig | 26 +- lib/std/Build/Step.zig | 97 + lib/std/{build => Build}/TranslateCStep.zig | 22 +- lib/std/{build => Build}/WriteFileStep.zig | 16 +- lib/std/build.zig | 1863 ----------------- lib/std/std.zig | 8 +- test/link/bss/build.zig | 4 +- test/link/common_symbols/build.zig | 4 +- test/link/common_symbols_alignment/build.zig | 4 +- .../interdependent_static_c_libs/build.zig | 4 +- test/link/macho/bugs/13056/build.zig | 3 +- test/link/macho/bugs/13457/build.zig | 5 +- test/link/macho/dead_strip/build.zig | 7 +- test/link/macho/dead_strip_dylibs/build.zig | 7 +- test/link/macho/dylib/build.zig | 3 +- test/link/macho/empty/build.zig | 5 +- test/link/macho/entry/build.zig | 3 +- test/link/macho/headerpad/build.zig | 7 +- test/link/macho/linksection/build.zig | 2 +- test/link/macho/needed_framework/build.zig | 5 +- test/link/macho/needed_library/build.zig | 5 +- test/link/macho/objc/build.zig | 5 +- test/link/macho/objcpp/build.zig | 3 +- test/link/macho/pagezero/build.zig | 3 +- test/link/macho/search_strategy/build.zig | 13 +- test/link/macho/stack_size/build.zig | 3 +- test/link/macho/strict_validation/build.zig | 5 +- test/link/macho/tls/build.zig | 3 +- test/link/macho/unwind_info/build.zig | 11 +- test/link/macho/uuid/build.zig | 11 +- test/link/macho/weak_framework/build.zig | 5 +- test/link/macho/weak_library/build.zig | 5 +- test/link/static_lib_as_system_lib/build.zig | 3 +- test/link/wasm/archive/build.zig | 3 +- test/link/wasm/basic-features/build.zig | 2 +- test/link/wasm/bss/build.zig | 3 +- test/link/wasm/export-data/build.zig | 3 +- test/link/wasm/export/build.zig | 2 +- test/link/wasm/extern-mangle/build.zig | 3 +- test/link/wasm/extern/build.zig | 2 +- test/link/wasm/function-table/build.zig | 3 +- test/link/wasm/infer-features/build.zig | 2 +- test/link/wasm/producers/build.zig | 3 +- test/link/wasm/segments/build.zig | 3 +- test/link/wasm/stack_pointer/build.zig | 3 +- test/link/wasm/type/build.zig | 3 +- test/src/compare_output.zig | 5 +- test/src/run_translated_c.zig | 5 +- test/src/translate_c.zig | 5 +- test/standalone/brace_expansion/build.zig | 4 +- test/standalone/c_compiler/build.zig | 5 +- test/standalone/emit_asm_and_bin/build.zig | 4 +- test/standalone/empty_env/build.zig | 4 +- test/standalone/global_linkage/build.zig | 4 +- test/standalone/install_raw_hex/build.zig | 4 +- test/standalone/issue_11595/build.zig | 5 +- test/standalone/issue_12588/build.zig | 3 +- test/standalone/issue_12706/build.zig | 5 +- test/standalone/issue_13030/build.zig | 3 +- test/standalone/issue_339/build.zig | 4 +- test/standalone/issue_5825/build.zig | 4 +- test/standalone/issue_7030/build.zig | 4 +- test/standalone/issue_794/build.zig | 4 +- test/standalone/issue_8550/build.zig | 2 +- test/standalone/issue_9812/build.zig | 2 +- .../standalone/load_dynamic_library/build.zig | 4 +- test/standalone/main_pkg_path/build.zig | 4 +- test/standalone/mix_c_files/build.zig | 5 +- test/standalone/mix_o_files/build.zig | 4 +- test/standalone/options/build.zig | 2 +- test/standalone/pie/build.zig | 4 +- test/standalone/pkg_import/build.zig | 4 +- test/standalone/shared_library/build.zig | 4 +- test/standalone/static_c_lib/build.zig | 4 +- test/standalone/test_runner_path/build.zig | 4 +- test/standalone/use_alias/build.zig | 4 +- test/standalone/windows_spawn/build.zig | 4 +- test/tests.zig | 60 +- 97 files changed, 2197 insertions(+), 2257 deletions(-) create mode 100644 lib/std/Build.zig rename lib/std/{build => Build}/CheckFileStep.zig (88%) rename lib/std/{build => Build}/CheckObjectStep.zig (98%) rename lib/std/{build => Build}/ConfigHeaderStep.zig (97%) rename lib/std/{build => Build}/EmulatableRunStep.zig (96%) rename lib/std/{build => Build}/FmtStep.zig (75%) rename lib/std/{build => Build}/InstallArtifactStep.zig (88%) rename lib/std/{build => Build}/InstallDirStep.zig (92%) rename lib/std/{build => Build}/InstallFileStep.zig (82%) rename lib/std/{build => Build}/InstallRawStep.zig (84%) rename lib/std/{build => Build}/LibExeObjStep.zig (97%) rename lib/std/{build => Build}/LogStep.zig (72%) rename lib/std/{build => Build}/OptionsStep.zig (97%) rename lib/std/{build => Build}/RemoveDirStep.zig (79%) rename lib/std/{build => Build}/RunStep.zig (94%) create mode 100644 lib/std/Build/Step.zig rename lib/std/{build => Build}/TranslateCStep.zig (90%) rename lib/std/{build => Build}/WriteFileStep.zig (91%) delete mode 100644 lib/std/build.zig diff --git a/build.zig b/build.zig index 98da9f31ee..6b6c384fc4 100644 --- a/build.zig +++ b/build.zig @@ -1,19 +1,18 @@ const std = @import("std"); const builtin = std.builtin; -const Builder = std.build.Builder; const tests = @import("test/tests.zig"); const BufMap = std.BufMap; const mem = std.mem; const ArrayList = std.ArrayList; const io = std.io; const fs = std.fs; -const InstallDirectoryOptions = std.build.InstallDirectoryOptions; +const InstallDirectoryOptions = std.Build.InstallDirectoryOptions; const assert = std.debug.assert; const zig_version = std.builtin.Version{ .major = 0, .minor = 11, .patch = 0 }; const stack_size = 32 * 1024 * 1024; -pub fn build(b: *Builder) !void { +pub fn build(b: *std.Build) !void { const release = b.option(bool, "release", "Build in release mode") orelse false; const only_c = b.option(bool, "only-c", "Translate the Zig compiler to C code, with only the C backend enabled") orelse false; const target = t: { @@ -477,7 +476,7 @@ pub fn build(b: *Builder) !void { try addWasiUpdateStep(b, version); } -fn addWasiUpdateStep(b: *Builder, version: [:0]const u8) !void { +fn addWasiUpdateStep(b: *std.Build, version: [:0]const u8) !void { const semver = try std.SemanticVersion.parse(version); var target: std.zig.CrossTarget = .{ @@ -514,10 +513,10 @@ fn addWasiUpdateStep(b: *Builder, version: [:0]const u8) !void { } fn addCompilerStep( - b: *Builder, + b: *std.Build, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget, -) *std.build.LibExeObjStep { +) *std.Build.LibExeObjStep { const exe = b.addExecutable(.{ .name = "zig", .root_source_file = .{ .path = "src/main.zig" }, @@ -543,9 +542,9 @@ const exe_cflags = [_][]const u8{ }; fn addCmakeCfgOptionsToExe( - b: *Builder, + b: *std.Build, cfg: CMakeConfig, - exe: *std.build.LibExeObjStep, + exe: *std.Build.LibExeObjStep, use_zig_libcxx: bool, ) !void { if (exe.target.isDarwin()) { @@ -624,7 +623,7 @@ fn addCmakeCfgOptionsToExe( } } -fn addStaticLlvmOptionsToExe(exe: *std.build.LibExeObjStep) !void { +fn addStaticLlvmOptionsToExe(exe: *std.Build.LibExeObjStep) !void { // Adds the Zig C++ sources which both stage1 and stage2 need. // // We need this because otherwise zig_clang_cc1_main.cpp ends up pulling @@ -661,9 +660,9 @@ fn addStaticLlvmOptionsToExe(exe: *std.build.LibExeObjStep) !void { } fn addCxxKnownPath( - b: *Builder, + b: *std.Build, ctx: CMakeConfig, - exe: *std.build.LibExeObjStep, + exe: *std.Build.LibExeObjStep, objname: []const u8, errtxt: ?[]const u8, need_cpp_includes: bool, @@ -696,7 +695,7 @@ fn addCxxKnownPath( } } -fn addCMakeLibraryList(exe: *std.build.LibExeObjStep, list: []const u8) void { +fn addCMakeLibraryList(exe: *std.Build.LibExeObjStep, list: []const u8) void { var it = mem.tokenize(u8, list, ";"); while (it.next()) |lib| { if (mem.startsWith(u8, lib, "-l")) { @@ -710,7 +709,7 @@ fn addCMakeLibraryList(exe: *std.build.LibExeObjStep, list: []const u8) void { } const CMakeConfig = struct { - llvm_linkage: std.build.LibExeObjStep.Linkage, + llvm_linkage: std.Build.LibExeObjStep.Linkage, cmake_binary_dir: []const u8, cmake_prefix_path: []const u8, cmake_static_library_prefix: []const u8, @@ -727,7 +726,7 @@ const CMakeConfig = struct { const max_config_h_bytes = 1 * 1024 * 1024; -fn findConfigH(b: *Builder, config_h_path_option: ?[]const u8) ?[]const u8 { +fn findConfigH(b: *std.Build, config_h_path_option: ?[]const u8) ?[]const u8 { if (config_h_path_option) |path| { var config_h_or_err = fs.cwd().openFile(path, .{}); if (config_h_or_err) |*file| { @@ -773,7 +772,7 @@ fn findConfigH(b: *Builder, config_h_path_option: ?[]const u8) ?[]const u8 { } else unreachable; // TODO should not need `else unreachable`. } -fn parseConfigH(b: *Builder, config_h_text: []const u8) ?CMakeConfig { +fn parseConfigH(b: *std.Build, config_h_text: []const u8) ?CMakeConfig { var ctx: CMakeConfig = .{ .llvm_linkage = undefined, .cmake_binary_dir = undefined, @@ -862,7 +861,7 @@ fn parseConfigH(b: *Builder, config_h_text: []const u8) ?CMakeConfig { return ctx; } -fn toNativePathSep(b: *Builder, s: []const u8) []u8 { +fn toNativePathSep(b: *std.Build, s: []const u8) []u8 { const duplicated = b.allocator.dupe(u8, s) catch unreachable; for (duplicated) |*byte| switch (byte.*) { '/' => byte.* = fs.path.sep, diff --git a/doc/langref.html.in b/doc/langref.html.in index c008149f41..1163ad0200 100644 --- a/doc/langref.html.in +++ b/doc/langref.html.in @@ -9528,9 +9528,9 @@ fn foo(comptime T: type, ptr: *T) T { To add standard build options to a build.zig file:

{#code_begin|syntax|build#} -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const exe = b.addExecutable(.{ .name = "example", @@ -10551,9 +10551,9 @@ const separator = if (builtin.os.tag == .windows) '\\' else '/';

This build.zig file is automatically generated by zig init-exe.

{#code_begin|syntax|build_executable#} -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { // Standard target options allows the person running `zig build` to choose // what target to build for. Here we do not override the defaults, which // means any target is allowed, and the default is native. Other options @@ -10588,9 +10588,9 @@ pub fn build(b: *Builder) void {

This build.zig file is automatically generated by zig init-lib.

{#code_begin|syntax|build_library#} -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const lib = b.addStaticLibrary(.{ .name = "example", @@ -10961,9 +10961,9 @@ int main(int argc, char **argv) { } {#end_syntax_block#} {#code_begin|syntax|build_c#} -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const lib = b.addSharedLibrary("mathtest", "mathtest.zig", b.version(1, 0, 0)); const exe = b.addExecutable(.{ @@ -11025,9 +11025,9 @@ int main(int argc, char **argv) { } {#end_syntax_block#} {#code_begin|syntax|build_object#} -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const obj = b.addObject("base64", "base64.zig"); const exe = b.addExecutable(.{ diff --git a/lib/build_runner.zig b/lib/build_runner.zig index 4df2eb1d62..189b118787 100644 --- a/lib/build_runner.zig +++ b/lib/build_runner.zig @@ -3,7 +3,6 @@ const std = @import("std"); const builtin = @import("builtin"); const io = std.io; const fmt = std.fmt; -const Builder = std.build.Builder; const mem = std.mem; const process = std.process; const ArrayList = std.ArrayList; @@ -42,7 +41,7 @@ pub fn main() !void { return error.InvalidArgs; }; - const builder = try Builder.create( + const builder = try std.Build.create( allocator, zig_exe, build_root, @@ -58,7 +57,7 @@ pub fn main() !void { const stdout_stream = io.getStdOut().writer(); var install_prefix: ?[]const u8 = null; - var dir_list = Builder.DirList{}; + var dir_list = std.Build.DirList{}; // before arg parsing, check for the NO_COLOR environment variable // if it exists, default the color setting to .off @@ -230,7 +229,7 @@ pub fn main() !void { }; } -fn usage(builder: *Builder, already_ran_build: bool, out_stream: anytype) !void { +fn usage(builder: *std.Build, already_ran_build: bool, out_stream: anytype) !void { // run the build script to collect the options if (!already_ran_build) { builder.resolveInstallPrefix(null, .{}); @@ -330,7 +329,7 @@ fn usage(builder: *Builder, already_ran_build: bool, out_stream: anytype) !void ); } -fn usageAndErr(builder: *Builder, already_ran_build: bool, out_stream: anytype) void { +fn usageAndErr(builder: *std.Build, already_ran_build: bool, out_stream: anytype) void { usage(builder, already_ran_build, out_stream) catch {}; process.exit(1); } diff --git a/lib/init-exe/build.zig b/lib/init-exe/build.zig index 36e5feddec..b88515b403 100644 --- a/lib/init-exe/build.zig +++ b/lib/init-exe/build.zig @@ -3,7 +3,7 @@ const std = @import("std"); // Although this function looks imperative, note that its job is to // declaratively construct a build graph that will be executed by an external // runner. -pub fn build(b: *std.build.Builder) void { +pub fn build(b: *std.Build) void { // Standard target options allows the person running `zig build` to choose // what target to build for. Here we do not override the defaults, which // means any target is allowed, and the default is native. Other options diff --git a/lib/init-lib/build.zig b/lib/init-lib/build.zig index 4a7b700dc2..5ebb55373f 100644 --- a/lib/init-lib/build.zig +++ b/lib/init-lib/build.zig @@ -3,7 +3,7 @@ const std = @import("std"); // Although this function looks imperative, note that its job is to // declaratively construct a build graph that will be executed by an external // runner. -pub fn build(b: *std.build.Builder) void { +pub fn build(b: *std.Build) void { // Standard target options allows the person running `zig build` to choose // what target to build for. Here we do not override the defaults, which // means any target is allowed, and the default is native. Other options diff --git a/lib/std/Build.zig b/lib/std/Build.zig new file mode 100644 index 0000000000..a3c579c743 --- /dev/null +++ b/lib/std/Build.zig @@ -0,0 +1,1771 @@ +const std = @import("std.zig"); +const builtin = @import("builtin"); +const io = std.io; +const fs = std.fs; +const mem = std.mem; +const debug = std.debug; +const panic = std.debug.panic; +const assert = debug.assert; +const log = std.log; +const ArrayList = std.ArrayList; +const StringHashMap = std.StringHashMap; +const Allocator = mem.Allocator; +const process = std.process; +const EnvMap = std.process.EnvMap; +const fmt_lib = std.fmt; +const File = std.fs.File; +const CrossTarget = std.zig.CrossTarget; +const NativeTargetInfo = std.zig.system.NativeTargetInfo; +const Sha256 = std.crypto.hash.sha2.Sha256; +const Build = @This(); + +pub const Step = @import("Build/Step.zig"); +pub const CheckFileStep = @import("Build/CheckFileStep.zig"); +pub const CheckObjectStep = @import("Build/CheckObjectStep.zig"); +pub const ConfigHeaderStep = @import("Build/ConfigHeaderStep.zig"); +pub const EmulatableRunStep = @import("Build/EmulatableRunStep.zig"); +pub const FmtStep = @import("Build/FmtStep.zig"); +pub const InstallArtifactStep = @import("Build/InstallArtifactStep.zig"); +pub const InstallDirStep = @import("Build/InstallDirStep.zig"); +pub const InstallFileStep = @import("Build/InstallFileStep.zig"); +pub const InstallRawStep = @import("Build/InstallRawStep.zig"); +pub const LibExeObjStep = @import("Build/LibExeObjStep.zig"); +pub const LogStep = @import("Build/LogStep.zig"); +pub const OptionsStep = @import("Build/OptionsStep.zig"); +pub const RemoveDirStep = @import("Build/RemoveDirStep.zig"); +pub const RunStep = @import("Build/RunStep.zig"); +pub const TranslateCStep = @import("Build/TranslateCStep.zig"); +pub const WriteFileStep = @import("Build/WriteFileStep.zig"); + +install_tls: TopLevelStep, +uninstall_tls: TopLevelStep, +allocator: Allocator, +user_input_options: UserInputOptionsMap, +available_options_map: AvailableOptionsMap, +available_options_list: ArrayList(AvailableOption), +verbose: bool, +verbose_link: bool, +verbose_cc: bool, +verbose_air: bool, +verbose_llvm_ir: bool, +verbose_cimport: bool, +verbose_llvm_cpu_features: bool, +/// The purpose of executing the command is for a human to read compile errors from the terminal +prominent_compile_errors: bool, +color: enum { auto, on, off } = .auto, +reference_trace: ?u32 = null, +invalid_user_input: bool, +zig_exe: []const u8, +default_step: *Step, +env_map: *EnvMap, +top_level_steps: ArrayList(*TopLevelStep), +install_prefix: []const u8, +dest_dir: ?[]const u8, +lib_dir: []const u8, +exe_dir: []const u8, +h_dir: []const u8, +install_path: []const u8, +sysroot: ?[]const u8 = null, +search_prefixes: ArrayList([]const u8), +libc_file: ?[]const u8 = null, +installed_files: ArrayList(InstalledFile), +/// Path to the directory containing build.zig. +build_root: []const u8, +cache_root: []const u8, +global_cache_root: []const u8, +/// zig lib dir +override_lib_dir: ?[]const u8, +vcpkg_root: VcpkgRoot = .unattempted, +pkg_config_pkg_list: ?(PkgConfigError![]const PkgConfigPkg) = null, +args: ?[][]const u8 = null, +debug_log_scopes: []const []const u8 = &.{}, +debug_compile_errors: bool = false, + +/// Experimental. Use system Darling installation to run cross compiled macOS build artifacts. +enable_darling: bool = false, +/// Use system QEMU installation to run cross compiled foreign architecture build artifacts. +enable_qemu: bool = false, +/// Darwin. Use Rosetta to run x86_64 macOS build artifacts on arm64 macOS. +enable_rosetta: bool = false, +/// Use system Wasmtime installation to run cross compiled wasm/wasi build artifacts. +enable_wasmtime: bool = false, +/// Use system Wine installation to run cross compiled Windows build artifacts. +enable_wine: bool = false, +/// After following the steps in https://github.com/ziglang/zig/wiki/Updating-libc#glibc, +/// this will be the directory $glibc-build-dir/install/glibcs +/// Given the example of the aarch64 target, this is the directory +/// that contains the path `aarch64-linux-gnu/lib/ld-linux-aarch64.so.1`. +glibc_runtimes_dir: ?[]const u8 = null, + +/// Information about the native target. Computed before build() is invoked. +host: NativeTargetInfo, + +dep_prefix: []const u8 = "", + +pub const ExecError = error{ + ReadFailure, + ExitCodeFailure, + ProcessTerminated, + ExecNotSupported, +} || std.ChildProcess.SpawnError; + +pub const PkgConfigError = error{ + PkgConfigCrashed, + PkgConfigFailed, + PkgConfigNotInstalled, + PkgConfigInvalidOutput, +}; + +pub const PkgConfigPkg = struct { + name: []const u8, + desc: []const u8, +}; + +pub const CStd = enum { + C89, + C99, + C11, +}; + +const UserInputOptionsMap = StringHashMap(UserInputOption); +const AvailableOptionsMap = StringHashMap(AvailableOption); + +const AvailableOption = struct { + name: []const u8, + type_id: TypeId, + description: []const u8, + /// If the `type_id` is `enum` this provides the list of enum options + enum_options: ?[]const []const u8, +}; + +const UserInputOption = struct { + name: []const u8, + value: UserValue, + used: bool, +}; + +const UserValue = union(enum) { + flag: void, + scalar: []const u8, + list: ArrayList([]const u8), + map: StringHashMap(*const UserValue), +}; + +const TypeId = enum { + bool, + int, + float, + @"enum", + string, + list, +}; + +const TopLevelStep = struct { + pub const base_id = .top_level; + + step: Step, + description: []const u8, +}; + +pub const DirList = struct { + lib_dir: ?[]const u8 = null, + exe_dir: ?[]const u8 = null, + include_dir: ?[]const u8 = null, +}; + +pub fn create( + allocator: Allocator, + zig_exe: []const u8, + build_root: []const u8, + cache_root: []const u8, + global_cache_root: []const u8, +) !*Build { + const env_map = try allocator.create(EnvMap); + env_map.* = try process.getEnvMap(allocator); + + const host = try NativeTargetInfo.detect(.{}); + + const self = try allocator.create(Build); + self.* = Build{ + .zig_exe = zig_exe, + .build_root = build_root, + .cache_root = try fs.path.relative(allocator, build_root, cache_root), + .global_cache_root = global_cache_root, + .verbose = false, + .verbose_link = false, + .verbose_cc = false, + .verbose_air = false, + .verbose_llvm_ir = false, + .verbose_cimport = false, + .verbose_llvm_cpu_features = false, + .prominent_compile_errors = false, + .invalid_user_input = false, + .allocator = allocator, + .user_input_options = UserInputOptionsMap.init(allocator), + .available_options_map = AvailableOptionsMap.init(allocator), + .available_options_list = ArrayList(AvailableOption).init(allocator), + .top_level_steps = ArrayList(*TopLevelStep).init(allocator), + .default_step = undefined, + .env_map = env_map, + .search_prefixes = ArrayList([]const u8).init(allocator), + .install_prefix = undefined, + .lib_dir = undefined, + .exe_dir = undefined, + .h_dir = undefined, + .dest_dir = env_map.get("DESTDIR"), + .installed_files = ArrayList(InstalledFile).init(allocator), + .install_tls = TopLevelStep{ + .step = Step.initNoOp(.top_level, "install", allocator), + .description = "Copy build artifacts to prefix path", + }, + .uninstall_tls = TopLevelStep{ + .step = Step.init(.top_level, "uninstall", allocator, makeUninstall), + .description = "Remove build artifacts from prefix path", + }, + .override_lib_dir = null, + .install_path = undefined, + .args = null, + .host = host, + }; + try self.top_level_steps.append(&self.install_tls); + try self.top_level_steps.append(&self.uninstall_tls); + self.default_step = &self.install_tls.step; + return self; +} + +fn createChild( + parent: *Build, + dep_name: []const u8, + build_root: []const u8, + args: anytype, +) !*Build { + const child = try createChildOnly(parent, dep_name, build_root); + try applyArgs(child, args); + return child; +} + +fn createChildOnly(parent: *Build, dep_name: []const u8, build_root: []const u8) !*Build { + const allocator = parent.allocator; + const child = try allocator.create(Build); + child.* = .{ + .allocator = allocator, + .install_tls = .{ + .step = Step.initNoOp(.top_level, "install", allocator), + .description = "Copy build artifacts to prefix path", + }, + .uninstall_tls = .{ + .step = Step.init(.top_level, "uninstall", allocator, makeUninstall), + .description = "Remove build artifacts from prefix path", + }, + .user_input_options = UserInputOptionsMap.init(allocator), + .available_options_map = AvailableOptionsMap.init(allocator), + .available_options_list = ArrayList(AvailableOption).init(allocator), + .verbose = parent.verbose, + .verbose_link = parent.verbose_link, + .verbose_cc = parent.verbose_cc, + .verbose_air = parent.verbose_air, + .verbose_llvm_ir = parent.verbose_llvm_ir, + .verbose_cimport = parent.verbose_cimport, + .verbose_llvm_cpu_features = parent.verbose_llvm_cpu_features, + .prominent_compile_errors = parent.prominent_compile_errors, + .color = parent.color, + .reference_trace = parent.reference_trace, + .invalid_user_input = false, + .zig_exe = parent.zig_exe, + .default_step = undefined, + .env_map = parent.env_map, + .top_level_steps = ArrayList(*TopLevelStep).init(allocator), + .install_prefix = undefined, + .dest_dir = parent.dest_dir, + .lib_dir = parent.lib_dir, + .exe_dir = parent.exe_dir, + .h_dir = parent.h_dir, + .install_path = parent.install_path, + .sysroot = parent.sysroot, + .search_prefixes = ArrayList([]const u8).init(allocator), + .libc_file = parent.libc_file, + .installed_files = ArrayList(InstalledFile).init(allocator), + .build_root = build_root, + .cache_root = parent.cache_root, + .global_cache_root = parent.global_cache_root, + .override_lib_dir = parent.override_lib_dir, + .debug_log_scopes = parent.debug_log_scopes, + .debug_compile_errors = parent.debug_compile_errors, + .enable_darling = parent.enable_darling, + .enable_qemu = parent.enable_qemu, + .enable_rosetta = parent.enable_rosetta, + .enable_wasmtime = parent.enable_wasmtime, + .enable_wine = parent.enable_wine, + .glibc_runtimes_dir = parent.glibc_runtimes_dir, + .host = parent.host, + .dep_prefix = parent.fmt("{s}{s}.", .{ parent.dep_prefix, dep_name }), + }; + try child.top_level_steps.append(&child.install_tls); + try child.top_level_steps.append(&child.uninstall_tls); + child.default_step = &child.install_tls.step; + return child; +} + +fn applyArgs(b: *Build, args: anytype) !void { + inline for (@typeInfo(@TypeOf(args)).Struct.fields) |field| { + const v = @field(args, field.name); + const T = @TypeOf(v); + switch (T) { + CrossTarget => { + try b.user_input_options.put(field.name, .{ + .name = field.name, + .value = .{ .scalar = try v.zigTriple(b.allocator) }, + .used = false, + }); + try b.user_input_options.put("cpu", .{ + .name = "cpu", + .value = .{ .scalar = try serializeCpu(b.allocator, v.getCpu()) }, + .used = false, + }); + }, + []const u8 => { + try b.user_input_options.put(field.name, .{ + .name = field.name, + .value = .{ .scalar = v }, + .used = false, + }); + }, + else => switch (@typeInfo(T)) { + .Bool => { + try b.user_input_options.put(field.name, .{ + .name = field.name, + .value = .{ .scalar = if (v) "true" else "false" }, + .used = false, + }); + }, + .Enum => { + try b.user_input_options.put(field.name, .{ + .name = field.name, + .value = .{ .scalar = @tagName(v) }, + .used = false, + }); + }, + .Int => { + try b.user_input_options.put(field.name, .{ + .name = field.name, + .value = .{ .scalar = try std.fmt.allocPrint(b.allocator, "{d}", .{v}) }, + .used = false, + }); + }, + else => @compileError("option '" ++ field.name ++ "' has unsupported type: " ++ @typeName(T)), + }, + } + } + const Hasher = std.crypto.auth.siphash.SipHash128(1, 3); + // Random bytes to make unique. Refresh this with new random bytes when + // implementation is modified in a non-backwards-compatible way. + var hash = Hasher.init("ZaEsvQ5ClaA2IdH9"); + hash.update(b.dep_prefix); + // TODO additionally update the hash with `args`. + + var digest: [16]u8 = undefined; + hash.final(&digest); + var hash_basename: [digest.len * 2]u8 = undefined; + _ = std.fmt.bufPrint(&hash_basename, "{s}", .{std.fmt.fmtSliceHexLower(&digest)}) catch + unreachable; + + const install_prefix = b.pathJoin(&.{ b.cache_root, "i", &hash_basename }); + b.resolveInstallPrefix(install_prefix, .{}); +} + +pub fn destroy(self: *Build) void { + self.env_map.deinit(); + self.top_level_steps.deinit(); + self.allocator.destroy(self); +} + +/// This function is intended to be called by lib/build_runner.zig, not a build.zig file. +pub fn resolveInstallPrefix(self: *Build, install_prefix: ?[]const u8, dir_list: DirList) void { + if (self.dest_dir) |dest_dir| { + self.install_prefix = install_prefix orelse "/usr"; + self.install_path = self.pathJoin(&.{ dest_dir, self.install_prefix }); + } else { + self.install_prefix = install_prefix orelse + (self.pathJoin(&.{ self.build_root, "zig-out" })); + self.install_path = self.install_prefix; + } + + var lib_list = [_][]const u8{ self.install_path, "lib" }; + var exe_list = [_][]const u8{ self.install_path, "bin" }; + var h_list = [_][]const u8{ self.install_path, "include" }; + + if (dir_list.lib_dir) |dir| { + if (std.fs.path.isAbsolute(dir)) lib_list[0] = self.dest_dir orelse ""; + lib_list[1] = dir; + } + + if (dir_list.exe_dir) |dir| { + if (std.fs.path.isAbsolute(dir)) exe_list[0] = self.dest_dir orelse ""; + exe_list[1] = dir; + } + + if (dir_list.include_dir) |dir| { + if (std.fs.path.isAbsolute(dir)) h_list[0] = self.dest_dir orelse ""; + h_list[1] = dir; + } + + self.lib_dir = self.pathJoin(&lib_list); + self.exe_dir = self.pathJoin(&exe_list); + self.h_dir = self.pathJoin(&h_list); +} + +pub fn addOptions(self: *Build) *OptionsStep { + return OptionsStep.create(self); +} + +pub const ExecutableOptions = struct { + name: []const u8, + root_source_file: ?FileSource = null, + version: ?std.builtin.Version = null, + target: CrossTarget = .{}, + optimize: std.builtin.Mode = .Debug, + linkage: ?LibExeObjStep.Linkage = null, +}; + +pub fn addExecutable(b: *Build, options: ExecutableOptions) *LibExeObjStep { + return LibExeObjStep.create(b, .{ + .name = options.name, + .root_source_file = options.root_source_file, + .version = options.version, + .target = options.target, + .optimize = options.optimize, + .kind = .exe, + .linkage = options.linkage, + }); +} + +pub const ObjectOptions = struct { + name: []const u8, + root_source_file: ?FileSource = null, + target: CrossTarget, + optimize: std.builtin.Mode, +}; + +pub fn addObject(b: *Build, options: ObjectOptions) *LibExeObjStep { + return LibExeObjStep.create(b, .{ + .name = options.name, + .root_source_file = options.root_source_file, + .target = options.target, + .optimize = options.optimize, + .kind = .obj, + }); +} + +pub const SharedLibraryOptions = struct { + name: []const u8, + root_source_file: ?FileSource = null, + version: ?std.builtin.Version = null, + target: CrossTarget, + optimize: std.builtin.Mode, +}; + +pub fn addSharedLibrary(b: *Build, options: SharedLibraryOptions) *LibExeObjStep { + return LibExeObjStep.create(b, .{ + .name = options.name, + .root_source_file = options.root_source_file, + .kind = .lib, + .linkage = .dynamic, + .version = options.version, + .target = options.target, + .optimize = options.optimize, + }); +} + +pub const StaticLibraryOptions = struct { + name: []const u8, + root_source_file: ?FileSource = null, + target: CrossTarget, + optimize: std.builtin.Mode, + version: ?std.builtin.Version = null, +}; + +pub fn addStaticLibrary(b: *Build, options: StaticLibraryOptions) *LibExeObjStep { + return LibExeObjStep.create(b, .{ + .name = options.name, + .root_source_file = options.root_source_file, + .kind = .lib, + .linkage = .static, + .version = options.version, + .target = options.target, + .optimize = options.optimize, + }); +} + +pub const TestOptions = struct { + name: []const u8 = "test", + kind: LibExeObjStep.Kind = .@"test", + root_source_file: FileSource, + target: CrossTarget = .{}, + optimize: std.builtin.Mode = .Debug, + version: ?std.builtin.Version = null, +}; + +pub fn addTest(b: *Build, options: TestOptions) *LibExeObjStep { + return LibExeObjStep.create(b, .{ + .name = options.name, + .kind = options.kind, + .root_source_file = options.root_source_file, + .target = options.target, + .optimize = options.optimize, + }); +} + +pub const AssemblyOptions = struct { + name: []const u8, + source_file: FileSource, + target: CrossTarget, + optimize: std.builtin.Mode, +}; + +pub fn addAssembly(b: *Build, options: AssemblyOptions) *LibExeObjStep { + const obj_step = LibExeObjStep.create(b, .{ + .name = options.name, + .root_source_file = null, + .target = options.target, + .optimize = options.optimize, + }); + obj_step.addAssemblyFileSource(options.source_file.dupe(b)); + return obj_step; +} + +/// Initializes a RunStep with argv, which must at least have the path to the +/// executable. More command line arguments can be added with `addArg`, +/// `addArgs`, and `addArtifactArg`. +/// Be careful using this function, as it introduces a system dependency. +/// To run an executable built with zig build, see `LibExeObjStep.run`. +pub fn addSystemCommand(self: *Build, argv: []const []const u8) *RunStep { + assert(argv.len >= 1); + const run_step = RunStep.create(self, self.fmt("run {s}", .{argv[0]})); + run_step.addArgs(argv); + return run_step; +} + +pub fn addConfigHeader( + b: *Build, + source: FileSource, + style: ConfigHeaderStep.Style, + values: anytype, +) *ConfigHeaderStep { + const config_header_step = ConfigHeaderStep.create(b, source, style); + config_header_step.addValues(values); + return config_header_step; +} + +/// Allocator.dupe without the need to handle out of memory. +pub fn dupe(self: *Build, bytes: []const u8) []u8 { + return self.allocator.dupe(u8, bytes) catch unreachable; +} + +/// Duplicates an array of strings without the need to handle out of memory. +pub fn dupeStrings(self: *Build, strings: []const []const u8) [][]u8 { + const array = self.allocator.alloc([]u8, strings.len) catch unreachable; + for (strings) |s, i| { + array[i] = self.dupe(s); + } + return array; +} + +/// Duplicates a path and converts all slashes to the OS's canonical path separator. +pub fn dupePath(self: *Build, bytes: []const u8) []u8 { + const the_copy = self.dupe(bytes); + for (the_copy) |*byte| { + switch (byte.*) { + '/', '\\' => byte.* = fs.path.sep, + else => {}, + } + } + return the_copy; +} + +/// Duplicates a package recursively. +pub fn dupePkg(self: *Build, package: Pkg) Pkg { + var the_copy = Pkg{ + .name = self.dupe(package.name), + .source = package.source.dupe(self), + }; + + if (package.dependencies) |dependencies| { + const new_dependencies = self.allocator.alloc(Pkg, dependencies.len) catch unreachable; + the_copy.dependencies = new_dependencies; + + for (dependencies) |dep_package, i| { + new_dependencies[i] = self.dupePkg(dep_package); + } + } + return the_copy; +} + +pub fn addWriteFile(self: *Build, file_path: []const u8, data: []const u8) *WriteFileStep { + const write_file_step = self.addWriteFiles(); + write_file_step.add(file_path, data); + return write_file_step; +} + +pub fn addWriteFiles(self: *Build) *WriteFileStep { + const write_file_step = self.allocator.create(WriteFileStep) catch unreachable; + write_file_step.* = WriteFileStep.init(self); + return write_file_step; +} + +pub fn addLog(self: *Build, comptime format: []const u8, args: anytype) *LogStep { + const data = self.fmt(format, args); + const log_step = self.allocator.create(LogStep) catch unreachable; + log_step.* = LogStep.init(self, data); + return log_step; +} + +pub fn addRemoveDirTree(self: *Build, dir_path: []const u8) *RemoveDirStep { + const remove_dir_step = self.allocator.create(RemoveDirStep) catch unreachable; + remove_dir_step.* = RemoveDirStep.init(self, dir_path); + return remove_dir_step; +} + +pub fn addFmt(self: *Build, paths: []const []const u8) *FmtStep { + return FmtStep.create(self, paths); +} + +pub fn addTranslateC(self: *Build, options: TranslateCStep.Options) *TranslateCStep { + return TranslateCStep.create(self, options); +} + +pub fn make(self: *Build, step_names: []const []const u8) !void { + try self.makePath(self.cache_root); + + var wanted_steps = ArrayList(*Step).init(self.allocator); + defer wanted_steps.deinit(); + + if (step_names.len == 0) { + try wanted_steps.append(self.default_step); + } else { + for (step_names) |step_name| { + const s = try self.getTopLevelStepByName(step_name); + try wanted_steps.append(s); + } + } + + for (wanted_steps.items) |s| { + try self.makeOneStep(s); + } +} + +pub fn getInstallStep(self: *Build) *Step { + return &self.install_tls.step; +} + +pub fn getUninstallStep(self: *Build) *Step { + return &self.uninstall_tls.step; +} + +fn makeUninstall(uninstall_step: *Step) anyerror!void { + const uninstall_tls = @fieldParentPtr(TopLevelStep, "step", uninstall_step); + const self = @fieldParentPtr(Build, "uninstall_tls", uninstall_tls); + + for (self.installed_files.items) |installed_file| { + const full_path = self.getInstallPath(installed_file.dir, installed_file.path); + if (self.verbose) { + log.info("rm {s}", .{full_path}); + } + fs.cwd().deleteTree(full_path) catch {}; + } + + // TODO remove empty directories +} + +fn makeOneStep(self: *Build, s: *Step) anyerror!void { + if (s.loop_flag) { + log.err("Dependency loop detected:\n {s}", .{s.name}); + return error.DependencyLoopDetected; + } + s.loop_flag = true; + + for (s.dependencies.items) |dep| { + self.makeOneStep(dep) catch |err| { + if (err == error.DependencyLoopDetected) { + log.err(" {s}", .{s.name}); + } + return err; + }; + } + + s.loop_flag = false; + + try s.make(); +} + +fn getTopLevelStepByName(self: *Build, name: []const u8) !*Step { + for (self.top_level_steps.items) |top_level_step| { + if (mem.eql(u8, top_level_step.step.name, name)) { + return &top_level_step.step; + } + } + log.err("Cannot run step '{s}' because it does not exist", .{name}); + return error.InvalidStepName; +} + +pub fn option(self: *Build, comptime T: type, name_raw: []const u8, description_raw: []const u8) ?T { + const name = self.dupe(name_raw); + const description = self.dupe(description_raw); + const type_id = comptime typeToEnum(T); + const enum_options = if (type_id == .@"enum") blk: { + const fields = comptime std.meta.fields(T); + var options = ArrayList([]const u8).initCapacity(self.allocator, fields.len) catch unreachable; + + inline for (fields) |field| { + options.appendAssumeCapacity(field.name); + } + + break :blk options.toOwnedSlice() catch unreachable; + } else null; + const available_option = AvailableOption{ + .name = name, + .type_id = type_id, + .description = description, + .enum_options = enum_options, + }; + if ((self.available_options_map.fetchPut(name, available_option) catch unreachable) != null) { + panic("Option '{s}' declared twice", .{name}); + } + self.available_options_list.append(available_option) catch unreachable; + + const option_ptr = self.user_input_options.getPtr(name) orelse return null; + option_ptr.used = true; + switch (type_id) { + .bool => switch (option_ptr.value) { + .flag => return true, + .scalar => |s| { + if (mem.eql(u8, s, "true")) { + return true; + } else if (mem.eql(u8, s, "false")) { + return false; + } else { + log.err("Expected -D{s} to be a boolean, but received '{s}'\n", .{ name, s }); + self.markInvalidUserInput(); + return null; + } + }, + .list, .map => { + log.err("Expected -D{s} to be a boolean, but received a {s}.\n", .{ + name, @tagName(option_ptr.value), + }); + self.markInvalidUserInput(); + return null; + }, + }, + .int => switch (option_ptr.value) { + .flag, .list, .map => { + log.err("Expected -D{s} to be an integer, but received a {s}.\n", .{ + name, @tagName(option_ptr.value), + }); + self.markInvalidUserInput(); + return null; + }, + .scalar => |s| { + const n = std.fmt.parseInt(T, s, 10) catch |err| switch (err) { + error.Overflow => { + log.err("-D{s} value {s} cannot fit into type {s}.\n", .{ name, s, @typeName(T) }); + self.markInvalidUserInput(); + return null; + }, + else => { + log.err("Expected -D{s} to be an integer of type {s}.\n", .{ name, @typeName(T) }); + self.markInvalidUserInput(); + return null; + }, + }; + return n; + }, + }, + .float => switch (option_ptr.value) { + .flag, .map, .list => { + log.err("Expected -D{s} to be a float, but received a {s}.\n", .{ + name, @tagName(option_ptr.value), + }); + self.markInvalidUserInput(); + return null; + }, + .scalar => |s| { + const n = std.fmt.parseFloat(T, s) catch { + log.err("Expected -D{s} to be a float of type {s}.\n", .{ name, @typeName(T) }); + self.markInvalidUserInput(); + return null; + }; + return n; + }, + }, + .@"enum" => switch (option_ptr.value) { + .flag, .map, .list => { + log.err("Expected -D{s} to be an enum, but received a {s}.\n", .{ + name, @tagName(option_ptr.value), + }); + self.markInvalidUserInput(); + return null; + }, + .scalar => |s| { + if (std.meta.stringToEnum(T, s)) |enum_lit| { + return enum_lit; + } else { + log.err("Expected -D{s} to be of type {s}.\n", .{ name, @typeName(T) }); + self.markInvalidUserInput(); + return null; + } + }, + }, + .string => switch (option_ptr.value) { + .flag, .list, .map => { + log.err("Expected -D{s} to be a string, but received a {s}.\n", .{ + name, @tagName(option_ptr.value), + }); + self.markInvalidUserInput(); + return null; + }, + .scalar => |s| return s, + }, + .list => switch (option_ptr.value) { + .flag, .map => { + log.err("Expected -D{s} to be a list, but received a {s}.\n", .{ + name, @tagName(option_ptr.value), + }); + self.markInvalidUserInput(); + return null; + }, + .scalar => |s| { + return self.allocator.dupe([]const u8, &[_][]const u8{s}) catch unreachable; + }, + .list => |lst| return lst.items, + }, + } +} + +pub fn step(self: *Build, name: []const u8, description: []const u8) *Step { + const step_info = self.allocator.create(TopLevelStep) catch unreachable; + step_info.* = TopLevelStep{ + .step = Step.initNoOp(.top_level, name, self.allocator), + .description = self.dupe(description), + }; + self.top_level_steps.append(step_info) catch unreachable; + return &step_info.step; +} + +pub const StandardOptimizeOptionOptions = struct { + preferred_optimize_mode: ?std.builtin.Mode = null, +}; + +pub fn standardOptimizeOption(self: *Build, options: StandardOptimizeOptionOptions) std.builtin.Mode { + if (options.preferred_optimize_mode) |mode| { + if (self.option(bool, "release", "optimize for end users") orelse false) { + return mode; + } else { + return .Debug; + } + } else { + return self.option( + std.builtin.Mode, + "optimize", + "prioritize performance, safety, or binary size (-O flag)", + ) orelse .Debug; + } +} + +pub const StandardTargetOptionsArgs = struct { + whitelist: ?[]const CrossTarget = null, + + default_target: CrossTarget = CrossTarget{}, +}; + +/// Exposes standard `zig build` options for choosing a target. +pub fn standardTargetOptions(self: *Build, args: StandardTargetOptionsArgs) CrossTarget { + const maybe_triple = self.option( + []const u8, + "target", + "The CPU architecture, OS, and ABI to build for", + ); + const mcpu = self.option([]const u8, "cpu", "Target CPU features to add or subtract"); + + if (maybe_triple == null and mcpu == null) { + return args.default_target; + } + + const triple = maybe_triple orelse "native"; + + var diags: CrossTarget.ParseOptions.Diagnostics = .{}; + const selected_target = CrossTarget.parse(.{ + .arch_os_abi = triple, + .cpu_features = mcpu, + .diagnostics = &diags, + }) catch |err| switch (err) { + error.UnknownCpuModel => { + log.err("Unknown CPU: '{s}'\nAvailable CPUs for architecture '{s}':", .{ + diags.cpu_name.?, + @tagName(diags.arch.?), + }); + for (diags.arch.?.allCpuModels()) |cpu| { + log.err(" {s}", .{cpu.name}); + } + self.markInvalidUserInput(); + return args.default_target; + }, + error.UnknownCpuFeature => { + log.err( + \\Unknown CPU feature: '{s}' + \\Available CPU features for architecture '{s}': + \\ + , .{ + diags.unknown_feature_name.?, + @tagName(diags.arch.?), + }); + for (diags.arch.?.allFeaturesList()) |feature| { + log.err(" {s}: {s}", .{ feature.name, feature.description }); + } + self.markInvalidUserInput(); + return args.default_target; + }, + error.UnknownOperatingSystem => { + log.err( + \\Unknown OS: '{s}' + \\Available operating systems: + \\ + , .{diags.os_name.?}); + inline for (std.meta.fields(std.Target.Os.Tag)) |field| { + log.err(" {s}", .{field.name}); + } + self.markInvalidUserInput(); + return args.default_target; + }, + else => |e| { + log.err("Unable to parse target '{s}': {s}\n", .{ triple, @errorName(e) }); + self.markInvalidUserInput(); + return args.default_target; + }, + }; + + const selected_canonicalized_triple = selected_target.zigTriple(self.allocator) catch unreachable; + + if (args.whitelist) |list| whitelist_check: { + // Make sure it's a match of one of the list. + var mismatch_triple = true; + var mismatch_cpu_features = true; + var whitelist_item = CrossTarget{}; + for (list) |t| { + mismatch_cpu_features = true; + mismatch_triple = true; + + const t_triple = t.zigTriple(self.allocator) catch unreachable; + if (mem.eql(u8, t_triple, selected_canonicalized_triple)) { + mismatch_triple = false; + whitelist_item = t; + if (t.getCpuFeatures().isSuperSetOf(selected_target.getCpuFeatures())) { + mismatch_cpu_features = false; + break :whitelist_check; + } else { + break; + } + } + } + if (mismatch_triple) { + log.err("Chosen target '{s}' does not match one of the supported targets:", .{ + selected_canonicalized_triple, + }); + for (list) |t| { + const t_triple = t.zigTriple(self.allocator) catch unreachable; + log.err(" {s}", .{t_triple}); + } + } else { + assert(mismatch_cpu_features); + const whitelist_cpu = whitelist_item.getCpu(); + const selected_cpu = selected_target.getCpu(); + log.err("Chosen CPU model '{s}' does not match one of the supported targets:", .{ + selected_cpu.model.name, + }); + log.err(" Supported feature Set: ", .{}); + const all_features = whitelist_cpu.arch.allFeaturesList(); + var populated_cpu_features = whitelist_cpu.model.features; + populated_cpu_features.populateDependencies(all_features); + for (all_features) |feature, i_usize| { + const i = @intCast(std.Target.Cpu.Feature.Set.Index, i_usize); + const in_cpu_set = populated_cpu_features.isEnabled(i); + if (in_cpu_set) { + log.err("{s} ", .{feature.name}); + } + } + log.err(" Remove: ", .{}); + for (all_features) |feature, i_usize| { + const i = @intCast(std.Target.Cpu.Feature.Set.Index, i_usize); + const in_cpu_set = populated_cpu_features.isEnabled(i); + const in_actual_set = selected_cpu.features.isEnabled(i); + if (in_actual_set and !in_cpu_set) { + log.err("{s} ", .{feature.name}); + } + } + } + self.markInvalidUserInput(); + return args.default_target; + } + + return selected_target; +} + +pub fn addUserInputOption(self: *Build, name_raw: []const u8, value_raw: []const u8) !bool { + const name = self.dupe(name_raw); + const value = self.dupe(value_raw); + const gop = try self.user_input_options.getOrPut(name); + if (!gop.found_existing) { + gop.value_ptr.* = UserInputOption{ + .name = name, + .value = .{ .scalar = value }, + .used = false, + }; + return false; + } + + // option already exists + switch (gop.value_ptr.value) { + .scalar => |s| { + // turn it into a list + var list = ArrayList([]const u8).init(self.allocator); + list.append(s) catch unreachable; + list.append(value) catch unreachable; + self.user_input_options.put(name, .{ + .name = name, + .value = .{ .list = list }, + .used = false, + }) catch unreachable; + }, + .list => |*list| { + // append to the list + list.append(value) catch unreachable; + self.user_input_options.put(name, .{ + .name = name, + .value = .{ .list = list.* }, + .used = false, + }) catch unreachable; + }, + .flag => { + log.warn("Option '-D{s}={s}' conflicts with flag '-D{s}'.", .{ name, value, name }); + return true; + }, + .map => |*map| { + _ = map; + log.warn("TODO maps as command line arguments is not implemented yet.", .{}); + return true; + }, + } + return false; +} + +pub fn addUserInputFlag(self: *Build, name_raw: []const u8) !bool { + const name = self.dupe(name_raw); + const gop = try self.user_input_options.getOrPut(name); + if (!gop.found_existing) { + gop.value_ptr.* = .{ + .name = name, + .value = .{ .flag = {} }, + .used = false, + }; + return false; + } + + // option already exists + switch (gop.value_ptr.value) { + .scalar => |s| { + log.err("Flag '-D{s}' conflicts with option '-D{s}={s}'.", .{ name, name, s }); + return true; + }, + .list, .map => { + log.err("Flag '-D{s}' conflicts with multiple options of the same name.", .{name}); + return true; + }, + .flag => {}, + } + return false; +} + +fn typeToEnum(comptime T: type) TypeId { + return switch (@typeInfo(T)) { + .Int => .int, + .Float => .float, + .Bool => .bool, + .Enum => .@"enum", + else => switch (T) { + []const u8 => .string, + []const []const u8 => .list, + else => @compileError("Unsupported type: " ++ @typeName(T)), + }, + }; +} + +fn markInvalidUserInput(self: *Build) void { + self.invalid_user_input = true; +} + +pub fn validateUserInputDidItFail(self: *Build) bool { + // make sure all args are used + var it = self.user_input_options.iterator(); + while (it.next()) |entry| { + if (!entry.value_ptr.used) { + log.err("Invalid option: -D{s}", .{entry.key_ptr.*}); + self.markInvalidUserInput(); + } + } + + return self.invalid_user_input; +} + +pub fn spawnChild(self: *Build, argv: []const []const u8) !void { + return self.spawnChildEnvMap(null, self.env_map, argv); +} + +fn printCmd(cwd: ?[]const u8, argv: []const []const u8) void { + if (cwd) |yes_cwd| std.debug.print("cd {s} && ", .{yes_cwd}); + for (argv) |arg| { + std.debug.print("{s} ", .{arg}); + } + std.debug.print("\n", .{}); +} + +pub fn spawnChildEnvMap(self: *Build, cwd: ?[]const u8, env_map: *const EnvMap, argv: []const []const u8) !void { + if (self.verbose) { + printCmd(cwd, argv); + } + + if (!std.process.can_spawn) + return error.ExecNotSupported; + + var child = std.ChildProcess.init(argv, self.allocator); + child.cwd = cwd; + child.env_map = env_map; + + const term = child.spawnAndWait() catch |err| { + log.err("Unable to spawn {s}: {s}", .{ argv[0], @errorName(err) }); + return err; + }; + + switch (term) { + .Exited => |code| { + if (code != 0) { + log.err("The following command exited with error code {}:", .{code}); + printCmd(cwd, argv); + return error.UncleanExit; + } + }, + else => { + log.err("The following command terminated unexpectedly:", .{}); + printCmd(cwd, argv); + + return error.UncleanExit; + }, + } +} + +pub fn makePath(self: *Build, path: []const u8) !void { + fs.cwd().makePath(self.pathFromRoot(path)) catch |err| { + log.err("Unable to create path {s}: {s}", .{ path, @errorName(err) }); + return err; + }; +} + +pub fn installArtifact(self: *Build, artifact: *LibExeObjStep) void { + self.getInstallStep().dependOn(&self.addInstallArtifact(artifact).step); +} + +pub fn addInstallArtifact(self: *Build, artifact: *LibExeObjStep) *InstallArtifactStep { + return InstallArtifactStep.create(self, artifact); +} + +///`dest_rel_path` is relative to prefix path +pub fn installFile(self: *Build, src_path: []const u8, dest_rel_path: []const u8) void { + self.getInstallStep().dependOn(&self.addInstallFileWithDir(.{ .path = src_path }, .prefix, dest_rel_path).step); +} + +pub fn installDirectory(self: *Build, options: InstallDirectoryOptions) void { + self.getInstallStep().dependOn(&self.addInstallDirectory(options).step); +} + +///`dest_rel_path` is relative to bin path +pub fn installBinFile(self: *Build, src_path: []const u8, dest_rel_path: []const u8) void { + self.getInstallStep().dependOn(&self.addInstallFileWithDir(.{ .path = src_path }, .bin, dest_rel_path).step); +} + +///`dest_rel_path` is relative to lib path +pub fn installLibFile(self: *Build, src_path: []const u8, dest_rel_path: []const u8) void { + self.getInstallStep().dependOn(&self.addInstallFileWithDir(.{ .path = src_path }, .lib, dest_rel_path).step); +} + +/// Output format (BIN vs Intel HEX) determined by filename +pub fn installRaw(self: *Build, artifact: *LibExeObjStep, dest_filename: []const u8, options: InstallRawStep.CreateOptions) *InstallRawStep { + const raw = self.addInstallRaw(artifact, dest_filename, options); + self.getInstallStep().dependOn(&raw.step); + return raw; +} + +///`dest_rel_path` is relative to install prefix path +pub fn addInstallFile(self: *Build, source: FileSource, dest_rel_path: []const u8) *InstallFileStep { + return self.addInstallFileWithDir(source.dupe(self), .prefix, dest_rel_path); +} + +///`dest_rel_path` is relative to bin path +pub fn addInstallBinFile(self: *Build, source: FileSource, dest_rel_path: []const u8) *InstallFileStep { + return self.addInstallFileWithDir(source.dupe(self), .bin, dest_rel_path); +} + +///`dest_rel_path` is relative to lib path +pub fn addInstallLibFile(self: *Build, source: FileSource, dest_rel_path: []const u8) *InstallFileStep { + return self.addInstallFileWithDir(source.dupe(self), .lib, dest_rel_path); +} + +pub fn addInstallHeaderFile(b: *Build, src_path: []const u8, dest_rel_path: []const u8) *InstallFileStep { + return b.addInstallFileWithDir(.{ .path = src_path }, .header, dest_rel_path); +} + +pub fn addInstallRaw(self: *Build, artifact: *LibExeObjStep, dest_filename: []const u8, options: InstallRawStep.CreateOptions) *InstallRawStep { + return InstallRawStep.create(self, artifact, dest_filename, options); +} + +pub fn addInstallFileWithDir( + self: *Build, + source: FileSource, + install_dir: InstallDir, + dest_rel_path: []const u8, +) *InstallFileStep { + if (dest_rel_path.len == 0) { + panic("dest_rel_path must be non-empty", .{}); + } + const install_step = self.allocator.create(InstallFileStep) catch unreachable; + install_step.* = InstallFileStep.init(self, source.dupe(self), install_dir, dest_rel_path); + return install_step; +} + +pub fn addInstallDirectory(self: *Build, options: InstallDirectoryOptions) *InstallDirStep { + const install_step = self.allocator.create(InstallDirStep) catch unreachable; + install_step.* = InstallDirStep.init(self, options); + return install_step; +} + +pub fn pushInstalledFile(self: *Build, dir: InstallDir, dest_rel_path: []const u8) void { + const file = InstalledFile{ + .dir = dir, + .path = dest_rel_path, + }; + self.installed_files.append(file.dupe(self)) catch unreachable; +} + +pub fn updateFile(self: *Build, source_path: []const u8, dest_path: []const u8) !void { + if (self.verbose) { + log.info("cp {s} {s} ", .{ source_path, dest_path }); + } + const cwd = fs.cwd(); + const prev_status = try fs.Dir.updateFile(cwd, source_path, cwd, dest_path, .{}); + if (self.verbose) switch (prev_status) { + .stale => log.info("# installed", .{}), + .fresh => log.info("# up-to-date", .{}), + }; +} + +pub fn truncateFile(self: *Build, dest_path: []const u8) !void { + if (self.verbose) { + log.info("truncate {s}", .{dest_path}); + } + const cwd = fs.cwd(); + var src_file = cwd.createFile(dest_path, .{}) catch |err| switch (err) { + error.FileNotFound => blk: { + if (fs.path.dirname(dest_path)) |dirname| { + try cwd.makePath(dirname); + } + break :blk try cwd.createFile(dest_path, .{}); + }, + else => |e| return e, + }; + src_file.close(); +} + +pub fn pathFromRoot(self: *Build, rel_path: []const u8) []u8 { + return fs.path.resolve(self.allocator, &[_][]const u8{ self.build_root, rel_path }) catch unreachable; +} + +/// Shorthand for `std.fs.path.join(Build.allocator, paths) catch unreachable` +pub fn pathJoin(self: *Build, paths: []const []const u8) []u8 { + return fs.path.join(self.allocator, paths) catch unreachable; +} + +pub fn fmt(self: *Build, comptime format: []const u8, args: anytype) []u8 { + return fmt_lib.allocPrint(self.allocator, format, args) catch unreachable; +} + +pub fn findProgram(self: *Build, names: []const []const u8, paths: []const []const u8) ![]const u8 { + // TODO report error for ambiguous situations + const exe_extension = @as(CrossTarget, .{}).exeFileExt(); + for (self.search_prefixes.items) |search_prefix| { + for (names) |name| { + if (fs.path.isAbsolute(name)) { + return name; + } + const full_path = self.pathJoin(&.{ + search_prefix, + "bin", + self.fmt("{s}{s}", .{ name, exe_extension }), + }); + return fs.realpathAlloc(self.allocator, full_path) catch continue; + } + } + if (self.env_map.get("PATH")) |PATH| { + for (names) |name| { + if (fs.path.isAbsolute(name)) { + return name; + } + var it = mem.tokenize(u8, PATH, &[_]u8{fs.path.delimiter}); + while (it.next()) |path| { + const full_path = self.pathJoin(&.{ + path, + self.fmt("{s}{s}", .{ name, exe_extension }), + }); + return fs.realpathAlloc(self.allocator, full_path) catch continue; + } + } + } + for (names) |name| { + if (fs.path.isAbsolute(name)) { + return name; + } + for (paths) |path| { + const full_path = self.pathJoin(&.{ + path, + self.fmt("{s}{s}", .{ name, exe_extension }), + }); + return fs.realpathAlloc(self.allocator, full_path) catch continue; + } + } + return error.FileNotFound; +} + +pub fn execAllowFail( + self: *Build, + argv: []const []const u8, + out_code: *u8, + stderr_behavior: std.ChildProcess.StdIo, +) ExecError![]u8 { + assert(argv.len != 0); + + if (!std.process.can_spawn) + return error.ExecNotSupported; + + const max_output_size = 400 * 1024; + var child = std.ChildProcess.init(argv, self.allocator); + child.stdin_behavior = .Ignore; + child.stdout_behavior = .Pipe; + child.stderr_behavior = stderr_behavior; + child.env_map = self.env_map; + + try child.spawn(); + + const stdout = child.stdout.?.reader().readAllAlloc(self.allocator, max_output_size) catch { + return error.ReadFailure; + }; + errdefer self.allocator.free(stdout); + + const term = try child.wait(); + switch (term) { + .Exited => |code| { + if (code != 0) { + out_code.* = @truncate(u8, code); + return error.ExitCodeFailure; + } + return stdout; + }, + .Signal, .Stopped, .Unknown => |code| { + out_code.* = @truncate(u8, code); + return error.ProcessTerminated; + }, + } +} + +pub fn execFromStep(self: *Build, argv: []const []const u8, src_step: ?*Step) ![]u8 { + assert(argv.len != 0); + + if (self.verbose) { + printCmd(null, argv); + } + + if (!std.process.can_spawn) { + if (src_step) |s| log.err("{s}...", .{s.name}); + log.err("Unable to spawn the following command: cannot spawn child process", .{}); + printCmd(null, argv); + std.os.abort(); + } + + var code: u8 = undefined; + return self.execAllowFail(argv, &code, .Inherit) catch |err| switch (err) { + error.ExecNotSupported => { + if (src_step) |s| log.err("{s}...", .{s.name}); + log.err("Unable to spawn the following command: cannot spawn child process", .{}); + printCmd(null, argv); + std.os.abort(); + }, + error.FileNotFound => { + if (src_step) |s| log.err("{s}...", .{s.name}); + log.err("Unable to spawn the following command: file not found", .{}); + printCmd(null, argv); + std.os.exit(@truncate(u8, code)); + }, + error.ExitCodeFailure => { + if (src_step) |s| log.err("{s}...", .{s.name}); + if (self.prominent_compile_errors) { + log.err("The step exited with error code {d}", .{code}); + } else { + log.err("The following command exited with error code {d}:", .{code}); + printCmd(null, argv); + } + + std.os.exit(@truncate(u8, code)); + }, + error.ProcessTerminated => { + if (src_step) |s| log.err("{s}...", .{s.name}); + log.err("The following command terminated unexpectedly:", .{}); + printCmd(null, argv); + std.os.exit(@truncate(u8, code)); + }, + else => |e| return e, + }; +} + +pub fn exec(self: *Build, argv: []const []const u8) ![]u8 { + return self.execFromStep(argv, null); +} + +pub fn addSearchPrefix(self: *Build, search_prefix: []const u8) void { + self.search_prefixes.append(self.dupePath(search_prefix)) catch unreachable; +} + +pub fn getInstallPath(self: *Build, dir: InstallDir, dest_rel_path: []const u8) []const u8 { + assert(!fs.path.isAbsolute(dest_rel_path)); // Install paths must be relative to the prefix + const base_dir = switch (dir) { + .prefix => self.install_path, + .bin => self.exe_dir, + .lib => self.lib_dir, + .header => self.h_dir, + .custom => |path| self.pathJoin(&.{ self.install_path, path }), + }; + return fs.path.resolve( + self.allocator, + &[_][]const u8{ base_dir, dest_rel_path }, + ) catch unreachable; +} + +pub const Dependency = struct { + builder: *Build, + + pub fn artifact(d: *Dependency, name: []const u8) *LibExeObjStep { + var found: ?*LibExeObjStep = null; + for (d.builder.install_tls.step.dependencies.items) |dep_step| { + const inst = dep_step.cast(InstallArtifactStep) orelse continue; + if (mem.eql(u8, inst.artifact.name, name)) { + if (found != null) panic("artifact name '{s}' is ambiguous", .{name}); + found = inst.artifact; + } + } + return found orelse { + for (d.builder.install_tls.step.dependencies.items) |dep_step| { + const inst = dep_step.cast(InstallArtifactStep) orelse continue; + log.info("available artifact: '{s}'", .{inst.artifact.name}); + } + panic("unable to find artifact '{s}'", .{name}); + }; + } +}; + +pub fn dependency(b: *Build, name: []const u8, args: anytype) *Dependency { + const build_runner = @import("root"); + const deps = build_runner.dependencies; + + inline for (@typeInfo(deps.imports).Struct.decls) |decl| { + if (mem.startsWith(u8, decl.name, b.dep_prefix) and + mem.endsWith(u8, decl.name, name) and + decl.name.len == b.dep_prefix.len + name.len) + { + const build_zig = @field(deps.imports, decl.name); + const build_root = @field(deps.build_root, decl.name); + return dependencyInner(b, name, build_root, build_zig, args); + } + } + + const full_path = b.pathFromRoot("build.zig.ini"); + std.debug.print("no dependency named '{s}' in '{s}'\n", .{ name, full_path }); + std.process.exit(1); +} + +fn dependencyInner( + b: *Build, + name: []const u8, + build_root: []const u8, + comptime build_zig: type, + args: anytype, +) *Dependency { + const sub_builder = b.createChild(name, build_root, args) catch unreachable; + sub_builder.runBuild(build_zig) catch unreachable; + + if (sub_builder.validateUserInputDidItFail()) { + std.debug.dumpCurrentStackTrace(@returnAddress()); + } + + const dep = b.allocator.create(Dependency) catch unreachable; + dep.* = .{ .builder = sub_builder }; + return dep; +} + +pub fn runBuild(b: *Build, build_zig: anytype) anyerror!void { + switch (@typeInfo(@typeInfo(@TypeOf(build_zig.build)).Fn.return_type.?)) { + .Void => build_zig.build(b), + .ErrorUnion => try build_zig.build(b), + else => @compileError("expected return type of build to be 'void' or '!void'"), + } +} + +test "builder.findProgram compiles" { + if (builtin.os.tag == .wasi) return error.SkipZigTest; + + var arena = std.heap.ArenaAllocator.init(std.heap.page_allocator); + defer arena.deinit(); + + const builder = try Build.create( + arena.allocator(), + "zig", + "zig-cache", + "zig-cache", + "zig-cache", + ); + defer builder.destroy(); + _ = builder.findProgram(&[_][]const u8{}, &[_][]const u8{}) catch null; +} + +pub const Pkg = struct { + name: []const u8, + source: FileSource, + dependencies: ?[]const Pkg = null, +}; + +/// A file that is generated by a build step. +/// This struct is an interface that is meant to be used with `@fieldParentPtr` to implement the actual path logic. +pub const GeneratedFile = struct { + /// The step that generates the file + step: *Step, + + /// The path to the generated file. Must be either absolute or relative to the build root. + /// This value must be set in the `fn make()` of the `step` and must not be `null` afterwards. + path: ?[]const u8 = null, + + pub fn getPath(self: GeneratedFile) []const u8 { + return self.path orelse std.debug.panic( + "getPath() was called on a GeneratedFile that wasn't build yet. Is there a missing Step dependency on step '{s}'?", + .{self.step.name}, + ); + } +}; + +/// A file source is a reference to an existing or future file. +/// +pub const FileSource = union(enum) { + /// A plain file path, relative to build root or absolute. + path: []const u8, + + /// A file that is generated by an interface. Those files usually are + /// not available until built by a build step. + generated: *const GeneratedFile, + + /// Returns a new file source that will have a relative path to the build root guaranteed. + /// This should be preferred over setting `.path` directly as it documents that the files are in the project directory. + pub fn relative(path: []const u8) FileSource { + std.debug.assert(!std.fs.path.isAbsolute(path)); + return FileSource{ .path = path }; + } + + /// Returns a string that can be shown to represent the file source. + /// Either returns the path or `"generated"`. + pub fn getDisplayName(self: FileSource) []const u8 { + return switch (self) { + .path => self.path, + .generated => "generated", + }; + } + + /// Adds dependencies this file source implies to the given step. + pub fn addStepDependencies(self: FileSource, other_step: *Step) void { + switch (self) { + .path => {}, + .generated => |gen| other_step.dependOn(gen.step), + } + } + + /// Should only be called during make(), returns a path relative to the build root or absolute. + pub fn getPath(self: FileSource, builder: *Build) []const u8 { + const path = switch (self) { + .path => |p| builder.pathFromRoot(p), + .generated => |gen| gen.getPath(), + }; + return path; + } + + /// Duplicates the file source for a given builder. + pub fn dupe(self: FileSource, b: *Build) FileSource { + return switch (self) { + .path => |p| .{ .path = b.dupePath(p) }, + .generated => |gen| .{ .generated = gen }, + }; + } +}; + +/// Allocates a new string for assigning a value to a named macro. +/// If the value is omitted, it is set to 1. +/// `name` and `value` need not live longer than the function call. +pub fn constructCMacro(allocator: Allocator, name: []const u8, value: ?[]const u8) []const u8 { + var macro = allocator.alloc( + u8, + name.len + if (value) |value_slice| value_slice.len + 1 else 0, + ) catch |err| if (err == error.OutOfMemory) @panic("Out of memory") else unreachable; + mem.copy(u8, macro, name); + if (value) |value_slice| { + macro[name.len] = '='; + mem.copy(u8, macro[name.len + 1 ..], value_slice); + } + return macro; +} + +/// deprecated: use `InstallDirStep.Options` +pub const InstallDirectoryOptions = InstallDirStep.Options; + +pub const VcpkgRoot = union(VcpkgRootStatus) { + unattempted: void, + not_found: void, + found: []const u8, +}; + +pub const VcpkgRootStatus = enum { + unattempted, + not_found, + found, +}; + +pub const InstallDir = union(enum) { + prefix: void, + lib: void, + bin: void, + header: void, + /// A path relative to the prefix + custom: []const u8, + + /// Duplicates the install directory including the path if set to custom. + pub fn dupe(self: InstallDir, builder: *Build) InstallDir { + if (self == .custom) { + // Written with this temporary to avoid RLS problems + const duped_path = builder.dupe(self.custom); + return .{ .custom = duped_path }; + } else { + return self; + } + } +}; + +pub const InstalledFile = struct { + dir: InstallDir, + path: []const u8, + + /// Duplicates the installed file path and directory. + pub fn dupe(self: InstalledFile, builder: *Build) InstalledFile { + return .{ + .dir = self.dir.dupe(builder), + .path = builder.dupe(self.path), + }; + } +}; + +pub fn serializeCpu(allocator: Allocator, cpu: std.Target.Cpu) ![]const u8 { + // TODO this logic can disappear if cpu model + features becomes part of the target triple + const all_features = cpu.arch.allFeaturesList(); + var populated_cpu_features = cpu.model.features; + populated_cpu_features.populateDependencies(all_features); + + if (populated_cpu_features.eql(cpu.features)) { + // The CPU name alone is sufficient. + return cpu.model.name; + } else { + var mcpu_buffer = ArrayList(u8).init(allocator); + try mcpu_buffer.appendSlice(cpu.model.name); + + for (all_features) |feature, i_usize| { + const i = @intCast(std.Target.Cpu.Feature.Set.Index, i_usize); + const in_cpu_set = populated_cpu_features.isEnabled(i); + const in_actual_set = cpu.features.isEnabled(i); + if (in_cpu_set and !in_actual_set) { + try mcpu_buffer.writer().print("-{s}", .{feature.name}); + } else if (!in_cpu_set and in_actual_set) { + try mcpu_buffer.writer().print("+{s}", .{feature.name}); + } + } + + return try mcpu_buffer.toOwnedSlice(); + } +} + +test "dupePkg()" { + if (builtin.os.tag == .wasi) return error.SkipZigTest; + + var arena = std.heap.ArenaAllocator.init(std.testing.allocator); + defer arena.deinit(); + var builder = try Build.create( + arena.allocator(), + "test", + "test", + "test", + "test", + ); + defer builder.destroy(); + + var pkg_dep = Pkg{ + .name = "pkg_dep", + .source = .{ .path = "/not/a/pkg_dep.zig" }, + }; + var pkg_top = Pkg{ + .name = "pkg_top", + .source = .{ .path = "/not/a/pkg_top.zig" }, + .dependencies = &[_]Pkg{pkg_dep}, + }; + const duped = builder.dupePkg(pkg_top); + + const original_deps = pkg_top.dependencies.?; + const dupe_deps = duped.dependencies.?; + + // probably the same top level package details + try std.testing.expectEqualStrings(pkg_top.name, duped.name); + + // probably the same dependencies + try std.testing.expectEqual(original_deps.len, dupe_deps.len); + try std.testing.expectEqual(original_deps[0].name, pkg_dep.name); + + // could segfault otherwise if pointers in duplicated package's fields are + // the same as those in stack allocated package's fields + try std.testing.expect(dupe_deps.ptr != original_deps.ptr); + try std.testing.expect(duped.name.ptr != pkg_top.name.ptr); + try std.testing.expect(duped.source.path.ptr != pkg_top.source.path.ptr); + try std.testing.expect(dupe_deps[0].name.ptr != pkg_dep.name.ptr); + try std.testing.expect(dupe_deps[0].source.path.ptr != pkg_dep.source.path.ptr); +} + +test { + _ = CheckFileStep; + _ = CheckObjectStep; + _ = EmulatableRunStep; + _ = FmtStep; + _ = InstallArtifactStep; + _ = InstallDirStep; + _ = InstallFileStep; + _ = InstallRawStep; + _ = LibExeObjStep; + _ = LogStep; + _ = OptionsStep; + _ = RemoveDirStep; + _ = RunStep; + _ = TranslateCStep; + _ = WriteFileStep; +} diff --git a/lib/std/build/CheckFileStep.zig b/lib/std/Build/CheckFileStep.zig similarity index 88% rename from lib/std/build/CheckFileStep.zig rename to lib/std/Build/CheckFileStep.zig index 2c06ab9279..3b8cfe5263 100644 --- a/lib/std/build/CheckFileStep.zig +++ b/lib/std/Build/CheckFileStep.zig @@ -1,7 +1,5 @@ const std = @import("../std.zig"); -const build = std.build; -const Step = build.Step; -const Builder = build.Builder; +const Step = std.Build.Step; const fs = std.fs; const mem = std.mem; @@ -10,14 +8,14 @@ const CheckFileStep = @This(); pub const base_id = .check_file; step: Step, -builder: *Builder, +builder: *std.Build, expected_matches: []const []const u8, -source: build.FileSource, +source: std.Build.FileSource, max_bytes: usize = 20 * 1024 * 1024, pub fn create( - builder: *Builder, - source: build.FileSource, + builder: *std.Build, + source: std.Build.FileSource, expected_matches: []const []const u8, ) *CheckFileStep { const self = builder.allocator.create(CheckFileStep) catch unreachable; diff --git a/lib/std/build/CheckObjectStep.zig b/lib/std/Build/CheckObjectStep.zig similarity index 98% rename from lib/std/build/CheckObjectStep.zig rename to lib/std/Build/CheckObjectStep.zig index 4ef350b418..7907be1787 100644 --- a/lib/std/build/CheckObjectStep.zig +++ b/lib/std/Build/CheckObjectStep.zig @@ -1,6 +1,5 @@ const std = @import("../std.zig"); const assert = std.debug.assert; -const build = std.build; const fs = std.fs; const macho = std.macho; const math = std.math; @@ -10,21 +9,20 @@ const testing = std.testing; const CheckObjectStep = @This(); const Allocator = mem.Allocator; -const Builder = build.Builder; -const Step = build.Step; -const EmulatableRunStep = build.EmulatableRunStep; +const Step = std.Build.Step; +const EmulatableRunStep = std.Build.EmulatableRunStep; pub const base_id = .check_object; step: Step, -builder: *Builder, -source: build.FileSource, +builder: *std.Build, +source: std.Build.FileSource, max_bytes: usize = 20 * 1024 * 1024, checks: std.ArrayList(Check), dump_symtab: bool = false, obj_format: std.Target.ObjectFormat, -pub fn create(builder: *Builder, source: build.FileSource, obj_format: std.Target.ObjectFormat) *CheckObjectStep { +pub fn create(builder: *std.Build, source: std.Build.FileSource, obj_format: std.Target.ObjectFormat) *CheckObjectStep { const gpa = builder.allocator; const self = gpa.create(CheckObjectStep) catch unreachable; self.* = .{ @@ -44,7 +42,7 @@ pub fn runAndCompare(self: *CheckObjectStep) *EmulatableRunStep { const dependencies_len = self.step.dependencies.items.len; assert(dependencies_len > 0); const exe_step = self.step.dependencies.items[dependencies_len - 1]; - const exe = exe_step.cast(std.build.LibExeObjStep).?; + const exe = exe_step.cast(std.Build.LibExeObjStep).?; const emulatable_step = EmulatableRunStep.create(self.builder, "EmulatableRun", exe); emulatable_step.step.dependOn(&self.step); return emulatable_step; @@ -216,10 +214,10 @@ const ComputeCompareExpected = struct { }; const Check = struct { - builder: *Builder, + builder: *std.Build, actions: std.ArrayList(Action), - fn create(b: *Builder) Check { + fn create(b: *std.Build) Check { return .{ .builder = b, .actions = std.ArrayList(Action).init(b.allocator), diff --git a/lib/std/build/ConfigHeaderStep.zig b/lib/std/Build/ConfigHeaderStep.zig similarity index 97% rename from lib/std/build/ConfigHeaderStep.zig rename to lib/std/Build/ConfigHeaderStep.zig index 400c06525e..b961227c9c 100644 --- a/lib/std/build/ConfigHeaderStep.zig +++ b/lib/std/Build/ConfigHeaderStep.zig @@ -1,7 +1,6 @@ const std = @import("../std.zig"); const ConfigHeaderStep = @This(); -const Step = std.build.Step; -const Builder = std.build.Builder; +const Step = std.Build.Step; pub const base_id: Step.Id = .config_header; @@ -24,15 +23,15 @@ pub const Value = union(enum) { }; step: Step, -builder: *Builder, -source: std.build.FileSource, +builder: *std.Build, +source: std.Build.FileSource, style: Style, values: std.StringHashMap(Value), max_bytes: usize = 2 * 1024 * 1024, output_dir: []const u8, output_basename: []const u8, -pub fn create(builder: *Builder, source: std.build.FileSource, style: Style) *ConfigHeaderStep { +pub fn create(builder: *std.Build, source: std.Build.FileSource, style: Style) *ConfigHeaderStep { const self = builder.allocator.create(ConfigHeaderStep) catch @panic("OOM"); const name = builder.fmt("configure header {s}", .{source.getDisplayName()}); self.* = .{ diff --git a/lib/std/build/EmulatableRunStep.zig b/lib/std/Build/EmulatableRunStep.zig similarity index 96% rename from lib/std/build/EmulatableRunStep.zig rename to lib/std/Build/EmulatableRunStep.zig index 52ce8edfac..b7b12d791f 100644 --- a/lib/std/build/EmulatableRunStep.zig +++ b/lib/std/Build/EmulatableRunStep.zig @@ -5,11 +5,9 @@ //! without having to verify if it's possible to be ran against. const std = @import("../std.zig"); -const build = std.build; -const Step = std.build.Step; -const Builder = std.build.Builder; -const LibExeObjStep = std.build.LibExeObjStep; -const RunStep = std.build.RunStep; +const Step = std.Build.Step; +const LibExeObjStep = std.Build.LibExeObjStep; +const RunStep = std.Build.RunStep; const fs = std.fs; const process = std.process; @@ -22,7 +20,7 @@ pub const base_id = .emulatable_run; const max_stdout_size = 1 * 1024 * 1024; // 1 MiB step: Step, -builder: *Builder, +builder: *std.Build, /// The artifact (executable) to be run by this step exe: *LibExeObjStep, @@ -47,7 +45,7 @@ hide_foreign_binaries_warning: bool, /// binary through emulation when any of the emulation options such as `enable_rosetta` are set to true. /// When set to false, and the binary is foreign, running the executable is skipped. /// Asserts given artifact is an executable. -pub fn create(builder: *Builder, name: []const u8, artifact: *LibExeObjStep) *EmulatableRunStep { +pub fn create(builder: *std.Build, name: []const u8, artifact: *LibExeObjStep) *EmulatableRunStep { std.debug.assert(artifact.kind == .exe or artifact.kind == .test_exe); const self = builder.allocator.create(EmulatableRunStep) catch unreachable; diff --git a/lib/std/build/FmtStep.zig b/lib/std/Build/FmtStep.zig similarity index 75% rename from lib/std/build/FmtStep.zig rename to lib/std/Build/FmtStep.zig index 62923623f2..44a93dee66 100644 --- a/lib/std/build/FmtStep.zig +++ b/lib/std/Build/FmtStep.zig @@ -1,19 +1,14 @@ const std = @import("../std.zig"); -const build = @import("../build.zig"); -const Step = build.Step; -const Builder = build.Builder; -const BufMap = std.BufMap; -const mem = std.mem; - +const Step = std.Build.Step; const FmtStep = @This(); pub const base_id = .fmt; step: Step, -builder: *Builder, +builder: *std.Build, argv: [][]const u8, -pub fn create(builder: *Builder, paths: []const []const u8) *FmtStep { +pub fn create(builder: *std.Build, paths: []const []const u8) *FmtStep { const self = builder.allocator.create(FmtStep) catch unreachable; const name = "zig fmt"; self.* = FmtStep{ diff --git a/lib/std/build/InstallArtifactStep.zig b/lib/std/Build/InstallArtifactStep.zig similarity index 88% rename from lib/std/build/InstallArtifactStep.zig rename to lib/std/Build/InstallArtifactStep.zig index 537b8c8fd9..929b30e935 100644 --- a/lib/std/build/InstallArtifactStep.zig +++ b/lib/std/Build/InstallArtifactStep.zig @@ -1,26 +1,23 @@ const std = @import("../std.zig"); -const build = @import("../build.zig"); -const Step = build.Step; -const Builder = build.Builder; -const LibExeObjStep = std.build.LibExeObjStep; -const InstallDir = std.build.InstallDir; +const Step = std.Build.Step; +const LibExeObjStep = std.Build.LibExeObjStep; +const InstallDir = std.Build.InstallDir; +const InstallArtifactStep = @This(); pub const base_id = .install_artifact; step: Step, -builder: *Builder, +builder: *std.Build, artifact: *LibExeObjStep, dest_dir: InstallDir, pdb_dir: ?InstallDir, h_dir: ?InstallDir, -const Self = @This(); - -pub fn create(builder: *Builder, artifact: *LibExeObjStep) *Self { +pub fn create(builder: *std.Build, artifact: *LibExeObjStep) *InstallArtifactStep { if (artifact.install_step) |s| return s; - const self = builder.allocator.create(Self) catch unreachable; - self.* = Self{ + const self = builder.allocator.create(InstallArtifactStep) catch unreachable; + self.* = InstallArtifactStep{ .builder = builder, .step = Step.init(.install_artifact, builder.fmt("install {s}", .{artifact.step.name}), builder.allocator, make), .artifact = artifact, @@ -64,7 +61,7 @@ pub fn create(builder: *Builder, artifact: *LibExeObjStep) *Self { } fn make(step: *Step) !void { - const self = @fieldParentPtr(Self, "step", step); + const self = @fieldParentPtr(InstallArtifactStep, "step", step); const builder = self.builder; const full_dest_path = builder.getInstallPath(self.dest_dir, self.artifact.out_filename); diff --git a/lib/std/build/InstallDirStep.zig b/lib/std/Build/InstallDirStep.zig similarity index 92% rename from lib/std/build/InstallDirStep.zig rename to lib/std/Build/InstallDirStep.zig index 0a41e1aaef..41dbb3e35a 100644 --- a/lib/std/build/InstallDirStep.zig +++ b/lib/std/Build/InstallDirStep.zig @@ -1,19 +1,17 @@ const std = @import("../std.zig"); const mem = std.mem; const fs = std.fs; -const build = @import("../build.zig"); -const Step = build.Step; -const Builder = build.Builder; -const InstallDir = std.build.InstallDir; +const Step = std.Build.Step; +const InstallDir = std.Build.InstallDir; const InstallDirStep = @This(); const log = std.log; step: Step, -builder: *Builder, +builder: *std.Build, options: Options, /// This is used by the build system when a file being installed comes from one /// package but is being installed by another. -override_source_builder: ?*Builder = null, +override_source_builder: ?*std.Build = null, pub const base_id = .install_dir; @@ -31,7 +29,7 @@ pub const Options = struct { /// `@import("test.zig")` would be a compile error. blank_extensions: []const []const u8 = &.{}, - fn dupe(self: Options, b: *Builder) Options { + fn dupe(self: Options, b: *std.Build) Options { return .{ .source_dir = b.dupe(self.source_dir), .install_dir = self.install_dir.dupe(b), @@ -43,7 +41,7 @@ pub const Options = struct { }; pub fn init( - builder: *Builder, + builder: *std.Build, options: Options, ) InstallDirStep { builder.pushInstalledFile(options.install_dir, options.install_subdir); diff --git a/lib/std/build/InstallFileStep.zig b/lib/std/Build/InstallFileStep.zig similarity index 82% rename from lib/std/build/InstallFileStep.zig rename to lib/std/Build/InstallFileStep.zig index 37203e64c5..8c8d8ad2d4 100644 --- a/lib/std/build/InstallFileStep.zig +++ b/lib/std/Build/InstallFileStep.zig @@ -1,24 +1,22 @@ const std = @import("../std.zig"); -const build = @import("../build.zig"); -const Step = build.Step; -const Builder = build.Builder; -const FileSource = std.build.FileSource; -const InstallDir = std.build.InstallDir; +const Step = std.Build.Step; +const FileSource = std.Build.FileSource; +const InstallDir = std.Build.InstallDir; const InstallFileStep = @This(); pub const base_id = .install_file; step: Step, -builder: *Builder, +builder: *std.Build, source: FileSource, dir: InstallDir, dest_rel_path: []const u8, /// This is used by the build system when a file being installed comes from one /// package but is being installed by another. -override_source_builder: ?*Builder = null, +override_source_builder: ?*std.Build = null, pub fn init( - builder: *Builder, + builder: *std.Build, source: FileSource, dir: InstallDir, dest_rel_path: []const u8, diff --git a/lib/std/build/InstallRawStep.zig b/lib/std/Build/InstallRawStep.zig similarity index 84% rename from lib/std/build/InstallRawStep.zig rename to lib/std/Build/InstallRawStep.zig index e8266dff5a..08d646ff88 100644 --- a/lib/std/build/InstallRawStep.zig +++ b/lib/std/Build/InstallRawStep.zig @@ -7,11 +7,10 @@ const InstallRawStep = @This(); const Allocator = std.mem.Allocator; const ArenaAllocator = std.heap.ArenaAllocator; const ArrayListUnmanaged = std.ArrayListUnmanaged; -const Builder = std.build.Builder; const File = std.fs.File; -const InstallDir = std.build.InstallDir; -const LibExeObjStep = std.build.LibExeObjStep; -const Step = std.build.Step; +const InstallDir = std.Build.InstallDir; +const LibExeObjStep = std.Build.LibExeObjStep; +const Step = std.Build.Step; const elf = std.elf; const fs = std.fs; const io = std.io; @@ -25,12 +24,12 @@ pub const RawFormat = enum { }; step: Step, -builder: *Builder, +builder: *std.Build, artifact: *LibExeObjStep, dest_dir: InstallDir, dest_filename: []const u8, options: CreateOptions, -output_file: std.build.GeneratedFile, +output_file: std.Build.GeneratedFile, pub const CreateOptions = struct { format: ?RawFormat = null, @@ -39,7 +38,12 @@ pub const CreateOptions = struct { pad_to: ?u64 = null, }; -pub fn create(builder: *Builder, artifact: *LibExeObjStep, dest_filename: []const u8, options: CreateOptions) *InstallRawStep { +pub fn create( + builder: *std.Build, + artifact: *LibExeObjStep, + dest_filename: []const u8, + options: CreateOptions, +) *InstallRawStep { const self = builder.allocator.create(InstallRawStep) catch unreachable; self.* = InstallRawStep{ .step = Step.init(.install_raw, builder.fmt("install raw binary {s}", .{artifact.step.name}), builder.allocator, make), @@ -53,7 +57,7 @@ pub fn create(builder: *Builder, artifact: *LibExeObjStep, dest_filename: []cons }, .dest_filename = dest_filename, .options = options, - .output_file = std.build.GeneratedFile{ .step = &self.step }, + .output_file = std.Build.GeneratedFile{ .step = &self.step }, }; self.step.dependOn(&artifact.step); @@ -61,8 +65,8 @@ pub fn create(builder: *Builder, artifact: *LibExeObjStep, dest_filename: []cons return self; } -pub fn getOutputSource(self: *const InstallRawStep) std.build.FileSource { - return std.build.FileSource{ .generated = &self.output_file }; +pub fn getOutputSource(self: *const InstallRawStep) std.Build.FileSource { + return std.Build.FileSource{ .generated = &self.output_file }; } fn make(step: *Step) !void { diff --git a/lib/std/build/LibExeObjStep.zig b/lib/std/Build/LibExeObjStep.zig similarity index 97% rename from lib/std/build/LibExeObjStep.zig rename to lib/std/Build/LibExeObjStep.zig index 6ee5205b50..af9d34440d 100644 --- a/lib/std/build/LibExeObjStep.zig +++ b/lib/std/Build/LibExeObjStep.zig @@ -9,32 +9,30 @@ const ArrayList = std.ArrayList; const StringHashMap = std.StringHashMap; const Sha256 = std.crypto.hash.sha2.Sha256; const Allocator = mem.Allocator; -const build = @import("../build.zig"); -const Step = build.Step; -const Builder = build.Builder; +const Step = std.Build.Step; const CrossTarget = std.zig.CrossTarget; const NativeTargetInfo = std.zig.system.NativeTargetInfo; -const FileSource = std.build.FileSource; -const PkgConfigPkg = Builder.PkgConfigPkg; -const PkgConfigError = Builder.PkgConfigError; -const ExecError = Builder.ExecError; -const Pkg = std.build.Pkg; -const VcpkgRoot = std.build.VcpkgRoot; -const InstallDir = std.build.InstallDir; -const InstallArtifactStep = std.build.InstallArtifactStep; -const GeneratedFile = std.build.GeneratedFile; -const InstallRawStep = std.build.InstallRawStep; -const EmulatableRunStep = std.build.EmulatableRunStep; -const CheckObjectStep = std.build.CheckObjectStep; -const RunStep = std.build.RunStep; -const OptionsStep = std.build.OptionsStep; -const ConfigHeaderStep = std.build.ConfigHeaderStep; +const FileSource = std.Build.FileSource; +const PkgConfigPkg = std.Build.PkgConfigPkg; +const PkgConfigError = std.Build.PkgConfigError; +const ExecError = std.Build.ExecError; +const Pkg = std.Build.Pkg; +const VcpkgRoot = std.Build.VcpkgRoot; +const InstallDir = std.Build.InstallDir; +const InstallArtifactStep = std.Build.InstallArtifactStep; +const GeneratedFile = std.Build.GeneratedFile; +const InstallRawStep = std.Build.InstallRawStep; +const EmulatableRunStep = std.Build.EmulatableRunStep; +const CheckObjectStep = std.Build.CheckObjectStep; +const RunStep = std.Build.RunStep; +const OptionsStep = std.Build.OptionsStep; +const ConfigHeaderStep = std.Build.ConfigHeaderStep; const LibExeObjStep = @This(); pub const base_id = .lib_exe_obj; step: Step, -builder: *Builder, +builder: *std.Build, name: []const u8, target: CrossTarget, target_info: NativeTargetInfo, @@ -84,7 +82,7 @@ initial_memory: ?u64 = null, max_memory: ?u64 = null, shared_memory: bool = false, global_base: ?u64 = null, -c_std: Builder.CStd, +c_std: std.Build.CStd, override_lib_dir: ?[]const u8, main_pkg_path: ?[]const u8, exec_cmd_args: ?[]const ?[]const u8, @@ -108,7 +106,7 @@ object_src: []const u8, link_objects: ArrayList(LinkObject), include_dirs: ArrayList(IncludeDir), c_macros: ArrayList([]const u8), -installed_headers: ArrayList(*std.build.Step), +installed_headers: ArrayList(*Step), output_dir: ?[]const u8, is_linking_libc: bool = false, is_linking_libcpp: bool = false, @@ -226,7 +224,7 @@ pub const CSourceFile = struct { source: FileSource, args: []const []const u8, - pub fn dupe(self: CSourceFile, b: *Builder) CSourceFile { + pub fn dupe(self: CSourceFile, b: *std.Build) CSourceFile { return .{ .source = self.source.dupe(b), .args = b.dupeStrings(self.args), @@ -297,7 +295,7 @@ pub const EmitOption = union(enum) { emit: void, emit_to: []const u8, - fn getArg(self: @This(), b: *Builder, arg_name: []const u8) ?[]const u8 { + fn getArg(self: @This(), b: *std.Build, arg_name: []const u8) ?[]const u8 { return switch (self) { .no_emit => b.fmt("-fno-{s}", .{arg_name}), .default => null, @@ -307,7 +305,7 @@ pub const EmitOption = union(enum) { } }; -pub fn create(builder: *Builder, options: Options) *LibExeObjStep { +pub fn create(builder: *std.Build, options: Options) *LibExeObjStep { const name = builder.dupe(options.name); const root_src: ?FileSource = if (options.root_source_file) |rsrc| rsrc.dupe(builder) else null; if (mem.indexOf(u8, name, "/") != null or mem.indexOf(u8, name, "\\") != null) { @@ -343,9 +341,9 @@ pub fn create(builder: *Builder, options: Options) *LibExeObjStep { .lib_paths = ArrayList([]const u8).init(builder.allocator), .rpaths = ArrayList([]const u8).init(builder.allocator), .framework_dirs = ArrayList([]const u8).init(builder.allocator), - .installed_headers = ArrayList(*std.build.Step).init(builder.allocator), + .installed_headers = ArrayList(*Step).init(builder.allocator), .object_src = undefined, - .c_std = Builder.CStd.C99, + .c_std = std.Build.CStd.C99, .override_lib_dir = null, .main_pkg_path = null, .exec_cmd_args = null, @@ -461,7 +459,7 @@ pub fn installHeadersDirectory( pub fn installHeadersDirectoryOptions( a: *LibExeObjStep, - options: std.build.InstallDirStep.Options, + options: std.Build.InstallDirStep.Options, ) void { const install_dir = a.builder.addInstallDirectory(options); a.builder.getInstallStep().dependOn(&install_dir.step); @@ -600,7 +598,7 @@ pub fn linkLibCpp(self: *LibExeObjStep) void { /// If the value is omitted, it is set to 1. /// `name` and `value` need not live longer than the function call. pub fn defineCMacro(self: *LibExeObjStep, name: []const u8, value: ?[]const u8) void { - const macro = std.build.constructCMacro(self.builder.allocator, name, value); + const macro = std.Build.constructCMacro(self.builder.allocator, name, value); self.c_macros.append(macro) catch unreachable; } @@ -1460,7 +1458,7 @@ fn make(step: *Step) !void { if (!self.target.isNative()) { try zig_args.appendSlice(&.{ "-target", try self.target.zigTriple(builder.allocator), - "-mcpu", try build.serializeCpu(builder.allocator, self.target.getCpu()), + "-mcpu", try std.Build.serializeCpu(builder.allocator, self.target.getCpu()), }); if (self.target.dynamic_linker.get()) |dynamic_linker| { @@ -1902,7 +1900,7 @@ pub fn doAtomicSymLinks(allocator: Allocator, output_path: []const u8, filename_ }; } -fn execPkgConfigList(self: *Builder, out_code: *u8) (PkgConfigError || ExecError)![]const PkgConfigPkg { +fn execPkgConfigList(self: *std.Build, out_code: *u8) (PkgConfigError || ExecError)![]const PkgConfigPkg { const stdout = try self.execAllowFail(&[_][]const u8{ "pkg-config", "--list-all" }, out_code, .Ignore); var list = ArrayList(PkgConfigPkg).init(self.allocator); errdefer list.deinit(); @@ -1918,7 +1916,7 @@ fn execPkgConfigList(self: *Builder, out_code: *u8) (PkgConfigError || ExecError return list.toOwnedSlice(); } -fn getPkgConfigList(self: *Builder) ![]const PkgConfigPkg { +fn getPkgConfigList(self: *std.Build) ![]const PkgConfigPkg { if (self.pkg_config_pkg_list) |res| { return res; } @@ -1948,7 +1946,7 @@ test "addPackage" { var arena = std.heap.ArenaAllocator.init(std.testing.allocator); defer arena.deinit(); - var builder = try Builder.create( + var builder = try std.Build.create( arena.allocator(), "test", "test", diff --git a/lib/std/build/LogStep.zig b/lib/std/Build/LogStep.zig similarity index 72% rename from lib/std/build/LogStep.zig rename to lib/std/Build/LogStep.zig index fd937b00f9..6d51df8cbd 100644 --- a/lib/std/build/LogStep.zig +++ b/lib/std/Build/LogStep.zig @@ -1,17 +1,15 @@ const std = @import("../std.zig"); const log = std.log; -const build = @import("../build.zig"); -const Step = build.Step; -const Builder = build.Builder; +const Step = std.Build.Step; const LogStep = @This(); pub const base_id = .log; step: Step, -builder: *Builder, +builder: *std.Build, data: []const u8, -pub fn init(builder: *Builder, data: []const u8) LogStep { +pub fn init(builder: *std.Build, data: []const u8) LogStep { return LogStep{ .builder = builder, .step = Step.init(.log, builder.fmt("log {s}", .{data}), builder.allocator, make), diff --git a/lib/std/build/OptionsStep.zig b/lib/std/Build/OptionsStep.zig similarity index 97% rename from lib/std/build/OptionsStep.zig rename to lib/std/Build/OptionsStep.zig index fb06cc2179..3d26807411 100644 --- a/lib/std/build/OptionsStep.zig +++ b/lib/std/Build/OptionsStep.zig @@ -1,12 +1,10 @@ const std = @import("../std.zig"); const builtin = @import("builtin"); -const build = std.build; const fs = std.fs; -const Step = build.Step; -const Builder = build.Builder; -const GeneratedFile = build.GeneratedFile; -const LibExeObjStep = build.LibExeObjStep; -const FileSource = build.FileSource; +const Step = std.Build.Step; +const GeneratedFile = std.Build.GeneratedFile; +const LibExeObjStep = std.Build.LibExeObjStep; +const FileSource = std.Build.FileSource; const OptionsStep = @This(); @@ -14,13 +12,13 @@ pub const base_id = .options; step: Step, generated_file: GeneratedFile, -builder: *Builder, +builder: *std.Build, contents: std.ArrayList(u8), artifact_args: std.ArrayList(OptionArtifactArg), file_source_args: std.ArrayList(OptionFileSourceArg), -pub fn create(builder: *Builder) *OptionsStep { +pub fn create(builder: *std.Build) *OptionsStep { const self = builder.allocator.create(OptionsStep) catch unreachable; self.* = .{ .builder = builder, @@ -202,7 +200,7 @@ pub fn addOptionArtifact(self: *OptionsStep, name: []const u8, artifact: *LibExe self.step.dependOn(&artifact.step); } -pub fn getPackage(self: *OptionsStep, package_name: []const u8) build.Pkg { +pub fn getPackage(self: *OptionsStep, package_name: []const u8) std.Build.Pkg { return .{ .name = package_name, .source = self.getSource() }; } @@ -281,7 +279,7 @@ test "OptionsStep" { var arena = std.heap.ArenaAllocator.init(std.testing.allocator); defer arena.deinit(); - var builder = try Builder.create( + var builder = try std.Build.create( arena.allocator(), "test", "test", diff --git a/lib/std/build/RemoveDirStep.zig b/lib/std/Build/RemoveDirStep.zig similarity index 79% rename from lib/std/build/RemoveDirStep.zig rename to lib/std/Build/RemoveDirStep.zig index 959414e54f..f3b71dcec1 100644 --- a/lib/std/build/RemoveDirStep.zig +++ b/lib/std/Build/RemoveDirStep.zig @@ -1,18 +1,16 @@ const std = @import("../std.zig"); const log = std.log; const fs = std.fs; -const build = @import("../build.zig"); -const Step = build.Step; -const Builder = build.Builder; +const Step = std.Build.Step; const RemoveDirStep = @This(); pub const base_id = .remove_dir; step: Step, -builder: *Builder, +builder: *std.Build, dir_path: []const u8, -pub fn init(builder: *Builder, dir_path: []const u8) RemoveDirStep { +pub fn init(builder: *std.Build, dir_path: []const u8) RemoveDirStep { return RemoveDirStep{ .builder = builder, .step = Step.init(.remove_dir, builder.fmt("RemoveDir {s}", .{dir_path}), builder.allocator, make), diff --git a/lib/std/build/RunStep.zig b/lib/std/Build/RunStep.zig similarity index 94% rename from lib/std/build/RunStep.zig rename to lib/std/Build/RunStep.zig index 5183a328cd..83e4f7f66c 100644 --- a/lib/std/build/RunStep.zig +++ b/lib/std/Build/RunStep.zig @@ -1,17 +1,15 @@ const std = @import("../std.zig"); const builtin = @import("builtin"); -const build = std.build; -const Step = build.Step; -const Builder = build.Builder; -const LibExeObjStep = build.LibExeObjStep; -const WriteFileStep = build.WriteFileStep; +const Step = std.Build.Step; +const LibExeObjStep = std.Build.LibExeObjStep; +const WriteFileStep = std.Build.WriteFileStep; const fs = std.fs; const mem = std.mem; const process = std.process; const ArrayList = std.ArrayList; const EnvMap = process.EnvMap; const Allocator = mem.Allocator; -const ExecError = build.Builder.ExecError; +const ExecError = std.Build.ExecError; const max_stdout_size = 1 * 1024 * 1024; // 1 MiB @@ -20,7 +18,7 @@ const RunStep = @This(); pub const base_id: Step.Id = .run; step: Step, -builder: *Builder, +builder: *std.Build, /// See also addArg and addArgs to modifying this directly argv: ArrayList(Arg), @@ -51,11 +49,11 @@ pub const StdIoAction = union(enum) { pub const Arg = union(enum) { artifact: *LibExeObjStep, - file_source: build.FileSource, + file_source: std.Build.FileSource, bytes: []u8, }; -pub fn create(builder: *Builder, name: []const u8) *RunStep { +pub fn create(builder: *std.Build, name: []const u8) *RunStep { const self = builder.allocator.create(RunStep) catch unreachable; self.* = RunStep{ .builder = builder, @@ -73,7 +71,7 @@ pub fn addArtifactArg(self: *RunStep, artifact: *LibExeObjStep) void { self.step.dependOn(&artifact.step); } -pub fn addFileSourceArg(self: *RunStep, file_source: build.FileSource) void { +pub fn addFileSourceArg(self: *RunStep, file_source: std.Build.FileSource) void { self.argv.append(Arg{ .file_source = file_source.dupe(self.builder), }) catch unreachable; @@ -101,7 +99,7 @@ pub fn addPathDir(self: *RunStep, search_path: []const u8) void { } /// For internal use only, users of `RunStep` should use `addPathDir` directly. -pub fn addPathDirInternal(step: *Step, builder: *Builder, search_path: []const u8) void { +pub fn addPathDirInternal(step: *Step, builder: *std.Build, search_path: []const u8) void { const env_map = getEnvMapInternal(step, builder.allocator); const key = "PATH"; @@ -122,7 +120,7 @@ pub fn getEnvMap(self: *RunStep) *EnvMap { fn getEnvMapInternal(step: *Step, allocator: Allocator) *EnvMap { const maybe_env_map = switch (step.id) { .run => step.cast(RunStep).?.env_map, - .emulatable_run => step.cast(build.EmulatableRunStep).?.env_map, + .emulatable_run => step.cast(std.Build.EmulatableRunStep).?.env_map, else => unreachable, }; return maybe_env_map orelse { @@ -195,7 +193,7 @@ fn make(step: *Step) !void { pub fn runCommand( argv: []const []const u8, - builder: *Builder, + builder: *std.Build, expected_exit_code: ?u8, stdout_action: StdIoAction, stderr_action: StdIoAction, @@ -363,7 +361,7 @@ fn addPathForDynLibs(self: *RunStep, artifact: *LibExeObjStep) void { /// This should only be used for internal usage, this is called automatically /// for the user. -pub fn addPathForDynLibsInternal(step: *Step, builder: *Builder, artifact: *LibExeObjStep) void { +pub fn addPathForDynLibsInternal(step: *Step, builder: *std.Build, artifact: *LibExeObjStep) void { for (artifact.link_objects.items) |link_object| { switch (link_object) { .other_step => |other| { diff --git a/lib/std/Build/Step.zig b/lib/std/Build/Step.zig new file mode 100644 index 0000000000..86d6645c29 --- /dev/null +++ b/lib/std/Build/Step.zig @@ -0,0 +1,97 @@ +id: Id, +name: []const u8, +makeFn: *const fn (self: *Step) anyerror!void, +dependencies: std.ArrayList(*Step), +loop_flag: bool, +done_flag: bool, + +pub const Id = enum { + top_level, + lib_exe_obj, + install_artifact, + install_file, + install_dir, + log, + remove_dir, + fmt, + translate_c, + write_file, + run, + emulatable_run, + check_file, + check_object, + config_header, + install_raw, + options, + custom, + + pub fn Type(comptime id: Id) type { + return switch (id) { + .top_level => Build.TopLevelStep, + .lib_exe_obj => Build.LibExeObjStep, + .install_artifact => Build.InstallArtifactStep, + .install_file => Build.InstallFileStep, + .install_dir => Build.InstallDirStep, + .log => Build.LogStep, + .remove_dir => Build.RemoveDirStep, + .fmt => Build.FmtStep, + .translate_c => Build.TranslateCStep, + .write_file => Build.WriteFileStep, + .run => Build.RunStep, + .emulatable_run => Build.EmulatableRunStep, + .check_file => Build.CheckFileStep, + .check_object => Build.CheckObjectStep, + .config_header => Build.ConfigHeaderStep, + .install_raw => Build.InstallRawStep, + .options => Build.OptionsStep, + .custom => @compileError("no type available for custom step"), + }; + } +}; + +pub fn init( + id: Id, + name: []const u8, + allocator: Allocator, + makeFn: *const fn (self: *Step) anyerror!void, +) Step { + return Step{ + .id = id, + .name = allocator.dupe(u8, name) catch unreachable, + .makeFn = makeFn, + .dependencies = std.ArrayList(*Step).init(allocator), + .loop_flag = false, + .done_flag = false, + }; +} + +pub fn initNoOp(id: Id, name: []const u8, allocator: Allocator) Step { + return init(id, name, allocator, makeNoOp); +} + +pub fn make(self: *Step) !void { + if (self.done_flag) return; + + try self.makeFn(self); + self.done_flag = true; +} + +pub fn dependOn(self: *Step, other: *Step) void { + self.dependencies.append(other) catch unreachable; +} + +fn makeNoOp(self: *Step) anyerror!void { + _ = self; +} + +pub fn cast(step: *Step, comptime T: type) ?*T { + if (step.id == T.base_id) { + return @fieldParentPtr(T, "step", step); + } + return null; +} + +const Step = @This(); +const std = @import("../std.zig"); +const Build = std.Build; +const Allocator = std.mem.Allocator; diff --git a/lib/std/build/TranslateCStep.zig b/lib/std/Build/TranslateCStep.zig similarity index 90% rename from lib/std/build/TranslateCStep.zig rename to lib/std/Build/TranslateCStep.zig index 9f45d606a1..5404747846 100644 --- a/lib/std/build/TranslateCStep.zig +++ b/lib/std/Build/TranslateCStep.zig @@ -1,9 +1,7 @@ const std = @import("../std.zig"); -const build = std.build; -const Step = build.Step; -const Builder = build.Builder; -const LibExeObjStep = build.LibExeObjStep; -const CheckFileStep = build.CheckFileStep; +const Step = std.Build.Step; +const LibExeObjStep = std.Build.LibExeObjStep; +const CheckFileStep = std.Build.CheckFileStep; const fs = std.fs; const mem = std.mem; const CrossTarget = std.zig.CrossTarget; @@ -13,23 +11,23 @@ const TranslateCStep = @This(); pub const base_id = .translate_c; step: Step, -builder: *Builder, -source: build.FileSource, +builder: *std.Build, +source: std.Build.FileSource, include_dirs: std.ArrayList([]const u8), c_macros: std.ArrayList([]const u8), output_dir: ?[]const u8, out_basename: []const u8, target: CrossTarget, optimize: std.builtin.OptimizeMode, -output_file: build.GeneratedFile, +output_file: std.Build.GeneratedFile, pub const Options = struct { - source_file: build.FileSource, + source_file: std.Build.FileSource, target: CrossTarget, optimize: std.builtin.OptimizeMode, }; -pub fn create(builder: *Builder, options: Options) *TranslateCStep { +pub fn create(builder: *std.Build, options: Options) *TranslateCStep { const self = builder.allocator.create(TranslateCStep) catch unreachable; const source = options.source_file.dupe(builder); self.* = TranslateCStep{ @@ -42,7 +40,7 @@ pub fn create(builder: *Builder, options: Options) *TranslateCStep { .out_basename = undefined, .target = options.target, .optimize = options.optimize, - .output_file = build.GeneratedFile{ .step = &self.step }, + .output_file = std.Build.GeneratedFile{ .step = &self.step }, }; source.addStepDependencies(&self.step); return self; @@ -79,7 +77,7 @@ pub fn addCheckFile(self: *TranslateCStep, expected_matches: []const []const u8) /// If the value is omitted, it is set to 1. /// `name` and `value` need not live longer than the function call. pub fn defineCMacro(self: *TranslateCStep, name: []const u8, value: ?[]const u8) void { - const macro = build.constructCMacro(self.builder.allocator, name, value); + const macro = std.Build.constructCMacro(self.builder.allocator, name, value); self.c_macros.append(macro) catch unreachable; } diff --git a/lib/std/build/WriteFileStep.zig b/lib/std/Build/WriteFileStep.zig similarity index 91% rename from lib/std/build/WriteFileStep.zig rename to lib/std/Build/WriteFileStep.zig index 4faae8f74e..59ac568221 100644 --- a/lib/std/build/WriteFileStep.zig +++ b/lib/std/Build/WriteFileStep.zig @@ -1,7 +1,5 @@ const std = @import("../std.zig"); -const build = @import("../build.zig"); -const Step = build.Step; -const Builder = build.Builder; +const Step = std.Build.Step; const fs = std.fs; const ArrayList = std.ArrayList; @@ -10,17 +8,17 @@ const WriteFileStep = @This(); pub const base_id = .write_file; step: Step, -builder: *Builder, +builder: *std.Build, output_dir: []const u8, files: std.TailQueue(File), pub const File = struct { - source: build.GeneratedFile, + source: std.Build.GeneratedFile, basename: []const u8, bytes: []const u8, }; -pub fn init(builder: *Builder) WriteFileStep { +pub fn init(builder: *std.Build) WriteFileStep { return WriteFileStep{ .builder = builder, .step = Step.init(.write_file, "writefile", builder.allocator, make), @@ -33,7 +31,7 @@ pub fn add(self: *WriteFileStep, basename: []const u8, bytes: []const u8) void { const node = self.builder.allocator.create(std.TailQueue(File).Node) catch unreachable; node.* = .{ .data = .{ - .source = build.GeneratedFile{ .step = &self.step }, + .source = std.Build.GeneratedFile{ .step = &self.step }, .basename = self.builder.dupePath(basename), .bytes = self.builder.dupe(bytes), }, @@ -43,11 +41,11 @@ pub fn add(self: *WriteFileStep, basename: []const u8, bytes: []const u8) void { } /// Gets a file source for the given basename. If the file does not exist, returns `null`. -pub fn getFileSource(step: *WriteFileStep, basename: []const u8) ?build.FileSource { +pub fn getFileSource(step: *WriteFileStep, basename: []const u8) ?std.Build.FileSource { var it = step.files.first; while (it) |node| : (it = node.next) { if (std.mem.eql(u8, node.data.basename, basename)) - return build.FileSource{ .generated = &node.data.source }; + return std.Build.FileSource{ .generated = &node.data.source }; } return null; } diff --git a/lib/std/build.zig b/lib/std/build.zig deleted file mode 100644 index 4ee00a4710..0000000000 --- a/lib/std/build.zig +++ /dev/null @@ -1,1863 +0,0 @@ -const std = @import("std.zig"); -const builtin = @import("builtin"); -const io = std.io; -const fs = std.fs; -const mem = std.mem; -const debug = std.debug; -const panic = std.debug.panic; -const assert = debug.assert; -const log = std.log; -const ArrayList = std.ArrayList; -const StringHashMap = std.StringHashMap; -const Allocator = mem.Allocator; -const process = std.process; -const EnvMap = std.process.EnvMap; -const fmt_lib = std.fmt; -const File = std.fs.File; -const CrossTarget = std.zig.CrossTarget; -const NativeTargetInfo = std.zig.system.NativeTargetInfo; -const Sha256 = std.crypto.hash.sha2.Sha256; -const ThisModule = @This(); - -pub const CheckFileStep = @import("build/CheckFileStep.zig"); -pub const CheckObjectStep = @import("build/CheckObjectStep.zig"); -pub const ConfigHeaderStep = @import("build/ConfigHeaderStep.zig"); -pub const EmulatableRunStep = @import("build/EmulatableRunStep.zig"); -pub const FmtStep = @import("build/FmtStep.zig"); -pub const InstallArtifactStep = @import("build/InstallArtifactStep.zig"); -pub const InstallDirStep = @import("build/InstallDirStep.zig"); -pub const InstallFileStep = @import("build/InstallFileStep.zig"); -pub const InstallRawStep = @import("build/InstallRawStep.zig"); -pub const LibExeObjStep = @import("build/LibExeObjStep.zig"); -pub const LogStep = @import("build/LogStep.zig"); -pub const OptionsStep = @import("build/OptionsStep.zig"); -pub const RemoveDirStep = @import("build/RemoveDirStep.zig"); -pub const RunStep = @import("build/RunStep.zig"); -pub const TranslateCStep = @import("build/TranslateCStep.zig"); -pub const WriteFileStep = @import("build/WriteFileStep.zig"); - -pub const Builder = struct { - install_tls: TopLevelStep, - uninstall_tls: TopLevelStep, - allocator: Allocator, - user_input_options: UserInputOptionsMap, - available_options_map: AvailableOptionsMap, - available_options_list: ArrayList(AvailableOption), - verbose: bool, - verbose_link: bool, - verbose_cc: bool, - verbose_air: bool, - verbose_llvm_ir: bool, - verbose_cimport: bool, - verbose_llvm_cpu_features: bool, - /// The purpose of executing the command is for a human to read compile errors from the terminal - prominent_compile_errors: bool, - color: enum { auto, on, off } = .auto, - reference_trace: ?u32 = null, - invalid_user_input: bool, - zig_exe: []const u8, - default_step: *Step, - env_map: *EnvMap, - top_level_steps: ArrayList(*TopLevelStep), - install_prefix: []const u8, - dest_dir: ?[]const u8, - lib_dir: []const u8, - exe_dir: []const u8, - h_dir: []const u8, - install_path: []const u8, - sysroot: ?[]const u8 = null, - search_prefixes: ArrayList([]const u8), - libc_file: ?[]const u8 = null, - installed_files: ArrayList(InstalledFile), - /// Path to the directory containing build.zig. - build_root: []const u8, - cache_root: []const u8, - global_cache_root: []const u8, - /// zig lib dir - override_lib_dir: ?[]const u8, - vcpkg_root: VcpkgRoot = .unattempted, - pkg_config_pkg_list: ?(PkgConfigError![]const PkgConfigPkg) = null, - args: ?[][]const u8 = null, - debug_log_scopes: []const []const u8 = &.{}, - debug_compile_errors: bool = false, - - /// Experimental. Use system Darling installation to run cross compiled macOS build artifacts. - enable_darling: bool = false, - /// Use system QEMU installation to run cross compiled foreign architecture build artifacts. - enable_qemu: bool = false, - /// Darwin. Use Rosetta to run x86_64 macOS build artifacts on arm64 macOS. - enable_rosetta: bool = false, - /// Use system Wasmtime installation to run cross compiled wasm/wasi build artifacts. - enable_wasmtime: bool = false, - /// Use system Wine installation to run cross compiled Windows build artifacts. - enable_wine: bool = false, - /// After following the steps in https://github.com/ziglang/zig/wiki/Updating-libc#glibc, - /// this will be the directory $glibc-build-dir/install/glibcs - /// Given the example of the aarch64 target, this is the directory - /// that contains the path `aarch64-linux-gnu/lib/ld-linux-aarch64.so.1`. - glibc_runtimes_dir: ?[]const u8 = null, - - /// Information about the native target. Computed before build() is invoked. - host: NativeTargetInfo, - - dep_prefix: []const u8 = "", - - pub const ExecError = error{ - ReadFailure, - ExitCodeFailure, - ProcessTerminated, - ExecNotSupported, - } || std.ChildProcess.SpawnError; - - pub const PkgConfigError = error{ - PkgConfigCrashed, - PkgConfigFailed, - PkgConfigNotInstalled, - PkgConfigInvalidOutput, - }; - - pub const PkgConfigPkg = struct { - name: []const u8, - desc: []const u8, - }; - - pub const CStd = enum { - C89, - C99, - C11, - }; - - const UserInputOptionsMap = StringHashMap(UserInputOption); - const AvailableOptionsMap = StringHashMap(AvailableOption); - - const AvailableOption = struct { - name: []const u8, - type_id: TypeId, - description: []const u8, - /// If the `type_id` is `enum` this provides the list of enum options - enum_options: ?[]const []const u8, - }; - - const UserInputOption = struct { - name: []const u8, - value: UserValue, - used: bool, - }; - - const UserValue = union(enum) { - flag: void, - scalar: []const u8, - list: ArrayList([]const u8), - map: StringHashMap(*const UserValue), - }; - - const TypeId = enum { - bool, - int, - float, - @"enum", - string, - list, - }; - - const TopLevelStep = struct { - pub const base_id = .top_level; - - step: Step, - description: []const u8, - }; - - pub const DirList = struct { - lib_dir: ?[]const u8 = null, - exe_dir: ?[]const u8 = null, - include_dir: ?[]const u8 = null, - }; - - pub fn create( - allocator: Allocator, - zig_exe: []const u8, - build_root: []const u8, - cache_root: []const u8, - global_cache_root: []const u8, - ) !*Builder { - const env_map = try allocator.create(EnvMap); - env_map.* = try process.getEnvMap(allocator); - - const host = try NativeTargetInfo.detect(.{}); - - const self = try allocator.create(Builder); - self.* = Builder{ - .zig_exe = zig_exe, - .build_root = build_root, - .cache_root = try fs.path.relative(allocator, build_root, cache_root), - .global_cache_root = global_cache_root, - .verbose = false, - .verbose_link = false, - .verbose_cc = false, - .verbose_air = false, - .verbose_llvm_ir = false, - .verbose_cimport = false, - .verbose_llvm_cpu_features = false, - .prominent_compile_errors = false, - .invalid_user_input = false, - .allocator = allocator, - .user_input_options = UserInputOptionsMap.init(allocator), - .available_options_map = AvailableOptionsMap.init(allocator), - .available_options_list = ArrayList(AvailableOption).init(allocator), - .top_level_steps = ArrayList(*TopLevelStep).init(allocator), - .default_step = undefined, - .env_map = env_map, - .search_prefixes = ArrayList([]const u8).init(allocator), - .install_prefix = undefined, - .lib_dir = undefined, - .exe_dir = undefined, - .h_dir = undefined, - .dest_dir = env_map.get("DESTDIR"), - .installed_files = ArrayList(InstalledFile).init(allocator), - .install_tls = TopLevelStep{ - .step = Step.initNoOp(.top_level, "install", allocator), - .description = "Copy build artifacts to prefix path", - }, - .uninstall_tls = TopLevelStep{ - .step = Step.init(.top_level, "uninstall", allocator, makeUninstall), - .description = "Remove build artifacts from prefix path", - }, - .override_lib_dir = null, - .install_path = undefined, - .args = null, - .host = host, - }; - try self.top_level_steps.append(&self.install_tls); - try self.top_level_steps.append(&self.uninstall_tls); - self.default_step = &self.install_tls.step; - return self; - } - - fn createChild( - parent: *Builder, - dep_name: []const u8, - build_root: []const u8, - args: anytype, - ) !*Builder { - const child = try createChildOnly(parent, dep_name, build_root); - try applyArgs(child, args); - return child; - } - - fn createChildOnly(parent: *Builder, dep_name: []const u8, build_root: []const u8) !*Builder { - const allocator = parent.allocator; - const child = try allocator.create(Builder); - child.* = .{ - .allocator = allocator, - .install_tls = .{ - .step = Step.initNoOp(.top_level, "install", allocator), - .description = "Copy build artifacts to prefix path", - }, - .uninstall_tls = .{ - .step = Step.init(.top_level, "uninstall", allocator, makeUninstall), - .description = "Remove build artifacts from prefix path", - }, - .user_input_options = UserInputOptionsMap.init(allocator), - .available_options_map = AvailableOptionsMap.init(allocator), - .available_options_list = ArrayList(AvailableOption).init(allocator), - .verbose = parent.verbose, - .verbose_link = parent.verbose_link, - .verbose_cc = parent.verbose_cc, - .verbose_air = parent.verbose_air, - .verbose_llvm_ir = parent.verbose_llvm_ir, - .verbose_cimport = parent.verbose_cimport, - .verbose_llvm_cpu_features = parent.verbose_llvm_cpu_features, - .prominent_compile_errors = parent.prominent_compile_errors, - .color = parent.color, - .reference_trace = parent.reference_trace, - .invalid_user_input = false, - .zig_exe = parent.zig_exe, - .default_step = undefined, - .env_map = parent.env_map, - .top_level_steps = ArrayList(*TopLevelStep).init(allocator), - .install_prefix = undefined, - .dest_dir = parent.dest_dir, - .lib_dir = parent.lib_dir, - .exe_dir = parent.exe_dir, - .h_dir = parent.h_dir, - .install_path = parent.install_path, - .sysroot = parent.sysroot, - .search_prefixes = ArrayList([]const u8).init(allocator), - .libc_file = parent.libc_file, - .installed_files = ArrayList(InstalledFile).init(allocator), - .build_root = build_root, - .cache_root = parent.cache_root, - .global_cache_root = parent.global_cache_root, - .override_lib_dir = parent.override_lib_dir, - .debug_log_scopes = parent.debug_log_scopes, - .debug_compile_errors = parent.debug_compile_errors, - .enable_darling = parent.enable_darling, - .enable_qemu = parent.enable_qemu, - .enable_rosetta = parent.enable_rosetta, - .enable_wasmtime = parent.enable_wasmtime, - .enable_wine = parent.enable_wine, - .glibc_runtimes_dir = parent.glibc_runtimes_dir, - .host = parent.host, - .dep_prefix = parent.fmt("{s}{s}.", .{ parent.dep_prefix, dep_name }), - }; - try child.top_level_steps.append(&child.install_tls); - try child.top_level_steps.append(&child.uninstall_tls); - child.default_step = &child.install_tls.step; - return child; - } - - fn applyArgs(b: *Builder, args: anytype) !void { - inline for (@typeInfo(@TypeOf(args)).Struct.fields) |field| { - const v = @field(args, field.name); - const T = @TypeOf(v); - switch (T) { - CrossTarget => { - try b.user_input_options.put(field.name, .{ - .name = field.name, - .value = .{ .scalar = try v.zigTriple(b.allocator) }, - .used = false, - }); - try b.user_input_options.put("cpu", .{ - .name = "cpu", - .value = .{ .scalar = try serializeCpu(b.allocator, v.getCpu()) }, - .used = false, - }); - }, - []const u8 => { - try b.user_input_options.put(field.name, .{ - .name = field.name, - .value = .{ .scalar = v }, - .used = false, - }); - }, - else => switch (@typeInfo(T)) { - .Bool => { - try b.user_input_options.put(field.name, .{ - .name = field.name, - .value = .{ .scalar = if (v) "true" else "false" }, - .used = false, - }); - }, - .Enum => { - try b.user_input_options.put(field.name, .{ - .name = field.name, - .value = .{ .scalar = @tagName(v) }, - .used = false, - }); - }, - .Int => { - try b.user_input_options.put(field.name, .{ - .name = field.name, - .value = .{ .scalar = try std.fmt.allocPrint(b.allocator, "{d}", .{v}) }, - .used = false, - }); - }, - else => @compileError("option '" ++ field.name ++ "' has unsupported type: " ++ @typeName(T)), - }, - } - } - const Hasher = std.crypto.auth.siphash.SipHash128(1, 3); - // Random bytes to make unique. Refresh this with new random bytes when - // implementation is modified in a non-backwards-compatible way. - var hash = Hasher.init("ZaEsvQ5ClaA2IdH9"); - hash.update(b.dep_prefix); - // TODO additionally update the hash with `args`. - - var digest: [16]u8 = undefined; - hash.final(&digest); - var hash_basename: [digest.len * 2]u8 = undefined; - _ = std.fmt.bufPrint(&hash_basename, "{s}", .{std.fmt.fmtSliceHexLower(&digest)}) catch - unreachable; - - const install_prefix = b.pathJoin(&.{ b.cache_root, "i", &hash_basename }); - b.resolveInstallPrefix(install_prefix, .{}); - } - - pub fn destroy(self: *Builder) void { - self.env_map.deinit(); - self.top_level_steps.deinit(); - self.allocator.destroy(self); - } - - /// This function is intended to be called by lib/build_runner.zig, not a build.zig file. - pub fn resolveInstallPrefix(self: *Builder, install_prefix: ?[]const u8, dir_list: DirList) void { - if (self.dest_dir) |dest_dir| { - self.install_prefix = install_prefix orelse "/usr"; - self.install_path = self.pathJoin(&.{ dest_dir, self.install_prefix }); - } else { - self.install_prefix = install_prefix orelse - (self.pathJoin(&.{ self.build_root, "zig-out" })); - self.install_path = self.install_prefix; - } - - var lib_list = [_][]const u8{ self.install_path, "lib" }; - var exe_list = [_][]const u8{ self.install_path, "bin" }; - var h_list = [_][]const u8{ self.install_path, "include" }; - - if (dir_list.lib_dir) |dir| { - if (std.fs.path.isAbsolute(dir)) lib_list[0] = self.dest_dir orelse ""; - lib_list[1] = dir; - } - - if (dir_list.exe_dir) |dir| { - if (std.fs.path.isAbsolute(dir)) exe_list[0] = self.dest_dir orelse ""; - exe_list[1] = dir; - } - - if (dir_list.include_dir) |dir| { - if (std.fs.path.isAbsolute(dir)) h_list[0] = self.dest_dir orelse ""; - h_list[1] = dir; - } - - self.lib_dir = self.pathJoin(&lib_list); - self.exe_dir = self.pathJoin(&exe_list); - self.h_dir = self.pathJoin(&h_list); - } - - pub fn addOptions(self: *Builder) *OptionsStep { - return OptionsStep.create(self); - } - - pub const ExecutableOptions = struct { - name: []const u8, - root_source_file: ?FileSource = null, - version: ?std.builtin.Version = null, - target: CrossTarget = .{}, - optimize: std.builtin.Mode = .Debug, - linkage: ?LibExeObjStep.Linkage = null, - }; - - pub fn addExecutable(b: *Builder, options: ExecutableOptions) *LibExeObjStep { - return LibExeObjStep.create(b, .{ - .name = options.name, - .root_source_file = options.root_source_file, - .version = options.version, - .target = options.target, - .optimize = options.optimize, - .kind = .exe, - .linkage = options.linkage, - }); - } - - pub const ObjectOptions = struct { - name: []const u8, - root_source_file: ?FileSource = null, - target: CrossTarget, - optimize: std.builtin.Mode, - }; - - pub fn addObject(b: *Builder, options: ObjectOptions) *LibExeObjStep { - return LibExeObjStep.create(b, .{ - .name = options.name, - .root_source_file = options.root_source_file, - .target = options.target, - .optimize = options.optimize, - .kind = .obj, - }); - } - - pub const SharedLibraryOptions = struct { - name: []const u8, - root_source_file: ?FileSource = null, - version: ?std.builtin.Version = null, - target: CrossTarget, - optimize: std.builtin.Mode, - }; - - pub fn addSharedLibrary(b: *Builder, options: SharedLibraryOptions) *LibExeObjStep { - return LibExeObjStep.create(b, .{ - .name = options.name, - .root_source_file = options.root_source_file, - .kind = .lib, - .linkage = .dynamic, - .version = options.version, - .target = options.target, - .optimize = options.optimize, - }); - } - - pub const StaticLibraryOptions = struct { - name: []const u8, - root_source_file: ?FileSource = null, - target: CrossTarget, - optimize: std.builtin.Mode, - version: ?std.builtin.Version = null, - }; - - pub fn addStaticLibrary(b: *Builder, options: StaticLibraryOptions) *LibExeObjStep { - return LibExeObjStep.create(b, .{ - .name = options.name, - .root_source_file = options.root_source_file, - .kind = .lib, - .linkage = .static, - .version = options.version, - .target = options.target, - .optimize = options.optimize, - }); - } - - pub const TestOptions = struct { - name: []const u8 = "test", - kind: LibExeObjStep.Kind = .@"test", - root_source_file: FileSource, - target: CrossTarget = .{}, - optimize: std.builtin.Mode = .Debug, - version: ?std.builtin.Version = null, - }; - - pub fn addTest(b: *Builder, options: TestOptions) *LibExeObjStep { - return LibExeObjStep.create(b, .{ - .name = options.name, - .kind = options.kind, - .root_source_file = options.root_source_file, - .target = options.target, - .optimize = options.optimize, - }); - } - - pub const AssemblyOptions = struct { - name: []const u8, - source_file: FileSource, - target: CrossTarget, - optimize: std.builtin.Mode, - }; - - pub fn addAssembly(b: *Builder, options: AssemblyOptions) *LibExeObjStep { - const obj_step = LibExeObjStep.create(b, .{ - .name = options.name, - .root_source_file = null, - .target = options.target, - .optimize = options.optimize, - }); - obj_step.addAssemblyFileSource(options.source_file.dupe(b)); - return obj_step; - } - - /// Initializes a RunStep with argv, which must at least have the path to the - /// executable. More command line arguments can be added with `addArg`, - /// `addArgs`, and `addArtifactArg`. - /// Be careful using this function, as it introduces a system dependency. - /// To run an executable built with zig build, see `LibExeObjStep.run`. - pub fn addSystemCommand(self: *Builder, argv: []const []const u8) *RunStep { - assert(argv.len >= 1); - const run_step = RunStep.create(self, self.fmt("run {s}", .{argv[0]})); - run_step.addArgs(argv); - return run_step; - } - - pub fn addConfigHeader( - b: *Builder, - source: FileSource, - style: ConfigHeaderStep.Style, - values: anytype, - ) *ConfigHeaderStep { - const config_header_step = ConfigHeaderStep.create(b, source, style); - config_header_step.addValues(values); - return config_header_step; - } - - /// Allocator.dupe without the need to handle out of memory. - pub fn dupe(self: *Builder, bytes: []const u8) []u8 { - return self.allocator.dupe(u8, bytes) catch unreachable; - } - - /// Duplicates an array of strings without the need to handle out of memory. - pub fn dupeStrings(self: *Builder, strings: []const []const u8) [][]u8 { - const array = self.allocator.alloc([]u8, strings.len) catch unreachable; - for (strings) |s, i| { - array[i] = self.dupe(s); - } - return array; - } - - /// Duplicates a path and converts all slashes to the OS's canonical path separator. - pub fn dupePath(self: *Builder, bytes: []const u8) []u8 { - const the_copy = self.dupe(bytes); - for (the_copy) |*byte| { - switch (byte.*) { - '/', '\\' => byte.* = fs.path.sep, - else => {}, - } - } - return the_copy; - } - - /// Duplicates a package recursively. - pub fn dupePkg(self: *Builder, package: Pkg) Pkg { - var the_copy = Pkg{ - .name = self.dupe(package.name), - .source = package.source.dupe(self), - }; - - if (package.dependencies) |dependencies| { - const new_dependencies = self.allocator.alloc(Pkg, dependencies.len) catch unreachable; - the_copy.dependencies = new_dependencies; - - for (dependencies) |dep_package, i| { - new_dependencies[i] = self.dupePkg(dep_package); - } - } - return the_copy; - } - - pub fn addWriteFile(self: *Builder, file_path: []const u8, data: []const u8) *WriteFileStep { - const write_file_step = self.addWriteFiles(); - write_file_step.add(file_path, data); - return write_file_step; - } - - pub fn addWriteFiles(self: *Builder) *WriteFileStep { - const write_file_step = self.allocator.create(WriteFileStep) catch unreachable; - write_file_step.* = WriteFileStep.init(self); - return write_file_step; - } - - pub fn addLog(self: *Builder, comptime format: []const u8, args: anytype) *LogStep { - const data = self.fmt(format, args); - const log_step = self.allocator.create(LogStep) catch unreachable; - log_step.* = LogStep.init(self, data); - return log_step; - } - - pub fn addRemoveDirTree(self: *Builder, dir_path: []const u8) *RemoveDirStep { - const remove_dir_step = self.allocator.create(RemoveDirStep) catch unreachable; - remove_dir_step.* = RemoveDirStep.init(self, dir_path); - return remove_dir_step; - } - - pub fn addFmt(self: *Builder, paths: []const []const u8) *FmtStep { - return FmtStep.create(self, paths); - } - - pub fn addTranslateC(self: *Builder, options: TranslateCStep.Options) *TranslateCStep { - return TranslateCStep.create(self, options); - } - - pub fn make(self: *Builder, step_names: []const []const u8) !void { - try self.makePath(self.cache_root); - - var wanted_steps = ArrayList(*Step).init(self.allocator); - defer wanted_steps.deinit(); - - if (step_names.len == 0) { - try wanted_steps.append(self.default_step); - } else { - for (step_names) |step_name| { - const s = try self.getTopLevelStepByName(step_name); - try wanted_steps.append(s); - } - } - - for (wanted_steps.items) |s| { - try self.makeOneStep(s); - } - } - - pub fn getInstallStep(self: *Builder) *Step { - return &self.install_tls.step; - } - - pub fn getUninstallStep(self: *Builder) *Step { - return &self.uninstall_tls.step; - } - - fn makeUninstall(uninstall_step: *Step) anyerror!void { - const uninstall_tls = @fieldParentPtr(TopLevelStep, "step", uninstall_step); - const self = @fieldParentPtr(Builder, "uninstall_tls", uninstall_tls); - - for (self.installed_files.items) |installed_file| { - const full_path = self.getInstallPath(installed_file.dir, installed_file.path); - if (self.verbose) { - log.info("rm {s}", .{full_path}); - } - fs.cwd().deleteTree(full_path) catch {}; - } - - // TODO remove empty directories - } - - fn makeOneStep(self: *Builder, s: *Step) anyerror!void { - if (s.loop_flag) { - log.err("Dependency loop detected:\n {s}", .{s.name}); - return error.DependencyLoopDetected; - } - s.loop_flag = true; - - for (s.dependencies.items) |dep| { - self.makeOneStep(dep) catch |err| { - if (err == error.DependencyLoopDetected) { - log.err(" {s}", .{s.name}); - } - return err; - }; - } - - s.loop_flag = false; - - try s.make(); - } - - fn getTopLevelStepByName(self: *Builder, name: []const u8) !*Step { - for (self.top_level_steps.items) |top_level_step| { - if (mem.eql(u8, top_level_step.step.name, name)) { - return &top_level_step.step; - } - } - log.err("Cannot run step '{s}' because it does not exist", .{name}); - return error.InvalidStepName; - } - - pub fn option(self: *Builder, comptime T: type, name_raw: []const u8, description_raw: []const u8) ?T { - const name = self.dupe(name_raw); - const description = self.dupe(description_raw); - const type_id = comptime typeToEnum(T); - const enum_options = if (type_id == .@"enum") blk: { - const fields = comptime std.meta.fields(T); - var options = ArrayList([]const u8).initCapacity(self.allocator, fields.len) catch unreachable; - - inline for (fields) |field| { - options.appendAssumeCapacity(field.name); - } - - break :blk options.toOwnedSlice() catch unreachable; - } else null; - const available_option = AvailableOption{ - .name = name, - .type_id = type_id, - .description = description, - .enum_options = enum_options, - }; - if ((self.available_options_map.fetchPut(name, available_option) catch unreachable) != null) { - panic("Option '{s}' declared twice", .{name}); - } - self.available_options_list.append(available_option) catch unreachable; - - const option_ptr = self.user_input_options.getPtr(name) orelse return null; - option_ptr.used = true; - switch (type_id) { - .bool => switch (option_ptr.value) { - .flag => return true, - .scalar => |s| { - if (mem.eql(u8, s, "true")) { - return true; - } else if (mem.eql(u8, s, "false")) { - return false; - } else { - log.err("Expected -D{s} to be a boolean, but received '{s}'\n", .{ name, s }); - self.markInvalidUserInput(); - return null; - } - }, - .list, .map => { - log.err("Expected -D{s} to be a boolean, but received a {s}.\n", .{ - name, @tagName(option_ptr.value), - }); - self.markInvalidUserInput(); - return null; - }, - }, - .int => switch (option_ptr.value) { - .flag, .list, .map => { - log.err("Expected -D{s} to be an integer, but received a {s}.\n", .{ - name, @tagName(option_ptr.value), - }); - self.markInvalidUserInput(); - return null; - }, - .scalar => |s| { - const n = std.fmt.parseInt(T, s, 10) catch |err| switch (err) { - error.Overflow => { - log.err("-D{s} value {s} cannot fit into type {s}.\n", .{ name, s, @typeName(T) }); - self.markInvalidUserInput(); - return null; - }, - else => { - log.err("Expected -D{s} to be an integer of type {s}.\n", .{ name, @typeName(T) }); - self.markInvalidUserInput(); - return null; - }, - }; - return n; - }, - }, - .float => switch (option_ptr.value) { - .flag, .map, .list => { - log.err("Expected -D{s} to be a float, but received a {s}.\n", .{ - name, @tagName(option_ptr.value), - }); - self.markInvalidUserInput(); - return null; - }, - .scalar => |s| { - const n = std.fmt.parseFloat(T, s) catch { - log.err("Expected -D{s} to be a float of type {s}.\n", .{ name, @typeName(T) }); - self.markInvalidUserInput(); - return null; - }; - return n; - }, - }, - .@"enum" => switch (option_ptr.value) { - .flag, .map, .list => { - log.err("Expected -D{s} to be an enum, but received a {s}.\n", .{ - name, @tagName(option_ptr.value), - }); - self.markInvalidUserInput(); - return null; - }, - .scalar => |s| { - if (std.meta.stringToEnum(T, s)) |enum_lit| { - return enum_lit; - } else { - log.err("Expected -D{s} to be of type {s}.\n", .{ name, @typeName(T) }); - self.markInvalidUserInput(); - return null; - } - }, - }, - .string => switch (option_ptr.value) { - .flag, .list, .map => { - log.err("Expected -D{s} to be a string, but received a {s}.\n", .{ - name, @tagName(option_ptr.value), - }); - self.markInvalidUserInput(); - return null; - }, - .scalar => |s| return s, - }, - .list => switch (option_ptr.value) { - .flag, .map => { - log.err("Expected -D{s} to be a list, but received a {s}.\n", .{ - name, @tagName(option_ptr.value), - }); - self.markInvalidUserInput(); - return null; - }, - .scalar => |s| { - return self.allocator.dupe([]const u8, &[_][]const u8{s}) catch unreachable; - }, - .list => |lst| return lst.items, - }, - } - } - - pub fn step(self: *Builder, name: []const u8, description: []const u8) *Step { - const step_info = self.allocator.create(TopLevelStep) catch unreachable; - step_info.* = TopLevelStep{ - .step = Step.initNoOp(.top_level, name, self.allocator), - .description = self.dupe(description), - }; - self.top_level_steps.append(step_info) catch unreachable; - return &step_info.step; - } - - pub const StandardOptimizeOptionOptions = struct { - preferred_optimize_mode: ?std.builtin.Mode = null, - }; - - pub fn standardOptimizeOption(self: *Builder, options: StandardOptimizeOptionOptions) std.builtin.Mode { - if (options.preferred_optimize_mode) |mode| { - if (self.option(bool, "release", "optimize for end users") orelse false) { - return mode; - } else { - return .Debug; - } - } else { - return self.option( - std.builtin.Mode, - "optimize", - "prioritize performance, safety, or binary size (-O flag)", - ) orelse .Debug; - } - } - - pub const StandardTargetOptionsArgs = struct { - whitelist: ?[]const CrossTarget = null, - - default_target: CrossTarget = CrossTarget{}, - }; - - /// Exposes standard `zig build` options for choosing a target. - pub fn standardTargetOptions(self: *Builder, args: StandardTargetOptionsArgs) CrossTarget { - const maybe_triple = self.option( - []const u8, - "target", - "The CPU architecture, OS, and ABI to build for", - ); - const mcpu = self.option([]const u8, "cpu", "Target CPU features to add or subtract"); - - if (maybe_triple == null and mcpu == null) { - return args.default_target; - } - - const triple = maybe_triple orelse "native"; - - var diags: CrossTarget.ParseOptions.Diagnostics = .{}; - const selected_target = CrossTarget.parse(.{ - .arch_os_abi = triple, - .cpu_features = mcpu, - .diagnostics = &diags, - }) catch |err| switch (err) { - error.UnknownCpuModel => { - log.err("Unknown CPU: '{s}'\nAvailable CPUs for architecture '{s}':", .{ - diags.cpu_name.?, - @tagName(diags.arch.?), - }); - for (diags.arch.?.allCpuModels()) |cpu| { - log.err(" {s}", .{cpu.name}); - } - self.markInvalidUserInput(); - return args.default_target; - }, - error.UnknownCpuFeature => { - log.err( - \\Unknown CPU feature: '{s}' - \\Available CPU features for architecture '{s}': - \\ - , .{ - diags.unknown_feature_name.?, - @tagName(diags.arch.?), - }); - for (diags.arch.?.allFeaturesList()) |feature| { - log.err(" {s}: {s}", .{ feature.name, feature.description }); - } - self.markInvalidUserInput(); - return args.default_target; - }, - error.UnknownOperatingSystem => { - log.err( - \\Unknown OS: '{s}' - \\Available operating systems: - \\ - , .{diags.os_name.?}); - inline for (std.meta.fields(std.Target.Os.Tag)) |field| { - log.err(" {s}", .{field.name}); - } - self.markInvalidUserInput(); - return args.default_target; - }, - else => |e| { - log.err("Unable to parse target '{s}': {s}\n", .{ triple, @errorName(e) }); - self.markInvalidUserInput(); - return args.default_target; - }, - }; - - const selected_canonicalized_triple = selected_target.zigTriple(self.allocator) catch unreachable; - - if (args.whitelist) |list| whitelist_check: { - // Make sure it's a match of one of the list. - var mismatch_triple = true; - var mismatch_cpu_features = true; - var whitelist_item = CrossTarget{}; - for (list) |t| { - mismatch_cpu_features = true; - mismatch_triple = true; - - const t_triple = t.zigTriple(self.allocator) catch unreachable; - if (mem.eql(u8, t_triple, selected_canonicalized_triple)) { - mismatch_triple = false; - whitelist_item = t; - if (t.getCpuFeatures().isSuperSetOf(selected_target.getCpuFeatures())) { - mismatch_cpu_features = false; - break :whitelist_check; - } else { - break; - } - } - } - if (mismatch_triple) { - log.err("Chosen target '{s}' does not match one of the supported targets:", .{ - selected_canonicalized_triple, - }); - for (list) |t| { - const t_triple = t.zigTriple(self.allocator) catch unreachable; - log.err(" {s}", .{t_triple}); - } - } else { - assert(mismatch_cpu_features); - const whitelist_cpu = whitelist_item.getCpu(); - const selected_cpu = selected_target.getCpu(); - log.err("Chosen CPU model '{s}' does not match one of the supported targets:", .{ - selected_cpu.model.name, - }); - log.err(" Supported feature Set: ", .{}); - const all_features = whitelist_cpu.arch.allFeaturesList(); - var populated_cpu_features = whitelist_cpu.model.features; - populated_cpu_features.populateDependencies(all_features); - for (all_features) |feature, i_usize| { - const i = @intCast(std.Target.Cpu.Feature.Set.Index, i_usize); - const in_cpu_set = populated_cpu_features.isEnabled(i); - if (in_cpu_set) { - log.err("{s} ", .{feature.name}); - } - } - log.err(" Remove: ", .{}); - for (all_features) |feature, i_usize| { - const i = @intCast(std.Target.Cpu.Feature.Set.Index, i_usize); - const in_cpu_set = populated_cpu_features.isEnabled(i); - const in_actual_set = selected_cpu.features.isEnabled(i); - if (in_actual_set and !in_cpu_set) { - log.err("{s} ", .{feature.name}); - } - } - } - self.markInvalidUserInput(); - return args.default_target; - } - - return selected_target; - } - - pub fn addUserInputOption(self: *Builder, name_raw: []const u8, value_raw: []const u8) !bool { - const name = self.dupe(name_raw); - const value = self.dupe(value_raw); - const gop = try self.user_input_options.getOrPut(name); - if (!gop.found_existing) { - gop.value_ptr.* = UserInputOption{ - .name = name, - .value = .{ .scalar = value }, - .used = false, - }; - return false; - } - - // option already exists - switch (gop.value_ptr.value) { - .scalar => |s| { - // turn it into a list - var list = ArrayList([]const u8).init(self.allocator); - list.append(s) catch unreachable; - list.append(value) catch unreachable; - self.user_input_options.put(name, .{ - .name = name, - .value = .{ .list = list }, - .used = false, - }) catch unreachable; - }, - .list => |*list| { - // append to the list - list.append(value) catch unreachable; - self.user_input_options.put(name, .{ - .name = name, - .value = .{ .list = list.* }, - .used = false, - }) catch unreachable; - }, - .flag => { - log.warn("Option '-D{s}={s}' conflicts with flag '-D{s}'.", .{ name, value, name }); - return true; - }, - .map => |*map| { - _ = map; - log.warn("TODO maps as command line arguments is not implemented yet.", .{}); - return true; - }, - } - return false; - } - - pub fn addUserInputFlag(self: *Builder, name_raw: []const u8) !bool { - const name = self.dupe(name_raw); - const gop = try self.user_input_options.getOrPut(name); - if (!gop.found_existing) { - gop.value_ptr.* = .{ - .name = name, - .value = .{ .flag = {} }, - .used = false, - }; - return false; - } - - // option already exists - switch (gop.value_ptr.value) { - .scalar => |s| { - log.err("Flag '-D{s}' conflicts with option '-D{s}={s}'.", .{ name, name, s }); - return true; - }, - .list, .map => { - log.err("Flag '-D{s}' conflicts with multiple options of the same name.", .{name}); - return true; - }, - .flag => {}, - } - return false; - } - - fn typeToEnum(comptime T: type) TypeId { - return switch (@typeInfo(T)) { - .Int => .int, - .Float => .float, - .Bool => .bool, - .Enum => .@"enum", - else => switch (T) { - []const u8 => .string, - []const []const u8 => .list, - else => @compileError("Unsupported type: " ++ @typeName(T)), - }, - }; - } - - fn markInvalidUserInput(self: *Builder) void { - self.invalid_user_input = true; - } - - pub fn validateUserInputDidItFail(self: *Builder) bool { - // make sure all args are used - var it = self.user_input_options.iterator(); - while (it.next()) |entry| { - if (!entry.value_ptr.used) { - log.err("Invalid option: -D{s}", .{entry.key_ptr.*}); - self.markInvalidUserInput(); - } - } - - return self.invalid_user_input; - } - - pub fn spawnChild(self: *Builder, argv: []const []const u8) !void { - return self.spawnChildEnvMap(null, self.env_map, argv); - } - - fn printCmd(cwd: ?[]const u8, argv: []const []const u8) void { - if (cwd) |yes_cwd| std.debug.print("cd {s} && ", .{yes_cwd}); - for (argv) |arg| { - std.debug.print("{s} ", .{arg}); - } - std.debug.print("\n", .{}); - } - - pub fn spawnChildEnvMap(self: *Builder, cwd: ?[]const u8, env_map: *const EnvMap, argv: []const []const u8) !void { - if (self.verbose) { - printCmd(cwd, argv); - } - - if (!std.process.can_spawn) - return error.ExecNotSupported; - - var child = std.ChildProcess.init(argv, self.allocator); - child.cwd = cwd; - child.env_map = env_map; - - const term = child.spawnAndWait() catch |err| { - log.err("Unable to spawn {s}: {s}", .{ argv[0], @errorName(err) }); - return err; - }; - - switch (term) { - .Exited => |code| { - if (code != 0) { - log.err("The following command exited with error code {}:", .{code}); - printCmd(cwd, argv); - return error.UncleanExit; - } - }, - else => { - log.err("The following command terminated unexpectedly:", .{}); - printCmd(cwd, argv); - - return error.UncleanExit; - }, - } - } - - pub fn makePath(self: *Builder, path: []const u8) !void { - fs.cwd().makePath(self.pathFromRoot(path)) catch |err| { - log.err("Unable to create path {s}: {s}", .{ path, @errorName(err) }); - return err; - }; - } - - pub fn installArtifact(self: *Builder, artifact: *LibExeObjStep) void { - self.getInstallStep().dependOn(&self.addInstallArtifact(artifact).step); - } - - pub fn addInstallArtifact(self: *Builder, artifact: *LibExeObjStep) *InstallArtifactStep { - return InstallArtifactStep.create(self, artifact); - } - - ///`dest_rel_path` is relative to prefix path - pub fn installFile(self: *Builder, src_path: []const u8, dest_rel_path: []const u8) void { - self.getInstallStep().dependOn(&self.addInstallFileWithDir(.{ .path = src_path }, .prefix, dest_rel_path).step); - } - - pub fn installDirectory(self: *Builder, options: InstallDirectoryOptions) void { - self.getInstallStep().dependOn(&self.addInstallDirectory(options).step); - } - - ///`dest_rel_path` is relative to bin path - pub fn installBinFile(self: *Builder, src_path: []const u8, dest_rel_path: []const u8) void { - self.getInstallStep().dependOn(&self.addInstallFileWithDir(.{ .path = src_path }, .bin, dest_rel_path).step); - } - - ///`dest_rel_path` is relative to lib path - pub fn installLibFile(self: *Builder, src_path: []const u8, dest_rel_path: []const u8) void { - self.getInstallStep().dependOn(&self.addInstallFileWithDir(.{ .path = src_path }, .lib, dest_rel_path).step); - } - - /// Output format (BIN vs Intel HEX) determined by filename - pub fn installRaw(self: *Builder, artifact: *LibExeObjStep, dest_filename: []const u8, options: InstallRawStep.CreateOptions) *InstallRawStep { - const raw = self.addInstallRaw(artifact, dest_filename, options); - self.getInstallStep().dependOn(&raw.step); - return raw; - } - - ///`dest_rel_path` is relative to install prefix path - pub fn addInstallFile(self: *Builder, source: FileSource, dest_rel_path: []const u8) *InstallFileStep { - return self.addInstallFileWithDir(source.dupe(self), .prefix, dest_rel_path); - } - - ///`dest_rel_path` is relative to bin path - pub fn addInstallBinFile(self: *Builder, source: FileSource, dest_rel_path: []const u8) *InstallFileStep { - return self.addInstallFileWithDir(source.dupe(self), .bin, dest_rel_path); - } - - ///`dest_rel_path` is relative to lib path - pub fn addInstallLibFile(self: *Builder, source: FileSource, dest_rel_path: []const u8) *InstallFileStep { - return self.addInstallFileWithDir(source.dupe(self), .lib, dest_rel_path); - } - - pub fn addInstallHeaderFile(b: *Builder, src_path: []const u8, dest_rel_path: []const u8) *InstallFileStep { - return b.addInstallFileWithDir(.{ .path = src_path }, .header, dest_rel_path); - } - - pub fn addInstallRaw(self: *Builder, artifact: *LibExeObjStep, dest_filename: []const u8, options: InstallRawStep.CreateOptions) *InstallRawStep { - return InstallRawStep.create(self, artifact, dest_filename, options); - } - - pub fn addInstallFileWithDir( - self: *Builder, - source: FileSource, - install_dir: InstallDir, - dest_rel_path: []const u8, - ) *InstallFileStep { - if (dest_rel_path.len == 0) { - panic("dest_rel_path must be non-empty", .{}); - } - const install_step = self.allocator.create(InstallFileStep) catch unreachable; - install_step.* = InstallFileStep.init(self, source.dupe(self), install_dir, dest_rel_path); - return install_step; - } - - pub fn addInstallDirectory(self: *Builder, options: InstallDirectoryOptions) *InstallDirStep { - const install_step = self.allocator.create(InstallDirStep) catch unreachable; - install_step.* = InstallDirStep.init(self, options); - return install_step; - } - - pub fn pushInstalledFile(self: *Builder, dir: InstallDir, dest_rel_path: []const u8) void { - const file = InstalledFile{ - .dir = dir, - .path = dest_rel_path, - }; - self.installed_files.append(file.dupe(self)) catch unreachable; - } - - pub fn updateFile(self: *Builder, source_path: []const u8, dest_path: []const u8) !void { - if (self.verbose) { - log.info("cp {s} {s} ", .{ source_path, dest_path }); - } - const cwd = fs.cwd(); - const prev_status = try fs.Dir.updateFile(cwd, source_path, cwd, dest_path, .{}); - if (self.verbose) switch (prev_status) { - .stale => log.info("# installed", .{}), - .fresh => log.info("# up-to-date", .{}), - }; - } - - pub fn truncateFile(self: *Builder, dest_path: []const u8) !void { - if (self.verbose) { - log.info("truncate {s}", .{dest_path}); - } - const cwd = fs.cwd(); - var src_file = cwd.createFile(dest_path, .{}) catch |err| switch (err) { - error.FileNotFound => blk: { - if (fs.path.dirname(dest_path)) |dirname| { - try cwd.makePath(dirname); - } - break :blk try cwd.createFile(dest_path, .{}); - }, - else => |e| return e, - }; - src_file.close(); - } - - pub fn pathFromRoot(self: *Builder, rel_path: []const u8) []u8 { - return fs.path.resolve(self.allocator, &[_][]const u8{ self.build_root, rel_path }) catch unreachable; - } - - /// Shorthand for `std.fs.path.join(builder.allocator, paths) catch unreachable` - pub fn pathJoin(self: *Builder, paths: []const []const u8) []u8 { - return fs.path.join(self.allocator, paths) catch unreachable; - } - - pub fn fmt(self: *Builder, comptime format: []const u8, args: anytype) []u8 { - return fmt_lib.allocPrint(self.allocator, format, args) catch unreachable; - } - - pub fn findProgram(self: *Builder, names: []const []const u8, paths: []const []const u8) ![]const u8 { - // TODO report error for ambiguous situations - const exe_extension = @as(CrossTarget, .{}).exeFileExt(); - for (self.search_prefixes.items) |search_prefix| { - for (names) |name| { - if (fs.path.isAbsolute(name)) { - return name; - } - const full_path = self.pathJoin(&.{ - search_prefix, - "bin", - self.fmt("{s}{s}", .{ name, exe_extension }), - }); - return fs.realpathAlloc(self.allocator, full_path) catch continue; - } - } - if (self.env_map.get("PATH")) |PATH| { - for (names) |name| { - if (fs.path.isAbsolute(name)) { - return name; - } - var it = mem.tokenize(u8, PATH, &[_]u8{fs.path.delimiter}); - while (it.next()) |path| { - const full_path = self.pathJoin(&.{ - path, - self.fmt("{s}{s}", .{ name, exe_extension }), - }); - return fs.realpathAlloc(self.allocator, full_path) catch continue; - } - } - } - for (names) |name| { - if (fs.path.isAbsolute(name)) { - return name; - } - for (paths) |path| { - const full_path = self.pathJoin(&.{ - path, - self.fmt("{s}{s}", .{ name, exe_extension }), - }); - return fs.realpathAlloc(self.allocator, full_path) catch continue; - } - } - return error.FileNotFound; - } - - pub fn execAllowFail( - self: *Builder, - argv: []const []const u8, - out_code: *u8, - stderr_behavior: std.ChildProcess.StdIo, - ) ExecError![]u8 { - assert(argv.len != 0); - - if (!std.process.can_spawn) - return error.ExecNotSupported; - - const max_output_size = 400 * 1024; - var child = std.ChildProcess.init(argv, self.allocator); - child.stdin_behavior = .Ignore; - child.stdout_behavior = .Pipe; - child.stderr_behavior = stderr_behavior; - child.env_map = self.env_map; - - try child.spawn(); - - const stdout = child.stdout.?.reader().readAllAlloc(self.allocator, max_output_size) catch { - return error.ReadFailure; - }; - errdefer self.allocator.free(stdout); - - const term = try child.wait(); - switch (term) { - .Exited => |code| { - if (code != 0) { - out_code.* = @truncate(u8, code); - return error.ExitCodeFailure; - } - return stdout; - }, - .Signal, .Stopped, .Unknown => |code| { - out_code.* = @truncate(u8, code); - return error.ProcessTerminated; - }, - } - } - - pub fn execFromStep(self: *Builder, argv: []const []const u8, src_step: ?*Step) ![]u8 { - assert(argv.len != 0); - - if (self.verbose) { - printCmd(null, argv); - } - - if (!std.process.can_spawn) { - if (src_step) |s| log.err("{s}...", .{s.name}); - log.err("Unable to spawn the following command: cannot spawn child process", .{}); - printCmd(null, argv); - std.os.abort(); - } - - var code: u8 = undefined; - return self.execAllowFail(argv, &code, .Inherit) catch |err| switch (err) { - error.ExecNotSupported => { - if (src_step) |s| log.err("{s}...", .{s.name}); - log.err("Unable to spawn the following command: cannot spawn child process", .{}); - printCmd(null, argv); - std.os.abort(); - }, - error.FileNotFound => { - if (src_step) |s| log.err("{s}...", .{s.name}); - log.err("Unable to spawn the following command: file not found", .{}); - printCmd(null, argv); - std.os.exit(@truncate(u8, code)); - }, - error.ExitCodeFailure => { - if (src_step) |s| log.err("{s}...", .{s.name}); - if (self.prominent_compile_errors) { - log.err("The step exited with error code {d}", .{code}); - } else { - log.err("The following command exited with error code {d}:", .{code}); - printCmd(null, argv); - } - - std.os.exit(@truncate(u8, code)); - }, - error.ProcessTerminated => { - if (src_step) |s| log.err("{s}...", .{s.name}); - log.err("The following command terminated unexpectedly:", .{}); - printCmd(null, argv); - std.os.exit(@truncate(u8, code)); - }, - else => |e| return e, - }; - } - - pub fn exec(self: *Builder, argv: []const []const u8) ![]u8 { - return self.execFromStep(argv, null); - } - - pub fn addSearchPrefix(self: *Builder, search_prefix: []const u8) void { - self.search_prefixes.append(self.dupePath(search_prefix)) catch unreachable; - } - - pub fn getInstallPath(self: *Builder, dir: InstallDir, dest_rel_path: []const u8) []const u8 { - assert(!fs.path.isAbsolute(dest_rel_path)); // Install paths must be relative to the prefix - const base_dir = switch (dir) { - .prefix => self.install_path, - .bin => self.exe_dir, - .lib => self.lib_dir, - .header => self.h_dir, - .custom => |path| self.pathJoin(&.{ self.install_path, path }), - }; - return fs.path.resolve( - self.allocator, - &[_][]const u8{ base_dir, dest_rel_path }, - ) catch unreachable; - } - - pub const Dependency = struct { - builder: *Builder, - - pub fn artifact(d: *Dependency, name: []const u8) *LibExeObjStep { - var found: ?*LibExeObjStep = null; - for (d.builder.install_tls.step.dependencies.items) |dep_step| { - const inst = dep_step.cast(InstallArtifactStep) orelse continue; - if (mem.eql(u8, inst.artifact.name, name)) { - if (found != null) panic("artifact name '{s}' is ambiguous", .{name}); - found = inst.artifact; - } - } - return found orelse { - for (d.builder.install_tls.step.dependencies.items) |dep_step| { - const inst = dep_step.cast(InstallArtifactStep) orelse continue; - log.info("available artifact: '{s}'", .{inst.artifact.name}); - } - panic("unable to find artifact '{s}'", .{name}); - }; - } - }; - - pub fn dependency(b: *Builder, name: []const u8, args: anytype) *Dependency { - const build_runner = @import("root"); - const deps = build_runner.dependencies; - - inline for (@typeInfo(deps.imports).Struct.decls) |decl| { - if (mem.startsWith(u8, decl.name, b.dep_prefix) and - mem.endsWith(u8, decl.name, name) and - decl.name.len == b.dep_prefix.len + name.len) - { - const build_zig = @field(deps.imports, decl.name); - const build_root = @field(deps.build_root, decl.name); - return dependencyInner(b, name, build_root, build_zig, args); - } - } - - const full_path = b.pathFromRoot("build.zig.ini"); - std.debug.print("no dependency named '{s}' in '{s}'\n", .{ name, full_path }); - std.process.exit(1); - } - - fn dependencyInner( - b: *Builder, - name: []const u8, - build_root: []const u8, - comptime build_zig: type, - args: anytype, - ) *Dependency { - const sub_builder = b.createChild(name, build_root, args) catch unreachable; - sub_builder.runBuild(build_zig) catch unreachable; - - if (sub_builder.validateUserInputDidItFail()) { - std.debug.dumpCurrentStackTrace(@returnAddress()); - } - - const dep = b.allocator.create(Dependency) catch unreachable; - dep.* = .{ .builder = sub_builder }; - return dep; - } - - pub fn runBuild(b: *Builder, build_zig: anytype) anyerror!void { - switch (@typeInfo(@typeInfo(@TypeOf(build_zig.build)).Fn.return_type.?)) { - .Void => build_zig.build(b), - .ErrorUnion => try build_zig.build(b), - else => @compileError("expected return type of build to be 'void' or '!void'"), - } - } -}; - -test "builder.findProgram compiles" { - if (builtin.os.tag == .wasi) return error.SkipZigTest; - - var arena = std.heap.ArenaAllocator.init(std.heap.page_allocator); - defer arena.deinit(); - - const builder = try Builder.create( - arena.allocator(), - "zig", - "zig-cache", - "zig-cache", - "zig-cache", - ); - defer builder.destroy(); - _ = builder.findProgram(&[_][]const u8{}, &[_][]const u8{}) catch null; -} - -pub const Pkg = struct { - name: []const u8, - source: FileSource, - dependencies: ?[]const Pkg = null, -}; - -/// A file that is generated by a build step. -/// This struct is an interface that is meant to be used with `@fieldParentPtr` to implement the actual path logic. -pub const GeneratedFile = struct { - /// The step that generates the file - step: *Step, - - /// The path to the generated file. Must be either absolute or relative to the build root. - /// This value must be set in the `fn make()` of the `step` and must not be `null` afterwards. - path: ?[]const u8 = null, - - pub fn getPath(self: GeneratedFile) []const u8 { - return self.path orelse std.debug.panic( - "getPath() was called on a GeneratedFile that wasn't build yet. Is there a missing Step dependency on step '{s}'?", - .{self.step.name}, - ); - } -}; - -/// A file source is a reference to an existing or future file. -/// -pub const FileSource = union(enum) { - /// A plain file path, relative to build root or absolute. - path: []const u8, - - /// A file that is generated by an interface. Those files usually are - /// not available until built by a build step. - generated: *const GeneratedFile, - - /// Returns a new file source that will have a relative path to the build root guaranteed. - /// This should be preferred over setting `.path` directly as it documents that the files are in the project directory. - pub fn relative(path: []const u8) FileSource { - std.debug.assert(!std.fs.path.isAbsolute(path)); - return FileSource{ .path = path }; - } - - /// Returns a string that can be shown to represent the file source. - /// Either returns the path or `"generated"`. - pub fn getDisplayName(self: FileSource) []const u8 { - return switch (self) { - .path => self.path, - .generated => "generated", - }; - } - - /// Adds dependencies this file source implies to the given step. - pub fn addStepDependencies(self: FileSource, step: *Step) void { - switch (self) { - .path => {}, - .generated => |gen| step.dependOn(gen.step), - } - } - - /// Should only be called during make(), returns a path relative to the build root or absolute. - pub fn getPath(self: FileSource, builder: *Builder) []const u8 { - const path = switch (self) { - .path => |p| builder.pathFromRoot(p), - .generated => |gen| gen.getPath(), - }; - return path; - } - - /// Duplicates the file source for a given builder. - pub fn dupe(self: FileSource, b: *Builder) FileSource { - return switch (self) { - .path => |p| .{ .path = b.dupePath(p) }, - .generated => |gen| .{ .generated = gen }, - }; - } -}; - -/// Allocates a new string for assigning a value to a named macro. -/// If the value is omitted, it is set to 1. -/// `name` and `value` need not live longer than the function call. -pub fn constructCMacro(allocator: Allocator, name: []const u8, value: ?[]const u8) []const u8 { - var macro = allocator.alloc( - u8, - name.len + if (value) |value_slice| value_slice.len + 1 else 0, - ) catch |err| if (err == error.OutOfMemory) @panic("Out of memory") else unreachable; - mem.copy(u8, macro, name); - if (value) |value_slice| { - macro[name.len] = '='; - mem.copy(u8, macro[name.len + 1 ..], value_slice); - } - return macro; -} - -/// deprecated: use `InstallDirStep.Options` -pub const InstallDirectoryOptions = InstallDirStep.Options; - -pub const Step = struct { - id: Id, - name: []const u8, - makeFn: MakeFn, - dependencies: ArrayList(*Step), - loop_flag: bool, - done_flag: bool, - - const MakeFn = *const fn (self: *Step) anyerror!void; - - pub const Id = enum { - top_level, - lib_exe_obj, - install_artifact, - install_file, - install_dir, - log, - remove_dir, - fmt, - translate_c, - write_file, - run, - emulatable_run, - check_file, - check_object, - config_header, - install_raw, - options, - custom, - - pub fn Type(comptime id: Id) type { - return switch (id) { - .top_level => Builder.TopLevelStep, - .lib_exe_obj => LibExeObjStep, - .install_artifact => InstallArtifactStep, - .install_file => InstallFileStep, - .install_dir => InstallDirStep, - .log => LogStep, - .remove_dir => RemoveDirStep, - .fmt => FmtStep, - .translate_c => TranslateCStep, - .write_file => WriteFileStep, - .run => RunStep, - .emulatable_run => EmulatableRunStep, - .check_file => CheckFileStep, - .check_object => CheckObjectStep, - .config_header => ConfigHeaderStep, - .install_raw => InstallRawStep, - .options => OptionsStep, - .custom => @compileError("no type available for custom step"), - }; - } - }; - - pub fn init(id: Id, name: []const u8, allocator: Allocator, makeFn: MakeFn) Step { - return Step{ - .id = id, - .name = allocator.dupe(u8, name) catch unreachable, - .makeFn = makeFn, - .dependencies = ArrayList(*Step).init(allocator), - .loop_flag = false, - .done_flag = false, - }; - } - pub fn initNoOp(id: Id, name: []const u8, allocator: Allocator) Step { - return init(id, name, allocator, makeNoOp); - } - - pub fn make(self: *Step) !void { - if (self.done_flag) return; - - try self.makeFn(self); - self.done_flag = true; - } - - pub fn dependOn(self: *Step, other: *Step) void { - self.dependencies.append(other) catch unreachable; - } - - fn makeNoOp(self: *Step) anyerror!void { - _ = self; - } - - pub fn cast(step: *Step, comptime T: type) ?*T { - if (step.id == T.base_id) { - return @fieldParentPtr(T, "step", step); - } - return null; - } -}; - -pub const VcpkgRoot = union(VcpkgRootStatus) { - unattempted: void, - not_found: void, - found: []const u8, -}; - -pub const VcpkgRootStatus = enum { - unattempted, - not_found, - found, -}; - -pub const InstallDir = union(enum) { - prefix: void, - lib: void, - bin: void, - header: void, - /// A path relative to the prefix - custom: []const u8, - - /// Duplicates the install directory including the path if set to custom. - pub fn dupe(self: InstallDir, builder: *Builder) InstallDir { - if (self == .custom) { - // Written with this temporary to avoid RLS problems - const duped_path = builder.dupe(self.custom); - return .{ .custom = duped_path }; - } else { - return self; - } - } -}; - -pub const InstalledFile = struct { - dir: InstallDir, - path: []const u8, - - /// Duplicates the installed file path and directory. - pub fn dupe(self: InstalledFile, builder: *Builder) InstalledFile { - return .{ - .dir = self.dir.dupe(builder), - .path = builder.dupe(self.path), - }; - } -}; - -pub fn serializeCpu(allocator: Allocator, cpu: std.Target.Cpu) ![]const u8 { - // TODO this logic can disappear if cpu model + features becomes part of the target triple - const all_features = cpu.arch.allFeaturesList(); - var populated_cpu_features = cpu.model.features; - populated_cpu_features.populateDependencies(all_features); - - if (populated_cpu_features.eql(cpu.features)) { - // The CPU name alone is sufficient. - return cpu.model.name; - } else { - var mcpu_buffer = ArrayList(u8).init(allocator); - try mcpu_buffer.appendSlice(cpu.model.name); - - for (all_features) |feature, i_usize| { - const i = @intCast(std.Target.Cpu.Feature.Set.Index, i_usize); - const in_cpu_set = populated_cpu_features.isEnabled(i); - const in_actual_set = cpu.features.isEnabled(i); - if (in_cpu_set and !in_actual_set) { - try mcpu_buffer.writer().print("-{s}", .{feature.name}); - } else if (!in_cpu_set and in_actual_set) { - try mcpu_buffer.writer().print("+{s}", .{feature.name}); - } - } - - return try mcpu_buffer.toOwnedSlice(); - } -} - -test "dupePkg()" { - if (builtin.os.tag == .wasi) return error.SkipZigTest; - - var arena = std.heap.ArenaAllocator.init(std.testing.allocator); - defer arena.deinit(); - var builder = try Builder.create( - arena.allocator(), - "test", - "test", - "test", - "test", - ); - defer builder.destroy(); - - var pkg_dep = Pkg{ - .name = "pkg_dep", - .source = .{ .path = "/not/a/pkg_dep.zig" }, - }; - var pkg_top = Pkg{ - .name = "pkg_top", - .source = .{ .path = "/not/a/pkg_top.zig" }, - .dependencies = &[_]Pkg{pkg_dep}, - }; - const dupe = builder.dupePkg(pkg_top); - - const original_deps = pkg_top.dependencies.?; - const dupe_deps = dupe.dependencies.?; - - // probably the same top level package details - try std.testing.expectEqualStrings(pkg_top.name, dupe.name); - - // probably the same dependencies - try std.testing.expectEqual(original_deps.len, dupe_deps.len); - try std.testing.expectEqual(original_deps[0].name, pkg_dep.name); - - // could segfault otherwise if pointers in duplicated package's fields are - // the same as those in stack allocated package's fields - try std.testing.expect(dupe_deps.ptr != original_deps.ptr); - try std.testing.expect(dupe.name.ptr != pkg_top.name.ptr); - try std.testing.expect(dupe.source.path.ptr != pkg_top.source.path.ptr); - try std.testing.expect(dupe_deps[0].name.ptr != pkg_dep.name.ptr); - try std.testing.expect(dupe_deps[0].source.path.ptr != pkg_dep.source.path.ptr); -} - -test { - _ = CheckFileStep; - _ = CheckObjectStep; - _ = EmulatableRunStep; - _ = FmtStep; - _ = InstallArtifactStep; - _ = InstallDirStep; - _ = InstallFileStep; - _ = InstallRawStep; - _ = LibExeObjStep; - _ = LogStep; - _ = OptionsStep; - _ = RemoveDirStep; - _ = RunStep; - _ = TranslateCStep; - _ = WriteFileStep; -} diff --git a/lib/std/std.zig b/lib/std/std.zig index ba52784b45..e0318ceb43 100644 --- a/lib/std/std.zig +++ b/lib/std/std.zig @@ -9,6 +9,7 @@ pub const AutoArrayHashMapUnmanaged = array_hash_map.AutoArrayHashMapUnmanaged; pub const AutoHashMap = hash_map.AutoHashMap; pub const AutoHashMapUnmanaged = hash_map.AutoHashMapUnmanaged; pub const BoundedArray = @import("bounded_array.zig").BoundedArray; +pub const Build = @import("Build.zig"); pub const BufMap = @import("buf_map.zig").BufMap; pub const BufSet = @import("buf_set.zig").BufSet; pub const ChildProcess = @import("child_process.zig").ChildProcess; @@ -49,7 +50,6 @@ pub const array_hash_map = @import("array_hash_map.zig"); pub const atomic = @import("atomic.zig"); pub const base64 = @import("base64.zig"); pub const bit_set = @import("bit_set.zig"); -pub const build = @import("build.zig"); pub const builtin = @import("builtin.zig"); pub const c = @import("c.zig"); pub const coff = @import("coff.zig"); @@ -96,6 +96,12 @@ pub const wasm = @import("wasm.zig"); pub const zig = @import("zig.zig"); pub const start = @import("start.zig"); +///// Deprecated. Use `std.Build` instead. +//pub const build = struct { +// /// Deprecated. Use `std.Build` instead. +// pub const Builder = Build; +//}; + const root = @import("root"); const options_override = if (@hasDecl(root, "std_options")) root.std_options else struct {}; diff --git a/test/link/bss/build.zig b/test/link/bss/build.zig index c31fa7faf5..0df9c1d323 100644 --- a/test/link/bss/build.zig +++ b/test/link/bss/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test"); diff --git a/test/link/common_symbols/build.zig b/test/link/common_symbols/build.zig index 068c3f9c57..ee9dd94ebd 100644 --- a/test/link/common_symbols/build.zig +++ b/test/link/common_symbols/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const lib_a = b.addStaticLibrary(.{ diff --git a/test/link/common_symbols_alignment/build.zig b/test/link/common_symbols_alignment/build.zig index b6dd39801c..f6efdc784b 100644 --- a/test/link/common_symbols_alignment/build.zig +++ b/test/link/common_symbols_alignment/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); diff --git a/test/link/interdependent_static_c_libs/build.zig b/test/link/interdependent_static_c_libs/build.zig index 50a214490d..d8962a8e08 100644 --- a/test/link/interdependent_static_c_libs/build.zig +++ b/test/link/interdependent_static_c_libs/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); diff --git a/test/link/macho/bugs/13056/build.zig b/test/link/macho/bugs/13056/build.zig index a65cd60766..662fd25c92 100644 --- a/test/link/macho/bugs/13056/build.zig +++ b/test/link/macho/bugs/13056/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; diff --git a/test/link/macho/bugs/13457/build.zig b/test/link/macho/bugs/13457/build.zig index 4c1ce89261..6ca1f31b86 100644 --- a/test/link/macho/bugs/13457/build.zig +++ b/test/link/macho/bugs/13457/build.zig @@ -1,8 +1,7 @@ const std = @import("std"); -const Builder = std.build.Builder; -const LibExeObjectStep = std.build.LibExeObjStep; +const LibExeObjectStep = std.Build.LibExeObjStep; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; diff --git a/test/link/macho/dead_strip/build.zig b/test/link/macho/dead_strip/build.zig index a4c3575e45..b6c3002492 100644 --- a/test/link/macho/dead_strip/build.zig +++ b/test/link/macho/dead_strip/build.zig @@ -1,8 +1,7 @@ const std = @import("std"); -const Builder = std.build.Builder; -const LibExeObjectStep = std.build.LibExeObjStep; +const LibExeObjectStep = std.Build.LibExeObjStep; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; @@ -37,7 +36,7 @@ pub fn build(b: *Builder) void { } } -fn createScenario(b: *Builder, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { +fn createScenario(b: *std.Build, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { const exe = b.addExecutable(.{ .name = "test", .optimize = optimize, diff --git a/test/link/macho/dead_strip_dylibs/build.zig b/test/link/macho/dead_strip_dylibs/build.zig index 0127b575fc..f61b30ca4a 100644 --- a/test/link/macho/dead_strip_dylibs/build.zig +++ b/test/link/macho/dead_strip_dylibs/build.zig @@ -1,8 +1,7 @@ const std = @import("std"); -const Builder = std.build.Builder; -const LibExeObjectStep = std.build.LibExeObjStep; +const LibExeObjectStep = std.Build.LibExeObjStep; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test the program"); @@ -36,7 +35,7 @@ pub fn build(b: *Builder) void { } } -fn createScenario(b: *Builder, optimize: std.builtin.OptimizeMode) *LibExeObjectStep { +fn createScenario(b: *std.Build, optimize: std.builtin.OptimizeMode) *LibExeObjectStep { const exe = b.addExecutable(.{ .name = "test", .optimize = optimize, diff --git a/test/link/macho/dylib/build.zig b/test/link/macho/dylib/build.zig index acd27a507f..7a1e2d862c 100644 --- a/test/link/macho/dylib/build.zig +++ b/test/link/macho/dylib/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; diff --git a/test/link/macho/empty/build.zig b/test/link/macho/empty/build.zig index 8b2d047371..586da1511b 100644 --- a/test/link/macho/empty/build.zig +++ b/test/link/macho/empty/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; @@ -17,7 +16,7 @@ pub fn build(b: *Builder) void { exe.addCSourceFile("empty.c", &[0][]const u8{}); exe.linkLibC(); - const run_cmd = std.build.EmulatableRunStep.create(b, "run", exe); + const run_cmd = std.Build.EmulatableRunStep.create(b, "run", exe); run_cmd.expectStdOutEqual("Hello!\n"); test_step.dependOn(&run_cmd.step); } diff --git a/test/link/macho/entry/build.zig b/test/link/macho/entry/build.zig index 87e4d1b5da..4504da9c6c 100644 --- a/test/link/macho/entry/build.zig +++ b/test/link/macho/entry/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test"); diff --git a/test/link/macho/headerpad/build.zig b/test/link/macho/headerpad/build.zig index 74efb5d580..2b3c6abb8a 100644 --- a/test/link/macho/headerpad/build.zig +++ b/test/link/macho/headerpad/build.zig @@ -1,9 +1,8 @@ const std = @import("std"); const builtin = @import("builtin"); -const Builder = std.build.Builder; -const LibExeObjectStep = std.build.LibExeObjStep; +const LibExeObjectStep = std.Build.LibExeObjStep; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test"); @@ -94,7 +93,7 @@ pub fn build(b: *Builder) void { } } -fn simpleExe(b: *Builder, optimize: std.builtin.OptimizeMode) *LibExeObjectStep { +fn simpleExe(b: *std.Build, optimize: std.builtin.OptimizeMode) *LibExeObjectStep { const exe = b.addExecutable(.{ .name = "main", .optimize = optimize, diff --git a/test/link/macho/linksection/build.zig b/test/link/macho/linksection/build.zig index eebb31a21e..227d4eeb63 100644 --- a/test/link/macho/linksection/build.zig +++ b/test/link/macho/linksection/build.zig @@ -1,6 +1,6 @@ const std = @import("std"); -pub fn build(b: *std.build.Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target = std.zig.CrossTarget{ .os_tag = .macos }; diff --git a/test/link/macho/needed_framework/build.zig b/test/link/macho/needed_framework/build.zig index 33965a9272..62b70b21f1 100644 --- a/test/link/macho/needed_framework/build.zig +++ b/test/link/macho/needed_framework/build.zig @@ -1,8 +1,7 @@ const std = @import("std"); -const Builder = std.build.Builder; -const LibExeObjectStep = std.build.LibExeObjStep; +const LibExeObjectStep = std.Build.LibExeObjStep; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test the program"); diff --git a/test/link/macho/needed_library/build.zig b/test/link/macho/needed_library/build.zig index 137239d292..cdad94357b 100644 --- a/test/link/macho/needed_library/build.zig +++ b/test/link/macho/needed_library/build.zig @@ -1,8 +1,7 @@ const std = @import("std"); -const Builder = std.build.Builder; -const LibExeObjectStep = std.build.LibExeObjStep; +const LibExeObjectStep = std.Build.LibExeObjStep; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; diff --git a/test/link/macho/objc/build.zig b/test/link/macho/objc/build.zig index 9c38739a5c..10d293baab 100644 --- a/test/link/macho/objc/build.zig +++ b/test/link/macho/objc/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test the program"); @@ -18,6 +17,6 @@ pub fn build(b: *Builder) void { // populate paths to the sysroot here. exe.linkFramework("Foundation"); - const run_cmd = std.build.EmulatableRunStep.create(b, "run", exe); + const run_cmd = std.Build.EmulatableRunStep.create(b, "run", exe); test_step.dependOn(&run_cmd.step); } diff --git a/test/link/macho/objcpp/build.zig b/test/link/macho/objcpp/build.zig index f4c88b2862..2a3459be50 100644 --- a/test/link/macho/objcpp/build.zig +++ b/test/link/macho/objcpp/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test the program"); diff --git a/test/link/macho/pagezero/build.zig b/test/link/macho/pagezero/build.zig index f61aa34a93..0a8471b919 100644 --- a/test/link/macho/pagezero/build.zig +++ b/test/link/macho/pagezero/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; diff --git a/test/link/macho/search_strategy/build.zig b/test/link/macho/search_strategy/build.zig index db894b6ae3..eeda89446b 100644 --- a/test/link/macho/search_strategy/build.zig +++ b/test/link/macho/search_strategy/build.zig @@ -1,8 +1,7 @@ const std = @import("std"); -const Builder = std.build.Builder; -const LibExeObjectStep = std.build.LibExeObjStep; +const LibExeObjectStep = std.Build.LibExeObjStep; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; @@ -29,14 +28,14 @@ pub fn build(b: *Builder) void { const exe = createScenario(b, optimize, target); exe.search_strategy = .paths_first; - const run = std.build.EmulatableRunStep.create(b, "run", exe); + const run = std.Build.EmulatableRunStep.create(b, "run", exe); run.cwd = b.pathFromRoot("."); run.expectStdOutEqual("Hello world"); test_step.dependOn(&run.step); } } -fn createScenario(b: *Builder, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { +fn createScenario(b: *std.Build, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { const static = b.addStaticLibrary(.{ .name = "a", .optimize = optimize, @@ -44,7 +43,7 @@ fn createScenario(b: *Builder, optimize: std.builtin.OptimizeMode, target: std.z }); static.addCSourceFile("a.c", &.{}); static.linkLibC(); - static.override_dest_dir = std.build.InstallDir{ + static.override_dest_dir = std.Build.InstallDir{ .custom = "static", }; static.install(); @@ -57,7 +56,7 @@ fn createScenario(b: *Builder, optimize: std.builtin.OptimizeMode, target: std.z }); dylib.addCSourceFile("a.c", &.{}); dylib.linkLibC(); - dylib.override_dest_dir = std.build.InstallDir{ + dylib.override_dest_dir = std.Build.InstallDir{ .custom = "dynamic", }; dylib.install(); diff --git a/test/link/macho/stack_size/build.zig b/test/link/macho/stack_size/build.zig index 74e9a86e94..3529a134eb 100644 --- a/test/link/macho/stack_size/build.zig +++ b/test/link/macho/stack_size/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; diff --git a/test/link/macho/strict_validation/build.zig b/test/link/macho/strict_validation/build.zig index b6baf63c11..6eabc02b5f 100644 --- a/test/link/macho/strict_validation/build.zig +++ b/test/link/macho/strict_validation/build.zig @@ -1,9 +1,8 @@ const std = @import("std"); const builtin = @import("builtin"); -const Builder = std.build.Builder; -const LibExeObjectStep = std.build.LibExeObjStep; +const LibExeObjectStep = std.Build.LibExeObjStep; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; diff --git a/test/link/macho/tls/build.zig b/test/link/macho/tls/build.zig index 9b2fe952bf..c77588cb5d 100644 --- a/test/link/macho/tls/build.zig +++ b/test/link/macho/tls/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; diff --git a/test/link/macho/unwind_info/build.zig b/test/link/macho/unwind_info/build.zig index dbbdbb3e51..e43c002e2e 100644 --- a/test/link/macho/unwind_info/build.zig +++ b/test/link/macho/unwind_info/build.zig @@ -1,9 +1,8 @@ const std = @import("std"); const builtin = @import("builtin"); -const Builder = std.build.Builder; -const LibExeObjectStep = std.build.LibExeObjStep; +const LibExeObjectStep = std.Build.LibExeObjStep; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; @@ -14,8 +13,8 @@ pub fn build(b: *Builder) void { } fn testUnwindInfo( - b: *Builder, - test_step: *std.build.Step, + b: *std.Build, + test_step: *std.Build.Step, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget, dead_strip: bool, @@ -52,7 +51,7 @@ fn testUnwindInfo( test_step.dependOn(&run_cmd.step); } -fn createScenario(b: *Builder, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { +fn createScenario(b: *std.Build, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { const exe = b.addExecutable(.{ .name = "test", .optimize = optimize, diff --git a/test/link/macho/uuid/build.zig b/test/link/macho/uuid/build.zig index 86ff99e8b1..62c288f1a0 100644 --- a/test/link/macho/uuid/build.zig +++ b/test/link/macho/uuid/build.zig @@ -1,8 +1,7 @@ const std = @import("std"); -const Builder = std.build.Builder; -const LibExeObjectStep = std.build.LibExeObjStep; +const LibExeObjectStep = std.Build.LibExeObjStep; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); @@ -27,8 +26,8 @@ pub fn build(b: *Builder) void { } fn testUuid( - b: *Builder, - test_step: *std.build.Step, + b: *std.Build, + test_step: *std.Build.Step, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget, comptime exp: []const u8, @@ -52,7 +51,7 @@ fn testUuid( } } -fn simpleDylib(b: *Builder, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { +fn simpleDylib(b: *std.Build, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { const dylib = b.addSharedLibrary(.{ .name = "test", .version = .{ .major = 1, .minor = 0 }, diff --git a/test/link/macho/weak_framework/build.zig b/test/link/macho/weak_framework/build.zig index f8460c4e82..5be66991dd 100644 --- a/test/link/macho/weak_framework/build.zig +++ b/test/link/macho/weak_framework/build.zig @@ -1,8 +1,7 @@ const std = @import("std"); -const Builder = std.build.Builder; -const LibExeObjectStep = std.build.LibExeObjStep; +const LibExeObjectStep = std.Build.LibExeObjStep; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test the program"); diff --git a/test/link/macho/weak_library/build.zig b/test/link/macho/weak_library/build.zig index 229d965e48..505ab5ae96 100644 --- a/test/link/macho/weak_library/build.zig +++ b/test/link/macho/weak_library/build.zig @@ -1,8 +1,7 @@ const std = @import("std"); -const Builder = std.build.Builder; -const LibExeObjectStep = std.build.LibExeObjStep; +const LibExeObjectStep = std.Build.LibExeObjStep; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target: std.zig.CrossTarget = .{ .os_tag = .macos }; diff --git a/test/link/static_lib_as_system_lib/build.zig b/test/link/static_lib_as_system_lib/build.zig index 895cdcf316..b6cf32d711 100644 --- a/test/link/static_lib_as_system_lib/build.zig +++ b/test/link/static_lib_as_system_lib/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); diff --git a/test/link/wasm/archive/build.zig b/test/link/wasm/archive/build.zig index 7401ba22dc..342c4c08d1 100644 --- a/test/link/wasm/archive/build.zig +++ b/test/link/wasm/archive/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); diff --git a/test/link/wasm/basic-features/build.zig b/test/link/wasm/basic-features/build.zig index 69e88aefae..9f57066518 100644 --- a/test/link/wasm/basic-features/build.zig +++ b/test/link/wasm/basic-features/build.zig @@ -1,6 +1,6 @@ const std = @import("std"); -pub fn build(b: *std.build.Builder) void { +pub fn build(b: *std.Build) void { // Library with explicitly set cpu features const lib = b.addSharedLibrary(.{ .name = "lib", diff --git a/test/link/wasm/bss/build.zig b/test/link/wasm/bss/build.zig index 6b29fd0dc3..1017e70a71 100644 --- a/test/link/wasm/bss/build.zig +++ b/test/link/wasm/bss/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); diff --git a/test/link/wasm/export-data/build.zig b/test/link/wasm/export-data/build.zig index 8eab283ec2..95caf42dd0 100644 --- a/test/link/wasm/export-data/build.zig +++ b/test/link/wasm/export-data/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); diff --git a/test/link/wasm/export/build.zig b/test/link/wasm/export/build.zig index 2b9a91d728..69c34a320e 100644 --- a/test/link/wasm/export/build.zig +++ b/test/link/wasm/export/build.zig @@ -1,6 +1,6 @@ const std = @import("std"); -pub fn build(b: *std.build.Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const no_export = b.addSharedLibrary(.{ diff --git a/test/link/wasm/extern-mangle/build.zig b/test/link/wasm/extern-mangle/build.zig index 71bb986dff..19913e6eca 100644 --- a/test/link/wasm/extern-mangle/build.zig +++ b/test/link/wasm/extern-mangle/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); diff --git a/test/link/wasm/extern/build.zig b/test/link/wasm/extern/build.zig index 800c76a31c..569d94091a 100644 --- a/test/link/wasm/extern/build.zig +++ b/test/link/wasm/extern/build.zig @@ -1,6 +1,6 @@ const std = @import("std"); -pub fn build(b: *std.build.Builder) void { +pub fn build(b: *std.Build) void { const exe = b.addExecutable(.{ .name = "extern", .root_source_file = .{ .path = "main.zig" }, diff --git a/test/link/wasm/function-table/build.zig b/test/link/wasm/function-table/build.zig index 804aaf0b09..4c25d0d860 100644 --- a/test/link/wasm/function-table/build.zig +++ b/test/link/wasm/function-table/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const test_step = b.step("test", "Test"); diff --git a/test/link/wasm/infer-features/build.zig b/test/link/wasm/infer-features/build.zig index 147fb55fda..d6d706a33d 100644 --- a/test/link/wasm/infer-features/build.zig +++ b/test/link/wasm/infer-features/build.zig @@ -1,6 +1,6 @@ const std = @import("std"); -pub fn build(b: *std.build.Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); // Wasm Object file which we will use to infer the features from diff --git a/test/link/wasm/producers/build.zig b/test/link/wasm/producers/build.zig index 57ee6acd18..2589b0dfcf 100644 --- a/test/link/wasm/producers/build.zig +++ b/test/link/wasm/producers/build.zig @@ -1,8 +1,7 @@ const std = @import("std"); const builtin = @import("builtin"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); diff --git a/test/link/wasm/segments/build.zig b/test/link/wasm/segments/build.zig index 8f7d9e0583..76160e905f 100644 --- a/test/link/wasm/segments/build.zig +++ b/test/link/wasm/segments/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); diff --git a/test/link/wasm/stack_pointer/build.zig b/test/link/wasm/stack_pointer/build.zig index 42971c607d..95c7643880 100644 --- a/test/link/wasm/stack_pointer/build.zig +++ b/test/link/wasm/stack_pointer/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); diff --git a/test/link/wasm/type/build.zig b/test/link/wasm/type/build.zig index 7fa3849083..816b57ccab 100644 --- a/test/link/wasm/type/build.zig +++ b/test/link/wasm/type/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const test_step = b.step("test", "Test"); test_step.dependOn(b.getInstallStep()); diff --git a/test/src/compare_output.zig b/test/src/compare_output.zig index a885faaadf..edd48321c9 100644 --- a/test/src/compare_output.zig +++ b/test/src/compare_output.zig @@ -1,7 +1,6 @@ // This is the implementation of the test harness. // For the actual test cases, see test/compare_output.zig. const std = @import("std"); -const build = std.build; const ArrayList = std.ArrayList; const fmt = std.fmt; const mem = std.mem; @@ -9,8 +8,8 @@ const fs = std.fs; const OptimizeMode = std.builtin.OptimizeMode; pub const CompareOutputContext = struct { - b: *build.Builder, - step: *build.Step, + b: *std.Build, + step: *std.Build.Step, test_index: usize, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode, diff --git a/test/src/run_translated_c.zig b/test/src/run_translated_c.zig index 0c54655b32..2103172ed6 100644 --- a/test/src/run_translated_c.zig +++ b/test/src/run_translated_c.zig @@ -1,15 +1,14 @@ // This is the implementation of the test harness for running translated // C code. For the actual test cases, see test/run_translated_c.zig. const std = @import("std"); -const build = std.build; const ArrayList = std.ArrayList; const fmt = std.fmt; const mem = std.mem; const fs = std.fs; pub const RunTranslatedCContext = struct { - b: *build.Builder, - step: *build.Step, + b: *std.Build, + step: *std.Build.Step, test_index: usize, test_filter: ?[]const u8, target: std.zig.CrossTarget, diff --git a/test/src/translate_c.zig b/test/src/translate_c.zig index ad5fbb7091..e275ee57ee 100644 --- a/test/src/translate_c.zig +++ b/test/src/translate_c.zig @@ -1,7 +1,6 @@ // This is the implementation of the test harness. // For the actual test cases, see test/translate_c.zig. const std = @import("std"); -const build = std.build; const ArrayList = std.ArrayList; const fmt = std.fmt; const mem = std.mem; @@ -9,8 +8,8 @@ const fs = std.fs; const CrossTarget = std.zig.CrossTarget; pub const TranslateCContext = struct { - b: *build.Builder, - step: *build.Step, + b: *std.Build, + step: *std.Build.Step, test_index: usize, test_filter: ?[]const u8, diff --git a/test/standalone/brace_expansion/build.zig b/test/standalone/brace_expansion/build.zig index 89250ff96f..7c32a09bef 100644 --- a/test/standalone/brace_expansion/build.zig +++ b/test/standalone/brace_expansion/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const main = b.addTest(.{ .root_source_file = .{ .path = "main.zig" }, .optimize = b.standardOptimizeOption(.{}), diff --git a/test/standalone/c_compiler/build.zig b/test/standalone/c_compiler/build.zig index 6959f810d6..dce999d4a2 100644 --- a/test/standalone/c_compiler/build.zig +++ b/test/standalone/c_compiler/build.zig @@ -1,9 +1,8 @@ const std = @import("std"); const builtin = @import("builtin"); -const Builder = std.build.Builder; const CrossTarget = std.zig.CrossTarget; -// TODO integrate this with the std.build executor API +// TODO integrate this with the std.Build executor API fn isRunnableTarget(t: CrossTarget) bool { if (t.isNative()) return true; @@ -11,7 +10,7 @@ fn isRunnableTarget(t: CrossTarget) bool { t.getCpuArch() == builtin.cpu.arch); } -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); diff --git a/test/standalone/emit_asm_and_bin/build.zig b/test/standalone/emit_asm_and_bin/build.zig index b8cbd5fc17..5345f0f538 100644 --- a/test/standalone/emit_asm_and_bin/build.zig +++ b/test/standalone/emit_asm_and_bin/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const main = b.addTest(.{ .root_source_file = .{ .path = "main.zig" }, .optimize = b.standardOptimizeOption(.{}), diff --git a/test/standalone/empty_env/build.zig b/test/standalone/empty_env/build.zig index ecdd74aa90..c4b4846141 100644 --- a/test/standalone/empty_env/build.zig +++ b/test/standalone/empty_env/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const main = b.addExecutable(.{ .name = "main", .root_source_file = .{ .path = "main.zig" }, diff --git a/test/standalone/global_linkage/build.zig b/test/standalone/global_linkage/build.zig index 3064c6cc08..9f79c80fcf 100644 --- a/test/standalone/global_linkage/build.zig +++ b/test/standalone/global_linkage/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const obj1 = b.addStaticLibrary(.{ diff --git a/test/standalone/install_raw_hex/build.zig b/test/standalone/install_raw_hex/build.zig index 94016b1d74..b0f938a344 100644 --- a/test/standalone/install_raw_hex/build.zig +++ b/test/standalone/install_raw_hex/build.zig @@ -1,8 +1,8 @@ const builtin = @import("builtin"); const std = @import("std"); -const CheckFileStep = std.build.CheckFileStep; +const CheckFileStep = std.Build.CheckFileStep; -pub fn build(b: *std.build.Builder) void { +pub fn build(b: *std.Build) void { const target = .{ .cpu_arch = .thumb, .cpu_model = .{ .explicit = &std.Target.arm.cpu.cortex_m4 }, diff --git a/test/standalone/issue_11595/build.zig b/test/standalone/issue_11595/build.zig index b0310947f6..c335fb73da 100644 --- a/test/standalone/issue_11595/build.zig +++ b/test/standalone/issue_11595/build.zig @@ -1,9 +1,8 @@ const std = @import("std"); const builtin = @import("builtin"); -const Builder = std.build.Builder; const CrossTarget = std.zig.CrossTarget; -// TODO integrate this with the std.build executor API +// TODO integrate this with the std.Build executor API fn isRunnableTarget(t: CrossTarget) bool { if (t.isNative()) return true; @@ -11,7 +10,7 @@ fn isRunnableTarget(t: CrossTarget) bool { t.getCpuArch() == builtin.cpu.arch); } -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); diff --git a/test/standalone/issue_12588/build.zig b/test/standalone/issue_12588/build.zig index 27a23d5a76..9f14c53e38 100644 --- a/test/standalone/issue_12588/build.zig +++ b/test/standalone/issue_12588/build.zig @@ -1,7 +1,6 @@ const std = @import("std"); -const Builder = std.build.Builder; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); diff --git a/test/standalone/issue_12706/build.zig b/test/standalone/issue_12706/build.zig index e3c40d34c6..9d616477a2 100644 --- a/test/standalone/issue_12706/build.zig +++ b/test/standalone/issue_12706/build.zig @@ -1,9 +1,8 @@ const std = @import("std"); const builtin = @import("builtin"); -const Builder = std.build.Builder; const CrossTarget = std.zig.CrossTarget; -// TODO integrate this with the std.build executor API +// TODO integrate this with the std.Build executor API fn isRunnableTarget(t: CrossTarget) bool { if (t.isNative()) return true; @@ -11,7 +10,7 @@ fn isRunnableTarget(t: CrossTarget) bool { t.getCpuArch() == builtin.cpu.arch); } -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); diff --git a/test/standalone/issue_13030/build.zig b/test/standalone/issue_13030/build.zig index 510c7610d9..258d9b7db8 100644 --- a/test/standalone/issue_13030/build.zig +++ b/test/standalone/issue_13030/build.zig @@ -1,9 +1,8 @@ const std = @import("std"); const builtin = @import("builtin"); -const Builder = std.build.Builder; const CrossTarget = std.zig.CrossTarget; -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); diff --git a/test/standalone/issue_339/build.zig b/test/standalone/issue_339/build.zig index 34c555cfdb..62ac128aab 100644 --- a/test/standalone/issue_339/build.zig +++ b/test/standalone/issue_339/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const obj = b.addObject(.{ .name = "test", .root_source_file = .{ .path = "test.zig" }, diff --git a/test/standalone/issue_5825/build.zig b/test/standalone/issue_5825/build.zig index 8d7acc3e9a..89272280d4 100644 --- a/test/standalone/issue_5825/build.zig +++ b/test/standalone/issue_5825/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const target = .{ .cpu_arch = .x86_64, .os_tag = .windows, diff --git a/test/standalone/issue_7030/build.zig b/test/standalone/issue_7030/build.zig index 41a646abe8..dc535318cc 100644 --- a/test/standalone/issue_7030/build.zig +++ b/test/standalone/issue_7030/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const exe = b.addExecutable(.{ .name = "issue_7030", .root_source_file = .{ .path = "main.zig" }, diff --git a/test/standalone/issue_794/build.zig b/test/standalone/issue_794/build.zig index 59ff7ea9ab..3089a28fd0 100644 --- a/test/standalone/issue_794/build.zig +++ b/test/standalone/issue_794/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const test_artifact = b.addTest(.{ .root_source_file = .{ .path = "main.zig" }, }); diff --git a/test/standalone/issue_8550/build.zig b/test/standalone/issue_8550/build.zig index 233f701661..c3303d55db 100644 --- a/test/standalone/issue_8550/build.zig +++ b/test/standalone/issue_8550/build.zig @@ -1,6 +1,6 @@ const std = @import("std"); -pub fn build(b: *std.build.Builder) !void { +pub fn build(b: *std.Build) !void { const target = std.zig.CrossTarget{ .os_tag = .freestanding, .cpu_arch = .arm, diff --git a/test/standalone/issue_9812/build.zig b/test/standalone/issue_9812/build.zig index 50eefe846c..4ca55ce999 100644 --- a/test/standalone/issue_9812/build.zig +++ b/test/standalone/issue_9812/build.zig @@ -1,6 +1,6 @@ const std = @import("std"); -pub fn build(b: *std.build.Builder) !void { +pub fn build(b: *std.Build) !void { const optimize = b.standardOptimizeOption(.{}); const zip_add = b.addTest(.{ .root_source_file = .{ .path = "main.zig" }, diff --git a/test/standalone/load_dynamic_library/build.zig b/test/standalone/load_dynamic_library/build.zig index 1aca02bc71..44fc37893c 100644 --- a/test/standalone/load_dynamic_library/build.zig +++ b/test/standalone/load_dynamic_library/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const target = b.standardTargetOptions(.{}); const optimize = b.standardOptimizeOption(.{}); diff --git a/test/standalone/main_pkg_path/build.zig b/test/standalone/main_pkg_path/build.zig index baee74052e..f9919d5ab5 100644 --- a/test/standalone/main_pkg_path/build.zig +++ b/test/standalone/main_pkg_path/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const test_exe = b.addTest(.{ .root_source_file = .{ .path = "a/test.zig" }, }); diff --git a/test/standalone/mix_c_files/build.zig b/test/standalone/mix_c_files/build.zig index ad69f05ff6..f2dfb2093f 100644 --- a/test/standalone/mix_c_files/build.zig +++ b/test/standalone/mix_c_files/build.zig @@ -1,9 +1,8 @@ const std = @import("std"); const builtin = @import("builtin"); -const Builder = std.build.Builder; const CrossTarget = std.zig.CrossTarget; -// TODO integrate this with the std.build executor API +// TODO integrate this with the std.Build executor API fn isRunnableTarget(t: CrossTarget) bool { if (t.isNative()) return true; @@ -11,7 +10,7 @@ fn isRunnableTarget(t: CrossTarget) bool { t.getCpuArch() == builtin.cpu.arch); } -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); diff --git a/test/standalone/mix_o_files/build.zig b/test/standalone/mix_o_files/build.zig index de37265388..2708343aa5 100644 --- a/test/standalone/mix_o_files/build.zig +++ b/test/standalone/mix_o_files/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const obj = b.addObject(.{ diff --git a/test/standalone/options/build.zig b/test/standalone/options/build.zig index 87a584a887..3f1e823359 100644 --- a/test/standalone/options/build.zig +++ b/test/standalone/options/build.zig @@ -1,6 +1,6 @@ const std = @import("std"); -pub fn build(b: *std.build.Builder) void { +pub fn build(b: *std.Build) void { const target = b.standardTargetOptions(.{}); const optimize = b.standardOptimizeOption(.{}); diff --git a/test/standalone/pie/build.zig b/test/standalone/pie/build.zig index 3f0b8b9f2f..d51ea27328 100644 --- a/test/standalone/pie/build.zig +++ b/test/standalone/pie/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const main = b.addTest(.{ .root_source_file = .{ .path = "main.zig" }, .optimize = b.standardOptimizeOption(.{}), diff --git a/test/standalone/pkg_import/build.zig b/test/standalone/pkg_import/build.zig index 8dcfaeded0..5fbc8a67ae 100644 --- a/test/standalone/pkg_import/build.zig +++ b/test/standalone/pkg_import/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const exe = b.addExecutable(.{ diff --git a/test/standalone/shared_library/build.zig b/test/standalone/shared_library/build.zig index 135be095bc..91f7c8a06a 100644 --- a/test/standalone/shared_library/build.zig +++ b/test/standalone/shared_library/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const target = b.standardTargetOptions(.{}); const lib = b.addSharedLibrary(.{ diff --git a/test/standalone/static_c_lib/build.zig b/test/standalone/static_c_lib/build.zig index 81b4349e20..9937888843 100644 --- a/test/standalone/static_c_lib/build.zig +++ b/test/standalone/static_c_lib/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const foo = b.addStaticLibrary(.{ diff --git a/test/standalone/test_runner_path/build.zig b/test/standalone/test_runner_path/build.zig index 9b02da50c1..f073c55d4a 100644 --- a/test/standalone/test_runner_path/build.zig +++ b/test/standalone/test_runner_path/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const test_exe = b.addTest(.{ .root_source_file = .{ .path = "test.zig" }, .kind = .test_exe, diff --git a/test/standalone/use_alias/build.zig b/test/standalone/use_alias/build.zig index d2ca90f3ab..89e07efb22 100644 --- a/test/standalone/use_alias/build.zig +++ b/test/standalone/use_alias/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const main = b.addTest(.{ .root_source_file = .{ .path = "main.zig" }, .optimize = b.standardOptimizeOption(.{}), diff --git a/test/standalone/windows_spawn/build.zig b/test/standalone/windows_spawn/build.zig index de58a602c3..3ebde5a50c 100644 --- a/test/standalone/windows_spawn/build.zig +++ b/test/standalone/windows_spawn/build.zig @@ -1,6 +1,6 @@ -const Builder = @import("std").build.Builder; +const std = @import("std"); -pub fn build(b: *Builder) void { +pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); const hello = b.addExecutable(.{ diff --git a/test/tests.zig b/test/tests.zig index 575550be02..de25528dde 100644 --- a/test/tests.zig +++ b/test/tests.zig @@ -1,7 +1,6 @@ const std = @import("std"); const builtin = @import("builtin"); const debug = std.debug; -const build = std.build; const CrossTarget = std.zig.CrossTarget; const io = std.io; const fs = std.fs; @@ -9,9 +8,10 @@ const mem = std.mem; const fmt = std.fmt; const ArrayList = std.ArrayList; const OptimizeMode = std.builtin.OptimizeMode; -const LibExeObjStep = build.LibExeObjStep; +const LibExeObjStep = std.Build.LibExeObjStep; const Allocator = mem.Allocator; -const ExecError = build.Builder.ExecError; +const ExecError = std.Build.ExecError; +const Step = std.Build.Step; // Cases const compare_output = @import("compare_output.zig"); @@ -462,7 +462,7 @@ const test_targets = blk: { const max_stdout_size = 1 * 1024 * 1024; // 1 MB -pub fn addCompareOutputTests(b: *build.Builder, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode) *build.Step { +pub fn addCompareOutputTests(b: *std.Build, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode) *Step { const cases = b.allocator.create(CompareOutputContext) catch unreachable; cases.* = CompareOutputContext{ .b = b, @@ -477,7 +477,7 @@ pub fn addCompareOutputTests(b: *build.Builder, test_filter: ?[]const u8, optimi return cases.step; } -pub fn addStackTraceTests(b: *build.Builder, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode) *build.Step { +pub fn addStackTraceTests(b: *std.Build, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode) *Step { const cases = b.allocator.create(StackTracesContext) catch unreachable; cases.* = StackTracesContext{ .b = b, @@ -493,7 +493,7 @@ pub fn addStackTraceTests(b: *build.Builder, test_filter: ?[]const u8, optimize_ } pub fn addStandaloneTests( - b: *build.Builder, + b: *std.Build, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode, skip_non_native: bool, @@ -506,7 +506,7 @@ pub fn addStandaloneTests( enable_wasmtime: bool, enable_wine: bool, enable_symlinks_windows: bool, -) *build.Step { +) *Step { const cases = b.allocator.create(StandaloneContext) catch unreachable; cases.* = StandaloneContext{ .b = b, @@ -532,13 +532,13 @@ pub fn addStandaloneTests( } pub fn addLinkTests( - b: *build.Builder, + b: *std.Build, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode, enable_macos_sdk: bool, omit_stage2: bool, enable_symlinks_windows: bool, -) *build.Step { +) *Step { const cases = b.allocator.create(StandaloneContext) catch unreachable; cases.* = StandaloneContext{ .b = b, @@ -556,7 +556,7 @@ pub fn addLinkTests( return cases.step; } -pub fn addCliTests(b: *build.Builder, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode) *build.Step { +pub fn addCliTests(b: *std.Build, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode) *Step { _ = test_filter; _ = optimize_modes; const step = b.step("test-cli", "Test the command line interface"); @@ -577,7 +577,7 @@ pub fn addCliTests(b: *build.Builder, test_filter: ?[]const u8, optimize_modes: return step; } -pub fn addAssembleAndLinkTests(b: *build.Builder, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode) *build.Step { +pub fn addAssembleAndLinkTests(b: *std.Build, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode) *Step { const cases = b.allocator.create(CompareOutputContext) catch unreachable; cases.* = CompareOutputContext{ .b = b, @@ -592,7 +592,7 @@ pub fn addAssembleAndLinkTests(b: *build.Builder, test_filter: ?[]const u8, opti return cases.step; } -pub fn addTranslateCTests(b: *build.Builder, test_filter: ?[]const u8) *build.Step { +pub fn addTranslateCTests(b: *std.Build, test_filter: ?[]const u8) *Step { const cases = b.allocator.create(TranslateCContext) catch unreachable; cases.* = TranslateCContext{ .b = b, @@ -607,10 +607,10 @@ pub fn addTranslateCTests(b: *build.Builder, test_filter: ?[]const u8) *build.St } pub fn addRunTranslatedCTests( - b: *build.Builder, + b: *std.Build, test_filter: ?[]const u8, target: std.zig.CrossTarget, -) *build.Step { +) *Step { const cases = b.allocator.create(RunTranslatedCContext) catch unreachable; cases.* = .{ .b = b, @@ -625,7 +625,7 @@ pub fn addRunTranslatedCTests( return cases.step; } -pub fn addGenHTests(b: *build.Builder, test_filter: ?[]const u8) *build.Step { +pub fn addGenHTests(b: *std.Build, test_filter: ?[]const u8) *Step { const cases = b.allocator.create(GenHContext) catch unreachable; cases.* = GenHContext{ .b = b, @@ -640,7 +640,7 @@ pub fn addGenHTests(b: *build.Builder, test_filter: ?[]const u8) *build.Step { } pub fn addPkgTests( - b: *build.Builder, + b: *std.Build, test_filter: ?[]const u8, root_src: []const u8, name: []const u8, @@ -651,7 +651,7 @@ pub fn addPkgTests( skip_libc: bool, skip_stage1: bool, skip_stage2: bool, -) *build.Step { +) *Step { const step = b.step(b.fmt("test-{s}", .{name}), desc); for (test_targets) |test_target| { @@ -742,8 +742,8 @@ pub fn addPkgTests( } pub const StackTracesContext = struct { - b: *build.Builder, - step: *build.Step, + b: *std.Build, + step: *Step, test_index: usize, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode, @@ -840,7 +840,7 @@ pub const StackTracesContext = struct { const RunAndCompareStep = struct { pub const base_id = .custom; - step: build.Step, + step: Step, context: *StackTracesContext, exe: *LibExeObjStep, name: []const u8, @@ -858,7 +858,7 @@ pub const StackTracesContext = struct { const allocator = context.b.allocator; const ptr = allocator.create(RunAndCompareStep) catch unreachable; ptr.* = RunAndCompareStep{ - .step = build.Step.init(.custom, "StackTraceCompareOutputStep", allocator, make), + .step = Step.init(.custom, "StackTraceCompareOutputStep", allocator, make), .context = context, .exe = exe, .name = name, @@ -871,7 +871,7 @@ pub const StackTracesContext = struct { return ptr; } - fn make(step: *build.Step) !void { + fn make(step: *Step) !void { const self = @fieldParentPtr(RunAndCompareStep, "step", step); const b = self.context.b; @@ -1014,8 +1014,8 @@ pub const StackTracesContext = struct { }; pub const StandaloneContext = struct { - b: *build.Builder, - step: *build.Step, + b: *std.Build, + step: *Step, test_index: usize, test_filter: ?[]const u8, optimize_modes: []const OptimizeMode, @@ -1150,8 +1150,8 @@ pub const StandaloneContext = struct { }; pub const GenHContext = struct { - b: *build.Builder, - step: *build.Step, + b: *std.Build, + step: *Step, test_index: usize, test_filter: ?[]const u8, @@ -1178,7 +1178,7 @@ pub const GenHContext = struct { }; const GenHCmpOutputStep = struct { - step: build.Step, + step: Step, context: *GenHContext, obj: *LibExeObjStep, name: []const u8, @@ -1194,7 +1194,7 @@ pub const GenHContext = struct { const allocator = context.b.allocator; const ptr = allocator.create(GenHCmpOutputStep) catch unreachable; ptr.* = GenHCmpOutputStep{ - .step = build.Step.init(.Custom, "ParseCCmpOutput", allocator, make), + .step = Step.init(.Custom, "ParseCCmpOutput", allocator, make), .context = context, .obj = obj, .name = name, @@ -1206,7 +1206,7 @@ pub const GenHContext = struct { return ptr; } - fn make(step: *build.Step) !void { + fn make(step: *Step) !void { const self = @fieldParentPtr(GenHCmpOutputStep, "step", step); const b = self.context.b; @@ -1348,7 +1348,7 @@ const c_abi_targets = [_]CrossTarget{ }, }; -pub fn addCAbiTests(b: *build.Builder, skip_non_native: bool, skip_release: bool) *build.Step { +pub fn addCAbiTests(b: *std.Build, skip_non_native: bool, skip_release: bool) *Step { const step = b.step("test-c-abi", "Run the C ABI tests"); const optimize_modes: [2]OptimizeMode = .{ .Debug, .ReleaseFast }; From 60c4befad39a1e1689872bc78dd1b8f8d5c34887 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 31 Jan 2023 00:20:37 -0700 Subject: [PATCH 48/84] build.zig: remove dead list of unused source files --- build.zig | 160 ------------------------------------------------------ 1 file changed, 160 deletions(-) diff --git a/build.zig b/build.zig index 6b6c384fc4..713eac6517 100644 --- a/build.zig +++ b/build.zig @@ -870,166 +870,6 @@ fn toNativePathSep(b: *std.Build, s: []const u8) []u8 { return duplicated; } -const softfloat_sources = [_][]const u8{ - "deps/SoftFloat-3e/source/8086/f128M_isSignalingNaN.c", - "deps/SoftFloat-3e/source/8086/extF80M_isSignalingNaN.c", - "deps/SoftFloat-3e/source/8086/s_commonNaNToF128M.c", - "deps/SoftFloat-3e/source/8086/s_commonNaNToExtF80M.c", - "deps/SoftFloat-3e/source/8086/s_commonNaNToF16UI.c", - "deps/SoftFloat-3e/source/8086/s_commonNaNToF32UI.c", - "deps/SoftFloat-3e/source/8086/s_commonNaNToF64UI.c", - "deps/SoftFloat-3e/source/8086/s_f128MToCommonNaN.c", - "deps/SoftFloat-3e/source/8086/s_extF80MToCommonNaN.c", - "deps/SoftFloat-3e/source/8086/s_f16UIToCommonNaN.c", - "deps/SoftFloat-3e/source/8086/s_f32UIToCommonNaN.c", - "deps/SoftFloat-3e/source/8086/s_f64UIToCommonNaN.c", - "deps/SoftFloat-3e/source/8086/s_propagateNaNF128M.c", - "deps/SoftFloat-3e/source/8086/s_propagateNaNExtF80M.c", - "deps/SoftFloat-3e/source/8086/s_propagateNaNF16UI.c", - "deps/SoftFloat-3e/source/8086/softfloat_raiseFlags.c", - "deps/SoftFloat-3e/source/f128M_add.c", - "deps/SoftFloat-3e/source/f128M_div.c", - "deps/SoftFloat-3e/source/f128M_eq.c", - "deps/SoftFloat-3e/source/f128M_eq_signaling.c", - "deps/SoftFloat-3e/source/f128M_le.c", - "deps/SoftFloat-3e/source/f128M_le_quiet.c", - "deps/SoftFloat-3e/source/f128M_lt.c", - "deps/SoftFloat-3e/source/f128M_lt_quiet.c", - "deps/SoftFloat-3e/source/f128M_mul.c", - "deps/SoftFloat-3e/source/f128M_mulAdd.c", - "deps/SoftFloat-3e/source/f128M_rem.c", - "deps/SoftFloat-3e/source/f128M_roundToInt.c", - "deps/SoftFloat-3e/source/f128M_sqrt.c", - "deps/SoftFloat-3e/source/f128M_sub.c", - "deps/SoftFloat-3e/source/f128M_to_f16.c", - "deps/SoftFloat-3e/source/f128M_to_f32.c", - "deps/SoftFloat-3e/source/f128M_to_f64.c", - "deps/SoftFloat-3e/source/f128M_to_extF80M.c", - "deps/SoftFloat-3e/source/f128M_to_i32.c", - "deps/SoftFloat-3e/source/f128M_to_i32_r_minMag.c", - "deps/SoftFloat-3e/source/f128M_to_i64.c", - "deps/SoftFloat-3e/source/f128M_to_i64_r_minMag.c", - "deps/SoftFloat-3e/source/f128M_to_ui32.c", - "deps/SoftFloat-3e/source/f128M_to_ui32_r_minMag.c", - "deps/SoftFloat-3e/source/f128M_to_ui64.c", - "deps/SoftFloat-3e/source/f128M_to_ui64_r_minMag.c", - "deps/SoftFloat-3e/source/extF80M_add.c", - "deps/SoftFloat-3e/source/extF80M_div.c", - "deps/SoftFloat-3e/source/extF80M_eq.c", - "deps/SoftFloat-3e/source/extF80M_le.c", - "deps/SoftFloat-3e/source/extF80M_lt.c", - "deps/SoftFloat-3e/source/extF80M_mul.c", - "deps/SoftFloat-3e/source/extF80M_rem.c", - "deps/SoftFloat-3e/source/extF80M_roundToInt.c", - "deps/SoftFloat-3e/source/extF80M_sqrt.c", - "deps/SoftFloat-3e/source/extF80M_sub.c", - "deps/SoftFloat-3e/source/extF80M_to_f16.c", - "deps/SoftFloat-3e/source/extF80M_to_f32.c", - "deps/SoftFloat-3e/source/extF80M_to_f64.c", - "deps/SoftFloat-3e/source/extF80M_to_f128M.c", - "deps/SoftFloat-3e/source/f16_add.c", - "deps/SoftFloat-3e/source/f16_div.c", - "deps/SoftFloat-3e/source/f16_eq.c", - "deps/SoftFloat-3e/source/f16_isSignalingNaN.c", - "deps/SoftFloat-3e/source/f16_lt.c", - "deps/SoftFloat-3e/source/f16_mul.c", - "deps/SoftFloat-3e/source/f16_mulAdd.c", - "deps/SoftFloat-3e/source/f16_rem.c", - "deps/SoftFloat-3e/source/f16_roundToInt.c", - "deps/SoftFloat-3e/source/f16_sqrt.c", - "deps/SoftFloat-3e/source/f16_sub.c", - "deps/SoftFloat-3e/source/f16_to_extF80M.c", - "deps/SoftFloat-3e/source/f16_to_f128M.c", - "deps/SoftFloat-3e/source/f16_to_f64.c", - "deps/SoftFloat-3e/source/f32_to_extF80M.c", - "deps/SoftFloat-3e/source/f32_to_f128M.c", - "deps/SoftFloat-3e/source/f64_to_extF80M.c", - "deps/SoftFloat-3e/source/f64_to_f128M.c", - "deps/SoftFloat-3e/source/f64_to_f16.c", - "deps/SoftFloat-3e/source/i32_to_f128M.c", - "deps/SoftFloat-3e/source/s_add256M.c", - "deps/SoftFloat-3e/source/s_addCarryM.c", - "deps/SoftFloat-3e/source/s_addComplCarryM.c", - "deps/SoftFloat-3e/source/s_addF128M.c", - "deps/SoftFloat-3e/source/s_addExtF80M.c", - "deps/SoftFloat-3e/source/s_addM.c", - "deps/SoftFloat-3e/source/s_addMagsF16.c", - "deps/SoftFloat-3e/source/s_addMagsF32.c", - "deps/SoftFloat-3e/source/s_addMagsF64.c", - "deps/SoftFloat-3e/source/s_approxRecip32_1.c", - "deps/SoftFloat-3e/source/s_approxRecipSqrt32_1.c", - "deps/SoftFloat-3e/source/s_approxRecipSqrt_1Ks.c", - "deps/SoftFloat-3e/source/s_approxRecip_1Ks.c", - "deps/SoftFloat-3e/source/s_compare128M.c", - "deps/SoftFloat-3e/source/s_compare96M.c", - "deps/SoftFloat-3e/source/s_compareNonnormExtF80M.c", - "deps/SoftFloat-3e/source/s_countLeadingZeros16.c", - "deps/SoftFloat-3e/source/s_countLeadingZeros32.c", - "deps/SoftFloat-3e/source/s_countLeadingZeros64.c", - "deps/SoftFloat-3e/source/s_countLeadingZeros8.c", - "deps/SoftFloat-3e/source/s_eq128.c", - "deps/SoftFloat-3e/source/s_invalidF128M.c", - "deps/SoftFloat-3e/source/s_invalidExtF80M.c", - "deps/SoftFloat-3e/source/s_isNaNF128M.c", - "deps/SoftFloat-3e/source/s_le128.c", - "deps/SoftFloat-3e/source/s_lt128.c", - "deps/SoftFloat-3e/source/s_mul128MTo256M.c", - "deps/SoftFloat-3e/source/s_mul64To128M.c", - "deps/SoftFloat-3e/source/s_mulAddF128M.c", - "deps/SoftFloat-3e/source/s_mulAddF16.c", - "deps/SoftFloat-3e/source/s_mulAddF32.c", - "deps/SoftFloat-3e/source/s_mulAddF64.c", - "deps/SoftFloat-3e/source/s_negXM.c", - "deps/SoftFloat-3e/source/s_normExtF80SigM.c", - "deps/SoftFloat-3e/source/s_normRoundPackMToF128M.c", - "deps/SoftFloat-3e/source/s_normRoundPackMToExtF80M.c", - "deps/SoftFloat-3e/source/s_normRoundPackToF16.c", - "deps/SoftFloat-3e/source/s_normRoundPackToF32.c", - "deps/SoftFloat-3e/source/s_normRoundPackToF64.c", - "deps/SoftFloat-3e/source/s_normSubnormalF128SigM.c", - "deps/SoftFloat-3e/source/s_normSubnormalF16Sig.c", - "deps/SoftFloat-3e/source/s_normSubnormalF32Sig.c", - "deps/SoftFloat-3e/source/s_normSubnormalF64Sig.c", - "deps/SoftFloat-3e/source/s_remStepMBy32.c", - "deps/SoftFloat-3e/source/s_roundMToI64.c", - "deps/SoftFloat-3e/source/s_roundMToUI64.c", - "deps/SoftFloat-3e/source/s_roundPackMToExtF80M.c", - "deps/SoftFloat-3e/source/s_roundPackMToF128M.c", - "deps/SoftFloat-3e/source/s_roundPackToF16.c", - "deps/SoftFloat-3e/source/s_roundPackToF32.c", - "deps/SoftFloat-3e/source/s_roundPackToF64.c", - "deps/SoftFloat-3e/source/s_roundToI32.c", - "deps/SoftFloat-3e/source/s_roundToI64.c", - "deps/SoftFloat-3e/source/s_roundToUI32.c", - "deps/SoftFloat-3e/source/s_roundToUI64.c", - "deps/SoftFloat-3e/source/s_shiftLeftM.c", - "deps/SoftFloat-3e/source/s_shiftNormSigF128M.c", - "deps/SoftFloat-3e/source/s_shiftRightJam256M.c", - "deps/SoftFloat-3e/source/s_shiftRightJam32.c", - "deps/SoftFloat-3e/source/s_shiftRightJam64.c", - "deps/SoftFloat-3e/source/s_shiftRightJamM.c", - "deps/SoftFloat-3e/source/s_shiftRightM.c", - "deps/SoftFloat-3e/source/s_shortShiftLeft64To96M.c", - "deps/SoftFloat-3e/source/s_shortShiftLeftM.c", - "deps/SoftFloat-3e/source/s_shortShiftRightExtendM.c", - "deps/SoftFloat-3e/source/s_shortShiftRightJam64.c", - "deps/SoftFloat-3e/source/s_shortShiftRightJamM.c", - "deps/SoftFloat-3e/source/s_shortShiftRightM.c", - "deps/SoftFloat-3e/source/s_sub1XM.c", - "deps/SoftFloat-3e/source/s_sub256M.c", - "deps/SoftFloat-3e/source/s_subM.c", - "deps/SoftFloat-3e/source/s_subMagsF16.c", - "deps/SoftFloat-3e/source/s_subMagsF32.c", - "deps/SoftFloat-3e/source/s_subMagsF64.c", - "deps/SoftFloat-3e/source/s_tryPropagateNaNF128M.c", - "deps/SoftFloat-3e/source/s_tryPropagateNaNExtF80M.c", - "deps/SoftFloat-3e/source/softfloat_state.c", - "deps/SoftFloat-3e/source/ui32_to_f128M.c", - "deps/SoftFloat-3e/source/ui64_to_f128M.c", - "deps/SoftFloat-3e/source/ui32_to_extF80M.c", - "deps/SoftFloat-3e/source/ui64_to_extF80M.c", -}; - const zig_cpp_sources = [_][]const u8{ // These are planned to stay even when we are self-hosted. "src/zig_llvm.cpp", From 5129fae4e8fdb68db1efdff20679b13487501691 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 31 Jan 2023 00:33:45 -0700 Subject: [PATCH 49/84] std.Build: accept host Target in create() And only detect native target in LibExeObjStep once, in create(). --- lib/build_runner.zig | 3 +++ lib/std/Build.zig | 10 ++++++++-- lib/std/Build/LibExeObjStep.zig | 8 ++++---- lib/std/Build/OptionsStep.zig | 4 ++++ 4 files changed, 19 insertions(+), 6 deletions(-) diff --git a/lib/build_runner.zig b/lib/build_runner.zig index 189b118787..f2b2eba950 100644 --- a/lib/build_runner.zig +++ b/lib/build_runner.zig @@ -41,12 +41,15 @@ pub fn main() !void { return error.InvalidArgs; }; + const host = try std.zig.system.NativeTargetInfo.detect(.{}); + const builder = try std.Build.create( allocator, zig_exe, build_root, cache_root, global_cache_root, + host, ); defer builder.destroy(); diff --git a/lib/std/Build.zig b/lib/std/Build.zig index a3c579c743..c0152ef6f1 100644 --- a/lib/std/Build.zig +++ b/lib/std/Build.zig @@ -179,12 +179,11 @@ pub fn create( build_root: []const u8, cache_root: []const u8, global_cache_root: []const u8, + host: NativeTargetInfo, ) !*Build { const env_map = try allocator.create(EnvMap); env_map.* = try process.getEnvMap(allocator); - const host = try NativeTargetInfo.detect(.{}); - const self = try allocator.create(Build); self.* = Build{ .zig_exe = zig_exe, @@ -1529,12 +1528,15 @@ test "builder.findProgram compiles" { var arena = std.heap.ArenaAllocator.init(std.heap.page_allocator); defer arena.deinit(); + const host = try NativeTargetInfo.detect(.{}); + const builder = try Build.create( arena.allocator(), "zig", "zig-cache", "zig-cache", "zig-cache", + host, ); defer builder.destroy(); _ = builder.findProgram(&[_][]const u8{}, &[_][]const u8{}) catch null; @@ -1713,12 +1715,16 @@ test "dupePkg()" { var arena = std.heap.ArenaAllocator.init(std.testing.allocator); defer arena.deinit(); + + const host = try NativeTargetInfo.detect(.{}); + var builder = try Build.create( arena.allocator(), "test", "test", "test", "test", + host, ); defer builder.destroy(); diff --git a/lib/std/Build/LibExeObjStep.zig b/lib/std/Build/LibExeObjStep.zig index af9d34440d..67f42c1783 100644 --- a/lib/std/Build/LibExeObjStep.zig +++ b/lib/std/Build/LibExeObjStep.zig @@ -364,7 +364,7 @@ pub fn create(builder: *std.Build, options: Options) *LibExeObjStep { .output_h_path_source = GeneratedFile{ .step = &self.step }, .output_pdb_path_source = GeneratedFile{ .step = &self.step }, - .target_info = undefined, // populated in computeOutFileNames + .target_info = NativeTargetInfo.detect(self.target) catch unreachable, }; self.computeOutFileNames(); if (root_src) |rs| rs.addStepDependencies(&self.step); @@ -372,9 +372,6 @@ pub fn create(builder: *std.Build, options: Options) *LibExeObjStep { } fn computeOutFileNames(self: *LibExeObjStep) void { - self.target_info = NativeTargetInfo.detect(self.target) catch - unreachable; - const target = self.target_info.target; self.out_filename = std.zig.binNameAlloc(self.builder.allocator, .{ @@ -1946,12 +1943,15 @@ test "addPackage" { var arena = std.heap.ArenaAllocator.init(std.testing.allocator); defer arena.deinit(); + const host = try NativeTargetInfo.detect(.{}); + var builder = try std.Build.create( arena.allocator(), "test", "test", "test", "test", + host, ); defer builder.destroy(); diff --git a/lib/std/Build/OptionsStep.zig b/lib/std/Build/OptionsStep.zig index 3d26807411..8e1a7ef2fc 100644 --- a/lib/std/Build/OptionsStep.zig +++ b/lib/std/Build/OptionsStep.zig @@ -279,12 +279,16 @@ test "OptionsStep" { var arena = std.heap.ArenaAllocator.init(std.testing.allocator); defer arena.deinit(); + + const host = try std.zig.system.NativeTargetInfo.detect(.{}); + var builder = try std.Build.create( arena.allocator(), "test", "test", "test", "test", + host, ); defer builder.destroy(); From 9a29f4e0387f0480273ca4347ee43e4917cad8e2 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 31 Jan 2023 12:48:46 -0700 Subject: [PATCH 50/84] langref updates for new std.Build API --- doc/langref.html.in | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/doc/langref.html.in b/doc/langref.html.in index 1163ad0200..00a263bae2 100644 --- a/doc/langref.html.in +++ b/doc/langref.html.in @@ -10560,8 +10560,9 @@ pub fn build(b: *std.Build) void { // for restricting supported target set are available. const target = b.standardTargetOptions(.{}); - // Standard release options allow the person running `zig build` to select - // between Debug, ReleaseSafe, ReleaseFast, and ReleaseSmall. + // Standard optimization options allow the person running `zig build` to select + // between Debug, ReleaseSafe, ReleaseFast, and ReleaseSmall. Here we do not + // set a preferred release mode, allowing the user to decide how to optimize. const optimize = b.standardOptimizeOption(.{}); const exe = b.addExecutable(.{ @@ -10964,8 +10965,11 @@ int main(int argc, char **argv) { const std = @import("std"); pub fn build(b: *std.Build) void { - const lib = b.addSharedLibrary("mathtest", "mathtest.zig", b.version(1, 0, 0)); - + const lib = b.addSharedLibrary(.{ + .name = "mathtest", + .root_source_file = .{ .path = "mathtest.zig" }, + .version = .{ .major = 1, .minor = 0, .patch = 0 }, + }); const exe = b.addExecutable(.{ .name = "test", }); @@ -11028,7 +11032,10 @@ int main(int argc, char **argv) { const std = @import("std"); pub fn build(b: *std.Build) void { - const obj = b.addObject("base64", "base64.zig"); + const obj = b.addObject(.{ + .name = "base64", + .root_source_file = .{ .path = "base64.zig" }, + }); const exe = b.addExecutable(.{ .name = "test", From 34b314509919d85a6b6ff9de3bbdad2fec6b2b78 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 31 Jan 2023 13:05:00 -0700 Subject: [PATCH 51/84] update test case for new std.builtin.OptimizeMode API --- test/cases/compile_errors/invalid_member_of_builtin_enum.zig | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/test/cases/compile_errors/invalid_member_of_builtin_enum.zig b/test/cases/compile_errors/invalid_member_of_builtin_enum.zig index 3edb17ffbf..b0a176d792 100644 --- a/test/cases/compile_errors/invalid_member_of_builtin_enum.zig +++ b/test/cases/compile_errors/invalid_member_of_builtin_enum.zig @@ -1,6 +1,6 @@ const builtin = @import("std").builtin; export fn entry() void { - const foo = builtin.Mode.x86; + const foo = builtin.OptimizeMode.x86; _ = foo; } @@ -8,5 +8,5 @@ export fn entry() void { // backend=stage2 // target=native // -// :3:30: error: enum 'builtin.Mode' has no member named 'x86' +// :3:38: error: enum 'builtin.OptimizeMode' has no member named 'x86' // :?:18: note: enum declared here From 77544683ddd5f4d577ecc9c92a2b52a276aed2a6 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 31 Jan 2023 13:38:03 -0700 Subject: [PATCH 52/84] fix init-exe, init-lib templates --- lib/init-exe/build.zig | 2 +- lib/init-lib/build.zig | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/lib/init-exe/build.zig b/lib/init-exe/build.zig index b88515b403..2ef5b21fe9 100644 --- a/lib/init-exe/build.zig +++ b/lib/init-exe/build.zig @@ -13,7 +13,7 @@ pub fn build(b: *std.Build) void { // Standard optimization options allow the person running `zig build` to select // between Debug, ReleaseSafe, ReleaseFast, and ReleaseSmall. Here we do not // set a preferred release mode, allowing the user to decide how to optimize. - const optimize = b.standardOptimizeOption(); + const optimize = b.standardOptimizeOption(.{}); const exe = b.addExecutable(.{ .name = "$", diff --git a/lib/init-lib/build.zig b/lib/init-lib/build.zig index 5ebb55373f..2887c170e6 100644 --- a/lib/init-lib/build.zig +++ b/lib/init-lib/build.zig @@ -13,7 +13,7 @@ pub fn build(b: *std.Build) void { // Standard optimization options allow the person running `zig build` to select // between Debug, ReleaseSafe, ReleaseFast, and ReleaseSmall. Here we do not // set a preferred release mode, allowing the user to decide how to optimize. - const optimize = b.standardOptimizeOption(); + const optimize = b.standardOptimizeOption(.{}); const lib = b.addStaticLibrary(.{ .name = "$", From 16cdd1297ebfac534615eaeb8439a4e1de71837c Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 31 Jan 2023 13:44:06 -0700 Subject: [PATCH 53/84] rename std.Build.LibExeObjStep to std.Build.CompileStep This matches the nomenclature internally: a Compilation is the main type that represents a single invokation of the compiler. --- build.zig | 12 +- lib/std/Build.zig | 49 +++--- lib/std/Build/CheckObjectStep.zig | 2 +- .../{LibExeObjStep.zig => CompileStep.zig} | 154 +++++++++--------- lib/std/Build/EmulatableRunStep.zig | 6 +- lib/std/Build/InstallArtifactStep.zig | 8 +- lib/std/Build/InstallRawStep.zig | 6 +- lib/std/Build/OptionsStep.zig | 6 +- lib/std/Build/RunStep.zig | 10 +- lib/std/Build/Step.zig | 4 +- lib/std/Build/TranslateCStep.zig | 6 +- lib/std/std.zig | 2 + test/link/macho/bugs/13457/build.zig | 1 - test/link/macho/dead_strip/build.zig | 7 +- test/link/macho/dead_strip_dylibs/build.zig | 3 +- test/link/macho/headerpad/build.zig | 3 +- test/link/macho/needed_framework/build.zig | 1 - test/link/macho/needed_library/build.zig | 1 - test/link/macho/search_strategy/build.zig | 7 +- test/link/macho/strict_validation/build.zig | 1 - test/link/macho/unwind_info/build.zig | 7 +- test/link/macho/uuid/build.zig | 7 +- test/link/macho/weak_framework/build.zig | 1 - test/link/macho/weak_library/build.zig | 1 - test/tests.zig | 10 +- 25 files changed, 162 insertions(+), 153 deletions(-) rename lib/std/Build/{LibExeObjStep.zig => CompileStep.zig} (93%) diff --git a/build.zig b/build.zig index 713eac6517..ecf51fe316 100644 --- a/build.zig +++ b/build.zig @@ -516,7 +516,7 @@ fn addCompilerStep( b: *std.Build, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget, -) *std.Build.LibExeObjStep { +) *std.Build.CompileStep { const exe = b.addExecutable(.{ .name = "zig", .root_source_file = .{ .path = "src/main.zig" }, @@ -544,7 +544,7 @@ const exe_cflags = [_][]const u8{ fn addCmakeCfgOptionsToExe( b: *std.Build, cfg: CMakeConfig, - exe: *std.Build.LibExeObjStep, + exe: *std.Build.CompileStep, use_zig_libcxx: bool, ) !void { if (exe.target.isDarwin()) { @@ -623,7 +623,7 @@ fn addCmakeCfgOptionsToExe( } } -fn addStaticLlvmOptionsToExe(exe: *std.Build.LibExeObjStep) !void { +fn addStaticLlvmOptionsToExe(exe: *std.Build.CompileStep) !void { // Adds the Zig C++ sources which both stage1 and stage2 need. // // We need this because otherwise zig_clang_cc1_main.cpp ends up pulling @@ -662,7 +662,7 @@ fn addStaticLlvmOptionsToExe(exe: *std.Build.LibExeObjStep) !void { fn addCxxKnownPath( b: *std.Build, ctx: CMakeConfig, - exe: *std.Build.LibExeObjStep, + exe: *std.Build.CompileStep, objname: []const u8, errtxt: ?[]const u8, need_cpp_includes: bool, @@ -695,7 +695,7 @@ fn addCxxKnownPath( } } -fn addCMakeLibraryList(exe: *std.Build.LibExeObjStep, list: []const u8) void { +fn addCMakeLibraryList(exe: *std.Build.CompileStep, list: []const u8) void { var it = mem.tokenize(u8, list, ";"); while (it.next()) |lib| { if (mem.startsWith(u8, lib, "-l")) { @@ -709,7 +709,7 @@ fn addCMakeLibraryList(exe: *std.Build.LibExeObjStep, list: []const u8) void { } const CMakeConfig = struct { - llvm_linkage: std.Build.LibExeObjStep.Linkage, + llvm_linkage: std.Build.CompileStep.Linkage, cmake_binary_dir: []const u8, cmake_prefix_path: []const u8, cmake_static_library_prefix: []const u8, diff --git a/lib/std/Build.zig b/lib/std/Build.zig index c0152ef6f1..4647baa398 100644 --- a/lib/std/Build.zig +++ b/lib/std/Build.zig @@ -19,6 +19,9 @@ const NativeTargetInfo = std.zig.system.NativeTargetInfo; const Sha256 = std.crypto.hash.sha2.Sha256; const Build = @This(); +///// deprecated: use `CompileStep` instead. +//pub const LibExeObjStep = CompileStep; + pub const Step = @import("Build/Step.zig"); pub const CheckFileStep = @import("Build/CheckFileStep.zig"); pub const CheckObjectStep = @import("Build/CheckObjectStep.zig"); @@ -29,7 +32,7 @@ pub const InstallArtifactStep = @import("Build/InstallArtifactStep.zig"); pub const InstallDirStep = @import("Build/InstallDirStep.zig"); pub const InstallFileStep = @import("Build/InstallFileStep.zig"); pub const InstallRawStep = @import("Build/InstallRawStep.zig"); -pub const LibExeObjStep = @import("Build/LibExeObjStep.zig"); +pub const CompileStep = @import("Build/CompileStep.zig"); pub const LogStep = @import("Build/LogStep.zig"); pub const OptionsStep = @import("Build/OptionsStep.zig"); pub const RemoveDirStep = @import("Build/RemoveDirStep.zig"); @@ -423,11 +426,11 @@ pub const ExecutableOptions = struct { version: ?std.builtin.Version = null, target: CrossTarget = .{}, optimize: std.builtin.Mode = .Debug, - linkage: ?LibExeObjStep.Linkage = null, + linkage: ?CompileStep.Linkage = null, }; -pub fn addExecutable(b: *Build, options: ExecutableOptions) *LibExeObjStep { - return LibExeObjStep.create(b, .{ +pub fn addExecutable(b: *Build, options: ExecutableOptions) *CompileStep { + return CompileStep.create(b, .{ .name = options.name, .root_source_file = options.root_source_file, .version = options.version, @@ -445,8 +448,8 @@ pub const ObjectOptions = struct { optimize: std.builtin.Mode, }; -pub fn addObject(b: *Build, options: ObjectOptions) *LibExeObjStep { - return LibExeObjStep.create(b, .{ +pub fn addObject(b: *Build, options: ObjectOptions) *CompileStep { + return CompileStep.create(b, .{ .name = options.name, .root_source_file = options.root_source_file, .target = options.target, @@ -463,8 +466,8 @@ pub const SharedLibraryOptions = struct { optimize: std.builtin.Mode, }; -pub fn addSharedLibrary(b: *Build, options: SharedLibraryOptions) *LibExeObjStep { - return LibExeObjStep.create(b, .{ +pub fn addSharedLibrary(b: *Build, options: SharedLibraryOptions) *CompileStep { + return CompileStep.create(b, .{ .name = options.name, .root_source_file = options.root_source_file, .kind = .lib, @@ -483,8 +486,8 @@ pub const StaticLibraryOptions = struct { version: ?std.builtin.Version = null, }; -pub fn addStaticLibrary(b: *Build, options: StaticLibraryOptions) *LibExeObjStep { - return LibExeObjStep.create(b, .{ +pub fn addStaticLibrary(b: *Build, options: StaticLibraryOptions) *CompileStep { + return CompileStep.create(b, .{ .name = options.name, .root_source_file = options.root_source_file, .kind = .lib, @@ -497,15 +500,15 @@ pub fn addStaticLibrary(b: *Build, options: StaticLibraryOptions) *LibExeObjStep pub const TestOptions = struct { name: []const u8 = "test", - kind: LibExeObjStep.Kind = .@"test", + kind: CompileStep.Kind = .@"test", root_source_file: FileSource, target: CrossTarget = .{}, optimize: std.builtin.Mode = .Debug, version: ?std.builtin.Version = null, }; -pub fn addTest(b: *Build, options: TestOptions) *LibExeObjStep { - return LibExeObjStep.create(b, .{ +pub fn addTest(b: *Build, options: TestOptions) *CompileStep { + return CompileStep.create(b, .{ .name = options.name, .kind = options.kind, .root_source_file = options.root_source_file, @@ -521,8 +524,8 @@ pub const AssemblyOptions = struct { optimize: std.builtin.Mode, }; -pub fn addAssembly(b: *Build, options: AssemblyOptions) *LibExeObjStep { - const obj_step = LibExeObjStep.create(b, .{ +pub fn addAssembly(b: *Build, options: AssemblyOptions) *CompileStep { + const obj_step = CompileStep.create(b, .{ .name = options.name, .root_source_file = null, .target = options.target, @@ -536,7 +539,7 @@ pub fn addAssembly(b: *Build, options: AssemblyOptions) *LibExeObjStep { /// executable. More command line arguments can be added with `addArg`, /// `addArgs`, and `addArtifactArg`. /// Be careful using this function, as it introduces a system dependency. -/// To run an executable built with zig build, see `LibExeObjStep.run`. +/// To run an executable built with zig build, see `CompileStep.run`. pub fn addSystemCommand(self: *Build, argv: []const []const u8) *RunStep { assert(argv.len >= 1); const run_step = RunStep.create(self, self.fmt("run {s}", .{argv[0]})); @@ -1167,11 +1170,11 @@ pub fn makePath(self: *Build, path: []const u8) !void { }; } -pub fn installArtifact(self: *Build, artifact: *LibExeObjStep) void { +pub fn installArtifact(self: *Build, artifact: *CompileStep) void { self.getInstallStep().dependOn(&self.addInstallArtifact(artifact).step); } -pub fn addInstallArtifact(self: *Build, artifact: *LibExeObjStep) *InstallArtifactStep { +pub fn addInstallArtifact(self: *Build, artifact: *CompileStep) *InstallArtifactStep { return InstallArtifactStep.create(self, artifact); } @@ -1195,7 +1198,7 @@ pub fn installLibFile(self: *Build, src_path: []const u8, dest_rel_path: []const } /// Output format (BIN vs Intel HEX) determined by filename -pub fn installRaw(self: *Build, artifact: *LibExeObjStep, dest_filename: []const u8, options: InstallRawStep.CreateOptions) *InstallRawStep { +pub fn installRaw(self: *Build, artifact: *CompileStep, dest_filename: []const u8, options: InstallRawStep.CreateOptions) *InstallRawStep { const raw = self.addInstallRaw(artifact, dest_filename, options); self.getInstallStep().dependOn(&raw.step); return raw; @@ -1220,7 +1223,7 @@ pub fn addInstallHeaderFile(b: *Build, src_path: []const u8, dest_rel_path: []co return b.addInstallFileWithDir(.{ .path = src_path }, .header, dest_rel_path); } -pub fn addInstallRaw(self: *Build, artifact: *LibExeObjStep, dest_filename: []const u8, options: InstallRawStep.CreateOptions) *InstallRawStep { +pub fn addInstallRaw(self: *Build, artifact: *CompileStep, dest_filename: []const u8, options: InstallRawStep.CreateOptions) *InstallRawStep { return InstallRawStep.create(self, artifact, dest_filename, options); } @@ -1456,8 +1459,8 @@ pub fn getInstallPath(self: *Build, dir: InstallDir, dest_rel_path: []const u8) pub const Dependency = struct { builder: *Build, - pub fn artifact(d: *Dependency, name: []const u8) *LibExeObjStep { - var found: ?*LibExeObjStep = null; + pub fn artifact(d: *Dependency, name: []const u8) *CompileStep { + var found: ?*CompileStep = null; for (d.builder.install_tls.step.dependencies.items) |dep_step| { const inst = dep_step.cast(InstallArtifactStep) orelse continue; if (mem.eql(u8, inst.artifact.name, name)) { @@ -1767,7 +1770,7 @@ test { _ = InstallDirStep; _ = InstallFileStep; _ = InstallRawStep; - _ = LibExeObjStep; + _ = CompileStep; _ = LogStep; _ = OptionsStep; _ = RemoveDirStep; diff --git a/lib/std/Build/CheckObjectStep.zig b/lib/std/Build/CheckObjectStep.zig index 7907be1787..bfa5338927 100644 --- a/lib/std/Build/CheckObjectStep.zig +++ b/lib/std/Build/CheckObjectStep.zig @@ -42,7 +42,7 @@ pub fn runAndCompare(self: *CheckObjectStep) *EmulatableRunStep { const dependencies_len = self.step.dependencies.items.len; assert(dependencies_len > 0); const exe_step = self.step.dependencies.items[dependencies_len - 1]; - const exe = exe_step.cast(std.Build.LibExeObjStep).?; + const exe = exe_step.cast(std.Build.CompileStep).?; const emulatable_step = EmulatableRunStep.create(self.builder, "EmulatableRun", exe); emulatable_step.step.dependOn(&self.step); return emulatable_step; diff --git a/lib/std/Build/LibExeObjStep.zig b/lib/std/Build/CompileStep.zig similarity index 93% rename from lib/std/Build/LibExeObjStep.zig rename to lib/std/Build/CompileStep.zig index 67f42c1783..5257c85a5c 100644 --- a/lib/std/Build/LibExeObjStep.zig +++ b/lib/std/Build/CompileStep.zig @@ -27,9 +27,9 @@ const CheckObjectStep = std.Build.CheckObjectStep; const RunStep = std.Build.RunStep; const OptionsStep = std.Build.OptionsStep; const ConfigHeaderStep = std.Build.ConfigHeaderStep; -const LibExeObjStep = @This(); +const CompileStep = @This(); -pub const base_id = .lib_exe_obj; +pub const base_id: Step.Id = .compile; step: Step, builder: *std.Build, @@ -234,7 +234,7 @@ pub const CSourceFile = struct { pub const LinkObject = union(enum) { static_path: FileSource, - other_step: *LibExeObjStep, + other_step: *CompileStep, system_lib: SystemLib, assembly_file: FileSource, c_source_file: *CSourceFile, @@ -265,7 +265,7 @@ const FrameworkLinkInfo = struct { pub const IncludeDir = union(enum) { raw_path: []const u8, raw_path_system: []const u8, - other_step: *LibExeObjStep, + other_step: *CompileStep, config_header_step: *ConfigHeaderStep, }; @@ -305,15 +305,15 @@ pub const EmitOption = union(enum) { } }; -pub fn create(builder: *std.Build, options: Options) *LibExeObjStep { +pub fn create(builder: *std.Build, options: Options) *CompileStep { const name = builder.dupe(options.name); const root_src: ?FileSource = if (options.root_source_file) |rsrc| rsrc.dupe(builder) else null; if (mem.indexOf(u8, name, "/") != null or mem.indexOf(u8, name, "\\") != null) { panic("invalid name: '{s}'. It looks like a file path, but it is supposed to be the library or application name.", .{name}); } - const self = builder.allocator.create(LibExeObjStep) catch unreachable; - self.* = LibExeObjStep{ + const self = builder.allocator.create(CompileStep) catch unreachable; + self.* = CompileStep{ .strip = null, .unwind_tables = null, .builder = builder, @@ -371,7 +371,7 @@ pub fn create(builder: *std.Build, options: Options) *LibExeObjStep { return self; } -fn computeOutFileNames(self: *LibExeObjStep) void { +fn computeOutFileNames(self: *CompileStep) void { const target = self.target_info.target; self.out_filename = std.zig.binNameAlloc(self.builder.allocator, .{ @@ -424,26 +424,26 @@ fn computeOutFileNames(self: *LibExeObjStep) void { } } -pub fn setOutputDir(self: *LibExeObjStep, dir: []const u8) void { +pub fn setOutputDir(self: *CompileStep, dir: []const u8) void { self.output_dir = self.builder.dupePath(dir); } -pub fn install(self: *LibExeObjStep) void { +pub fn install(self: *CompileStep) void { self.builder.installArtifact(self); } -pub fn installRaw(self: *LibExeObjStep, dest_filename: []const u8, options: InstallRawStep.CreateOptions) *InstallRawStep { +pub fn installRaw(self: *CompileStep, dest_filename: []const u8, options: InstallRawStep.CreateOptions) *InstallRawStep { return self.builder.installRaw(self, dest_filename, options); } -pub fn installHeader(a: *LibExeObjStep, src_path: []const u8, dest_rel_path: []const u8) void { +pub fn installHeader(a: *CompileStep, src_path: []const u8, dest_rel_path: []const u8) void { const install_file = a.builder.addInstallHeaderFile(src_path, dest_rel_path); a.builder.getInstallStep().dependOn(&install_file.step); a.installed_headers.append(&install_file.step) catch unreachable; } pub fn installHeadersDirectory( - a: *LibExeObjStep, + a: *CompileStep, src_dir_path: []const u8, dest_rel_path: []const u8, ) void { @@ -455,7 +455,7 @@ pub fn installHeadersDirectory( } pub fn installHeadersDirectoryOptions( - a: *LibExeObjStep, + a: *CompileStep, options: std.Build.InstallDirStep.Options, ) void { const install_dir = a.builder.addInstallDirectory(options); @@ -463,7 +463,7 @@ pub fn installHeadersDirectoryOptions( a.installed_headers.append(&install_dir.step) catch unreachable; } -pub fn installLibraryHeaders(a: *LibExeObjStep, l: *LibExeObjStep) void { +pub fn installLibraryHeaders(a: *CompileStep, l: *CompileStep) void { assert(l.kind == .lib); const install_step = a.builder.getInstallStep(); // Copy each element from installed_headers, modifying the builder @@ -488,7 +488,7 @@ pub fn installLibraryHeaders(a: *LibExeObjStep, l: *LibExeObjStep) void { /// Creates a `RunStep` with an executable built with `addExecutable`. /// Add command line arguments with `addArg`. -pub fn run(exe: *LibExeObjStep) *RunStep { +pub fn run(exe: *CompileStep) *RunStep { assert(exe.kind == .exe or exe.kind == .test_exe); // It doesn't have to be native. We catch that if you actually try to run it. @@ -512,7 +512,7 @@ pub fn run(exe: *LibExeObjStep) *RunStep { /// Allows running foreign binaries through emulation platforms such as Qemu or Rosetta. /// When a binary cannot be ran through emulation or the option is disabled, a warning /// will be printed and the binary will *NOT* be ran. -pub fn runEmulatable(exe: *LibExeObjStep) *EmulatableRunStep { +pub fn runEmulatable(exe: *CompileStep) *EmulatableRunStep { assert(exe.kind == .exe or exe.kind == .test_exe); const run_step = EmulatableRunStep.create(exe.builder, exe.builder.fmt("run {s}", .{exe.step.name}), exe); @@ -522,33 +522,33 @@ pub fn runEmulatable(exe: *LibExeObjStep) *EmulatableRunStep { return run_step; } -pub fn checkObject(self: *LibExeObjStep, obj_format: std.Target.ObjectFormat) *CheckObjectStep { +pub fn checkObject(self: *CompileStep, obj_format: std.Target.ObjectFormat) *CheckObjectStep { return CheckObjectStep.create(self.builder, self.getOutputSource(), obj_format); } -pub fn setLinkerScriptPath(self: *LibExeObjStep, source: FileSource) void { +pub fn setLinkerScriptPath(self: *CompileStep, source: FileSource) void { self.linker_script = source.dupe(self.builder); source.addStepDependencies(&self.step); } -pub fn linkFramework(self: *LibExeObjStep, framework_name: []const u8) void { +pub fn linkFramework(self: *CompileStep, framework_name: []const u8) void { self.frameworks.put(self.builder.dupe(framework_name), .{}) catch unreachable; } -pub fn linkFrameworkNeeded(self: *LibExeObjStep, framework_name: []const u8) void { +pub fn linkFrameworkNeeded(self: *CompileStep, framework_name: []const u8) void { self.frameworks.put(self.builder.dupe(framework_name), .{ .needed = true, }) catch unreachable; } -pub fn linkFrameworkWeak(self: *LibExeObjStep, framework_name: []const u8) void { +pub fn linkFrameworkWeak(self: *CompileStep, framework_name: []const u8) void { self.frameworks.put(self.builder.dupe(framework_name), .{ .weak = true, }) catch unreachable; } /// Returns whether the library, executable, or object depends on a particular system library. -pub fn dependsOnSystemLibrary(self: LibExeObjStep, name: []const u8) bool { +pub fn dependsOnSystemLibrary(self: CompileStep, name: []const u8) bool { if (isLibCLibrary(name)) { return self.is_linking_libc; } @@ -564,49 +564,49 @@ pub fn dependsOnSystemLibrary(self: LibExeObjStep, name: []const u8) bool { return false; } -pub fn linkLibrary(self: *LibExeObjStep, lib: *LibExeObjStep) void { +pub fn linkLibrary(self: *CompileStep, lib: *CompileStep) void { assert(lib.kind == .lib); self.linkLibraryOrObject(lib); } -pub fn isDynamicLibrary(self: *LibExeObjStep) bool { +pub fn isDynamicLibrary(self: *CompileStep) bool { return self.kind == .lib and self.linkage == Linkage.dynamic; } -pub fn isStaticLibrary(self: *LibExeObjStep) bool { +pub fn isStaticLibrary(self: *CompileStep) bool { return self.kind == .lib and self.linkage != Linkage.dynamic; } -pub fn producesPdbFile(self: *LibExeObjStep) bool { +pub fn producesPdbFile(self: *CompileStep) bool { if (!self.target.isWindows() and !self.target.isUefi()) return false; if (self.target.getObjectFormat() == .c) return false; if (self.strip == true) return false; return self.isDynamicLibrary() or self.kind == .exe or self.kind == .test_exe; } -pub fn linkLibC(self: *LibExeObjStep) void { +pub fn linkLibC(self: *CompileStep) void { self.is_linking_libc = true; } -pub fn linkLibCpp(self: *LibExeObjStep) void { +pub fn linkLibCpp(self: *CompileStep) void { self.is_linking_libcpp = true; } /// If the value is omitted, it is set to 1. /// `name` and `value` need not live longer than the function call. -pub fn defineCMacro(self: *LibExeObjStep, name: []const u8, value: ?[]const u8) void { +pub fn defineCMacro(self: *CompileStep, name: []const u8, value: ?[]const u8) void { const macro = std.Build.constructCMacro(self.builder.allocator, name, value); self.c_macros.append(macro) catch unreachable; } /// name_and_value looks like [name]=[value]. If the value is omitted, it is set to 1. -pub fn defineCMacroRaw(self: *LibExeObjStep, name_and_value: []const u8) void { +pub fn defineCMacroRaw(self: *CompileStep, name_and_value: []const u8) void { self.c_macros.append(self.builder.dupe(name_and_value)) catch unreachable; } /// This one has no integration with anything, it just puts -lname on the command line. /// Prefer to use `linkSystemLibrary` instead. -pub fn linkSystemLibraryName(self: *LibExeObjStep, name: []const u8) void { +pub fn linkSystemLibraryName(self: *CompileStep, name: []const u8) void { self.link_objects.append(.{ .system_lib = .{ .name = self.builder.dupe(name), @@ -619,7 +619,7 @@ pub fn linkSystemLibraryName(self: *LibExeObjStep, name: []const u8) void { /// This one has no integration with anything, it just puts -needed-lname on the command line. /// Prefer to use `linkSystemLibraryNeeded` instead. -pub fn linkSystemLibraryNeededName(self: *LibExeObjStep, name: []const u8) void { +pub fn linkSystemLibraryNeededName(self: *CompileStep, name: []const u8) void { self.link_objects.append(.{ .system_lib = .{ .name = self.builder.dupe(name), @@ -632,7 +632,7 @@ pub fn linkSystemLibraryNeededName(self: *LibExeObjStep, name: []const u8) void /// Darwin-only. This one has no integration with anything, it just puts -weak-lname on the /// command line. Prefer to use `linkSystemLibraryWeak` instead. -pub fn linkSystemLibraryWeakName(self: *LibExeObjStep, name: []const u8) void { +pub fn linkSystemLibraryWeakName(self: *CompileStep, name: []const u8) void { self.link_objects.append(.{ .system_lib = .{ .name = self.builder.dupe(name), @@ -645,7 +645,7 @@ pub fn linkSystemLibraryWeakName(self: *LibExeObjStep, name: []const u8) void { /// This links against a system library, exclusively using pkg-config to find the library. /// Prefer to use `linkSystemLibrary` instead. -pub fn linkSystemLibraryPkgConfigOnly(self: *LibExeObjStep, lib_name: []const u8) void { +pub fn linkSystemLibraryPkgConfigOnly(self: *CompileStep, lib_name: []const u8) void { self.link_objects.append(.{ .system_lib = .{ .name = self.builder.dupe(lib_name), @@ -658,7 +658,7 @@ pub fn linkSystemLibraryPkgConfigOnly(self: *LibExeObjStep, lib_name: []const u8 /// This links against a system library, exclusively using pkg-config to find the library. /// Prefer to use `linkSystemLibraryNeeded` instead. -pub fn linkSystemLibraryNeededPkgConfigOnly(self: *LibExeObjStep, lib_name: []const u8) void { +pub fn linkSystemLibraryNeededPkgConfigOnly(self: *CompileStep, lib_name: []const u8) void { self.link_objects.append(.{ .system_lib = .{ .name = self.builder.dupe(lib_name), @@ -671,7 +671,7 @@ pub fn linkSystemLibraryNeededPkgConfigOnly(self: *LibExeObjStep, lib_name: []co /// Run pkg-config for the given library name and parse the output, returning the arguments /// that should be passed to zig to link the given library. -pub fn runPkgConfig(self: *LibExeObjStep, lib_name: []const u8) ![]const []const u8 { +pub fn runPkgConfig(self: *CompileStep, lib_name: []const u8) ![]const []const u8 { const pkg_name = match: { // First we have to map the library name to pkg config name. Unfortunately, // there are several examples where this is not straightforward: @@ -765,19 +765,19 @@ pub fn runPkgConfig(self: *LibExeObjStep, lib_name: []const u8) ![]const []const return zig_args.toOwnedSlice(); } -pub fn linkSystemLibrary(self: *LibExeObjStep, name: []const u8) void { +pub fn linkSystemLibrary(self: *CompileStep, name: []const u8) void { self.linkSystemLibraryInner(name, .{}); } -pub fn linkSystemLibraryNeeded(self: *LibExeObjStep, name: []const u8) void { +pub fn linkSystemLibraryNeeded(self: *CompileStep, name: []const u8) void { self.linkSystemLibraryInner(name, .{ .needed = true }); } -pub fn linkSystemLibraryWeak(self: *LibExeObjStep, name: []const u8) void { +pub fn linkSystemLibraryWeak(self: *CompileStep, name: []const u8) void { self.linkSystemLibraryInner(name, .{ .weak = true }); } -fn linkSystemLibraryInner(self: *LibExeObjStep, name: []const u8, opts: struct { +fn linkSystemLibraryInner(self: *CompileStep, name: []const u8, opts: struct { needed: bool = false, weak: bool = false, }) void { @@ -800,23 +800,23 @@ fn linkSystemLibraryInner(self: *LibExeObjStep, name: []const u8, opts: struct { }) catch unreachable; } -pub fn setNamePrefix(self: *LibExeObjStep, text: []const u8) void { +pub fn setNamePrefix(self: *CompileStep, text: []const u8) void { assert(self.kind == .@"test" or self.kind == .test_exe); self.name_prefix = self.builder.dupe(text); } -pub fn setFilter(self: *LibExeObjStep, text: ?[]const u8) void { +pub fn setFilter(self: *CompileStep, text: ?[]const u8) void { assert(self.kind == .@"test" or self.kind == .test_exe); self.filter = if (text) |t| self.builder.dupe(t) else null; } -pub fn setTestRunner(self: *LibExeObjStep, path: ?[]const u8) void { +pub fn setTestRunner(self: *CompileStep, path: ?[]const u8) void { assert(self.kind == .@"test" or self.kind == .test_exe); self.test_runner = if (path) |p| self.builder.dupePath(p) else null; } /// Handy when you have many C/C++ source files and want them all to have the same flags. -pub fn addCSourceFiles(self: *LibExeObjStep, files: []const []const u8, flags: []const []const u8) void { +pub fn addCSourceFiles(self: *CompileStep, files: []const []const u8, flags: []const []const u8) void { const c_source_files = self.builder.allocator.create(CSourceFiles) catch unreachable; const files_copy = self.builder.dupeStrings(files); @@ -829,89 +829,89 @@ pub fn addCSourceFiles(self: *LibExeObjStep, files: []const []const u8, flags: [ self.link_objects.append(.{ .c_source_files = c_source_files }) catch unreachable; } -pub fn addCSourceFile(self: *LibExeObjStep, file: []const u8, flags: []const []const u8) void { +pub fn addCSourceFile(self: *CompileStep, file: []const u8, flags: []const []const u8) void { self.addCSourceFileSource(.{ .args = flags, .source = .{ .path = file }, }); } -pub fn addCSourceFileSource(self: *LibExeObjStep, source: CSourceFile) void { +pub fn addCSourceFileSource(self: *CompileStep, source: CSourceFile) void { const c_source_file = self.builder.allocator.create(CSourceFile) catch unreachable; c_source_file.* = source.dupe(self.builder); self.link_objects.append(.{ .c_source_file = c_source_file }) catch unreachable; source.source.addStepDependencies(&self.step); } -pub fn setVerboseLink(self: *LibExeObjStep, value: bool) void { +pub fn setVerboseLink(self: *CompileStep, value: bool) void { self.verbose_link = value; } -pub fn setVerboseCC(self: *LibExeObjStep, value: bool) void { +pub fn setVerboseCC(self: *CompileStep, value: bool) void { self.verbose_cc = value; } -pub fn overrideZigLibDir(self: *LibExeObjStep, dir_path: []const u8) void { +pub fn overrideZigLibDir(self: *CompileStep, dir_path: []const u8) void { self.override_lib_dir = self.builder.dupePath(dir_path); } -pub fn setMainPkgPath(self: *LibExeObjStep, dir_path: []const u8) void { +pub fn setMainPkgPath(self: *CompileStep, dir_path: []const u8) void { self.main_pkg_path = self.builder.dupePath(dir_path); } -pub fn setLibCFile(self: *LibExeObjStep, libc_file: ?FileSource) void { +pub fn setLibCFile(self: *CompileStep, libc_file: ?FileSource) void { self.libc_file = if (libc_file) |f| f.dupe(self.builder) else null; } /// Returns the generated executable, library or object file. /// To run an executable built with zig build, use `run`, or create an install step and invoke it. -pub fn getOutputSource(self: *LibExeObjStep) FileSource { +pub fn getOutputSource(self: *CompileStep) FileSource { return FileSource{ .generated = &self.output_path_source }; } /// Returns the generated import library. This function can only be called for libraries. -pub fn getOutputLibSource(self: *LibExeObjStep) FileSource { +pub fn getOutputLibSource(self: *CompileStep) FileSource { assert(self.kind == .lib); return FileSource{ .generated = &self.output_lib_path_source }; } /// Returns the generated header file. /// This function can only be called for libraries or object files which have `emit_h` set. -pub fn getOutputHSource(self: *LibExeObjStep) FileSource { +pub fn getOutputHSource(self: *CompileStep) FileSource { assert(self.kind != .exe and self.kind != .test_exe and self.kind != .@"test"); assert(self.emit_h); return FileSource{ .generated = &self.output_h_path_source }; } /// Returns the generated PDB file. This function can only be called for Windows and UEFI. -pub fn getOutputPdbSource(self: *LibExeObjStep) FileSource { +pub fn getOutputPdbSource(self: *CompileStep) FileSource { // TODO: Is this right? Isn't PDB for *any* PE/COFF file? assert(self.target.isWindows() or self.target.isUefi()); return FileSource{ .generated = &self.output_pdb_path_source }; } -pub fn addAssemblyFile(self: *LibExeObjStep, path: []const u8) void { +pub fn addAssemblyFile(self: *CompileStep, path: []const u8) void { self.link_objects.append(.{ .assembly_file = .{ .path = self.builder.dupe(path) }, }) catch unreachable; } -pub fn addAssemblyFileSource(self: *LibExeObjStep, source: FileSource) void { +pub fn addAssemblyFileSource(self: *CompileStep, source: FileSource) void { const source_duped = source.dupe(self.builder); self.link_objects.append(.{ .assembly_file = source_duped }) catch unreachable; source_duped.addStepDependencies(&self.step); } -pub fn addObjectFile(self: *LibExeObjStep, source_file: []const u8) void { +pub fn addObjectFile(self: *CompileStep, source_file: []const u8) void { self.addObjectFileSource(.{ .path = source_file }); } -pub fn addObjectFileSource(self: *LibExeObjStep, source: FileSource) void { +pub fn addObjectFileSource(self: *CompileStep, source: FileSource) void { self.link_objects.append(.{ .static_path = source.dupe(self.builder) }) catch unreachable; source.addStepDependencies(&self.step); } -pub fn addObject(self: *LibExeObjStep, obj: *LibExeObjStep) void { +pub fn addObject(self: *CompileStep, obj: *CompileStep) void { assert(obj.kind == .obj); self.linkLibraryOrObject(obj); } @@ -921,41 +921,41 @@ pub const addIncludeDir = @compileError("deprecated; use addIncludePath"); pub const addLibPath = @compileError("deprecated, use addLibraryPath"); pub const addFrameworkDir = @compileError("deprecated, use addFrameworkPath"); -pub fn addSystemIncludePath(self: *LibExeObjStep, path: []const u8) void { +pub fn addSystemIncludePath(self: *CompileStep, path: []const u8) void { self.include_dirs.append(IncludeDir{ .raw_path_system = self.builder.dupe(path) }) catch unreachable; } -pub fn addIncludePath(self: *LibExeObjStep, path: []const u8) void { +pub fn addIncludePath(self: *CompileStep, path: []const u8) void { self.include_dirs.append(IncludeDir{ .raw_path = self.builder.dupe(path) }) catch unreachable; } -pub fn addConfigHeader(self: *LibExeObjStep, config_header: *ConfigHeaderStep) void { +pub fn addConfigHeader(self: *CompileStep, config_header: *ConfigHeaderStep) void { self.step.dependOn(&config_header.step); self.include_dirs.append(.{ .config_header_step = config_header }) catch @panic("OOM"); } -pub fn addLibraryPath(self: *LibExeObjStep, path: []const u8) void { +pub fn addLibraryPath(self: *CompileStep, path: []const u8) void { self.lib_paths.append(self.builder.dupe(path)) catch unreachable; } -pub fn addRPath(self: *LibExeObjStep, path: []const u8) void { +pub fn addRPath(self: *CompileStep, path: []const u8) void { self.rpaths.append(self.builder.dupe(path)) catch unreachable; } -pub fn addFrameworkPath(self: *LibExeObjStep, dir_path: []const u8) void { +pub fn addFrameworkPath(self: *CompileStep, dir_path: []const u8) void { self.framework_dirs.append(self.builder.dupe(dir_path)) catch unreachable; } -pub fn addPackage(self: *LibExeObjStep, package: Pkg) void { +pub fn addPackage(self: *CompileStep, package: Pkg) void { self.packages.append(self.builder.dupePkg(package)) catch unreachable; self.addRecursiveBuildDeps(package); } -pub fn addOptions(self: *LibExeObjStep, package_name: []const u8, options: *OptionsStep) void { +pub fn addOptions(self: *CompileStep, package_name: []const u8, options: *OptionsStep) void { self.addPackage(options.getPackage(package_name)); } -fn addRecursiveBuildDeps(self: *LibExeObjStep, package: Pkg) void { +fn addRecursiveBuildDeps(self: *CompileStep, package: Pkg) void { package.source.addStepDependencies(&self.step); if (package.dependencies) |deps| { for (deps) |dep| { @@ -964,7 +964,7 @@ fn addRecursiveBuildDeps(self: *LibExeObjStep, package: Pkg) void { } } -pub fn addPackagePath(self: *LibExeObjStep, name: []const u8, pkg_index_path: []const u8) void { +pub fn addPackagePath(self: *CompileStep, name: []const u8, pkg_index_path: []const u8) void { self.addPackage(Pkg{ .name = self.builder.dupe(name), .source = .{ .path = self.builder.dupe(pkg_index_path) }, @@ -973,7 +973,7 @@ pub fn addPackagePath(self: *LibExeObjStep, name: []const u8, pkg_index_path: [] /// If Vcpkg was found on the system, it will be added to include and lib /// paths for the specified target. -pub fn addVcpkgPaths(self: *LibExeObjStep, linkage: LibExeObjStep.Linkage) !void { +pub fn addVcpkgPaths(self: *CompileStep, linkage: CompileStep.Linkage) !void { // Ideally in the Unattempted case we would call the function recursively // after findVcpkgRoot and have only one switch statement, but the compiler // cannot resolve the error set. @@ -1008,7 +1008,7 @@ pub fn addVcpkgPaths(self: *LibExeObjStep, linkage: LibExeObjStep.Linkage) !void } } -pub fn setExecCmd(self: *LibExeObjStep, args: []const ?[]const u8) void { +pub fn setExecCmd(self: *CompileStep, args: []const ?[]const u8) void { assert(self.kind == .@"test"); const duped_args = self.builder.allocator.alloc(?[]u8, args.len) catch unreachable; for (args) |arg, i| { @@ -1017,13 +1017,13 @@ pub fn setExecCmd(self: *LibExeObjStep, args: []const ?[]const u8) void { self.exec_cmd_args = duped_args; } -fn linkLibraryOrObject(self: *LibExeObjStep, other: *LibExeObjStep) void { +fn linkLibraryOrObject(self: *CompileStep, other: *CompileStep) void { self.step.dependOn(&other.step); self.link_objects.append(.{ .other_step = other }) catch unreachable; self.include_dirs.append(.{ .other_step = other }) catch unreachable; } -fn makePackageCmd(self: *LibExeObjStep, pkg: Pkg, zig_args: *ArrayList([]const u8)) error{OutOfMemory}!void { +fn makePackageCmd(self: *CompileStep, pkg: Pkg, zig_args: *ArrayList([]const u8)) error{OutOfMemory}!void { const builder = self.builder; try zig_args.append("--pkg-begin"); @@ -1040,7 +1040,7 @@ fn makePackageCmd(self: *LibExeObjStep, pkg: Pkg, zig_args: *ArrayList([]const u } fn make(step: *Step) !void { - const self = @fieldParentPtr(LibExeObjStep, "step", step); + const self = @fieldParentPtr(CompileStep, "step", step); const builder = self.builder; if (self.root_src == null and self.link_objects.items.len == 0) { @@ -2004,7 +2004,7 @@ const TransitiveDeps = struct { } } - fn addInner(td: *TransitiveDeps, other: *LibExeObjStep, dyn: bool) !void { + fn addInner(td: *TransitiveDeps, other: *CompileStep, dyn: bool) !void { // Inherit dependency on libc and libc++ td.is_linking_libcpp = td.is_linking_libcpp or other.is_linking_libcpp; td.is_linking_libc = td.is_linking_libc or other.is_linking_libc; diff --git a/lib/std/Build/EmulatableRunStep.zig b/lib/std/Build/EmulatableRunStep.zig index b7b12d791f..26804b2fc8 100644 --- a/lib/std/Build/EmulatableRunStep.zig +++ b/lib/std/Build/EmulatableRunStep.zig @@ -6,7 +6,7 @@ const std = @import("../std.zig"); const Step = std.Build.Step; -const LibExeObjStep = std.Build.LibExeObjStep; +const CompileStep = std.Build.CompileStep; const RunStep = std.Build.RunStep; const fs = std.fs; @@ -23,7 +23,7 @@ step: Step, builder: *std.Build, /// The artifact (executable) to be run by this step -exe: *LibExeObjStep, +exe: *CompileStep, /// Set this to `null` to ignore the exit code for the purpose of determining a successful execution expected_exit_code: ?u8 = 0, @@ -45,7 +45,7 @@ hide_foreign_binaries_warning: bool, /// binary through emulation when any of the emulation options such as `enable_rosetta` are set to true. /// When set to false, and the binary is foreign, running the executable is skipped. /// Asserts given artifact is an executable. -pub fn create(builder: *std.Build, name: []const u8, artifact: *LibExeObjStep) *EmulatableRunStep { +pub fn create(builder: *std.Build, name: []const u8, artifact: *CompileStep) *EmulatableRunStep { std.debug.assert(artifact.kind == .exe or artifact.kind == .test_exe); const self = builder.allocator.create(EmulatableRunStep) catch unreachable; diff --git a/lib/std/Build/InstallArtifactStep.zig b/lib/std/Build/InstallArtifactStep.zig index 929b30e935..898b9e85e7 100644 --- a/lib/std/Build/InstallArtifactStep.zig +++ b/lib/std/Build/InstallArtifactStep.zig @@ -1,6 +1,6 @@ const std = @import("../std.zig"); const Step = std.Build.Step; -const LibExeObjStep = std.Build.LibExeObjStep; +const CompileStep = std.Build.CompileStep; const InstallDir = std.Build.InstallDir; const InstallArtifactStep = @This(); @@ -8,12 +8,12 @@ pub const base_id = .install_artifact; step: Step, builder: *std.Build, -artifact: *LibExeObjStep, +artifact: *CompileStep, dest_dir: InstallDir, pdb_dir: ?InstallDir, h_dir: ?InstallDir, -pub fn create(builder: *std.Build, artifact: *LibExeObjStep) *InstallArtifactStep { +pub fn create(builder: *std.Build, artifact: *CompileStep) *InstallArtifactStep { if (artifact.install_step) |s| return s; const self = builder.allocator.create(InstallArtifactStep) catch unreachable; @@ -67,7 +67,7 @@ fn make(step: *Step) !void { const full_dest_path = builder.getInstallPath(self.dest_dir, self.artifact.out_filename); try builder.updateFile(self.artifact.getOutputSource().getPath(builder), full_dest_path); if (self.artifact.isDynamicLibrary() and self.artifact.version != null and self.artifact.target.wantSharedLibSymLinks()) { - try LibExeObjStep.doAtomicSymLinks(builder.allocator, full_dest_path, self.artifact.major_only_filename.?, self.artifact.name_only_filename.?); + try CompileStep.doAtomicSymLinks(builder.allocator, full_dest_path, self.artifact.major_only_filename.?, self.artifact.name_only_filename.?); } if (self.artifact.isDynamicLibrary() and self.artifact.target.isWindows() and self.artifact.emit_implib != .no_emit) { const full_implib_path = builder.getInstallPath(self.dest_dir, self.artifact.out_lib_filename); diff --git a/lib/std/Build/InstallRawStep.zig b/lib/std/Build/InstallRawStep.zig index 08d646ff88..e7ffe78878 100644 --- a/lib/std/Build/InstallRawStep.zig +++ b/lib/std/Build/InstallRawStep.zig @@ -9,7 +9,7 @@ const ArenaAllocator = std.heap.ArenaAllocator; const ArrayListUnmanaged = std.ArrayListUnmanaged; const File = std.fs.File; const InstallDir = std.Build.InstallDir; -const LibExeObjStep = std.Build.LibExeObjStep; +const CompileStep = std.Build.CompileStep; const Step = std.Build.Step; const elf = std.elf; const fs = std.fs; @@ -25,7 +25,7 @@ pub const RawFormat = enum { step: Step, builder: *std.Build, -artifact: *LibExeObjStep, +artifact: *CompileStep, dest_dir: InstallDir, dest_filename: []const u8, options: CreateOptions, @@ -40,7 +40,7 @@ pub const CreateOptions = struct { pub fn create( builder: *std.Build, - artifact: *LibExeObjStep, + artifact: *CompileStep, dest_filename: []const u8, options: CreateOptions, ) *InstallRawStep { diff --git a/lib/std/Build/OptionsStep.zig b/lib/std/Build/OptionsStep.zig index 8e1a7ef2fc..94c41ce9e6 100644 --- a/lib/std/Build/OptionsStep.zig +++ b/lib/std/Build/OptionsStep.zig @@ -3,7 +3,7 @@ const builtin = @import("builtin"); const fs = std.fs; const Step = std.Build.Step; const GeneratedFile = std.Build.GeneratedFile; -const LibExeObjStep = std.Build.LibExeObjStep; +const CompileStep = std.Build.CompileStep; const FileSource = std.Build.FileSource; const OptionsStep = @This(); @@ -195,7 +195,7 @@ pub fn addOptionFileSource( /// The value is the path in the cache dir. /// Adds a dependency automatically. -pub fn addOptionArtifact(self: *OptionsStep, name: []const u8, artifact: *LibExeObjStep) void { +pub fn addOptionArtifact(self: *OptionsStep, name: []const u8, artifact: *CompileStep) void { self.artifact_args.append(.{ .name = self.builder.dupe(name), .artifact = artifact }) catch unreachable; self.step.dependOn(&artifact.step); } @@ -266,7 +266,7 @@ fn hashContentsToFileName(self: *OptionsStep) [64]u8 { const OptionArtifactArg = struct { name: []const u8, - artifact: *LibExeObjStep, + artifact: *CompileStep, }; const OptionFileSourceArg = struct { diff --git a/lib/std/Build/RunStep.zig b/lib/std/Build/RunStep.zig index 83e4f7f66c..9ab9ea6335 100644 --- a/lib/std/Build/RunStep.zig +++ b/lib/std/Build/RunStep.zig @@ -1,7 +1,7 @@ const std = @import("../std.zig"); const builtin = @import("builtin"); const Step = std.Build.Step; -const LibExeObjStep = std.Build.LibExeObjStep; +const CompileStep = std.Build.CompileStep; const WriteFileStep = std.Build.WriteFileStep; const fs = std.fs; const mem = std.mem; @@ -48,7 +48,7 @@ pub const StdIoAction = union(enum) { }; pub const Arg = union(enum) { - artifact: *LibExeObjStep, + artifact: *CompileStep, file_source: std.Build.FileSource, bytes: []u8, }; @@ -66,7 +66,7 @@ pub fn create(builder: *std.Build, name: []const u8) *RunStep { return self; } -pub fn addArtifactArg(self: *RunStep, artifact: *LibExeObjStep) void { +pub fn addArtifactArg(self: *RunStep, artifact: *CompileStep) void { self.argv.append(Arg{ .artifact = artifact }) catch unreachable; self.step.dependOn(&artifact.step); } @@ -355,13 +355,13 @@ fn printCmd(cwd: ?[]const u8, argv: []const []const u8) void { std.debug.print("\n", .{}); } -fn addPathForDynLibs(self: *RunStep, artifact: *LibExeObjStep) void { +fn addPathForDynLibs(self: *RunStep, artifact: *CompileStep) void { addPathForDynLibsInternal(&self.step, self.builder, artifact); } /// This should only be used for internal usage, this is called automatically /// for the user. -pub fn addPathForDynLibsInternal(step: *Step, builder: *std.Build, artifact: *LibExeObjStep) void { +pub fn addPathForDynLibsInternal(step: *Step, builder: *std.Build, artifact: *CompileStep) void { for (artifact.link_objects.items) |link_object| { switch (link_object) { .other_step => |other| { diff --git a/lib/std/Build/Step.zig b/lib/std/Build/Step.zig index 86d6645c29..aff8a49161 100644 --- a/lib/std/Build/Step.zig +++ b/lib/std/Build/Step.zig @@ -7,7 +7,7 @@ done_flag: bool, pub const Id = enum { top_level, - lib_exe_obj, + compile, install_artifact, install_file, install_dir, @@ -28,7 +28,7 @@ pub const Id = enum { pub fn Type(comptime id: Id) type { return switch (id) { .top_level => Build.TopLevelStep, - .lib_exe_obj => Build.LibExeObjStep, + .compile => Build.CompileStep, .install_artifact => Build.InstallArtifactStep, .install_file => Build.InstallFileStep, .install_dir => Build.InstallDirStep, diff --git a/lib/std/Build/TranslateCStep.zig b/lib/std/Build/TranslateCStep.zig index 5404747846..c59362aeee 100644 --- a/lib/std/Build/TranslateCStep.zig +++ b/lib/std/Build/TranslateCStep.zig @@ -1,6 +1,6 @@ const std = @import("../std.zig"); const Step = std.Build.Step; -const LibExeObjStep = std.Build.LibExeObjStep; +const CompileStep = std.Build.CompileStep; const CheckFileStep = std.Build.CheckFileStep; const fs = std.fs; const mem = std.mem; @@ -51,11 +51,11 @@ pub const AddExecutableOptions = struct { version: ?std.builtin.Version = null, target: ?CrossTarget = null, optimize: ?std.builtin.Mode = null, - linkage: ?LibExeObjStep.Linkage = null, + linkage: ?CompileStep.Linkage = null, }; /// Creates a step to build an executable from the translated source. -pub fn addExecutable(self: *TranslateCStep, options: AddExecutableOptions) *LibExeObjStep { +pub fn addExecutable(self: *TranslateCStep, options: AddExecutableOptions) *CompileStep { return self.builder.addExecutable(.{ .root_source_file = .{ .generated = &self.output_file }, .name = options.name orelse "translated_c", diff --git a/lib/std/std.zig b/lib/std/std.zig index e0318ceb43..7440b49662 100644 --- a/lib/std/std.zig +++ b/lib/std/std.zig @@ -97,8 +97,10 @@ pub const zig = @import("zig.zig"); pub const start = @import("start.zig"); ///// Deprecated. Use `std.Build` instead. +///// TODO: remove this after releasing 0.11.0 //pub const build = struct { // /// Deprecated. Use `std.Build` instead. +// /// TODO: remove this after releasing 0.11.0 // pub const Builder = Build; //}; diff --git a/test/link/macho/bugs/13457/build.zig b/test/link/macho/bugs/13457/build.zig index 6ca1f31b86..3560b4a168 100644 --- a/test/link/macho/bugs/13457/build.zig +++ b/test/link/macho/bugs/13457/build.zig @@ -1,5 +1,4 @@ const std = @import("std"); -const LibExeObjectStep = std.Build.LibExeObjStep; pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); diff --git a/test/link/macho/dead_strip/build.zig b/test/link/macho/dead_strip/build.zig index b6c3002492..d82c81edca 100644 --- a/test/link/macho/dead_strip/build.zig +++ b/test/link/macho/dead_strip/build.zig @@ -1,5 +1,4 @@ const std = @import("std"); -const LibExeObjectStep = std.Build.LibExeObjStep; pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); @@ -36,7 +35,11 @@ pub fn build(b: *std.Build) void { } } -fn createScenario(b: *std.Build, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { +fn createScenario( + b: *std.Build, + optimize: std.builtin.OptimizeMode, + target: std.zig.CrossTarget, +) *std.Build.CompileStep { const exe = b.addExecutable(.{ .name = "test", .optimize = optimize, diff --git a/test/link/macho/dead_strip_dylibs/build.zig b/test/link/macho/dead_strip_dylibs/build.zig index f61b30ca4a..8b62cec6e6 100644 --- a/test/link/macho/dead_strip_dylibs/build.zig +++ b/test/link/macho/dead_strip_dylibs/build.zig @@ -1,5 +1,4 @@ const std = @import("std"); -const LibExeObjectStep = std.Build.LibExeObjStep; pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); @@ -35,7 +34,7 @@ pub fn build(b: *std.Build) void { } } -fn createScenario(b: *std.Build, optimize: std.builtin.OptimizeMode) *LibExeObjectStep { +fn createScenario(b: *std.Build, optimize: std.builtin.OptimizeMode) *std.Build.CompileStep { const exe = b.addExecutable(.{ .name = "test", .optimize = optimize, diff --git a/test/link/macho/headerpad/build.zig b/test/link/macho/headerpad/build.zig index 2b3c6abb8a..3ef17573f8 100644 --- a/test/link/macho/headerpad/build.zig +++ b/test/link/macho/headerpad/build.zig @@ -1,6 +1,5 @@ const std = @import("std"); const builtin = @import("builtin"); -const LibExeObjectStep = std.Build.LibExeObjStep; pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); @@ -93,7 +92,7 @@ pub fn build(b: *std.Build) void { } } -fn simpleExe(b: *std.Build, optimize: std.builtin.OptimizeMode) *LibExeObjectStep { +fn simpleExe(b: *std.Build, optimize: std.builtin.OptimizeMode) *std.Build.CompileStep { const exe = b.addExecutable(.{ .name = "main", .optimize = optimize, diff --git a/test/link/macho/needed_framework/build.zig b/test/link/macho/needed_framework/build.zig index 62b70b21f1..8b6e3dd87f 100644 --- a/test/link/macho/needed_framework/build.zig +++ b/test/link/macho/needed_framework/build.zig @@ -1,5 +1,4 @@ const std = @import("std"); -const LibExeObjectStep = std.Build.LibExeObjStep; pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); diff --git a/test/link/macho/needed_library/build.zig b/test/link/macho/needed_library/build.zig index cdad94357b..92a73d22b7 100644 --- a/test/link/macho/needed_library/build.zig +++ b/test/link/macho/needed_library/build.zig @@ -1,5 +1,4 @@ const std = @import("std"); -const LibExeObjectStep = std.Build.LibExeObjStep; pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); diff --git a/test/link/macho/search_strategy/build.zig b/test/link/macho/search_strategy/build.zig index eeda89446b..62757f885b 100644 --- a/test/link/macho/search_strategy/build.zig +++ b/test/link/macho/search_strategy/build.zig @@ -1,5 +1,4 @@ const std = @import("std"); -const LibExeObjectStep = std.Build.LibExeObjStep; pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); @@ -35,7 +34,11 @@ pub fn build(b: *std.Build) void { } } -fn createScenario(b: *std.Build, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { +fn createScenario( + b: *std.Build, + optimize: std.builtin.OptimizeMode, + target: std.zig.CrossTarget, +) *std.Build.CompileStep { const static = b.addStaticLibrary(.{ .name = "a", .optimize = optimize, diff --git a/test/link/macho/strict_validation/build.zig b/test/link/macho/strict_validation/build.zig index 6eabc02b5f..408076657b 100644 --- a/test/link/macho/strict_validation/build.zig +++ b/test/link/macho/strict_validation/build.zig @@ -1,6 +1,5 @@ const std = @import("std"); const builtin = @import("builtin"); -const LibExeObjectStep = std.Build.LibExeObjStep; pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); diff --git a/test/link/macho/unwind_info/build.zig b/test/link/macho/unwind_info/build.zig index e43c002e2e..408f762f5d 100644 --- a/test/link/macho/unwind_info/build.zig +++ b/test/link/macho/unwind_info/build.zig @@ -1,6 +1,5 @@ const std = @import("std"); const builtin = @import("builtin"); -const LibExeObjectStep = std.Build.LibExeObjStep; pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); @@ -51,7 +50,11 @@ fn testUnwindInfo( test_step.dependOn(&run_cmd.step); } -fn createScenario(b: *std.Build, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { +fn createScenario( + b: *std.Build, + optimize: std.builtin.OptimizeMode, + target: std.zig.CrossTarget, +) *std.Build.CompileStep { const exe = b.addExecutable(.{ .name = "test", .optimize = optimize, diff --git a/test/link/macho/uuid/build.zig b/test/link/macho/uuid/build.zig index 62c288f1a0..6a68263fbf 100644 --- a/test/link/macho/uuid/build.zig +++ b/test/link/macho/uuid/build.zig @@ -1,5 +1,4 @@ const std = @import("std"); -const LibExeObjectStep = std.Build.LibExeObjStep; pub fn build(b: *std.Build) void { const test_step = b.step("test", "Test"); @@ -51,7 +50,11 @@ fn testUuid( } } -fn simpleDylib(b: *std.Build, optimize: std.builtin.OptimizeMode, target: std.zig.CrossTarget) *LibExeObjectStep { +fn simpleDylib( + b: *std.Build, + optimize: std.builtin.OptimizeMode, + target: std.zig.CrossTarget, +) *std.Build.CompileStep { const dylib = b.addSharedLibrary(.{ .name = "test", .version = .{ .major = 1, .minor = 0 }, diff --git a/test/link/macho/weak_framework/build.zig b/test/link/macho/weak_framework/build.zig index 5be66991dd..ca28458d77 100644 --- a/test/link/macho/weak_framework/build.zig +++ b/test/link/macho/weak_framework/build.zig @@ -1,5 +1,4 @@ const std = @import("std"); -const LibExeObjectStep = std.Build.LibExeObjStep; pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); diff --git a/test/link/macho/weak_library/build.zig b/test/link/macho/weak_library/build.zig index 505ab5ae96..de5aa45e30 100644 --- a/test/link/macho/weak_library/build.zig +++ b/test/link/macho/weak_library/build.zig @@ -1,5 +1,4 @@ const std = @import("std"); -const LibExeObjectStep = std.Build.LibExeObjStep; pub fn build(b: *std.Build) void { const optimize = b.standardOptimizeOption(.{}); diff --git a/test/tests.zig b/test/tests.zig index de25528dde..0f36c8eb94 100644 --- a/test/tests.zig +++ b/test/tests.zig @@ -8,7 +8,7 @@ const mem = std.mem; const fmt = std.fmt; const ArrayList = std.ArrayList; const OptimizeMode = std.builtin.OptimizeMode; -const LibExeObjStep = std.Build.LibExeObjStep; +const CompileStep = std.Build.CompileStep; const Allocator = mem.Allocator; const ExecError = std.Build.ExecError; const Step = std.Build.Step; @@ -842,7 +842,7 @@ pub const StackTracesContext = struct { step: Step, context: *StackTracesContext, - exe: *LibExeObjStep, + exe: *CompileStep, name: []const u8, optimize_mode: OptimizeMode, expect_output: []const u8, @@ -850,7 +850,7 @@ pub const StackTracesContext = struct { pub fn create( context: *StackTracesContext, - exe: *LibExeObjStep, + exe: *CompileStep, name: []const u8, optimize_mode: OptimizeMode, expect_output: []const u8, @@ -1180,14 +1180,14 @@ pub const GenHContext = struct { const GenHCmpOutputStep = struct { step: Step, context: *GenHContext, - obj: *LibExeObjStep, + obj: *CompileStep, name: []const u8, test_index: usize, case: *const TestCase, pub fn create( context: *GenHContext, - obj: *LibExeObjStep, + obj: *CompileStep, name: []const u8, case: *const TestCase, ) *GenHCmpOutputStep { From 13a96165405af33fa6ef43a3ce2c1d8aea846287 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 31 Jan 2023 13:48:24 -0700 Subject: [PATCH 54/84] std.Build: add deprecated declarations These declarations are now aliases of their new APIs and marked as deprecated via doc comments: * std.build.Builder * std.build * std.Build.LibExeObjStep --- lib/std/Build.zig | 11 ++++++----- lib/std/std.zig | 9 ++------- 2 files changed, 8 insertions(+), 12 deletions(-) diff --git a/lib/std/Build.zig b/lib/std/Build.zig index 4647baa398..008ae5f4d7 100644 --- a/lib/std/Build.zig +++ b/lib/std/Build.zig @@ -19,8 +19,12 @@ const NativeTargetInfo = std.zig.system.NativeTargetInfo; const Sha256 = std.crypto.hash.sha2.Sha256; const Build = @This(); -///// deprecated: use `CompileStep` instead. -//pub const LibExeObjStep = CompileStep; +/// deprecated: use `CompileStep`. +pub const LibExeObjStep = CompileStep; +/// deprecated: use `Build`. +pub const Builder = Build; +/// deprecated: use `InstallDirStep.Options` +pub const InstallDirectoryOptions = InstallDirStep.Options; pub const Step = @import("Build/Step.zig"); pub const CheckFileStep = @import("Build/CheckFileStep.zig"); @@ -1637,9 +1641,6 @@ pub fn constructCMacro(allocator: Allocator, name: []const u8, value: ?[]const u return macro; } -/// deprecated: use `InstallDirStep.Options` -pub const InstallDirectoryOptions = InstallDirStep.Options; - pub const VcpkgRoot = union(VcpkgRootStatus) { unattempted: void, not_found: void, diff --git a/lib/std/std.zig b/lib/std/std.zig index 7440b49662..40ba896569 100644 --- a/lib/std/std.zig +++ b/lib/std/std.zig @@ -96,13 +96,8 @@ pub const wasm = @import("wasm.zig"); pub const zig = @import("zig.zig"); pub const start = @import("start.zig"); -///// Deprecated. Use `std.Build` instead. -///// TODO: remove this after releasing 0.11.0 -//pub const build = struct { -// /// Deprecated. Use `std.Build` instead. -// /// TODO: remove this after releasing 0.11.0 -// pub const Builder = Build; -//}; +/// deprecated: use `Build`. +pub const build = Build; const root = @import("root"); const options_override = if (@hasDecl(root, "std_options")) root.std_options else struct {}; From 90e48d4b3469fb4f8dd2f3b52e05453029d45fdc Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 31 Jan 2023 14:02:32 -0700 Subject: [PATCH 55/84] std.Build: avoid use of catch unreachable Usage of `catch unreachable` in build scripts is completely harmless because build scripts are always run in Debug mode, however, it sets a poor example for beginners to learn from. --- lib/std/Build.zig | 69 ++++++++------- lib/std/Build/CheckFileStep.zig | 2 +- lib/std/Build/CheckObjectStep.zig | 12 +-- lib/std/Build/CompileStep.zig | 121 ++++++++++++++------------ lib/std/Build/EmulatableRunStep.zig | 8 +- lib/std/Build/FmtStep.zig | 4 +- lib/std/Build/InstallArtifactStep.zig | 2 +- lib/std/Build/InstallRawStep.zig | 4 +- lib/std/Build/OptionsStep.zig | 62 +++++++------ lib/std/Build/RunStep.zig | 24 ++--- lib/std/Build/Step.zig | 4 +- lib/std/Build/TranslateCStep.zig | 12 +-- lib/std/Build/WriteFileStep.zig | 6 +- 13 files changed, 169 insertions(+), 161 deletions(-) diff --git a/lib/std/Build.zig b/lib/std/Build.zig index 008ae5f4d7..d695637fc3 100644 --- a/lib/std/Build.zig +++ b/lib/std/Build.zig @@ -564,12 +564,12 @@ pub fn addConfigHeader( /// Allocator.dupe without the need to handle out of memory. pub fn dupe(self: *Build, bytes: []const u8) []u8 { - return self.allocator.dupe(u8, bytes) catch unreachable; + return self.allocator.dupe(u8, bytes) catch @panic("OOM"); } /// Duplicates an array of strings without the need to handle out of memory. pub fn dupeStrings(self: *Build, strings: []const []const u8) [][]u8 { - const array = self.allocator.alloc([]u8, strings.len) catch unreachable; + const array = self.allocator.alloc([]u8, strings.len) catch @panic("OOM"); for (strings) |s, i| { array[i] = self.dupe(s); } @@ -596,7 +596,7 @@ pub fn dupePkg(self: *Build, package: Pkg) Pkg { }; if (package.dependencies) |dependencies| { - const new_dependencies = self.allocator.alloc(Pkg, dependencies.len) catch unreachable; + const new_dependencies = self.allocator.alloc(Pkg, dependencies.len) catch @panic("OOM"); the_copy.dependencies = new_dependencies; for (dependencies) |dep_package, i| { @@ -613,20 +613,20 @@ pub fn addWriteFile(self: *Build, file_path: []const u8, data: []const u8) *Writ } pub fn addWriteFiles(self: *Build) *WriteFileStep { - const write_file_step = self.allocator.create(WriteFileStep) catch unreachable; + const write_file_step = self.allocator.create(WriteFileStep) catch @panic("OOM"); write_file_step.* = WriteFileStep.init(self); return write_file_step; } pub fn addLog(self: *Build, comptime format: []const u8, args: anytype) *LogStep { const data = self.fmt(format, args); - const log_step = self.allocator.create(LogStep) catch unreachable; + const log_step = self.allocator.create(LogStep) catch @panic("OOM"); log_step.* = LogStep.init(self, data); return log_step; } pub fn addRemoveDirTree(self: *Build, dir_path: []const u8) *RemoveDirStep { - const remove_dir_step = self.allocator.create(RemoveDirStep) catch unreachable; + const remove_dir_step = self.allocator.create(RemoveDirStep) catch @panic("OOM"); remove_dir_step.* = RemoveDirStep.init(self, dir_path); return remove_dir_step; } @@ -719,13 +719,13 @@ pub fn option(self: *Build, comptime T: type, name_raw: []const u8, description_ const type_id = comptime typeToEnum(T); const enum_options = if (type_id == .@"enum") blk: { const fields = comptime std.meta.fields(T); - var options = ArrayList([]const u8).initCapacity(self.allocator, fields.len) catch unreachable; + var options = ArrayList([]const u8).initCapacity(self.allocator, fields.len) catch @panic("OOM"); inline for (fields) |field| { options.appendAssumeCapacity(field.name); } - break :blk options.toOwnedSlice() catch unreachable; + break :blk options.toOwnedSlice() catch @panic("OOM"); } else null; const available_option = AvailableOption{ .name = name, @@ -733,10 +733,10 @@ pub fn option(self: *Build, comptime T: type, name_raw: []const u8, description_ .description = description, .enum_options = enum_options, }; - if ((self.available_options_map.fetchPut(name, available_option) catch unreachable) != null) { + if ((self.available_options_map.fetchPut(name, available_option) catch @panic("OOM")) != null) { panic("Option '{s}' declared twice", .{name}); } - self.available_options_list.append(available_option) catch unreachable; + self.available_options_list.append(available_option) catch @panic("OOM"); const option_ptr = self.user_input_options.getPtr(name) orelse return null; option_ptr.used = true; @@ -840,7 +840,7 @@ pub fn option(self: *Build, comptime T: type, name_raw: []const u8, description_ return null; }, .scalar => |s| { - return self.allocator.dupe([]const u8, &[_][]const u8{s}) catch unreachable; + return self.allocator.dupe([]const u8, &[_][]const u8{s}) catch @panic("OOM"); }, .list => |lst| return lst.items, }, @@ -848,12 +848,12 @@ pub fn option(self: *Build, comptime T: type, name_raw: []const u8, description_ } pub fn step(self: *Build, name: []const u8, description: []const u8) *Step { - const step_info = self.allocator.create(TopLevelStep) catch unreachable; + const step_info = self.allocator.create(TopLevelStep) catch @panic("OOM"); step_info.* = TopLevelStep{ .step = Step.initNoOp(.top_level, name, self.allocator), .description = self.dupe(description), }; - self.top_level_steps.append(step_info) catch unreachable; + self.top_level_steps.append(step_info) catch @panic("OOM"); return &step_info.step; } @@ -949,7 +949,7 @@ pub fn standardTargetOptions(self: *Build, args: StandardTargetOptionsArgs) Cros }, }; - const selected_canonicalized_triple = selected_target.zigTriple(self.allocator) catch unreachable; + const selected_canonicalized_triple = selected_target.zigTriple(self.allocator) catch @panic("OOM"); if (args.whitelist) |list| whitelist_check: { // Make sure it's a match of one of the list. @@ -960,7 +960,7 @@ pub fn standardTargetOptions(self: *Build, args: StandardTargetOptionsArgs) Cros mismatch_cpu_features = true; mismatch_triple = true; - const t_triple = t.zigTriple(self.allocator) catch unreachable; + const t_triple = t.zigTriple(self.allocator) catch @panic("OOM"); if (mem.eql(u8, t_triple, selected_canonicalized_triple)) { mismatch_triple = false; whitelist_item = t; @@ -977,7 +977,7 @@ pub fn standardTargetOptions(self: *Build, args: StandardTargetOptionsArgs) Cros selected_canonicalized_triple, }); for (list) |t| { - const t_triple = t.zigTriple(self.allocator) catch unreachable; + const t_triple = t.zigTriple(self.allocator) catch @panic("OOM"); log.err(" {s}", .{t_triple}); } } else { @@ -1033,22 +1033,22 @@ pub fn addUserInputOption(self: *Build, name_raw: []const u8, value_raw: []const .scalar => |s| { // turn it into a list var list = ArrayList([]const u8).init(self.allocator); - list.append(s) catch unreachable; - list.append(value) catch unreachable; - self.user_input_options.put(name, .{ + try list.append(s); + try list.append(value); + try self.user_input_options.put(name, .{ .name = name, .value = .{ .list = list }, .used = false, - }) catch unreachable; + }); }, .list => |*list| { // append to the list - list.append(value) catch unreachable; - self.user_input_options.put(name, .{ + try list.append(value); + try self.user_input_options.put(name, .{ .name = name, .value = .{ .list = list.* }, .used = false, - }) catch unreachable; + }); }, .flag => { log.warn("Option '-D{s}={s}' conflicts with flag '-D{s}'.", .{ name, value, name }); @@ -1240,13 +1240,13 @@ pub fn addInstallFileWithDir( if (dest_rel_path.len == 0) { panic("dest_rel_path must be non-empty", .{}); } - const install_step = self.allocator.create(InstallFileStep) catch unreachable; + const install_step = self.allocator.create(InstallFileStep) catch @panic("OOM"); install_step.* = InstallFileStep.init(self, source.dupe(self), install_dir, dest_rel_path); return install_step; } pub fn addInstallDirectory(self: *Build, options: InstallDirectoryOptions) *InstallDirStep { - const install_step = self.allocator.create(InstallDirStep) catch unreachable; + const install_step = self.allocator.create(InstallDirStep) catch @panic("OOM"); install_step.* = InstallDirStep.init(self, options); return install_step; } @@ -1256,7 +1256,7 @@ pub fn pushInstalledFile(self: *Build, dir: InstallDir, dest_rel_path: []const u .dir = dir, .path = dest_rel_path, }; - self.installed_files.append(file.dupe(self)) catch unreachable; + self.installed_files.append(file.dupe(self)) catch @panic("OOM"); } pub fn updateFile(self: *Build, source_path: []const u8, dest_path: []const u8) !void { @@ -1289,16 +1289,15 @@ pub fn truncateFile(self: *Build, dest_path: []const u8) !void { } pub fn pathFromRoot(self: *Build, rel_path: []const u8) []u8 { - return fs.path.resolve(self.allocator, &[_][]const u8{ self.build_root, rel_path }) catch unreachable; + return fs.path.resolve(self.allocator, &[_][]const u8{ self.build_root, rel_path }) catch @panic("OOM"); } -/// Shorthand for `std.fs.path.join(Build.allocator, paths) catch unreachable` pub fn pathJoin(self: *Build, paths: []const []const u8) []u8 { - return fs.path.join(self.allocator, paths) catch unreachable; + return fs.path.join(self.allocator, paths) catch @panic("OOM"); } pub fn fmt(self: *Build, comptime format: []const u8, args: anytype) []u8 { - return fmt_lib.allocPrint(self.allocator, format, args) catch unreachable; + return fmt_lib.allocPrint(self.allocator, format, args) catch @panic("OOM"); } pub fn findProgram(self: *Build, names: []const []const u8, paths: []const []const u8) ![]const u8 { @@ -1442,7 +1441,7 @@ pub fn exec(self: *Build, argv: []const []const u8) ![]u8 { } pub fn addSearchPrefix(self: *Build, search_prefix: []const u8) void { - self.search_prefixes.append(self.dupePath(search_prefix)) catch unreachable; + self.search_prefixes.append(self.dupePath(search_prefix)) catch @panic("OOM"); } pub fn getInstallPath(self: *Build, dir: InstallDir, dest_rel_path: []const u8) []const u8 { @@ -1457,7 +1456,7 @@ pub fn getInstallPath(self: *Build, dir: InstallDir, dest_rel_path: []const u8) return fs.path.resolve( self.allocator, &[_][]const u8{ base_dir, dest_rel_path }, - ) catch unreachable; + ) catch @panic("OOM"); } pub const Dependency = struct { @@ -1509,14 +1508,14 @@ fn dependencyInner( comptime build_zig: type, args: anytype, ) *Dependency { - const sub_builder = b.createChild(name, build_root, args) catch unreachable; - sub_builder.runBuild(build_zig) catch unreachable; + const sub_builder = b.createChild(name, build_root, args) catch @panic("unhandled error"); + sub_builder.runBuild(build_zig) catch @panic("unhandled error"); if (sub_builder.validateUserInputDidItFail()) { std.debug.dumpCurrentStackTrace(@returnAddress()); } - const dep = b.allocator.create(Dependency) catch unreachable; + const dep = b.allocator.create(Dependency) catch @panic("OOM"); dep.* = .{ .builder = sub_builder }; return dep; } diff --git a/lib/std/Build/CheckFileStep.zig b/lib/std/Build/CheckFileStep.zig index 3b8cfe5263..b08a797e84 100644 --- a/lib/std/Build/CheckFileStep.zig +++ b/lib/std/Build/CheckFileStep.zig @@ -18,7 +18,7 @@ pub fn create( source: std.Build.FileSource, expected_matches: []const []const u8, ) *CheckFileStep { - const self = builder.allocator.create(CheckFileStep) catch unreachable; + const self = builder.allocator.create(CheckFileStep) catch @panic("OOM"); self.* = CheckFileStep{ .builder = builder, .step = Step.init(.check_file, "CheckFile", builder.allocator, make), diff --git a/lib/std/Build/CheckObjectStep.zig b/lib/std/Build/CheckObjectStep.zig index bfa5338927..5cb096581f 100644 --- a/lib/std/Build/CheckObjectStep.zig +++ b/lib/std/Build/CheckObjectStep.zig @@ -24,7 +24,7 @@ obj_format: std.Target.ObjectFormat, pub fn create(builder: *std.Build, source: std.Build.FileSource, obj_format: std.Target.ObjectFormat) *CheckObjectStep { const gpa = builder.allocator; - const self = gpa.create(CheckObjectStep) catch unreachable; + const self = gpa.create(CheckObjectStep) catch @panic("OOM"); self.* = .{ .builder = builder, .step = Step.init(.check_file, "CheckObject", gpa, make), @@ -228,14 +228,14 @@ const Check = struct { self.actions.append(.{ .tag = .match, .phrase = self.builder.dupe(phrase), - }) catch unreachable; + }) catch @panic("OOM"); } fn notPresent(self: *Check, phrase: []const u8) void { self.actions.append(.{ .tag = .not_present, .phrase = self.builder.dupe(phrase), - }) catch unreachable; + }) catch @panic("OOM"); } fn computeCmp(self: *Check, phrase: []const u8, expected: ComputeCompareExpected) void { @@ -243,7 +243,7 @@ const Check = struct { .tag = .compute_cmp, .phrase = self.builder.dupe(phrase), .expected = expected, - }) catch unreachable; + }) catch @panic("OOM"); } }; @@ -251,7 +251,7 @@ const Check = struct { pub fn checkStart(self: *CheckObjectStep, phrase: []const u8) void { var new_check = Check.create(self.builder); new_check.match(phrase); - self.checks.append(new_check) catch unreachable; + self.checks.append(new_check) catch @panic("OOM"); } /// Adds another searched phrase to the latest created Check with `CheckObjectStep.checkStart(...)`. @@ -293,7 +293,7 @@ pub fn checkComputeCompare( ) void { var new_check = Check.create(self.builder); new_check.computeCmp(program, expected); - self.checks.append(new_check) catch unreachable; + self.checks.append(new_check) catch @panic("OOM"); } fn make(step: *Step) !void { diff --git a/lib/std/Build/CompileStep.zig b/lib/std/Build/CompileStep.zig index 5257c85a5c..7396a5ce66 100644 --- a/lib/std/Build/CompileStep.zig +++ b/lib/std/Build/CompileStep.zig @@ -312,7 +312,7 @@ pub fn create(builder: *std.Build, options: Options) *CompileStep { panic("invalid name: '{s}'. It looks like a file path, but it is supposed to be the library or application name.", .{name}); } - const self = builder.allocator.create(CompileStep) catch unreachable; + const self = builder.allocator.create(CompileStep) catch @panic("OOM"); self.* = CompileStep{ .strip = null, .unwind_tables = null, @@ -364,7 +364,7 @@ pub fn create(builder: *std.Build, options: Options) *CompileStep { .output_h_path_source = GeneratedFile{ .step = &self.step }, .output_pdb_path_source = GeneratedFile{ .step = &self.step }, - .target_info = NativeTargetInfo.detect(self.target) catch unreachable, + .target_info = NativeTargetInfo.detect(self.target) catch @panic("unhandled error"), }; self.computeOutFileNames(); if (root_src) |rs| rs.addStepDependencies(&self.step); @@ -387,7 +387,7 @@ fn computeOutFileNames(self: *CompileStep) void { .static => .Static, }) else null, .version = self.version, - }) catch unreachable; + }) catch @panic("OOM"); if (self.kind == .lib) { if (self.linkage != null and self.linkage.? == .static) { @@ -439,7 +439,7 @@ pub fn installRaw(self: *CompileStep, dest_filename: []const u8, options: Instal pub fn installHeader(a: *CompileStep, src_path: []const u8, dest_rel_path: []const u8) void { const install_file = a.builder.addInstallHeaderFile(src_path, dest_rel_path); a.builder.getInstallStep().dependOn(&install_file.step); - a.installed_headers.append(&install_file.step) catch unreachable; + a.installed_headers.append(&install_file.step) catch @panic("OOM"); } pub fn installHeadersDirectory( @@ -460,7 +460,7 @@ pub fn installHeadersDirectoryOptions( ) void { const install_dir = a.builder.addInstallDirectory(options); a.builder.getInstallStep().dependOn(&install_dir.step); - a.installed_headers.append(&install_dir.step) catch unreachable; + a.installed_headers.append(&install_dir.step) catch @panic("OOM"); } pub fn installLibraryHeaders(a: *CompileStep, l: *CompileStep) void { @@ -472,7 +472,7 @@ pub fn installLibraryHeaders(a: *CompileStep, l: *CompileStep) void { const step_copy = switch (step.id) { inline .install_file, .install_dir => |id| blk: { const T = id.Type(); - const ptr = a.builder.allocator.create(T) catch unreachable; + const ptr = a.builder.allocator.create(T) catch @panic("OOM"); ptr.* = step.cast(T).?.*; ptr.override_source_builder = ptr.builder; ptr.builder = a.builder; @@ -480,10 +480,10 @@ pub fn installLibraryHeaders(a: *CompileStep, l: *CompileStep) void { }, else => unreachable, }; - a.installed_headers.append(step_copy) catch unreachable; + a.installed_headers.append(step_copy) catch @panic("OOM"); install_step.dependOn(step_copy); } - a.installed_headers.appendSlice(l.installed_headers.items) catch unreachable; + a.installed_headers.appendSlice(l.installed_headers.items) catch @panic("OOM"); } /// Creates a `RunStep` with an executable built with `addExecutable`. @@ -532,19 +532,19 @@ pub fn setLinkerScriptPath(self: *CompileStep, source: FileSource) void { } pub fn linkFramework(self: *CompileStep, framework_name: []const u8) void { - self.frameworks.put(self.builder.dupe(framework_name), .{}) catch unreachable; + self.frameworks.put(self.builder.dupe(framework_name), .{}) catch @panic("OOM"); } pub fn linkFrameworkNeeded(self: *CompileStep, framework_name: []const u8) void { self.frameworks.put(self.builder.dupe(framework_name), .{ .needed = true, - }) catch unreachable; + }) catch @panic("OOM"); } pub fn linkFrameworkWeak(self: *CompileStep, framework_name: []const u8) void { self.frameworks.put(self.builder.dupe(framework_name), .{ .weak = true, - }) catch unreachable; + }) catch @panic("OOM"); } /// Returns whether the library, executable, or object depends on a particular system library. @@ -596,12 +596,12 @@ pub fn linkLibCpp(self: *CompileStep) void { /// `name` and `value` need not live longer than the function call. pub fn defineCMacro(self: *CompileStep, name: []const u8, value: ?[]const u8) void { const macro = std.Build.constructCMacro(self.builder.allocator, name, value); - self.c_macros.append(macro) catch unreachable; + self.c_macros.append(macro) catch @panic("OOM"); } /// name_and_value looks like [name]=[value]. If the value is omitted, it is set to 1. pub fn defineCMacroRaw(self: *CompileStep, name_and_value: []const u8) void { - self.c_macros.append(self.builder.dupe(name_and_value)) catch unreachable; + self.c_macros.append(self.builder.dupe(name_and_value)) catch @panic("OOM"); } /// This one has no integration with anything, it just puts -lname on the command line. @@ -614,7 +614,7 @@ pub fn linkSystemLibraryName(self: *CompileStep, name: []const u8) void { .weak = false, .use_pkg_config = .no, }, - }) catch unreachable; + }) catch @panic("OOM"); } /// This one has no integration with anything, it just puts -needed-lname on the command line. @@ -627,7 +627,7 @@ pub fn linkSystemLibraryNeededName(self: *CompileStep, name: []const u8) void { .weak = false, .use_pkg_config = .no, }, - }) catch unreachable; + }) catch @panic("OOM"); } /// Darwin-only. This one has no integration with anything, it just puts -weak-lname on the @@ -640,7 +640,7 @@ pub fn linkSystemLibraryWeakName(self: *CompileStep, name: []const u8) void { .weak = true, .use_pkg_config = .no, }, - }) catch unreachable; + }) catch @panic("OOM"); } /// This links against a system library, exclusively using pkg-config to find the library. @@ -653,7 +653,7 @@ pub fn linkSystemLibraryPkgConfigOnly(self: *CompileStep, lib_name: []const u8) .weak = false, .use_pkg_config = .force, }, - }) catch unreachable; + }) catch @panic("OOM"); } /// This links against a system library, exclusively using pkg-config to find the library. @@ -666,7 +666,7 @@ pub fn linkSystemLibraryNeededPkgConfigOnly(self: *CompileStep, lib_name: []cons .weak = false, .use_pkg_config = .force, }, - }) catch unreachable; + }) catch @panic("OOM"); } /// Run pkg-config for the given library name and parse the output, returning the arguments @@ -797,7 +797,7 @@ fn linkSystemLibraryInner(self: *CompileStep, name: []const u8, opts: struct { .weak = opts.weak, .use_pkg_config = .yes, }, - }) catch unreachable; + }) catch @panic("OOM"); } pub fn setNamePrefix(self: *CompileStep, text: []const u8) void { @@ -817,7 +817,7 @@ pub fn setTestRunner(self: *CompileStep, path: ?[]const u8) void { /// Handy when you have many C/C++ source files and want them all to have the same flags. pub fn addCSourceFiles(self: *CompileStep, files: []const []const u8, flags: []const []const u8) void { - const c_source_files = self.builder.allocator.create(CSourceFiles) catch unreachable; + const c_source_files = self.builder.allocator.create(CSourceFiles) catch @panic("OOM"); const files_copy = self.builder.dupeStrings(files); const flags_copy = self.builder.dupeStrings(flags); @@ -826,7 +826,7 @@ pub fn addCSourceFiles(self: *CompileStep, files: []const []const u8, flags: []c .files = files_copy, .flags = flags_copy, }; - self.link_objects.append(.{ .c_source_files = c_source_files }) catch unreachable; + self.link_objects.append(.{ .c_source_files = c_source_files }) catch @panic("OOM"); } pub fn addCSourceFile(self: *CompileStep, file: []const u8, flags: []const []const u8) void { @@ -837,9 +837,9 @@ pub fn addCSourceFile(self: *CompileStep, file: []const u8, flags: []const []con } pub fn addCSourceFileSource(self: *CompileStep, source: CSourceFile) void { - const c_source_file = self.builder.allocator.create(CSourceFile) catch unreachable; + const c_source_file = self.builder.allocator.create(CSourceFile) catch @panic("OOM"); c_source_file.* = source.dupe(self.builder); - self.link_objects.append(.{ .c_source_file = c_source_file }) catch unreachable; + self.link_objects.append(.{ .c_source_file = c_source_file }) catch @panic("OOM"); source.source.addStepDependencies(&self.step); } @@ -893,12 +893,12 @@ pub fn getOutputPdbSource(self: *CompileStep) FileSource { pub fn addAssemblyFile(self: *CompileStep, path: []const u8) void { self.link_objects.append(.{ .assembly_file = .{ .path = self.builder.dupe(path) }, - }) catch unreachable; + }) catch @panic("OOM"); } pub fn addAssemblyFileSource(self: *CompileStep, source: FileSource) void { const source_duped = source.dupe(self.builder); - self.link_objects.append(.{ .assembly_file = source_duped }) catch unreachable; + self.link_objects.append(.{ .assembly_file = source_duped }) catch @panic("OOM"); source_duped.addStepDependencies(&self.step); } @@ -907,7 +907,7 @@ pub fn addObjectFile(self: *CompileStep, source_file: []const u8) void { } pub fn addObjectFileSource(self: *CompileStep, source: FileSource) void { - self.link_objects.append(.{ .static_path = source.dupe(self.builder) }) catch unreachable; + self.link_objects.append(.{ .static_path = source.dupe(self.builder) }) catch @panic("OOM"); source.addStepDependencies(&self.step); } @@ -922,11 +922,11 @@ pub const addLibPath = @compileError("deprecated, use addLibraryPath"); pub const addFrameworkDir = @compileError("deprecated, use addFrameworkPath"); pub fn addSystemIncludePath(self: *CompileStep, path: []const u8) void { - self.include_dirs.append(IncludeDir{ .raw_path_system = self.builder.dupe(path) }) catch unreachable; + self.include_dirs.append(IncludeDir{ .raw_path_system = self.builder.dupe(path) }) catch @panic("OOM"); } pub fn addIncludePath(self: *CompileStep, path: []const u8) void { - self.include_dirs.append(IncludeDir{ .raw_path = self.builder.dupe(path) }) catch unreachable; + self.include_dirs.append(IncludeDir{ .raw_path = self.builder.dupe(path) }) catch @panic("OOM"); } pub fn addConfigHeader(self: *CompileStep, config_header: *ConfigHeaderStep) void { @@ -935,19 +935,19 @@ pub fn addConfigHeader(self: *CompileStep, config_header: *ConfigHeaderStep) voi } pub fn addLibraryPath(self: *CompileStep, path: []const u8) void { - self.lib_paths.append(self.builder.dupe(path)) catch unreachable; + self.lib_paths.append(self.builder.dupe(path)) catch @panic("OOM"); } pub fn addRPath(self: *CompileStep, path: []const u8) void { - self.rpaths.append(self.builder.dupe(path)) catch unreachable; + self.rpaths.append(self.builder.dupe(path)) catch @panic("OOM"); } pub fn addFrameworkPath(self: *CompileStep, dir_path: []const u8) void { - self.framework_dirs.append(self.builder.dupe(dir_path)) catch unreachable; + self.framework_dirs.append(self.builder.dupe(dir_path)) catch @panic("OOM"); } pub fn addPackage(self: *CompileStep, package: Pkg) void { - self.packages.append(self.builder.dupePkg(package)) catch unreachable; + self.packages.append(self.builder.dupePkg(package)) catch @panic("OOM"); self.addRecursiveBuildDeps(package); } @@ -1010,7 +1010,7 @@ pub fn addVcpkgPaths(self: *CompileStep, linkage: CompileStep.Linkage) !void { pub fn setExecCmd(self: *CompileStep, args: []const ?[]const u8) void { assert(self.kind == .@"test"); - const duped_args = self.builder.allocator.alloc(?[]u8, args.len) catch unreachable; + const duped_args = self.builder.allocator.alloc(?[]u8, args.len) catch @panic("OOM"); for (args) |arg, i| { duped_args[i] = if (arg) |a| self.builder.dupe(a) else null; } @@ -1019,8 +1019,8 @@ pub fn setExecCmd(self: *CompileStep, args: []const ?[]const u8) void { fn linkLibraryOrObject(self: *CompileStep, other: *CompileStep) void { self.step.dependOn(&other.step); - self.link_objects.append(.{ .other_step = other }) catch unreachable; - self.include_dirs.append(.{ .other_step = other }) catch unreachable; + self.link_objects.append(.{ .other_step = other }) catch @panic("OOM"); + self.include_dirs.append(.{ .other_step = other }) catch @panic("OOM"); } fn makePackageCmd(self: *CompileStep, pkg: Pkg, zig_args: *ArrayList([]const u8)) error{OutOfMemory}!void { @@ -1051,7 +1051,7 @@ fn make(step: *Step) !void { var zig_args = ArrayList([]const u8).init(builder.allocator); defer zig_args.deinit(); - zig_args.append(builder.zig_exe) catch unreachable; + try zig_args.append(builder.zig_exe); const cmd = switch (self.kind) { .lib => "build-lib", @@ -1060,7 +1060,7 @@ fn make(step: *Step) !void { .@"test" => "test", .test_exe => "test", }; - zig_args.append(cmd) catch unreachable; + try zig_args.append(cmd); if (builder.color != .auto) { try zig_args.append("--color"); @@ -1265,12 +1265,12 @@ fn make(step: *Step) !void { try zig_args.append("--debug-compile-errors"); } - if (builder.verbose_cimport) zig_args.append("--verbose-cimport") catch unreachable; - if (builder.verbose_air) zig_args.append("--verbose-air") catch unreachable; - if (builder.verbose_llvm_ir) zig_args.append("--verbose-llvm-ir") catch unreachable; - if (builder.verbose_link or self.verbose_link) zig_args.append("--verbose-link") catch unreachable; - if (builder.verbose_cc or self.verbose_cc) zig_args.append("--verbose-cc") catch unreachable; - if (builder.verbose_llvm_cpu_features) zig_args.append("--verbose-llvm-cpu-features") catch unreachable; + if (builder.verbose_cimport) try zig_args.append("--verbose-cimport"); + if (builder.verbose_air) try zig_args.append("--verbose-air"); + if (builder.verbose_llvm_ir) try zig_args.append("--verbose-llvm-ir"); + if (builder.verbose_link or self.verbose_link) try zig_args.append("--verbose-link"); + if (builder.verbose_cc or self.verbose_cc) try zig_args.append("--verbose-cc"); + if (builder.verbose_llvm_cpu_features) try zig_args.append("--verbose-llvm-cpu-features"); if (self.emit_analysis.getArg(builder, "emit-analysis")) |arg| try zig_args.append(arg); if (self.emit_asm.getArg(builder, "emit-asm")) |arg| try zig_args.append(arg); @@ -1336,7 +1336,7 @@ fn make(step: *Step) !void { switch (self.optimize) { .Debug => {}, // Skip since it's the default. - else => zig_args.append(builder.fmt("-O{s}", .{@tagName(self.optimize)})) catch unreachable, + else => try zig_args.append(builder.fmt("-O{s}", .{@tagName(self.optimize)})), } try zig_args.append("--cache-dir"); @@ -1345,8 +1345,8 @@ fn make(step: *Step) !void { try zig_args.append("--global-cache-dir"); try zig_args.append(builder.pathFromRoot(builder.global_cache_root)); - zig_args.append("--name") catch unreachable; - zig_args.append(self.name) catch unreachable; + try zig_args.append("--name"); + try zig_args.append(self.name); if (self.linkage) |some| switch (some) { .dynamic => try zig_args.append("-dynamic"), @@ -1354,8 +1354,8 @@ fn make(step: *Step) !void { }; if (self.kind == .lib and self.linkage != null and self.linkage.? == .dynamic) { if (self.version) |version| { - zig_args.append("--version") catch unreachable; - zig_args.append(builder.fmt("{}", .{version})) catch unreachable; + try zig_args.append("--version"); + try zig_args.append(builder.fmt("{}", .{version})); } if (self.target.isDarwin()) { @@ -1651,13 +1651,13 @@ fn make(step: *Step) !void { const name = entry.key_ptr.*; const info = entry.value_ptr.*; if (info.needed) { - zig_args.append("-needed_framework") catch unreachable; + try zig_args.append("-needed_framework"); } else if (info.weak) { - zig_args.append("-weak_framework") catch unreachable; + try zig_args.append("-weak_framework"); } else { - zig_args.append("-framework") catch unreachable; + try zig_args.append("-framework"); } - zig_args.append(name) catch unreachable; + try zig_args.append(name); } } else { if (self.framework_dirs.items.len > 0) { @@ -1748,7 +1748,7 @@ fn make(step: *Step) !void { // Slow path for arguments that need to be escaped. We'll need to allocate and copy var escaped = try ArrayList(u8).initCapacity(args_arena.allocator(), arg.len + 1); const writer = escaped.writer(); - writer.writeAll(arg[0..arg_idx]) catch unreachable; + try writer.writeAll(arg[0..arg_idx]); for (arg[arg_idx..]) |to_escape| { if (to_escape == '\\' or to_escape == '"') try writer.writeByte('\\'); try writer.writeByte(to_escape); @@ -1874,23 +1874,28 @@ fn findVcpkgRoot(allocator: Allocator) !?[]const u8 { return vcpkg_path; } -pub fn doAtomicSymLinks(allocator: Allocator, output_path: []const u8, filename_major_only: []const u8, filename_name_only: []const u8) !void { +pub fn doAtomicSymLinks( + allocator: Allocator, + output_path: []const u8, + filename_major_only: []const u8, + filename_name_only: []const u8, +) !void { const out_dir = fs.path.dirname(output_path) orelse "."; const out_basename = fs.path.basename(output_path); // sym link for libfoo.so.1 to libfoo.so.1.2.3 - const major_only_path = fs.path.join( + const major_only_path = try fs.path.join( allocator, &[_][]const u8{ out_dir, filename_major_only }, - ) catch unreachable; + ); fs.atomicSymLink(allocator, out_basename, major_only_path) catch |err| { log.err("Unable to symlink {s} -> {s}", .{ major_only_path, out_basename }); return err; }; // sym link for libfoo.so to libfoo.so.1 - const name_only_path = fs.path.join( + const name_only_path = try fs.path.join( allocator, &[_][]const u8{ out_dir, filename_name_only }, - ) catch unreachable; + ); fs.atomicSymLink(allocator, filename_major_only, name_only_path) catch |err| { log.err("Unable to symlink {s} -> {s}", .{ name_only_path, filename_major_only }); return err; diff --git a/lib/std/Build/EmulatableRunStep.zig b/lib/std/Build/EmulatableRunStep.zig index 26804b2fc8..5517f7f9aa 100644 --- a/lib/std/Build/EmulatableRunStep.zig +++ b/lib/std/Build/EmulatableRunStep.zig @@ -47,7 +47,7 @@ hide_foreign_binaries_warning: bool, /// Asserts given artifact is an executable. pub fn create(builder: *std.Build, name: []const u8, artifact: *CompileStep) *EmulatableRunStep { std.debug.assert(artifact.kind == .exe or artifact.kind == .test_exe); - const self = builder.allocator.create(EmulatableRunStep) catch unreachable; + const self = builder.allocator.create(EmulatableRunStep) catch @panic("OOM"); const option_name = "hide-foreign-warnings"; const hide_warnings = if (builder.available_options_map.get(option_name) == null) warn: { @@ -154,9 +154,9 @@ fn warnAboutForeignBinaries(step: *EmulatableRunStep) void { const builder = step.builder; const artifact = step.exe; - const host_name = builder.host.target.zigTriple(builder.allocator) catch unreachable; - const foreign_name = artifact.target.zigTriple(builder.allocator) catch unreachable; - const target_info = std.zig.system.NativeTargetInfo.detect(artifact.target) catch unreachable; + const host_name = builder.host.target.zigTriple(builder.allocator) catch @panic("unhandled error"); + const foreign_name = artifact.target.zigTriple(builder.allocator) catch @panic("unhandled error"); + const target_info = std.zig.system.NativeTargetInfo.detect(artifact.target) catch @panic("unhandled error"); const need_cross_glibc = artifact.target.isGnuLibC() and artifact.is_linking_libc; switch (builder.host.getExternalExecutor(target_info, .{ .qemu_fixes_dl = need_cross_glibc and builder.glibc_runtimes_dir != null, diff --git a/lib/std/Build/FmtStep.zig b/lib/std/Build/FmtStep.zig index 44a93dee66..6404d22f13 100644 --- a/lib/std/Build/FmtStep.zig +++ b/lib/std/Build/FmtStep.zig @@ -9,12 +9,12 @@ builder: *std.Build, argv: [][]const u8, pub fn create(builder: *std.Build, paths: []const []const u8) *FmtStep { - const self = builder.allocator.create(FmtStep) catch unreachable; + const self = builder.allocator.create(FmtStep) catch @panic("OOM"); const name = "zig fmt"; self.* = FmtStep{ .step = Step.init(.fmt, name, builder.allocator, make), .builder = builder, - .argv = builder.allocator.alloc([]u8, paths.len + 2) catch unreachable, + .argv = builder.allocator.alloc([]u8, paths.len + 2) catch @panic("OOM"), }; self.argv[0] = builder.zig_exe; diff --git a/lib/std/Build/InstallArtifactStep.zig b/lib/std/Build/InstallArtifactStep.zig index 898b9e85e7..8ee739a41c 100644 --- a/lib/std/Build/InstallArtifactStep.zig +++ b/lib/std/Build/InstallArtifactStep.zig @@ -16,7 +16,7 @@ h_dir: ?InstallDir, pub fn create(builder: *std.Build, artifact: *CompileStep) *InstallArtifactStep { if (artifact.install_step) |s| return s; - const self = builder.allocator.create(InstallArtifactStep) catch unreachable; + const self = builder.allocator.create(InstallArtifactStep) catch @panic("OOM"); self.* = InstallArtifactStep{ .builder = builder, .step = Step.init(.install_artifact, builder.fmt("install {s}", .{artifact.step.name}), builder.allocator, make), diff --git a/lib/std/Build/InstallRawStep.zig b/lib/std/Build/InstallRawStep.zig index e7ffe78878..014c44f287 100644 --- a/lib/std/Build/InstallRawStep.zig +++ b/lib/std/Build/InstallRawStep.zig @@ -44,7 +44,7 @@ pub fn create( dest_filename: []const u8, options: CreateOptions, ) *InstallRawStep { - const self = builder.allocator.create(InstallRawStep) catch unreachable; + const self = builder.allocator.create(InstallRawStep) catch @panic("OOM"); self.* = InstallRawStep{ .step = Step.init(.install_raw, builder.fmt("install raw binary {s}", .{artifact.step.name}), builder.allocator, make), .builder = builder, @@ -82,7 +82,7 @@ fn make(step: *Step) !void { const full_dest_path = b.getInstallPath(self.dest_dir, self.dest_filename); self.output_file.path = full_dest_path; - fs.cwd().makePath(b.getInstallPath(self.dest_dir, "")) catch unreachable; + try fs.cwd().makePath(b.getInstallPath(self.dest_dir, "")); var argv_list = std.ArrayList([]const u8).init(b.allocator); try argv_list.appendSlice(&.{ b.zig_exe, "objcopy" }); diff --git a/lib/std/Build/OptionsStep.zig b/lib/std/Build/OptionsStep.zig index 94c41ce9e6..a353737512 100644 --- a/lib/std/Build/OptionsStep.zig +++ b/lib/std/Build/OptionsStep.zig @@ -19,7 +19,7 @@ artifact_args: std.ArrayList(OptionArtifactArg), file_source_args: std.ArrayList(OptionFileSourceArg), pub fn create(builder: *std.Build) *OptionsStep { - const self = builder.allocator.create(OptionsStep) catch unreachable; + const self = builder.allocator.create(OptionsStep) catch @panic("OOM"); self.* = .{ .builder = builder, .step = Step.init(.options, "options", builder.allocator, make), @@ -34,44 +34,48 @@ pub fn create(builder: *std.Build) *OptionsStep { } pub fn addOption(self: *OptionsStep, comptime T: type, name: []const u8, value: T) void { + return addOptionFallible(self, T, name, value) catch @panic("unhandled error"); +} + +fn addOptionFallible(self: *OptionsStep, comptime T: type, name: []const u8, value: T) !void { const out = self.contents.writer(); switch (T) { []const []const u8 => { - out.print("pub const {}: []const []const u8 = &[_][]const u8{{\n", .{std.zig.fmtId(name)}) catch unreachable; + try out.print("pub const {}: []const []const u8 = &[_][]const u8{{\n", .{std.zig.fmtId(name)}); for (value) |slice| { - out.print(" \"{}\",\n", .{std.zig.fmtEscapes(slice)}) catch unreachable; + try out.print(" \"{}\",\n", .{std.zig.fmtEscapes(slice)}); } - out.writeAll("};\n") catch unreachable; + try out.writeAll("};\n"); return; }, [:0]const u8 => { - out.print("pub const {}: [:0]const u8 = \"{}\";\n", .{ std.zig.fmtId(name), std.zig.fmtEscapes(value) }) catch unreachable; + try out.print("pub const {}: [:0]const u8 = \"{}\";\n", .{ std.zig.fmtId(name), std.zig.fmtEscapes(value) }); return; }, []const u8 => { - out.print("pub const {}: []const u8 = \"{}\";\n", .{ std.zig.fmtId(name), std.zig.fmtEscapes(value) }) catch unreachable; + try out.print("pub const {}: []const u8 = \"{}\";\n", .{ std.zig.fmtId(name), std.zig.fmtEscapes(value) }); return; }, ?[:0]const u8 => { - out.print("pub const {}: ?[:0]const u8 = ", .{std.zig.fmtId(name)}) catch unreachable; + try out.print("pub const {}: ?[:0]const u8 = ", .{std.zig.fmtId(name)}); if (value) |payload| { - out.print("\"{}\";\n", .{std.zig.fmtEscapes(payload)}) catch unreachable; + try out.print("\"{}\";\n", .{std.zig.fmtEscapes(payload)}); } else { - out.writeAll("null;\n") catch unreachable; + try out.writeAll("null;\n"); } return; }, ?[]const u8 => { - out.print("pub const {}: ?[]const u8 = ", .{std.zig.fmtId(name)}) catch unreachable; + try out.print("pub const {}: ?[]const u8 = ", .{std.zig.fmtId(name)}); if (value) |payload| { - out.print("\"{}\";\n", .{std.zig.fmtEscapes(payload)}) catch unreachable; + try out.print("\"{}\";\n", .{std.zig.fmtEscapes(payload)}); } else { - out.writeAll("null;\n") catch unreachable; + try out.writeAll("null;\n"); } return; }, std.builtin.Version => { - out.print( + try out.print( \\pub const {}: @import("std").builtin.Version = .{{ \\ .major = {d}, \\ .minor = {d}, @@ -84,11 +88,11 @@ pub fn addOption(self: *OptionsStep, comptime T: type, name: []const u8, value: value.major, value.minor, value.patch, - }) catch unreachable; + }); return; }, std.SemanticVersion => { - out.print( + try out.print( \\pub const {}: @import("std").SemanticVersion = .{{ \\ .major = {d}, \\ .minor = {d}, @@ -100,38 +104,38 @@ pub fn addOption(self: *OptionsStep, comptime T: type, name: []const u8, value: value.major, value.minor, value.patch, - }) catch unreachable; + }); if (value.pre) |some| { - out.print(" .pre = \"{}\",\n", .{std.zig.fmtEscapes(some)}) catch unreachable; + try out.print(" .pre = \"{}\",\n", .{std.zig.fmtEscapes(some)}); } if (value.build) |some| { - out.print(" .build = \"{}\",\n", .{std.zig.fmtEscapes(some)}) catch unreachable; + try out.print(" .build = \"{}\",\n", .{std.zig.fmtEscapes(some)}); } - out.writeAll("};\n") catch unreachable; + try out.writeAll("};\n"); return; }, else => {}, } switch (@typeInfo(T)) { .Enum => |enum_info| { - out.print("pub const {} = enum {{\n", .{std.zig.fmtId(@typeName(T))}) catch unreachable; + try out.print("pub const {} = enum {{\n", .{std.zig.fmtId(@typeName(T))}); inline for (enum_info.fields) |field| { - out.print(" {},\n", .{std.zig.fmtId(field.name)}) catch unreachable; + try out.print(" {},\n", .{std.zig.fmtId(field.name)}); } - out.writeAll("};\n") catch unreachable; - out.print("pub const {}: {s} = {s}.{s};\n", .{ + try out.writeAll("};\n"); + try out.print("pub const {}: {s} = {s}.{s};\n", .{ std.zig.fmtId(name), std.zig.fmtId(@typeName(T)), std.zig.fmtId(@typeName(T)), std.zig.fmtId(@tagName(value)), - }) catch unreachable; + }); return; }, else => {}, } - out.print("pub const {}: {s} = ", .{ std.zig.fmtId(name), @typeName(T) }) catch unreachable; - printLiteral(out, value, 0) catch unreachable; - out.writeAll(";\n") catch unreachable; + try out.print("pub const {}: {s} = ", .{ std.zig.fmtId(name), @typeName(T) }); + try printLiteral(out, value, 0); + try out.writeAll(";\n"); } // TODO: non-recursive? @@ -189,14 +193,14 @@ pub fn addOptionFileSource( self.file_source_args.append(.{ .name = name, .source = source.dupe(self.builder), - }) catch unreachable; + }) catch @panic("OOM"); source.addStepDependencies(&self.step); } /// The value is the path in the cache dir. /// Adds a dependency automatically. pub fn addOptionArtifact(self: *OptionsStep, name: []const u8, artifact: *CompileStep) void { - self.artifact_args.append(.{ .name = self.builder.dupe(name), .artifact = artifact }) catch unreachable; + self.artifact_args.append(.{ .name = self.builder.dupe(name), .artifact = artifact }) catch @panic("OOM"); self.step.dependOn(&artifact.step); } diff --git a/lib/std/Build/RunStep.zig b/lib/std/Build/RunStep.zig index 9ab9ea6335..07f2363623 100644 --- a/lib/std/Build/RunStep.zig +++ b/lib/std/Build/RunStep.zig @@ -54,7 +54,7 @@ pub const Arg = union(enum) { }; pub fn create(builder: *std.Build, name: []const u8) *RunStep { - const self = builder.allocator.create(RunStep) catch unreachable; + const self = builder.allocator.create(RunStep) catch @panic("OOM"); self.* = RunStep{ .builder = builder, .step = Step.init(base_id, name, builder.allocator, make), @@ -67,19 +67,19 @@ pub fn create(builder: *std.Build, name: []const u8) *RunStep { } pub fn addArtifactArg(self: *RunStep, artifact: *CompileStep) void { - self.argv.append(Arg{ .artifact = artifact }) catch unreachable; + self.argv.append(Arg{ .artifact = artifact }) catch @panic("OOM"); self.step.dependOn(&artifact.step); } pub fn addFileSourceArg(self: *RunStep, file_source: std.Build.FileSource) void { self.argv.append(Arg{ .file_source = file_source.dupe(self.builder), - }) catch unreachable; + }) catch @panic("OOM"); file_source.addStepDependencies(&self.step); } pub fn addArg(self: *RunStep, arg: []const u8) void { - self.argv.append(Arg{ .bytes = self.builder.dupe(arg) }) catch unreachable; + self.argv.append(Arg{ .bytes = self.builder.dupe(arg) }) catch @panic("OOM"); } pub fn addArgs(self: *RunStep, args: []const []const u8) void { @@ -89,7 +89,7 @@ pub fn addArgs(self: *RunStep, args: []const []const u8) void { } pub fn clearEnvironment(self: *RunStep) void { - const new_env_map = self.builder.allocator.create(EnvMap) catch unreachable; + const new_env_map = self.builder.allocator.create(EnvMap) catch @panic("OOM"); new_env_map.* = EnvMap.init(self.builder.allocator); self.env_map = new_env_map; } @@ -107,9 +107,9 @@ pub fn addPathDirInternal(step: *Step, builder: *std.Build, search_path: []const if (prev_path) |pp| { const new_path = builder.fmt("{s}" ++ [1]u8{fs.path.delimiter} ++ "{s}", .{ pp, search_path }); - env_map.put(key, new_path) catch unreachable; + env_map.put(key, new_path) catch @panic("OOM"); } else { - env_map.put(key, builder.dupePath(search_path)) catch unreachable; + env_map.put(key, builder.dupePath(search_path)) catch @panic("OOM"); } } @@ -124,8 +124,8 @@ fn getEnvMapInternal(step: *Step, allocator: Allocator) *EnvMap { else => unreachable, }; return maybe_env_map orelse { - const env_map = allocator.create(EnvMap) catch unreachable; - env_map.* = process.getEnvMap(allocator) catch unreachable; + const env_map = allocator.create(EnvMap) catch @panic("OOM"); + env_map.* = process.getEnvMap(allocator) catch @panic("unhandled error"); switch (step.id) { .run => step.cast(RunStep).?.env_map = env_map, .emulatable_run => step.cast(RunStep).?.env_map = env_map, @@ -140,7 +140,7 @@ pub fn setEnvironmentVariable(self: *RunStep, key: []const u8, value: []const u8 env_map.put( self.builder.dupe(key), self.builder.dupe(value), - ) catch unreachable; + ) catch @panic("unhandled error"); } pub fn expectStdErrEqual(self: *RunStep, bytes: []const u8) void { @@ -234,7 +234,7 @@ pub fn runCommand( switch (stdout_action) { .expect_exact, .expect_matches => { - stdout = child.stdout.?.reader().readAllAlloc(builder.allocator, max_stdout_size) catch unreachable; + stdout = try child.stdout.?.reader().readAllAlloc(builder.allocator, max_stdout_size); }, .inherit, .ignore => {}, } @@ -244,7 +244,7 @@ pub fn runCommand( switch (stderr_action) { .expect_exact, .expect_matches => { - stderr = child.stderr.?.reader().readAllAlloc(builder.allocator, max_stdout_size) catch unreachable; + stderr = try child.stderr.?.reader().readAllAlloc(builder.allocator, max_stdout_size); }, .inherit, .ignore => {}, } diff --git a/lib/std/Build/Step.zig b/lib/std/Build/Step.zig index aff8a49161..ff0ceb2a51 100644 --- a/lib/std/Build/Step.zig +++ b/lib/std/Build/Step.zig @@ -57,7 +57,7 @@ pub fn init( ) Step { return Step{ .id = id, - .name = allocator.dupe(u8, name) catch unreachable, + .name = allocator.dupe(u8, name) catch @panic("OOM"), .makeFn = makeFn, .dependencies = std.ArrayList(*Step).init(allocator), .loop_flag = false, @@ -77,7 +77,7 @@ pub fn make(self: *Step) !void { } pub fn dependOn(self: *Step, other: *Step) void { - self.dependencies.append(other) catch unreachable; + self.dependencies.append(other) catch @panic("OOM"); } fn makeNoOp(self: *Step) anyerror!void { diff --git a/lib/std/Build/TranslateCStep.zig b/lib/std/Build/TranslateCStep.zig index c59362aeee..d9874142d8 100644 --- a/lib/std/Build/TranslateCStep.zig +++ b/lib/std/Build/TranslateCStep.zig @@ -28,7 +28,7 @@ pub const Options = struct { }; pub fn create(builder: *std.Build, options: Options) *TranslateCStep { - const self = builder.allocator.create(TranslateCStep) catch unreachable; + const self = builder.allocator.create(TranslateCStep) catch @panic("OOM"); const source = options.source_file.dupe(builder); self.* = TranslateCStep{ .step = Step.init(.translate_c, "translate-c", builder.allocator, make), @@ -67,7 +67,7 @@ pub fn addExecutable(self: *TranslateCStep, options: AddExecutableOptions) *Comp } pub fn addIncludeDir(self: *TranslateCStep, include_dir: []const u8) void { - self.include_dirs.append(self.builder.dupePath(include_dir)) catch unreachable; + self.include_dirs.append(self.builder.dupePath(include_dir)) catch @panic("OOM"); } pub fn addCheckFile(self: *TranslateCStep, expected_matches: []const []const u8) *CheckFileStep { @@ -78,12 +78,12 @@ pub fn addCheckFile(self: *TranslateCStep, expected_matches: []const []const u8) /// `name` and `value` need not live longer than the function call. pub fn defineCMacro(self: *TranslateCStep, name: []const u8, value: ?[]const u8) void { const macro = std.Build.constructCMacro(self.builder.allocator, name, value); - self.c_macros.append(macro) catch unreachable; + self.c_macros.append(macro) catch @panic("OOM"); } /// name_and_value looks like [name]=[value]. If the value is omitted, it is set to 1. pub fn defineCMacroRaw(self: *TranslateCStep, name_and_value: []const u8) void { - self.c_macros.append(self.builder.dupe(name_and_value)) catch unreachable; + self.c_macros.append(self.builder.dupe(name_and_value)) catch @panic("OOM"); } fn make(step: *Step) !void { @@ -129,8 +129,8 @@ fn make(step: *Step) !void { self.output_dir = fs.path.dirname(output_path).?; } - self.output_file.path = fs.path.join( + self.output_file.path = try fs.path.join( self.builder.allocator, &[_][]const u8{ self.output_dir.?, self.out_basename }, - ) catch unreachable; + ); } diff --git a/lib/std/Build/WriteFileStep.zig b/lib/std/Build/WriteFileStep.zig index 59ac568221..9e8fcdc203 100644 --- a/lib/std/Build/WriteFileStep.zig +++ b/lib/std/Build/WriteFileStep.zig @@ -28,7 +28,7 @@ pub fn init(builder: *std.Build) WriteFileStep { } pub fn add(self: *WriteFileStep, basename: []const u8, bytes: []const u8) void { - const node = self.builder.allocator.create(std.TailQueue(File).Node) catch unreachable; + const node = self.builder.allocator.create(std.TailQueue(File).Node) catch @panic("unhandled error"); node.* = .{ .data = .{ .source = std.Build.GeneratedFile{ .step = &self.step }, @@ -106,10 +106,10 @@ fn make(step: *Step) !void { }); return err; }; - node.data.source.path = fs.path.join( + node.data.source.path = try fs.path.join( self.builder.allocator, &[_][]const u8{ self.output_dir, node.data.basename }, - ) catch unreachable; + ); } } } From 2f5892671e49850070064f689a7d8f93d6a7a0dd Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 31 Jan 2023 14:56:35 -0700 Subject: [PATCH 56/84] move compiler's CType logic to std.Target This API only depends on std.Target and is extremely useful in build scripts when populating configure files. --- lib/std/target.zig | 553 +++++++++++++++++++++++++++++++++++++ src/Sema.zig | 2 +- src/codegen/c.zig | 1 - src/codegen/llvm.zig | 5 +- src/type.zig | 630 ++++--------------------------------------- 5 files changed, 601 insertions(+), 590 deletions(-) diff --git a/lib/std/target.zig b/lib/std/target.zig index 8ae175aac8..4429f8be2d 100644 --- a/lib/std/target.zig +++ b/lib/std/target.zig @@ -1880,6 +1880,559 @@ pub const Target = struct { => 16, }; } + + pub const CType = enum { + short, + ushort, + int, + uint, + long, + ulong, + longlong, + ulonglong, + float, + double, + longdouble, + }; + + pub fn c_type_byte_size(t: Target, c_type: CType) u16 { + return switch (c_type) { + .short, + .ushort, + .int, + .uint, + .long, + .ulong, + .longlong, + .ulonglong, + => @divExact(c_type_bit_size(t, c_type), 8), + + .float => 4, + .double => 8, + + .longdouble => switch (c_type_bit_size(t, c_type)) { + 16 => 2, + 32 => 4, + 64 => 8, + 80 => @intCast(u16, mem.alignForward(10, c_type_alignment(t, .longdouble))), + 128 => 16, + else => unreachable, + }, + }; + } + + pub fn c_type_bit_size(target: Target, c_type: CType) u16 { + switch (target.os.tag) { + .freestanding, .other => switch (target.cpu.arch) { + .msp430 => switch (c_type) { + .short, .ushort, .int, .uint => return 16, + .float, .long, .ulong => return 32, + .longlong, .ulonglong, .double, .longdouble => return 64, + }, + .avr => switch (c_type) { + .short, .ushort, .int, .uint => return 16, + .long, .ulong, .float, .double, .longdouble => return 32, + .longlong, .ulonglong => return 64, + }, + .tce, .tcele => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .long, .ulong, .longlong, .ulonglong => return 32, + .float, .double, .longdouble => return 32, + }, + .mips64, .mips64el => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .float => return 32, + .long, .ulong => return if (target.abi != .gnuabin32) 64 else 32, + .longlong, .ulonglong, .double => return 64, + .longdouble => return 128, + }, + .x86_64 => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .float => return 32, + .long, .ulong => switch (target.abi) { + .gnux32, .muslx32 => return 32, + else => return 64, + }, + .longlong, .ulonglong, .double => return 64, + .longdouble => return 80, + }, + else => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .float => return 32, + .long, .ulong => return target.cpu.arch.ptrBitWidth(), + .longlong, .ulonglong, .double => return 64, + .longdouble => switch (target.cpu.arch) { + .x86 => switch (target.abi) { + .android => return 64, + else => return 80, + }, + + .powerpc, + .powerpcle, + .powerpc64, + .powerpc64le, + => switch (target.abi) { + .musl, + .musleabi, + .musleabihf, + .muslx32, + => return 64, + else => return 128, + }, + + .riscv32, + .riscv64, + .aarch64, + .aarch64_be, + .aarch64_32, + .s390x, + .sparc, + .sparc64, + .sparcel, + .wasm32, + .wasm64, + => return 128, + + else => return 64, + }, + }, + }, + + .linux, + .freebsd, + .netbsd, + .dragonfly, + .openbsd, + .wasi, + .emscripten, + .plan9, + .solaris, + .haiku, + .ananas, + .fuchsia, + .minix, + => switch (target.cpu.arch) { + .msp430 => switch (c_type) { + .short, .ushort, .int, .uint => return 16, + .long, .ulong, .float => return 32, + .longlong, .ulonglong, .double, .longdouble => return 64, + }, + .avr => switch (c_type) { + .short, .ushort, .int, .uint => return 16, + .long, .ulong, .float, .double, .longdouble => return 32, + .longlong, .ulonglong => return 64, + }, + .tce, .tcele => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .long, .ulong, .longlong, .ulonglong => return 32, + .float, .double, .longdouble => return 32, + }, + .mips64, .mips64el => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .float => return 32, + .long, .ulong => return if (target.abi != .gnuabin32) 64 else 32, + .longlong, .ulonglong, .double => return 64, + .longdouble => if (target.os.tag == .freebsd) return 64 else return 128, + }, + .x86_64 => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .float => return 32, + .long, .ulong => switch (target.abi) { + .gnux32, .muslx32 => return 32, + else => return 64, + }, + .longlong, .ulonglong, .double => return 64, + .longdouble => return 80, + }, + else => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .float => return 32, + .long, .ulong => return target.cpu.arch.ptrBitWidth(), + .longlong, .ulonglong, .double => return 64, + .longdouble => switch (target.cpu.arch) { + .x86 => switch (target.abi) { + .android => return 64, + else => return 80, + }, + + .powerpc, + .powerpcle, + => switch (target.abi) { + .musl, + .musleabi, + .musleabihf, + .muslx32, + => return 64, + else => switch (target.os.tag) { + .freebsd, .netbsd, .openbsd => return 64, + else => return 128, + }, + }, + + .powerpc64, + .powerpc64le, + => switch (target.abi) { + .musl, + .musleabi, + .musleabihf, + .muslx32, + => return 64, + else => switch (target.os.tag) { + .freebsd, .openbsd => return 64, + else => return 128, + }, + }, + + .riscv32, + .riscv64, + .aarch64, + .aarch64_be, + .aarch64_32, + .s390x, + .mips64, + .mips64el, + .sparc, + .sparc64, + .sparcel, + .wasm32, + .wasm64, + => return 128, + + else => return 64, + }, + }, + }, + + .windows, .uefi => switch (target.cpu.arch) { + .x86 => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .float => return 32, + .long, .ulong => return 32, + .longlong, .ulonglong, .double => return 64, + .longdouble => switch (target.abi) { + .gnu, .gnuilp32, .cygnus => return 80, + else => return 64, + }, + }, + .x86_64 => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .float => return 32, + .long, .ulong => switch (target.abi) { + .cygnus => return 64, + else => return 32, + }, + .longlong, .ulonglong, .double => return 64, + .longdouble => switch (target.abi) { + .gnu, .gnuilp32, .cygnus => return 80, + else => return 64, + }, + }, + else => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .float => return 32, + .long, .ulong => return 32, + .longlong, .ulonglong, .double => return 64, + .longdouble => return 64, + }, + }, + + .macos, .ios, .tvos, .watchos => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .float => return 32, + .long, .ulong => switch (target.cpu.arch) { + .x86, .arm, .aarch64_32 => return 32, + .x86_64 => switch (target.abi) { + .gnux32, .muslx32 => return 32, + else => return 64, + }, + else => return 64, + }, + .longlong, .ulonglong, .double => return 64, + .longdouble => switch (target.cpu.arch) { + .x86 => switch (target.abi) { + .android => return 64, + else => return 80, + }, + .x86_64 => return 80, + else => return 64, + }, + }, + + .nvcl, .cuda => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .float => return 32, + .long, .ulong => switch (target.cpu.arch) { + .nvptx => return 32, + .nvptx64 => return 64, + else => return 64, + }, + .longlong, .ulonglong, .double => return 64, + .longdouble => return 64, + }, + + .amdhsa, .amdpal => switch (c_type) { + .short, .ushort => return 16, + .int, .uint, .float => return 32, + .long, .ulong, .longlong, .ulonglong, .double => return 64, + .longdouble => return 128, + }, + + .cloudabi, + .kfreebsd, + .lv2, + .zos, + .rtems, + .nacl, + .aix, + .ps4, + .ps5, + .elfiamcu, + .mesa3d, + .contiki, + .hermit, + .hurd, + .opencl, + .glsl450, + .vulkan, + .driverkit, + .shadermodel, + => @panic("TODO specify the C integer and float type sizes for this OS"), + } + } + + pub fn c_type_alignment(target: Target, c_type: CType) u16 { + // Overrides for unusual alignments + switch (target.cpu.arch) { + .avr => switch (c_type) { + .short, .ushort => return 2, + else => return 1, + }, + .x86 => switch (target.os.tag) { + .windows, .uefi => switch (c_type) { + .longlong, .ulonglong, .double => return 8, + .longdouble => switch (target.abi) { + .gnu, .gnuilp32, .cygnus => return 4, + else => return 8, + }, + else => {}, + }, + else => {}, + }, + else => {}, + } + + // Next-power-of-two-aligned, up to a maximum. + return @min( + std.math.ceilPowerOfTwoAssert(u16, (c_type_bit_size(target, c_type) + 7) / 8), + switch (target.cpu.arch) { + .arm, .armeb, .thumb, .thumbeb => switch (target.os.tag) { + .netbsd => switch (target.abi) { + .gnueabi, + .gnueabihf, + .eabi, + .eabihf, + .android, + .musleabi, + .musleabihf, + => 8, + + else => @as(u16, 4), + }, + .ios, .tvos, .watchos => 4, + else => 8, + }, + + .msp430, + .avr, + => 2, + + .arc, + .csky, + .x86, + .xcore, + .dxil, + .loongarch32, + .tce, + .tcele, + .le32, + .amdil, + .hsail, + .spir, + .spirv32, + .kalimba, + .shave, + .renderscript32, + .ve, + .spu_2, + => 4, + + .aarch64_32, + .amdgcn, + .amdil64, + .bpfel, + .bpfeb, + .hexagon, + .hsail64, + .loongarch64, + .m68k, + .mips, + .mipsel, + .sparc, + .sparcel, + .sparc64, + .lanai, + .le64, + .nvptx, + .nvptx64, + .r600, + .s390x, + .spir64, + .spirv64, + .renderscript64, + => 8, + + .aarch64, + .aarch64_be, + .mips64, + .mips64el, + .powerpc, + .powerpcle, + .powerpc64, + .powerpc64le, + .riscv32, + .riscv64, + .x86_64, + .wasm32, + .wasm64, + => 16, + }, + ); + } + + pub fn c_type_preferred_alignment(target: Target, c_type: CType) u16 { + // Overrides for unusual alignments + switch (target.cpu.arch) { + .arm, .armeb, .thumb, .thumbeb => switch (target.os.tag) { + .netbsd => switch (target.abi) { + .gnueabi, + .gnueabihf, + .eabi, + .eabihf, + .android, + .musleabi, + .musleabihf, + => {}, + + else => switch (c_type) { + .longdouble => return 4, + else => {}, + }, + }, + .ios, .tvos, .watchos => switch (c_type) { + .longdouble => return 4, + else => {}, + }, + else => {}, + }, + .arc => switch (c_type) { + .longdouble => return 4, + else => {}, + }, + .avr => switch (c_type) { + .int, .uint, .long, .ulong, .float, .longdouble => return 1, + .short, .ushort => return 2, + .double => return 4, + .longlong, .ulonglong => return 8, + }, + .x86 => switch (target.os.tag) { + .windows, .uefi => switch (c_type) { + .longdouble => switch (target.abi) { + .gnu, .gnuilp32, .cygnus => return 4, + else => return 8, + }, + else => {}, + }, + else => switch (c_type) { + .longdouble => return 4, + else => {}, + }, + }, + else => {}, + } + + // Next-power-of-two-aligned, up to a maximum. + return @min( + std.math.ceilPowerOfTwoAssert(u16, (c_type_bit_size(target, c_type) + 7) / 8), + switch (target.cpu.arch) { + .msp430 => @as(u16, 2), + + .csky, + .xcore, + .dxil, + .loongarch32, + .tce, + .tcele, + .le32, + .amdil, + .hsail, + .spir, + .spirv32, + .kalimba, + .shave, + .renderscript32, + .ve, + .spu_2, + => 4, + + .arc, + .arm, + .armeb, + .avr, + .thumb, + .thumbeb, + .aarch64_32, + .amdgcn, + .amdil64, + .bpfel, + .bpfeb, + .hexagon, + .hsail64, + .x86, + .loongarch64, + .m68k, + .mips, + .mipsel, + .sparc, + .sparcel, + .sparc64, + .lanai, + .le64, + .nvptx, + .nvptx64, + .r600, + .s390x, + .spir64, + .spirv64, + .renderscript64, + => 8, + + .aarch64, + .aarch64_be, + .mips64, + .mips64el, + .powerpc, + .powerpcle, + .powerpc64, + .powerpc64le, + .riscv32, + .riscv64, + .x86_64, + .wasm32, + .wasm64, + => 16, + }, + ); + } }; test { diff --git a/src/Sema.zig b/src/Sema.zig index 7448fd149c..87be3de7be 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -26076,7 +26076,7 @@ fn coerceVarArgParam( .Array => return sema.fail(block, inst_src, "arrays must be passed by reference to variadic function", .{}), .Float => float: { const target = sema.mod.getTarget(); - const double_bits = @import("type.zig").CType.sizeInBits(.double, target); + const double_bits = target.c_type_bit_size(.double); const inst_bits = uncasted_ty.floatBits(sema.mod.getTarget()); if (inst_bits >= double_bits) break :float inst; switch (double_bits) { diff --git a/src/codegen/c.zig b/src/codegen/c.zig index eb0ae1b1f6..2f721e1b4b 100644 --- a/src/codegen/c.zig +++ b/src/codegen/c.zig @@ -16,7 +16,6 @@ const trace = @import("../tracy.zig").trace; const LazySrcLoc = Module.LazySrcLoc; const Air = @import("../Air.zig"); const Liveness = @import("../Liveness.zig"); -const CType = @import("../type.zig").CType; const target_util = @import("../target.zig"); const libcFloatPrefix = target_util.libcFloatPrefix; diff --git a/src/codegen/llvm.zig b/src/codegen/llvm.zig index c528abdd7c..e19c70f322 100644 --- a/src/codegen/llvm.zig +++ b/src/codegen/llvm.zig @@ -19,7 +19,6 @@ const Liveness = @import("../Liveness.zig"); const Value = @import("../value.zig").Value; const Type = @import("../type.zig").Type; const LazySrcLoc = Module.LazySrcLoc; -const CType = @import("../type.zig").CType; const x86_64_abi = @import("../arch/x86_64/abi.zig"); const wasm_c_abi = @import("../arch/wasm/abi.zig"); const aarch64_c_abi = @import("../arch/aarch64/abi.zig"); @@ -11043,8 +11042,8 @@ fn backendSupportsF128(target: std.Target) bool { fn intrinsicsAllowed(scalar_ty: Type, target: std.Target) bool { return switch (scalar_ty.tag()) { .f16 => backendSupportsF16(target), - .f80 => (CType.longdouble.sizeInBits(target) == 80) and backendSupportsF80(target), - .f128 => (CType.longdouble.sizeInBits(target) == 128) and backendSupportsF128(target), + .f80 => (target.c_type_bit_size(.longdouble) == 80) and backendSupportsF80(target), + .f128 => (target.c_type_bit_size(.longdouble) == 128) and backendSupportsF128(target), else => true, }; } diff --git a/src/type.zig b/src/type.zig index c675cd225d..a13e30cb4c 100644 --- a/src/type.zig +++ b/src/type.zig @@ -2937,24 +2937,24 @@ pub const Type = extern union { .anyframe_T, => return AbiAlignmentAdvanced{ .scalar = @divExact(target.cpu.arch.ptrBitWidth(), 8) }, - .c_short => return AbiAlignmentAdvanced{ .scalar = CType.short.alignment(target) }, - .c_ushort => return AbiAlignmentAdvanced{ .scalar = CType.ushort.alignment(target) }, - .c_int => return AbiAlignmentAdvanced{ .scalar = CType.int.alignment(target) }, - .c_uint => return AbiAlignmentAdvanced{ .scalar = CType.uint.alignment(target) }, - .c_long => return AbiAlignmentAdvanced{ .scalar = CType.long.alignment(target) }, - .c_ulong => return AbiAlignmentAdvanced{ .scalar = CType.ulong.alignment(target) }, - .c_longlong => return AbiAlignmentAdvanced{ .scalar = CType.longlong.alignment(target) }, - .c_ulonglong => return AbiAlignmentAdvanced{ .scalar = CType.ulonglong.alignment(target) }, - .c_longdouble => return AbiAlignmentAdvanced{ .scalar = CType.longdouble.alignment(target) }, + .c_short => return AbiAlignmentAdvanced{ .scalar = target.c_type_alignment(.short) }, + .c_ushort => return AbiAlignmentAdvanced{ .scalar = target.c_type_alignment(.ushort) }, + .c_int => return AbiAlignmentAdvanced{ .scalar = target.c_type_alignment(.int) }, + .c_uint => return AbiAlignmentAdvanced{ .scalar = target.c_type_alignment(.uint) }, + .c_long => return AbiAlignmentAdvanced{ .scalar = target.c_type_alignment(.long) }, + .c_ulong => return AbiAlignmentAdvanced{ .scalar = target.c_type_alignment(.ulong) }, + .c_longlong => return AbiAlignmentAdvanced{ .scalar = target.c_type_alignment(.longlong) }, + .c_ulonglong => return AbiAlignmentAdvanced{ .scalar = target.c_type_alignment(.ulonglong) }, + .c_longdouble => return AbiAlignmentAdvanced{ .scalar = target.c_type_alignment(.longdouble) }, .f16 => return AbiAlignmentAdvanced{ .scalar = 2 }, - .f32 => return AbiAlignmentAdvanced{ .scalar = CType.float.alignment(target) }, - .f64 => switch (CType.double.sizeInBits(target)) { - 64 => return AbiAlignmentAdvanced{ .scalar = CType.double.alignment(target) }, + .f32 => return AbiAlignmentAdvanced{ .scalar = target.c_type_alignment(.float) }, + .f64 => switch (target.c_type_bit_size(.double)) { + 64 => return AbiAlignmentAdvanced{ .scalar = target.c_type_alignment(.double) }, else => return AbiAlignmentAdvanced{ .scalar = 8 }, }, - .f80 => switch (CType.longdouble.sizeInBits(target)) { - 80 => return AbiAlignmentAdvanced{ .scalar = CType.longdouble.alignment(target) }, + .f80 => switch (target.c_type_bit_size(.longdouble)) { + 80 => return AbiAlignmentAdvanced{ .scalar = target.c_type_alignment(.longdouble) }, else => { var payload: Payload.Bits = .{ .base = .{ .tag = .int_unsigned }, @@ -2964,8 +2964,8 @@ pub const Type = extern union { return AbiAlignmentAdvanced{ .scalar = abiAlignment(u80_ty, target) }; }, }, - .f128 => switch (CType.longdouble.sizeInBits(target)) { - 128 => return AbiAlignmentAdvanced{ .scalar = CType.longdouble.alignment(target) }, + .f128 => switch (target.c_type_bit_size(.longdouble)) { + 128 => return AbiAlignmentAdvanced{ .scalar = target.c_type_alignment(.longdouble) }, else => return AbiAlignmentAdvanced{ .scalar = 16 }, }, @@ -3434,21 +3434,22 @@ pub const Type = extern union { else => return AbiSizeAdvanced{ .scalar = @divExact(target.cpu.arch.ptrBitWidth(), 8) }, }, - .c_short => return AbiSizeAdvanced{ .scalar = @divExact(CType.short.sizeInBits(target), 8) }, - .c_ushort => return AbiSizeAdvanced{ .scalar = @divExact(CType.ushort.sizeInBits(target), 8) }, - .c_int => return AbiSizeAdvanced{ .scalar = @divExact(CType.int.sizeInBits(target), 8) }, - .c_uint => return AbiSizeAdvanced{ .scalar = @divExact(CType.uint.sizeInBits(target), 8) }, - .c_long => return AbiSizeAdvanced{ .scalar = @divExact(CType.long.sizeInBits(target), 8) }, - .c_ulong => return AbiSizeAdvanced{ .scalar = @divExact(CType.ulong.sizeInBits(target), 8) }, - .c_longlong => return AbiSizeAdvanced{ .scalar = @divExact(CType.longlong.sizeInBits(target), 8) }, - .c_ulonglong => return AbiSizeAdvanced{ .scalar = @divExact(CType.ulonglong.sizeInBits(target), 8) }, + .c_short => return AbiSizeAdvanced{ .scalar = target.c_type_byte_size(.short) }, + .c_ushort => return AbiSizeAdvanced{ .scalar = target.c_type_byte_size(.ushort) }, + .c_int => return AbiSizeAdvanced{ .scalar = target.c_type_byte_size(.int) }, + .c_uint => return AbiSizeAdvanced{ .scalar = target.c_type_byte_size(.uint) }, + .c_long => return AbiSizeAdvanced{ .scalar = target.c_type_byte_size(.long) }, + .c_ulong => return AbiSizeAdvanced{ .scalar = target.c_type_byte_size(.ulong) }, + .c_longlong => return AbiSizeAdvanced{ .scalar = target.c_type_byte_size(.longlong) }, + .c_ulonglong => return AbiSizeAdvanced{ .scalar = target.c_type_byte_size(.ulonglong) }, + .c_longdouble => return AbiSizeAdvanced{ .scalar = target.c_type_byte_size(.longdouble) }, .f16 => return AbiSizeAdvanced{ .scalar = 2 }, .f32 => return AbiSizeAdvanced{ .scalar = 4 }, .f64 => return AbiSizeAdvanced{ .scalar = 8 }, .f128 => return AbiSizeAdvanced{ .scalar = 16 }, - .f80 => switch (CType.longdouble.sizeInBits(target)) { - 80 => return AbiSizeAdvanced{ .scalar = std.mem.alignForward(10, CType.longdouble.alignment(target)) }, + .f80 => switch (target.c_type_bit_size(.longdouble)) { + 80 => return AbiSizeAdvanced{ .scalar = target.c_type_byte_size(.longdouble) }, else => { var payload: Payload.Bits = .{ .base = .{ .tag = .int_unsigned }, @@ -3458,14 +3459,6 @@ pub const Type = extern union { return AbiSizeAdvanced{ .scalar = abiSize(u80_ty, target) }; }, }, - .c_longdouble => switch (CType.longdouble.sizeInBits(target)) { - 16 => return AbiSizeAdvanced{ .scalar = abiSize(Type.f16, target) }, - 32 => return AbiSizeAdvanced{ .scalar = abiSize(Type.f32, target) }, - 64 => return AbiSizeAdvanced{ .scalar = abiSize(Type.f64, target) }, - 80 => return AbiSizeAdvanced{ .scalar = abiSize(Type.f80, target) }, - 128 => return AbiSizeAdvanced{ .scalar = abiSize(Type.f128, target) }, - else => unreachable, - }, // TODO revisit this when we have the concept of the error tag type .anyerror_void_error_union, @@ -3748,15 +3741,15 @@ pub const Type = extern union { .manyptr_const_u8_sentinel_0, => return target.cpu.arch.ptrBitWidth(), - .c_short => return CType.short.sizeInBits(target), - .c_ushort => return CType.ushort.sizeInBits(target), - .c_int => return CType.int.sizeInBits(target), - .c_uint => return CType.uint.sizeInBits(target), - .c_long => return CType.long.sizeInBits(target), - .c_ulong => return CType.ulong.sizeInBits(target), - .c_longlong => return CType.longlong.sizeInBits(target), - .c_ulonglong => return CType.ulonglong.sizeInBits(target), - .c_longdouble => return CType.longdouble.sizeInBits(target), + .c_short => return target.c_type_bit_size(.short), + .c_ushort => return target.c_type_bit_size(.ushort), + .c_int => return target.c_type_bit_size(.int), + .c_uint => return target.c_type_bit_size(.uint), + .c_long => return target.c_type_bit_size(.long), + .c_ulong => return target.c_type_bit_size(.ulong), + .c_longlong => return target.c_type_bit_size(.longlong), + .c_ulonglong => return target.c_type_bit_size(.ulonglong), + .c_longdouble => return target.c_type_bit_size(.longdouble), .error_set, .error_set_single, @@ -4631,14 +4624,14 @@ pub const Type = extern union { .i128 => return .{ .signedness = .signed, .bits = 128 }, .usize => return .{ .signedness = .unsigned, .bits = target.cpu.arch.ptrBitWidth() }, .isize => return .{ .signedness = .signed, .bits = target.cpu.arch.ptrBitWidth() }, - .c_short => return .{ .signedness = .signed, .bits = CType.short.sizeInBits(target) }, - .c_ushort => return .{ .signedness = .unsigned, .bits = CType.ushort.sizeInBits(target) }, - .c_int => return .{ .signedness = .signed, .bits = CType.int.sizeInBits(target) }, - .c_uint => return .{ .signedness = .unsigned, .bits = CType.uint.sizeInBits(target) }, - .c_long => return .{ .signedness = .signed, .bits = CType.long.sizeInBits(target) }, - .c_ulong => return .{ .signedness = .unsigned, .bits = CType.ulong.sizeInBits(target) }, - .c_longlong => return .{ .signedness = .signed, .bits = CType.longlong.sizeInBits(target) }, - .c_ulonglong => return .{ .signedness = .unsigned, .bits = CType.ulonglong.sizeInBits(target) }, + .c_short => return .{ .signedness = .signed, .bits = target.c_type_bit_size(.short) }, + .c_ushort => return .{ .signedness = .unsigned, .bits = target.c_type_bit_size(.ushort) }, + .c_int => return .{ .signedness = .signed, .bits = target.c_type_bit_size(.int) }, + .c_uint => return .{ .signedness = .unsigned, .bits = target.c_type_bit_size(.uint) }, + .c_long => return .{ .signedness = .signed, .bits = target.c_type_bit_size(.long) }, + .c_ulong => return .{ .signedness = .unsigned, .bits = target.c_type_bit_size(.ulong) }, + .c_longlong => return .{ .signedness = .signed, .bits = target.c_type_bit_size(.longlong) }, + .c_ulonglong => return .{ .signedness = .unsigned, .bits = target.c_type_bit_size(.ulonglong) }, .enum_full, .enum_nonexhaustive => ty = ty.cast(Payload.EnumFull).?.data.tag_ty, .enum_numbered => ty = ty.castTag(.enum_numbered).?.data.tag_ty, @@ -4724,7 +4717,7 @@ pub const Type = extern union { .f64 => 64, .f80 => 80, .f128, .comptime_float => 128, - .c_longdouble => CType.longdouble.sizeInBits(target), + .c_longdouble => target.c_type_bit_size(.longdouble), else => unreachable, }; @@ -6689,536 +6682,3 @@ pub const Type = extern union { /// to packed struct layout to find out all the places in the codebase you need to edit! pub const packed_struct_layout_version = 2; }; - -pub const CType = enum { - short, - ushort, - int, - uint, - long, - ulong, - longlong, - ulonglong, - longdouble, - - // We don't have a `c_float`/`c_double` type in Zig, but these - // are useful for querying target-correct alignment and checking - // whether C's double is f64 or f32 - float, - double, - - pub fn sizeInBits(self: CType, target: Target) u16 { - switch (target.os.tag) { - .freestanding, .other => switch (target.cpu.arch) { - .msp430 => switch (self) { - .short, .ushort, .int, .uint => return 16, - .float, .long, .ulong => return 32, - .longlong, .ulonglong, .double, .longdouble => return 64, - }, - .avr => switch (self) { - .short, .ushort, .int, .uint => return 16, - .long, .ulong, .float, .double, .longdouble => return 32, - .longlong, .ulonglong => return 64, - }, - .tce, .tcele => switch (self) { - .short, .ushort => return 16, - .int, .uint, .long, .ulong, .longlong, .ulonglong => return 32, - .float, .double, .longdouble => return 32, - }, - .mips64, .mips64el => switch (self) { - .short, .ushort => return 16, - .int, .uint, .float => return 32, - .long, .ulong => return if (target.abi != .gnuabin32) 64 else 32, - .longlong, .ulonglong, .double => return 64, - .longdouble => return 128, - }, - .x86_64 => switch (self) { - .short, .ushort => return 16, - .int, .uint, .float => return 32, - .long, .ulong => switch (target.abi) { - .gnux32, .muslx32 => return 32, - else => return 64, - }, - .longlong, .ulonglong, .double => return 64, - .longdouble => return 80, - }, - else => switch (self) { - .short, .ushort => return 16, - .int, .uint, .float => return 32, - .long, .ulong => return target.cpu.arch.ptrBitWidth(), - .longlong, .ulonglong, .double => return 64, - .longdouble => switch (target.cpu.arch) { - .x86 => switch (target.abi) { - .android => return 64, - else => return 80, - }, - - .powerpc, - .powerpcle, - .powerpc64, - .powerpc64le, - => switch (target.abi) { - .musl, - .musleabi, - .musleabihf, - .muslx32, - => return 64, - else => return 128, - }, - - .riscv32, - .riscv64, - .aarch64, - .aarch64_be, - .aarch64_32, - .s390x, - .sparc, - .sparc64, - .sparcel, - .wasm32, - .wasm64, - => return 128, - - else => return 64, - }, - }, - }, - - .linux, - .freebsd, - .netbsd, - .dragonfly, - .openbsd, - .wasi, - .emscripten, - .plan9, - .solaris, - .haiku, - .ananas, - .fuchsia, - .minix, - => switch (target.cpu.arch) { - .msp430 => switch (self) { - .short, .ushort, .int, .uint => return 16, - .long, .ulong, .float => return 32, - .longlong, .ulonglong, .double, .longdouble => return 64, - }, - .avr => switch (self) { - .short, .ushort, .int, .uint => return 16, - .long, .ulong, .float, .double, .longdouble => return 32, - .longlong, .ulonglong => return 64, - }, - .tce, .tcele => switch (self) { - .short, .ushort => return 16, - .int, .uint, .long, .ulong, .longlong, .ulonglong => return 32, - .float, .double, .longdouble => return 32, - }, - .mips64, .mips64el => switch (self) { - .short, .ushort => return 16, - .int, .uint, .float => return 32, - .long, .ulong => return if (target.abi != .gnuabin32) 64 else 32, - .longlong, .ulonglong, .double => return 64, - .longdouble => if (target.os.tag == .freebsd) return 64 else return 128, - }, - .x86_64 => switch (self) { - .short, .ushort => return 16, - .int, .uint, .float => return 32, - .long, .ulong => switch (target.abi) { - .gnux32, .muslx32 => return 32, - else => return 64, - }, - .longlong, .ulonglong, .double => return 64, - .longdouble => return 80, - }, - else => switch (self) { - .short, .ushort => return 16, - .int, .uint, .float => return 32, - .long, .ulong => return target.cpu.arch.ptrBitWidth(), - .longlong, .ulonglong, .double => return 64, - .longdouble => switch (target.cpu.arch) { - .x86 => switch (target.abi) { - .android => return 64, - else => return 80, - }, - - .powerpc, - .powerpcle, - => switch (target.abi) { - .musl, - .musleabi, - .musleabihf, - .muslx32, - => return 64, - else => switch (target.os.tag) { - .freebsd, .netbsd, .openbsd => return 64, - else => return 128, - }, - }, - - .powerpc64, - .powerpc64le, - => switch (target.abi) { - .musl, - .musleabi, - .musleabihf, - .muslx32, - => return 64, - else => switch (target.os.tag) { - .freebsd, .openbsd => return 64, - else => return 128, - }, - }, - - .riscv32, - .riscv64, - .aarch64, - .aarch64_be, - .aarch64_32, - .s390x, - .mips64, - .mips64el, - .sparc, - .sparc64, - .sparcel, - .wasm32, - .wasm64, - => return 128, - - else => return 64, - }, - }, - }, - - .windows, .uefi => switch (target.cpu.arch) { - .x86 => switch (self) { - .short, .ushort => return 16, - .int, .uint, .float => return 32, - .long, .ulong => return 32, - .longlong, .ulonglong, .double => return 64, - .longdouble => switch (target.abi) { - .gnu, .gnuilp32, .cygnus => return 80, - else => return 64, - }, - }, - .x86_64 => switch (self) { - .short, .ushort => return 16, - .int, .uint, .float => return 32, - .long, .ulong => switch (target.abi) { - .cygnus => return 64, - else => return 32, - }, - .longlong, .ulonglong, .double => return 64, - .longdouble => switch (target.abi) { - .gnu, .gnuilp32, .cygnus => return 80, - else => return 64, - }, - }, - else => switch (self) { - .short, .ushort => return 16, - .int, .uint, .float => return 32, - .long, .ulong => return 32, - .longlong, .ulonglong, .double => return 64, - .longdouble => return 64, - }, - }, - - .macos, .ios, .tvos, .watchos => switch (self) { - .short, .ushort => return 16, - .int, .uint, .float => return 32, - .long, .ulong => switch (target.cpu.arch) { - .x86, .arm, .aarch64_32 => return 32, - .x86_64 => switch (target.abi) { - .gnux32, .muslx32 => return 32, - else => return 64, - }, - else => return 64, - }, - .longlong, .ulonglong, .double => return 64, - .longdouble => switch (target.cpu.arch) { - .x86 => switch (target.abi) { - .android => return 64, - else => return 80, - }, - .x86_64 => return 80, - else => return 64, - }, - }, - - .nvcl, .cuda => switch (self) { - .short, .ushort => return 16, - .int, .uint, .float => return 32, - .long, .ulong => switch (target.cpu.arch) { - .nvptx => return 32, - .nvptx64 => return 64, - else => return 64, - }, - .longlong, .ulonglong, .double => return 64, - .longdouble => return 64, - }, - - .amdhsa, .amdpal => switch (self) { - .short, .ushort => return 16, - .int, .uint, .float => return 32, - .long, .ulong, .longlong, .ulonglong, .double => return 64, - .longdouble => return 128, - }, - - .cloudabi, - .kfreebsd, - .lv2, - .zos, - .rtems, - .nacl, - .aix, - .ps4, - .ps5, - .elfiamcu, - .mesa3d, - .contiki, - .hermit, - .hurd, - .opencl, - .glsl450, - .vulkan, - .driverkit, - .shadermodel, - => @panic("TODO specify the C integer and float type sizes for this OS"), - } - } - - pub fn alignment(self: CType, target: Target) u16 { - - // Overrides for unusual alignments - switch (target.cpu.arch) { - .avr => switch (self) { - .short, .ushort => return 2, - else => return 1, - }, - .x86 => switch (target.os.tag) { - .windows, .uefi => switch (self) { - .longlong, .ulonglong, .double => return 8, - .longdouble => switch (target.abi) { - .gnu, .gnuilp32, .cygnus => return 4, - else => return 8, - }, - else => {}, - }, - else => {}, - }, - else => {}, - } - - // Next-power-of-two-aligned, up to a maximum. - return @min( - std.math.ceilPowerOfTwoAssert(u16, (self.sizeInBits(target) + 7) / 8), - switch (target.cpu.arch) { - .arm, .armeb, .thumb, .thumbeb => switch (target.os.tag) { - .netbsd => switch (target.abi) { - .gnueabi, - .gnueabihf, - .eabi, - .eabihf, - .android, - .musleabi, - .musleabihf, - => 8, - - else => @as(u16, 4), - }, - .ios, .tvos, .watchos => 4, - else => 8, - }, - - .msp430, - .avr, - => 2, - - .arc, - .csky, - .x86, - .xcore, - .dxil, - .loongarch32, - .tce, - .tcele, - .le32, - .amdil, - .hsail, - .spir, - .spirv32, - .kalimba, - .shave, - .renderscript32, - .ve, - .spu_2, - => 4, - - .aarch64_32, - .amdgcn, - .amdil64, - .bpfel, - .bpfeb, - .hexagon, - .hsail64, - .loongarch64, - .m68k, - .mips, - .mipsel, - .sparc, - .sparcel, - .sparc64, - .lanai, - .le64, - .nvptx, - .nvptx64, - .r600, - .s390x, - .spir64, - .spirv64, - .renderscript64, - => 8, - - .aarch64, - .aarch64_be, - .mips64, - .mips64el, - .powerpc, - .powerpcle, - .powerpc64, - .powerpc64le, - .riscv32, - .riscv64, - .x86_64, - .wasm32, - .wasm64, - => 16, - }, - ); - } - - pub fn preferredAlignment(self: CType, target: Target) u16 { - - // Overrides for unusual alignments - switch (target.cpu.arch) { - .arm, .armeb, .thumb, .thumbeb => switch (target.os.tag) { - .netbsd => switch (target.abi) { - .gnueabi, - .gnueabihf, - .eabi, - .eabihf, - .android, - .musleabi, - .musleabihf, - => {}, - - else => switch (self) { - .longdouble => return 4, - else => {}, - }, - }, - .ios, .tvos, .watchos => switch (self) { - .longdouble => return 4, - else => {}, - }, - else => {}, - }, - .arc => switch (self) { - .longdouble => return 4, - else => {}, - }, - .avr => switch (self) { - .int, .uint, .long, .ulong, .float, .longdouble => return 1, - .short, .ushort => return 2, - .double => return 4, - .longlong, .ulonglong => return 8, - }, - .x86 => switch (target.os.tag) { - .windows, .uefi => switch (self) { - .longdouble => switch (target.abi) { - .gnu, .gnuilp32, .cygnus => return 4, - else => return 8, - }, - else => {}, - }, - else => switch (self) { - .longdouble => return 4, - else => {}, - }, - }, - else => {}, - } - - // Next-power-of-two-aligned, up to a maximum. - return @min( - std.math.ceilPowerOfTwoAssert(u16, (self.sizeInBits(target) + 7) / 8), - switch (target.cpu.arch) { - .msp430 => @as(u16, 2), - - .csky, - .xcore, - .dxil, - .loongarch32, - .tce, - .tcele, - .le32, - .amdil, - .hsail, - .spir, - .spirv32, - .kalimba, - .shave, - .renderscript32, - .ve, - .spu_2, - => 4, - - .arc, - .arm, - .armeb, - .avr, - .thumb, - .thumbeb, - .aarch64_32, - .amdgcn, - .amdil64, - .bpfel, - .bpfeb, - .hexagon, - .hsail64, - .x86, - .loongarch64, - .m68k, - .mips, - .mipsel, - .sparc, - .sparcel, - .sparc64, - .lanai, - .le64, - .nvptx, - .nvptx64, - .r600, - .s390x, - .spir64, - .spirv64, - .renderscript64, - => 8, - - .aarch64, - .aarch64_be, - .mips64, - .mips64el, - .powerpc, - .powerpcle, - .powerpc64, - .powerpc64le, - .riscv32, - .riscv64, - .x86_64, - .wasm32, - .wasm64, - => 16, - }, - ); - } -}; From 3c1fc3f566b4a0c4493187c7f07b5c401a3e3a1b Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 31 Jan 2023 14:57:20 -0700 Subject: [PATCH 57/84] std.Build.ConfigHeaderStep: support more types --- lib/std/Build/ConfigHeaderStep.zig | 76 +++++++++++++++++------------- 1 file changed, 44 insertions(+), 32 deletions(-) diff --git a/lib/std/Build/ConfigHeaderStep.zig b/lib/std/Build/ConfigHeaderStep.zig index b961227c9c..58a78b939d 100644 --- a/lib/std/Build/ConfigHeaderStep.zig +++ b/lib/std/Build/ConfigHeaderStep.zig @@ -61,39 +61,51 @@ pub fn addValues(self: *ConfigHeaderStep, values: anytype) void { fn addValuesInner(self: *ConfigHeaderStep, values: anytype) !void { inline for (@typeInfo(@TypeOf(values)).Struct.fields) |field| { - switch (@typeInfo(field.type)) { - .Null => { - try self.values.put(field.name, .undef); - }, - .Void => { - try self.values.put(field.name, .defined); - }, - .Bool => { - try self.values.put(field.name, .{ .boolean = @field(values, field.name) }); - }, - .ComptimeInt => { - try self.values.put(field.name, .{ .int = @field(values, field.name) }); - }, - .EnumLiteral => { - try self.values.put(field.name, .{ .ident = @tagName(@field(values, field.name)) }); - }, - .Pointer => |ptr| { - switch (@typeInfo(ptr.child)) { - .Array => |array| { - if (ptr.size == .One and array.child == u8) { - try self.values.put(field.name, .{ .string = @field(values, field.name) }); - continue; - } - }, - else => {}, - } + try putValue(self, field.name, field.type, @field(values, field.name)); + } +} - @compileError("unsupported ConfigHeaderStep value type: " ++ - @typeName(field.type)); - }, - else => @compileError("unsupported ConfigHeaderStep value type: " ++ - @typeName(field.type)), - } +fn putValue(self: *ConfigHeaderStep, field_name: []const u8, comptime T: type, v: T) !void { + switch (@typeInfo(T)) { + .Null => { + try self.values.put(field_name, .undef); + }, + .Void => { + try self.values.put(field_name, .defined); + }, + .Bool => { + try self.values.put(field_name, .{ .boolean = v }); + }, + .Int => { + try self.values.put(field_name, .{ .int = v }); + }, + .ComptimeInt => { + try self.values.put(field_name, .{ .int = v }); + }, + .EnumLiteral => { + try self.values.put(field_name, .{ .ident = @tagName(v) }); + }, + .Optional => { + if (v) |x| { + return putValue(self, field_name, @TypeOf(x), x); + } else { + try self.values.put(field_name, .undef); + } + }, + .Pointer => |ptr| { + switch (@typeInfo(ptr.child)) { + .Array => |array| { + if (ptr.size == .One and array.child == u8) { + try self.values.put(field_name, .{ .string = v }); + return; + } + }, + else => {}, + } + + @compileError("unsupported ConfigHeaderStep value type: " ++ @typeName(T)); + }, + else => @compileError("unsupported ConfigHeaderStep value type: " ++ @typeName(T)), } } From 7d14baec900efbbbae0ae25da79f976716241ec0 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 31 Jan 2023 15:00:26 -0700 Subject: [PATCH 58/84] tests: fix missing target for C ABI tests This regressed earlier in this branch. --- test/tests.zig | 1 + 1 file changed, 1 insertion(+) diff --git a/test/tests.zig b/test/tests.zig index 0f36c8eb94..94030ce851 100644 --- a/test/tests.zig +++ b/test/tests.zig @@ -1360,6 +1360,7 @@ pub fn addCAbiTests(b: *std.Build, skip_non_native: bool, skip_release: bool) *S const test_step = b.addTest(.{ .root_source_file = .{ .path = "test/c_abi/main.zig" }, .optimize = optimize_mode, + .target = c_abi_target, }); if (c_abi_target.abi != null and c_abi_target.abi.?.isMusl()) { // TODO NativeTargetInfo insists on dynamically linking musl From 8d37c6f71c790faecdb6acdd2868823be2bd2496 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Tue, 31 Jan 2023 15:34:08 -0700 Subject: [PATCH 59/84] std.Build.CompileStep: fix API usage in unit test --- lib/std/Build/CompileStep.zig | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/lib/std/Build/CompileStep.zig b/lib/std/Build/CompileStep.zig index 7396a5ce66..12c73bdba6 100644 --- a/lib/std/Build/CompileStep.zig +++ b/lib/std/Build/CompileStep.zig @@ -1970,7 +1970,10 @@ test "addPackage" { .dependencies = &[_]Pkg{pkg_dep}, }; - var exe = builder.addExecutable("not_an_executable", "/not/an/executable.zig"); + var exe = builder.addExecutable(.{ + .name = "not_an_executable", + .root_source_file = .{ .path = "/not/an/executable.zig" }, + }); exe.addPackage(pkg_top); try std.testing.expectEqual(@as(usize, 1), exe.packages.items.len); From 2ccff5115454bab4898bae3de88f5619310bc5c1 Mon Sep 17 00:00:00 2001 From: praschke Date: Tue, 31 Jan 2023 21:55:16 +0000 Subject: [PATCH 60/84] mingw: repair msvcrt-os build flags __LIBMSVCRT__ is still used and is distinct from __LIBMSVCRT_OS__ --- src/mingw.zig | 1 + 1 file changed, 1 insertion(+) diff --git a/src/mingw.zig b/src/mingw.zig index 1fee8e90a4..06880743c6 100644 --- a/src/mingw.zig +++ b/src/mingw.zig @@ -106,6 +106,7 @@ pub fn buildCRTFile(comp: *Compilation, crt_file: CRTFile) !void { .msvcrt_os_lib => { const extra_flags = try arena.dupe([]const u8, &[_][]const u8{ "-DHAVE_CONFIG_H", + "-D__LIBMSVCRT__", "-D__LIBMSVCRT_OS__", "-I", From 9fdc32c96e3961ae2f5287483c9638051df34180 Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Wed, 1 Feb 2023 09:13:49 +0100 Subject: [PATCH 61/84] link: clean up type resolution in Elf.Atom and MachO.Atom --- src/link/Coff/Atom.zig | 2 +- src/link/Elf/Atom.zig | 4 ++-- src/link/MachO/Atom.zig | 18 +++++++++--------- 3 files changed, 12 insertions(+), 12 deletions(-) diff --git a/src/link/Coff/Atom.zig b/src/link/Coff/Atom.zig index 1ee31cccaa..80c04a8fa1 100644 --- a/src/link/Coff/Atom.zig +++ b/src/link/Coff/Atom.zig @@ -119,7 +119,7 @@ pub fn addBaseRelocation(coff_file: *Coff, atom_index: Index, offset: u32) !void try gop.value_ptr.append(gpa, offset); } -pub fn freeRelocations(coff_file: *Coff, atom_index: Atom.Index) void { +pub fn freeRelocations(coff_file: *Coff, atom_index: Index) void { const gpa = coff_file.base.allocator; var removed_relocs = coff_file.relocs.fetchRemove(atom_index); if (removed_relocs) |*relocs| relocs.value.deinit(gpa); diff --git a/src/link/Elf/Atom.zig b/src/link/Elf/Atom.zig index 79b699636f..24cf19432c 100644 --- a/src/link/Elf/Atom.zig +++ b/src/link/Elf/Atom.zig @@ -20,8 +20,8 @@ offset_table_index: u32, /// Points to the previous and next neighbors, based on the `text_offset`. /// This can be used to find, for example, the capacity of this `TextBlock`. -prev_index: ?Atom.Index, -next_index: ?Atom.Index, +prev_index: ?Index, +next_index: ?Index, dbg_info_atom: Dwarf.Atom, diff --git a/src/link/MachO/Atom.zig b/src/link/MachO/Atom.zig index da0115d069..401d71813c 100644 --- a/src/link/MachO/Atom.zig +++ b/src/link/MachO/Atom.zig @@ -40,8 +40,8 @@ alignment: u32, /// Points to the previous and next neighbours /// TODO use the same trick as with symbols: reserve index 0 as null atom -next_index: ?Atom.Index, -prev_index: ?Atom.Index, +next_index: ?Index, +prev_index: ?Index, dbg_info_atom: Dwarf.Atom, @@ -119,13 +119,13 @@ pub fn freeListEligible(self: Atom, macho_file: *MachO) bool { return surplus >= MachO.min_text_capacity; } -pub fn addRelocation(macho_file: *MachO, atom_index: Atom.Index, reloc: Relocation) !void { +pub fn addRelocation(macho_file: *MachO, atom_index: Index, reloc: Relocation) !void { return addRelocations(macho_file, atom_index, 1, .{reloc}); } pub fn addRelocations( macho_file: *MachO, - atom_index: Atom.Index, + atom_index: Index, comptime count: comptime_int, relocs: [count]Relocation, ) !void { @@ -145,7 +145,7 @@ pub fn addRelocations( } } -pub fn addRebase(macho_file: *MachO, atom_index: Atom.Index, offset: u32) !void { +pub fn addRebase(macho_file: *MachO, atom_index: Index, offset: u32) !void { const gpa = macho_file.base.allocator; const atom = macho_file.getAtom(atom_index); log.debug(" (adding rebase at offset 0x{x} in %{?d})", .{ offset, atom.getSymbolIndex() }); @@ -156,7 +156,7 @@ pub fn addRebase(macho_file: *MachO, atom_index: Atom.Index, offset: u32) !void try gop.value_ptr.append(gpa, offset); } -pub fn addBinding(macho_file: *MachO, atom_index: Atom.Index, binding: Binding) !void { +pub fn addBinding(macho_file: *MachO, atom_index: Index, binding: Binding) !void { const gpa = macho_file.base.allocator; const atom = macho_file.getAtom(atom_index); log.debug(" (adding binding to symbol {s} at offset 0x{x} in %{?d})", .{ @@ -171,7 +171,7 @@ pub fn addBinding(macho_file: *MachO, atom_index: Atom.Index, binding: Binding) try gop.value_ptr.append(gpa, binding); } -pub fn addLazyBinding(macho_file: *MachO, atom_index: Atom.Index, binding: Binding) !void { +pub fn addLazyBinding(macho_file: *MachO, atom_index: Index, binding: Binding) !void { const gpa = macho_file.base.allocator; const atom = macho_file.getAtom(atom_index); log.debug(" (adding lazy binding to symbol {s} at offset 0x{x} in %{?d})", .{ @@ -186,7 +186,7 @@ pub fn addLazyBinding(macho_file: *MachO, atom_index: Atom.Index, binding: Bindi try gop.value_ptr.append(gpa, binding); } -pub fn resolveRelocations(macho_file: *MachO, atom_index: Atom.Index) !void { +pub fn resolveRelocations(macho_file: *MachO, atom_index: Index) !void { const atom = macho_file.getAtom(atom_index); const relocs = macho_file.relocs.get(atom_index) orelse return; const source_sym = atom.getSymbol(macho_file); @@ -203,7 +203,7 @@ pub fn resolveRelocations(macho_file: *MachO, atom_index: Atom.Index) !void { } } -pub fn freeRelocations(macho_file: *MachO, atom_index: Atom.Index) void { +pub fn freeRelocations(macho_file: *MachO, atom_index: Index) void { const gpa = macho_file.base.allocator; var removed_relocs = macho_file.relocs.fetchOrderedRemove(atom_index); if (removed_relocs) |*relocs| relocs.value.deinit(gpa); From b3277c893691c462ec2e82577a78e7baafb42bf6 Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Wed, 1 Feb 2023 11:12:53 +0100 Subject: [PATCH 62/84] link: make Plan9 atoms fully owned by the linker --- src/Module.zig | 4 +- src/Sema.zig | 2 +- src/arch/aarch64/CodeGen.zig | 11 +- src/arch/arm/CodeGen.zig | 5 +- src/arch/riscv64/CodeGen.zig | 5 +- src/arch/x86_64/CodeGen.zig | 11 +- src/link.zig | 4 +- src/link/Plan9.zig | 228 ++++++++++++++++++++++------------- 8 files changed, 170 insertions(+), 100 deletions(-) diff --git a/src/Module.zig b/src/Module.zig index b39fd2bab2..a914dc90d8 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -5277,7 +5277,7 @@ pub fn clearDecl( .coff => .{ .coff = {} }, .elf => .{ .elf = {} }, .macho => .{ .macho = {} }, - .plan9 => .{ .plan9 = link.File.Plan9.DeclBlock.empty }, + .plan9 => .{ .plan9 = {} }, .c => .{ .c = {} }, .wasm => .{ .wasm = link.File.Wasm.DeclBlock.empty }, .spirv => .{ .spirv = {} }, @@ -5697,7 +5697,7 @@ pub fn allocateNewDecl( .coff => .{ .coff = {} }, .elf => .{ .elf = {} }, .macho => .{ .macho = {} }, - .plan9 => .{ .plan9 = link.File.Plan9.DeclBlock.empty }, + .plan9 => .{ .plan9 = {} }, .c => .{ .c = {} }, .wasm => .{ .wasm = link.File.Wasm.DeclBlock.empty }, .spirv => .{ .spirv = {} }, diff --git a/src/Sema.zig b/src/Sema.zig index 82321ef545..e54bfc7bd9 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -5568,7 +5568,7 @@ pub fn analyzeExport( .coff => .{ .coff = {} }, .elf => .{ .elf = {} }, .macho => .{ .macho = {} }, - .plan9 => .{ .plan9 = null }, + .plan9 => .{ .plan9 = {} }, .c => .{ .c = {} }, .wasm => .{ .wasm = .{} }, .spirv => .{ .spirv = {} }, diff --git a/src/arch/aarch64/CodeGen.zig b/src/arch/aarch64/CodeGen.zig index d0fba2fd0e..aab30b73dc 100644 --- a/src/arch/aarch64/CodeGen.zig +++ b/src/arch/aarch64/CodeGen.zig @@ -4307,7 +4307,6 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier if (self.air.value(callee)) |func_value| { if (func_value.castTag(.function)) |func_payload| { const func = func_payload.data; - const fn_owner_decl = mod.declPtr(func.owner_decl); if (self.bin_file.cast(link.File.Elf)) |elf_file| { const atom_index = try elf_file.getOrCreateAtomForDecl(func.owner_decl); @@ -4333,11 +4332,12 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier }, }); } else if (self.bin_file.cast(link.File.Plan9)) |p9| { - try p9.seeDecl(func.owner_decl); + const decl_block_index = try p9.seeDecl(func.owner_decl); + const decl_block = p9.getDeclBlock(decl_block_index); const ptr_bits = self.target.cpu.arch.ptrBitWidth(); const ptr_bytes: u64 = @divExact(ptr_bits, 8); const got_addr = p9.bases.data; - const got_index = fn_owner_decl.link.plan9.got_index.?; + const got_index = decl_block.got_index.?; const fn_got_addr = got_addr + got_index * ptr_bytes; try self.genSetReg(Type.initTag(.usize), .x30, .{ .memory = fn_got_addr }); } else unreachable; @@ -6166,8 +6166,9 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne .sym_index = sym_index, } }; } else if (self.bin_file.cast(link.File.Plan9)) |p9| { - try p9.seeDecl(decl_index); - const got_addr = p9.bases.data + decl.link.plan9.got_index.? * ptr_bytes; + const decl_block_index = try p9.seeDecl(decl_index); + const decl_block = p9.getDeclBlock(decl_block_index); + const got_addr = p9.bases.data + decl_block.got_index.? * ptr_bytes; return MCValue{ .memory = got_addr }; } else { return self.fail("TODO codegen non-ELF const Decl pointer", .{}); diff --git a/src/arch/arm/CodeGen.zig b/src/arch/arm/CodeGen.zig index c6ee960e51..6574501767 100644 --- a/src/arch/arm/CodeGen.zig +++ b/src/arch/arm/CodeGen.zig @@ -6091,8 +6091,9 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne } else if (self.bin_file.cast(link.File.Coff)) |_| { return self.fail("TODO codegen COFF const Decl pointer", .{}); } else if (self.bin_file.cast(link.File.Plan9)) |p9| { - try p9.seeDecl(decl_index); - const got_addr = p9.bases.data + decl.link.plan9.got_index.? * ptr_bytes; + const decl_block_index = try p9.seeDecl(decl_index); + const decl_block = p9.getDeclBlock(decl_block_index); + const got_addr = p9.bases.data + decl_block.got_index.? * ptr_bytes; return MCValue{ .memory = got_addr }; } else { return self.fail("TODO codegen non-ELF const Decl pointer", .{}); diff --git a/src/arch/riscv64/CodeGen.zig b/src/arch/riscv64/CodeGen.zig index a0af1b3cce..423816c0b1 100644 --- a/src/arch/riscv64/CodeGen.zig +++ b/src/arch/riscv64/CodeGen.zig @@ -2558,8 +2558,9 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne } else if (self.bin_file.cast(link.File.Coff)) |_| { return self.fail("TODO codegen COFF const Decl pointer", .{}); } else if (self.bin_file.cast(link.File.Plan9)) |p9| { - try p9.seeDecl(decl_index); - const got_addr = p9.bases.data + decl.link.plan9.got_index.? * ptr_bytes; + const decl_block_index = try p9.seeDecl(decl_index); + const decl_block = p9.getDeclBlock(decl_block_index); + const got_addr = p9.bases.data + decl_block.got_index.? * ptr_bytes; return MCValue{ .memory = got_addr }; } else { return self.fail("TODO codegen non-ELF const Decl pointer", .{}); diff --git a/src/arch/x86_64/CodeGen.zig b/src/arch/x86_64/CodeGen.zig index b41973ea97..fcae7eaabc 100644 --- a/src/arch/x86_64/CodeGen.zig +++ b/src/arch/x86_64/CodeGen.zig @@ -3996,7 +3996,6 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier if (self.air.value(callee)) |func_value| { if (func_value.castTag(.function)) |func_payload| { const func = func_payload.data; - const fn_owner_decl = mod.declPtr(func.owner_decl); if (self.bin_file.cast(link.File.Elf)) |elf_file| { const atom_index = try elf_file.getOrCreateAtomForDecl(func.owner_decl); @@ -4042,11 +4041,12 @@ fn airCall(self: *Self, inst: Air.Inst.Index, modifier: std.builtin.CallModifier .data = undefined, }); } else if (self.bin_file.cast(link.File.Plan9)) |p9| { - try p9.seeDecl(func.owner_decl); + const decl_block_index = try p9.seeDecl(func.owner_decl); + const decl_block = p9.getDeclBlock(decl_block_index); const ptr_bits = self.target.cpu.arch.ptrBitWidth(); const ptr_bytes: u64 = @divExact(ptr_bits, 8); const got_addr = p9.bases.data; - const got_index = fn_owner_decl.link.plan9.got_index.?; + const got_index = decl_block.got_index.?; const fn_got_addr = got_addr + got_index * ptr_bytes; _ = try self.addInst(.{ .tag = .call, @@ -6739,8 +6739,9 @@ fn lowerDeclRef(self: *Self, tv: TypedValue, decl_index: Module.Decl.Index) Inne .sym_index = sym_index, } }; } else if (self.bin_file.cast(link.File.Plan9)) |p9| { - try p9.seeDecl(decl_index); - const got_addr = p9.bases.data + decl.link.plan9.got_index.? * ptr_bytes; + const decl_block_index = try p9.seeDecl(decl_index); + const decl_block = p9.getDeclBlock(decl_block_index); + const got_addr = p9.bases.data + decl_block.got_index.? * ptr_bytes; return MCValue{ .memory = got_addr }; } else { return self.fail("TODO codegen non-ELF const Decl pointer", .{}); diff --git a/src/link.zig b/src/link.zig index eb74615492..c0eacf88a0 100644 --- a/src/link.zig +++ b/src/link.zig @@ -265,7 +265,7 @@ pub const File = struct { elf: void, coff: void, macho: void, - plan9: Plan9.DeclBlock, + plan9: void, c: void, wasm: Wasm.DeclBlock, spirv: void, @@ -287,7 +287,7 @@ pub const File = struct { elf: void, coff: void, macho: void, - plan9: Plan9.Export, + plan9: void, c: void, wasm: Wasm.Export, spirv: void, diff --git a/src/link/Plan9.zig b/src/link/Plan9.zig index a8b8caafab..20f540022a 100644 --- a/src/link/Plan9.zig +++ b/src/link/Plan9.zig @@ -21,14 +21,7 @@ const Allocator = std.mem.Allocator; const log = std.log.scoped(.link); const assert = std.debug.assert; -const FnDeclOutput = struct { - /// this code is modified when relocated so it is mutable - code: []u8, - /// this might have to be modified in the linker, so thats why its mutable - lineinfo: []u8, - start_line: u32, - end_line: u32, -}; +pub const base_tag = .plan9; base: link.File, sixtyfour_bit: bool, @@ -101,6 +94,9 @@ got_index_free_list: std.ArrayListUnmanaged(usize) = .{}, syms_index_free_list: std.ArrayListUnmanaged(usize) = .{}, +decl_blocks: std.ArrayListUnmanaged(DeclBlock) = .{}, +decls: std.AutoHashMapUnmanaged(Module.Decl.Index, DeclMetadata) = .{}, + const Reloc = struct { target: Module.Decl.Index, offset: u64, @@ -115,6 +111,42 @@ const Bases = struct { const UnnamedConstTable = std.AutoHashMapUnmanaged(Module.Decl.Index, std.ArrayListUnmanaged(struct { info: DeclBlock, code: []const u8 })); +pub const PtrWidth = enum { p32, p64 }; + +pub const DeclBlock = struct { + type: aout.Sym.Type, + /// offset in the text or data sects + offset: ?u64, + /// offset into syms + sym_index: ?usize, + /// offset into got + got_index: ?usize, + + pub const Index = u32; +}; + +const DeclMetadata = struct { + index: DeclBlock.Index, + exports: std.ArrayListUnmanaged(usize) = .{}, + + fn getExport(m: DeclMetadata, p9: *const Plan9, name: []const u8) ?usize { + for (m.exports.items) |exp| { + const sym = p9.syms.items[exp]; + if (mem.eql(u8, name, sym.name)) return exp; + } + return null; + } +}; + +const FnDeclOutput = struct { + /// this code is modified when relocated so it is mutable + code: []u8, + /// this might have to be modified in the linker, so thats why its mutable + lineinfo: []u8, + start_line: u32, + end_line: u32, +}; + fn getAddr(self: Plan9, addr: u64, t: aout.Sym.Type) u64 { return addr + switch (t) { .T, .t, .l, .L => self.bases.text, @@ -127,22 +159,6 @@ fn getSymAddr(self: Plan9, s: aout.Sym) u64 { return self.getAddr(s.value, s.type); } -pub const DeclBlock = struct { - type: aout.Sym.Type, - /// offset in the text or data sects - offset: ?u64, - /// offset into syms - sym_index: ?usize, - /// offset into got - got_index: ?usize, - pub const empty = DeclBlock{ - .type = .t, - .offset = null, - .sym_index = null, - .got_index = null, - }; -}; - pub fn defaultBaseAddrs(arch: std.Target.Cpu.Arch) Bases { return switch (arch) { .x86_64 => .{ @@ -164,8 +180,6 @@ pub fn defaultBaseAddrs(arch: std.Target.Cpu.Arch) Bases { }; } -pub const PtrWidth = enum { p32, p64 }; - pub fn createEmpty(gpa: Allocator, options: link.Options) !*Plan9 { if (options.use_llvm) return error.LLVMBackendDoesNotSupportPlan9; @@ -271,7 +285,7 @@ pub fn updateFunc(self: *Plan9, module: *Module, func: *Module.Fn, air: Air, liv const decl = module.declPtr(decl_index); self.freeUnnamedConsts(decl_index); - try self.seeDecl(decl_index); + _ = try self.seeDecl(decl_index); log.debug("codegen decl {*} ({s})", .{ decl, decl.name }); var code_buffer = std.ArrayList(u8).init(self.base.allocator); @@ -313,11 +327,11 @@ pub fn updateFunc(self: *Plan9, module: *Module, func: *Module.Fn, air: Air, liv .end_line = end_line, }; try self.putFn(decl_index, out); - return self.updateFinish(decl); + return self.updateFinish(decl_index); } pub fn lowerUnnamedConst(self: *Plan9, tv: TypedValue, decl_index: Module.Decl.Index) !u32 { - try self.seeDecl(decl_index); + _ = try self.seeDecl(decl_index); var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); @@ -387,7 +401,7 @@ pub fn updateDecl(self: *Plan9, module: *Module, decl_index: Module.Decl.Index) } } - try self.seeDecl(decl_index); + _ = try self.seeDecl(decl_index); log.debug("codegen decl {*} ({s}) ({d})", .{ decl, decl.name, decl_index }); @@ -414,28 +428,31 @@ pub fn updateDecl(self: *Plan9, module: *Module, decl_index: Module.Decl.Index) if (self.data_decl_table.fetchPutAssumeCapacity(decl_index, duped_code)) |old_entry| { self.base.allocator.free(old_entry.value); } - return self.updateFinish(decl); + return self.updateFinish(decl_index); } /// called at the end of update{Decl,Func} -fn updateFinish(self: *Plan9, decl: *Module.Decl) !void { +fn updateFinish(self: *Plan9, decl_index: Module.Decl.Index) !void { + const decl = self.base.options.module.?.declPtr(decl_index); const is_fn = (decl.ty.zigTypeTag() == .Fn); log.debug("update the symbol table and got for decl {*} ({s})", .{ decl, decl.name }); const sym_t: aout.Sym.Type = if (is_fn) .t else .d; + + const decl_block = self.getDeclBlockPtr(self.decls.get(decl_index).?.index); // write the internal linker metadata - decl.link.plan9.type = sym_t; + decl_block.type = sym_t; // write the symbol // we already have the got index const sym: aout.Sym = .{ .value = undefined, // the value of stuff gets filled in in flushModule - .type = decl.link.plan9.type, + .type = decl_block.type, .name = mem.span(decl.name), }; - if (decl.link.plan9.sym_index) |s| { + if (decl_block.sym_index) |s| { self.syms.items[s] = sym; } else { const s = try self.allocateSymbolIndex(); - decl.link.plan9.sym_index = s; + decl_block.sym_index = s; self.syms.items[s] = sym; } } @@ -550,6 +567,7 @@ pub fn flushModule(self: *Plan9, comp: *Compilation, prog_node: *std.Progress.No while (it.next()) |entry| { const decl_index = entry.key_ptr.*; const decl = mod.declPtr(decl_index); + const decl_block = self.getDeclBlockPtr(self.decls.get(decl_index).?.index); const out = entry.value_ptr.*; log.debug("write text decl {*} ({s}), lines {d} to {d}", .{ decl, decl.name, out.start_line + 1, out.end_line }); { @@ -568,16 +586,16 @@ pub fn flushModule(self: *Plan9, comp: *Compilation, prog_node: *std.Progress.No iovecs_i += 1; const off = self.getAddr(text_i, .t); text_i += out.code.len; - decl.link.plan9.offset = off; + decl_block.offset = off; if (!self.sixtyfour_bit) { - mem.writeIntNative(u32, got_table[decl.link.plan9.got_index.? * 4 ..][0..4], @intCast(u32, off)); - mem.writeInt(u32, got_table[decl.link.plan9.got_index.? * 4 ..][0..4], @intCast(u32, off), self.base.options.target.cpu.arch.endian()); + mem.writeIntNative(u32, got_table[decl_block.got_index.? * 4 ..][0..4], @intCast(u32, off)); + mem.writeInt(u32, got_table[decl_block.got_index.? * 4 ..][0..4], @intCast(u32, off), self.base.options.target.cpu.arch.endian()); } else { - mem.writeInt(u64, got_table[decl.link.plan9.got_index.? * 8 ..][0..8], off, self.base.options.target.cpu.arch.endian()); + mem.writeInt(u64, got_table[decl_block.got_index.? * 8 ..][0..8], off, self.base.options.target.cpu.arch.endian()); } - self.syms.items[decl.link.plan9.sym_index.?].value = off; + self.syms.items[decl_block.sym_index.?].value = off; if (mod.decl_exports.get(decl_index)) |exports| { - try self.addDeclExports(mod, decl, exports.items); + try self.addDeclExports(mod, decl_index, exports.items); } } } @@ -598,6 +616,7 @@ pub fn flushModule(self: *Plan9, comp: *Compilation, prog_node: *std.Progress.No while (it.next()) |entry| { const decl_index = entry.key_ptr.*; const decl = mod.declPtr(decl_index); + const decl_block = self.getDeclBlockPtr(self.decls.get(decl_index).?.index); const code = entry.value_ptr.*; log.debug("write data decl {*} ({s})", .{ decl, decl.name }); @@ -606,15 +625,15 @@ pub fn flushModule(self: *Plan9, comp: *Compilation, prog_node: *std.Progress.No iovecs_i += 1; const off = self.getAddr(data_i, .d); data_i += code.len; - decl.link.plan9.offset = off; + decl_block.offset = off; if (!self.sixtyfour_bit) { - mem.writeInt(u32, got_table[decl.link.plan9.got_index.? * 4 ..][0..4], @intCast(u32, off), self.base.options.target.cpu.arch.endian()); + mem.writeInt(u32, got_table[decl_block.got_index.? * 4 ..][0..4], @intCast(u32, off), self.base.options.target.cpu.arch.endian()); } else { - mem.writeInt(u64, got_table[decl.link.plan9.got_index.? * 8 ..][0..8], off, self.base.options.target.cpu.arch.endian()); + mem.writeInt(u64, got_table[decl_block.got_index.? * 8 ..][0..8], off, self.base.options.target.cpu.arch.endian()); } - self.syms.items[decl.link.plan9.sym_index.?].value = off; + self.syms.items[decl_block.sym_index.?].value = off; if (mod.decl_exports.get(decl_index)) |exports| { - try self.addDeclExports(mod, decl, exports.items); + try self.addDeclExports(mod, decl_index, exports.items); } } // write the unnamed constants after the other data decls @@ -676,7 +695,8 @@ pub fn flushModule(self: *Plan9, comp: *Compilation, prog_node: *std.Progress.No for (kv.value_ptr.items) |reloc| { const target_decl_index = reloc.target; const target_decl = mod.declPtr(target_decl_index); - const target_decl_offset = target_decl.link.plan9.offset.?; + const target_decl_block = self.getDeclBlock(self.decls.get(target_decl_index).?.index); + const target_decl_offset = target_decl_block.offset.?; const offset = reloc.offset; const addend = reloc.addend; @@ -709,28 +729,36 @@ pub fn flushModule(self: *Plan9, comp: *Compilation, prog_node: *std.Progress.No fn addDeclExports( self: *Plan9, module: *Module, - decl: *Module.Decl, + decl_index: Module.Decl.Index, exports: []const *Module.Export, ) !void { + const metadata = self.decls.getPtr(decl_index).?; + const decl_block = self.getDeclBlock(metadata.index); + for (exports) |exp| { // plan9 does not support custom sections if (exp.options.section) |section_name| { if (!mem.eql(u8, section_name, ".text") or !mem.eql(u8, section_name, ".data")) { - try module.failed_exports.put(module.gpa, exp, try Module.ErrorMsg.create(self.base.allocator, decl.srcLoc(), "plan9 does not support extra sections", .{})); + try module.failed_exports.put(module.gpa, exp, try Module.ErrorMsg.create( + self.base.allocator, + module.declPtr(decl_index).srcLoc(), + "plan9 does not support extra sections", + .{}, + )); break; } } const sym = .{ - .value = decl.link.plan9.offset.?, - .type = decl.link.plan9.type.toGlobal(), + .value = decl_block.offset.?, + .type = decl_block.type.toGlobal(), .name = exp.options.name, }; - if (exp.link.plan9) |i| { + if (metadata.getExport(self, exp.options.name)) |i| { self.syms.items[i] = sym; } else { try self.syms.append(self.base.allocator, sym); - exp.link.plan9 = self.syms.items.len - 1; + try metadata.exports.append(self.base.allocator, self.syms.items.len - 1); } } } @@ -760,13 +788,18 @@ pub fn freeDecl(self: *Plan9, decl_index: Module.Decl.Index) void { self.base.allocator.free(removed_entry.value); } } - if (decl.link.plan9.got_index) |i| { - // TODO: if this catch {} is triggered, an assertion in flushModule will be triggered, because got_index_free_list will have the wrong length - self.got_index_free_list.append(self.base.allocator, i) catch {}; - } - if (decl.link.plan9.sym_index) |i| { - self.syms_index_free_list.append(self.base.allocator, i) catch {}; - self.syms.items[i] = aout.Sym.undefined_symbol; + if (self.decls.fetchRemove(decl_index)) |const_kv| { + var kv = const_kv; + const decl_block = self.getDeclBlock(kv.value.index); + if (decl_block.got_index) |i| { + // TODO: if this catch {} is triggered, an assertion in flushModule will be triggered, because got_index_free_list will have the wrong length + self.got_index_free_list.append(self.base.allocator, i) catch {}; + } + if (decl_block.sym_index) |i| { + self.syms_index_free_list.append(self.base.allocator, i) catch {}; + self.syms.items[i] = aout.Sym.undefined_symbol; + } + kv.value.exports.deinit(self.base.allocator); } self.freeUnnamedConsts(decl_index); { @@ -786,12 +819,30 @@ fn freeUnnamedConsts(self: *Plan9, decl_index: Module.Decl.Index) void { unnamed_consts.clearAndFree(self.base.allocator); } -pub fn seeDecl(self: *Plan9, decl_index: Module.Decl.Index) !void { - const mod = self.base.options.module.?; - const decl = mod.declPtr(decl_index); - if (decl.link.plan9.got_index == null) { - decl.link.plan9.got_index = self.allocateGotIndex(); +fn createDeclBlock(self: *Plan9) !DeclBlock.Index { + const gpa = self.base.allocator; + const index = @intCast(DeclBlock.Index, self.decl_blocks.items.len); + const decl_block = try self.decl_blocks.addOne(gpa); + decl_block.* = .{ + .type = .t, + .offset = null, + .sym_index = null, + .got_index = null, + }; + return index; +} + +pub fn seeDecl(self: *Plan9, decl_index: Module.Decl.Index) !DeclBlock.Index { + const gop = try self.decls.getOrPut(self.base.allocator, decl_index); + if (!gop.found_existing) { + const index = try self.createDeclBlock(); + self.getDeclBlockPtr(index).got_index = self.allocateGotIndex(); + gop.value_ptr.* = .{ + .index = index, + .exports = .{}, + }; } + return gop.value_ptr.index; } pub fn updateDeclExports( @@ -800,7 +851,7 @@ pub fn updateDeclExports( decl_index: Module.Decl.Index, exports: []const *Module.Export, ) !void { - try self.seeDecl(decl_index); + _ = try self.seeDecl(decl_index); // we do all the things in flush _ = module; _ = exports; @@ -842,10 +893,17 @@ pub fn deinit(self: *Plan9) void { self.syms_index_free_list.deinit(gpa); self.file_segments.deinit(gpa); self.path_arena.deinit(); + self.decl_blocks.deinit(gpa); + + { + var it = self.decls.iterator(); + while (it.next()) |entry| { + entry.value_ptr.exports.deinit(gpa); + } + self.decls.deinit(gpa); + } } -pub const Export = ?usize; -pub const base_tag = .plan9; pub fn openPath(allocator: Allocator, sub_path: []const u8, options: link.Options) !*Plan9 { if (options.use_llvm) return error.LLVMBackendDoesNotSupportPlan9; @@ -911,20 +969,19 @@ pub fn writeSyms(self: *Plan9, buf: *std.ArrayList(u8)) !void { } } - const mod = self.base.options.module.?; - // write the data symbols { var it = self.data_decl_table.iterator(); while (it.next()) |entry| { const decl_index = entry.key_ptr.*; - const decl = mod.declPtr(decl_index); - const sym = self.syms.items[decl.link.plan9.sym_index.?]; + const decl_metadata = self.decls.get(decl_index).?; + const decl_block = self.getDeclBlock(decl_metadata.index); + const sym = self.syms.items[decl_block.sym_index.?]; try self.writeSym(writer, sym); if (self.base.options.module.?.decl_exports.get(decl_index)) |exports| { - for (exports.items) |e| { - try self.writeSym(writer, self.syms.items[e.link.plan9.?]); - } + for (exports.items) |e| if (decl_metadata.getExport(self, e.options.name)) |exp_i| { + try self.writeSym(writer, self.syms.items[exp_i]); + }; } } } @@ -943,16 +1000,17 @@ pub fn writeSyms(self: *Plan9, buf: *std.ArrayList(u8)) !void { var submap_it = symidx_and_submap.functions.iterator(); while (submap_it.next()) |entry| { const decl_index = entry.key_ptr.*; - const decl = mod.declPtr(decl_index); - const sym = self.syms.items[decl.link.plan9.sym_index.?]; + const decl_metadata = self.decls.get(decl_index).?; + const decl_block = self.getDeclBlock(decl_metadata.index); + const sym = self.syms.items[decl_block.sym_index.?]; try self.writeSym(writer, sym); if (self.base.options.module.?.decl_exports.get(decl_index)) |exports| { - for (exports.items) |e| { - const s = self.syms.items[e.link.plan9.?]; + for (exports.items) |e| if (decl_metadata.getExport(self, e.options.name)) |exp_i| { + const s = self.syms.items[exp_i]; if (mem.eql(u8, s.name, "_start")) self.entry_val = s.value; try self.writeSym(writer, s); - } + }; } } } @@ -1004,3 +1062,11 @@ pub fn getDeclVAddr( }); return undefined; } + +pub fn getDeclBlock(self: *const Plan9, index: DeclBlock.Index) DeclBlock { + return self.decl_blocks.items[index]; +} + +fn getDeclBlockPtr(self: *Plan9, index: DeclBlock.Index) *DeclBlock { + return &self.decl_blocks.items[index]; +} From d98fc53b8fbe479f828114b0276d5290146cc2a3 Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Wed, 1 Feb 2023 11:49:07 +0100 Subject: [PATCH 63/84] link: use strtab.StringTable in Dwarf --- src/link/Dwarf.zig | 20 ++++++-------------- src/link/Elf.zig | 10 +++++----- src/link/MachO/DebugSymbols.zig | 12 ++++++------ 3 files changed, 17 insertions(+), 25 deletions(-) diff --git a/src/link/Dwarf.zig b/src/link/Dwarf.zig index 8278377095..61ddda3494 100644 --- a/src/link/Dwarf.zig +++ b/src/link/Dwarf.zig @@ -18,8 +18,9 @@ const LinkBlock = File.LinkBlock; const LinkFn = File.LinkFn; const LinkerLoad = @import("../codegen.zig").LinkerLoad; const Module = @import("../Module.zig"); -const Value = @import("../value.zig").Value; +const StringTable = @import("strtab.zig").StringTable; const Type = @import("../type.zig").Type; +const Value = @import("../value.zig").Value; allocator: Allocator, bin_file: *File, @@ -42,7 +43,7 @@ abbrev_table_offset: ?u64 = null, /// TODO replace with InternPool /// Table of debug symbol names. -strtab: std.ArrayListUnmanaged(u8) = .{}, +strtab: StringTable(.strtab) = .{}, /// Quick lookup array of all defined source files referenced by at least one Decl. /// They will end up in the DWARF debug_line header as two lists: @@ -1770,11 +1771,11 @@ pub fn writeDbgInfoHeader(self: *Dwarf, module: *Module, low_pc: u64, high_pc: u }, } // Write the form for the compile unit, which must match the abbrev table above. - const name_strp = try self.makeString(module.root_pkg.root_src_path); + const name_strp = try self.strtab.insert(self.allocator, module.root_pkg.root_src_path); var compile_unit_dir_buffer: [std.fs.MAX_PATH_BYTES]u8 = undefined; const compile_unit_dir = resolveCompilationDir(module, &compile_unit_dir_buffer); - const comp_dir_strp = try self.makeString(compile_unit_dir); - const producer_strp = try self.makeString(link.producer_string); + const comp_dir_strp = try self.strtab.insert(self.allocator, compile_unit_dir); + const producer_strp = try self.strtab.insert(self.allocator, link.producer_string); di_buf.appendAssumeCapacity(@enumToInt(AbbrevKind.compile_unit)); if (self.bin_file.tag == .macho) { @@ -2435,15 +2436,6 @@ fn getRelocDbgInfoSubprogramHighPC(self: Dwarf) u32 { return dbg_info_low_pc_reloc_index + self.ptrWidthBytes(); } -/// TODO Improve this to use a table. -fn makeString(self: *Dwarf, bytes: []const u8) !u32 { - try self.strtab.ensureUnusedCapacity(self.allocator, bytes.len + 1); - const result = self.strtab.items.len; - self.strtab.appendSliceAssumeCapacity(bytes); - self.strtab.appendAssumeCapacity(0); - return @intCast(u32, result); -} - fn padToIdeal(actual_size: anytype) @TypeOf(actual_size) { return actual_size +| (actual_size / ideal_factor); } diff --git a/src/link/Elf.zig b/src/link/Elf.zig index 747120ac5d..01326fb82e 100644 --- a/src/link/Elf.zig +++ b/src/link/Elf.zig @@ -688,8 +688,8 @@ pub fn populateMissingMetadata(self: *Elf) !void { // if (self.dwarf) |*dw| { // if (self.debug_str_section_index == null) { // self.debug_str_section_index = @intCast(u16, self.sections.slice().len); - // assert(dw.strtab.items.len == 0); - // try dw.strtab.append(gpa, 0); + // assert(dw.strtab.buffer.items.len == 0); + // try dw.strtab.buffer.append(gpa, 0); // try self.sections.append(gpa, .{ // .shdr = .{ // .sh_name = try self.shstrtab.insert(gpa, ".debug_str"), @@ -1164,10 +1164,10 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node // if (self.dwarf) |dwarf| { // const shdr_index = self.debug_str_section_index.?; - // if (self.debug_strtab_dirty or dwarf.strtab.items.len != self.sections.items(.shdr)[shdr_index].sh_size) { - // try self.growNonAllocSection(shdr_index, dwarf.strtab.items.len, 1, false); + // if (self.debug_strtab_dirty or dwarf.strtab.buffer.items.len != self.sections.items(.shdr)[shdr_index].sh_size) { + // try self.growNonAllocSection(shdr_index, dwarf.strtab.buffer.items.len, 1, false); // const debug_strtab_sect = self.sections.items(.shdr)[shdr_index]; - // try self.base.file.?.pwriteAll(dwarf.strtab.items, debug_strtab_sect.sh_offset); + // try self.base.file.?.pwriteAll(dwarf.strtab.buffer.items, debug_strtab_sect.sh_offset); // self.debug_strtab_dirty = false; // } // } diff --git a/src/link/MachO/DebugSymbols.zig b/src/link/MachO/DebugSymbols.zig index 7c22f441cd..0a5c8b0372 100644 --- a/src/link/MachO/DebugSymbols.zig +++ b/src/link/MachO/DebugSymbols.zig @@ -82,11 +82,11 @@ pub fn populateMissingMetadata(self: *DebugSymbols) !void { } if (self.debug_str_section_index == null) { - assert(self.dwarf.strtab.items.len == 0); - try self.dwarf.strtab.append(self.allocator, 0); + assert(self.dwarf.strtab.buffer.items.len == 0); + try self.dwarf.strtab.buffer.append(self.allocator, 0); self.debug_str_section_index = try self.allocateSection( "__debug_str", - @intCast(u32, self.dwarf.strtab.items.len), + @intCast(u32, self.dwarf.strtab.buffer.items.len), 0, ); self.debug_string_table_dirty = true; @@ -291,10 +291,10 @@ pub fn flushModule(self: *DebugSymbols, macho_file: *MachO) !void { { const sect_index = self.debug_str_section_index.?; - if (self.debug_string_table_dirty or self.dwarf.strtab.items.len != self.getSection(sect_index).size) { - const needed_size = @intCast(u32, self.dwarf.strtab.items.len); + if (self.debug_string_table_dirty or self.dwarf.strtab.buffer.items.len != self.getSection(sect_index).size) { + const needed_size = @intCast(u32, self.dwarf.strtab.buffer.items.len); try self.growSection(sect_index, needed_size, false); - try self.file.pwriteAll(self.dwarf.strtab.items, self.getSection(sect_index).offset); + try self.file.pwriteAll(self.dwarf.strtab.buffer.items, self.getSection(sect_index).offset); self.debug_string_table_dirty = false; } } From 5de2aae63cd75322e58204a6be8df49754e4851a Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Wed, 1 Feb 2023 15:03:55 +0100 Subject: [PATCH 64/84] link: decouple DI atoms from linker atoms, and manage them in Dwarf linker --- src/Compilation.zig | 2 +- src/Module.zig | 12 +- src/arch/aarch64/CodeGen.zig | 17 +- src/arch/arm/CodeGen.zig | 17 +- src/arch/riscv64/CodeGen.zig | 10 +- src/arch/sparc64/CodeGen.zig | 10 +- src/arch/wasm/CodeGen.zig | 4 +- src/arch/x86_64/CodeGen.zig | 4 +- src/link.zig | 23 +- src/link/C.zig | 4 +- src/link/Coff.zig | 5 +- src/link/Dwarf.zig | 522 ++++++++++++++++++++--------------- src/link/Elf.zig | 520 +++++++++++++++++----------------- src/link/Elf/Atom.zig | 3 - src/link/MachO.zig | 130 ++++----- src/link/MachO/Atom.zig | 3 - src/link/Plan9.zig | 4 +- src/link/Wasm.zig | 17 +- src/link/Wasm/Atom.zig | 5 - 19 files changed, 655 insertions(+), 657 deletions(-) diff --git a/src/Compilation.zig b/src/Compilation.zig index 09c6e1c686..7d42d3b610 100644 --- a/src/Compilation.zig +++ b/src/Compilation.zig @@ -3299,7 +3299,7 @@ fn processOneJob(comp: *Compilation, job: Job) !void { const gpa = comp.gpa; const module = comp.bin_file.options.module.?; const decl = module.declPtr(decl_index); - comp.bin_file.updateDeclLineNumber(module, decl) catch |err| { + comp.bin_file.updateDeclLineNumber(module, decl_index) catch |err| { try module.failed_decls.ensureUnusedCapacity(gpa, 1); module.failed_decls.putAssumeCapacityNoClobber(decl_index, try Module.ErrorMsg.create( gpa, diff --git a/src/Module.zig b/src/Module.zig index a914dc90d8..eb947a6977 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -5186,12 +5186,12 @@ fn scanDecl(iter: *ScanDeclIter, decl_sub_index: usize, flags: u4) Allocator.Err .coff => { // TODO Implement for COFF }, - .elf => if (decl.fn_link.elf.len != 0) { + .elf => { // TODO Look into detecting when this would be unnecessary by storing enough state // in `Decl` to notice that the line number did not change. comp.work_queue.writeItemAssumeCapacity(.{ .update_line_number = decl_index }); }, - .macho => if (decl.fn_link.macho.len != 0) { + .macho => { // TODO Look into detecting when this would be unnecessary by storing enough state // in `Decl` to notice that the line number did not change. comp.work_queue.writeItemAssumeCapacity(.{ .update_line_number = decl_index }); @@ -5285,8 +5285,8 @@ pub fn clearDecl( }; decl.fn_link = switch (mod.comp.bin_file.tag) { .coff => .{ .coff = {} }, - .elf => .{ .elf = link.File.Dwarf.SrcFn.empty }, - .macho => .{ .macho = link.File.Dwarf.SrcFn.empty }, + .elf => .{ .elf = {} }, + .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = {} }, .c => .{ .c = {} }, .wasm => .{ .wasm = link.File.Wasm.FnData.empty }, @@ -5705,8 +5705,8 @@ pub fn allocateNewDecl( }, .fn_link = switch (mod.comp.bin_file.tag) { .coff => .{ .coff = {} }, - .elf => .{ .elf = link.File.Dwarf.SrcFn.empty }, - .macho => .{ .macho = link.File.Dwarf.SrcFn.empty }, + .elf => .{ .elf = {} }, + .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = {} }, .c => .{ .c = {} }, .wasm => .{ .wasm = link.File.Wasm.FnData.empty }, diff --git a/src/arch/aarch64/CodeGen.zig b/src/arch/aarch64/CodeGen.zig index aab30b73dc..473a62fd83 100644 --- a/src/arch/aarch64/CodeGen.zig +++ b/src/arch/aarch64/CodeGen.zig @@ -203,13 +203,7 @@ const DbgInfoReloc = struct { else => unreachable, // not a possible argument }; - try dw.genArgDbgInfo( - reloc.name, - reloc.ty, - function.bin_file.tag, - function.mod_fn.owner_decl, - loc, - ); + try dw.genArgDbgInfo(reloc.name, reloc.ty, function.mod_fn.owner_decl, loc); }, .plan9 => {}, .none => {}, @@ -255,14 +249,7 @@ const DbgInfoReloc = struct { break :blk .nop; }, }; - try dw.genVarDbgInfo( - reloc.name, - reloc.ty, - function.bin_file.tag, - function.mod_fn.owner_decl, - is_ptr, - loc, - ); + try dw.genVarDbgInfo(reloc.name, reloc.ty, function.mod_fn.owner_decl, is_ptr, loc); }, .plan9 => {}, .none => {}, diff --git a/src/arch/arm/CodeGen.zig b/src/arch/arm/CodeGen.zig index 6574501767..57a8aed699 100644 --- a/src/arch/arm/CodeGen.zig +++ b/src/arch/arm/CodeGen.zig @@ -282,13 +282,7 @@ const DbgInfoReloc = struct { else => unreachable, // not a possible argument }; - try dw.genArgDbgInfo( - reloc.name, - reloc.ty, - function.bin_file.tag, - function.mod_fn.owner_decl, - loc, - ); + try dw.genArgDbgInfo(reloc.name, reloc.ty, function.mod_fn.owner_decl, loc); }, .plan9 => {}, .none => {}, @@ -331,14 +325,7 @@ const DbgInfoReloc = struct { break :blk .nop; }, }; - try dw.genVarDbgInfo( - reloc.name, - reloc.ty, - function.bin_file.tag, - function.mod_fn.owner_decl, - is_ptr, - loc, - ); + try dw.genVarDbgInfo(reloc.name, reloc.ty, function.mod_fn.owner_decl, is_ptr, loc); }, .plan9 => {}, .none => {}, diff --git a/src/arch/riscv64/CodeGen.zig b/src/arch/riscv64/CodeGen.zig index 423816c0b1..8b8fca4859 100644 --- a/src/arch/riscv64/CodeGen.zig +++ b/src/arch/riscv64/CodeGen.zig @@ -1615,13 +1615,9 @@ fn genArgDbgInfo(self: Self, inst: Air.Inst.Index, mcv: MCValue) !void { switch (self.debug_output) { .dwarf => |dw| switch (mcv) { - .register => |reg| try dw.genArgDbgInfo( - name, - ty, - self.bin_file.tag, - self.mod_fn.owner_decl, - .{ .register = reg.dwarfLocOp() }, - ), + .register => |reg| try dw.genArgDbgInfo(name, ty, self.mod_fn.owner_decl, .{ + .register = reg.dwarfLocOp(), + }), .stack_offset => {}, else => {}, }, diff --git a/src/arch/sparc64/CodeGen.zig b/src/arch/sparc64/CodeGen.zig index e67244167e..418c67c580 100644 --- a/src/arch/sparc64/CodeGen.zig +++ b/src/arch/sparc64/CodeGen.zig @@ -3412,13 +3412,9 @@ fn genArgDbgInfo(self: Self, inst: Air.Inst.Index, mcv: MCValue) !void { switch (self.debug_output) { .dwarf => |dw| switch (mcv) { - .register => |reg| try dw.genArgDbgInfo( - name, - ty, - self.bin_file.tag, - self.mod_fn.owner_decl, - .{ .register = reg.dwarfLocOp() }, - ), + .register => |reg| try dw.genArgDbgInfo(name, ty, self.mod_fn.owner_decl, .{ + .register = reg.dwarfLocOp(), + }), else => {}, }, else => {}, diff --git a/src/arch/wasm/CodeGen.zig b/src/arch/wasm/CodeGen.zig index 342d6b70cc..8212d281e5 100644 --- a/src/arch/wasm/CodeGen.zig +++ b/src/arch/wasm/CodeGen.zig @@ -2475,7 +2475,7 @@ fn airArg(func: *CodeGen, inst: Air.Inst.Index) InnerError!void { .dwarf => |dwarf| { const src_index = func.air.instructions.items(.data)[inst].arg.src_index; const name = func.mod_fn.getParamName(func.bin_file.base.options.module.?, src_index); - try dwarf.genArgDbgInfo(name, arg_ty, .wasm, func.mod_fn.owner_decl, .{ + try dwarf.genArgDbgInfo(name, arg_ty, func.mod_fn.owner_decl, .{ .wasm_local = arg.local.value, }); }, @@ -5539,7 +5539,7 @@ fn airDbgVar(func: *CodeGen, inst: Air.Inst.Index, is_ptr: bool) !void { break :blk .nop; }, }; - try func.debug_output.dwarf.genVarDbgInfo(name, ty, .wasm, func.mod_fn.owner_decl, is_ptr, loc); + try func.debug_output.dwarf.genVarDbgInfo(name, ty, func.mod_fn.owner_decl, is_ptr, loc); func.finishAir(inst, .none, &.{}); } diff --git a/src/arch/x86_64/CodeGen.zig b/src/arch/x86_64/CodeGen.zig index fcae7eaabc..c11ea4e63e 100644 --- a/src/arch/x86_64/CodeGen.zig +++ b/src/arch/x86_64/CodeGen.zig @@ -3836,7 +3836,7 @@ fn genArgDbgInfo(self: Self, ty: Type, name: [:0]const u8, mcv: MCValue) !void { }, else => unreachable, // not a valid function parameter }; - try dw.genArgDbgInfo(name, ty, self.bin_file.tag, self.mod_fn.owner_decl, loc); + try dw.genArgDbgInfo(name, ty, self.mod_fn.owner_decl, loc); }, .plan9 => {}, .none => {}, @@ -3876,7 +3876,7 @@ fn genVarDbgInfo( break :blk .nop; }, }; - try dw.genVarDbgInfo(name, ty, self.bin_file.tag, self.mod_fn.owner_decl, is_ptr, loc); + try dw.genVarDbgInfo(name, ty, self.mod_fn.owner_decl, is_ptr, loc); }, .plan9 => {}, .none => {}, diff --git a/src/link.zig b/src/link.zig index c0eacf88a0..3dd182b586 100644 --- a/src/link.zig +++ b/src/link.zig @@ -273,9 +273,9 @@ pub const File = struct { }; pub const LinkFn = union { - elf: Dwarf.SrcFn, - coff: Coff.SrcFn, - macho: Dwarf.SrcFn, + elf: void, + coff: void, + macho: void, plan9: void, c: void, wasm: Wasm.FnData, @@ -580,22 +580,23 @@ pub const File = struct { } } - pub fn updateDeclLineNumber(base: *File, module: *Module, decl: *Module.Decl) UpdateDeclError!void { + pub fn updateDeclLineNumber(base: *File, module: *Module, decl_index: Module.Decl.Index) UpdateDeclError!void { + const decl = module.declPtr(decl_index); log.debug("updateDeclLineNumber {*} ({s}), line={}", .{ decl, decl.name, decl.src_line + 1, }); assert(decl.has_tv); if (build_options.only_c) { assert(base.tag == .c); - return @fieldParentPtr(C, "base", base).updateDeclLineNumber(module, decl); + return @fieldParentPtr(C, "base", base).updateDeclLineNumber(module, decl_index); } switch (base.tag) { - .coff => return @fieldParentPtr(Coff, "base", base).updateDeclLineNumber(module, decl), - .elf => return @fieldParentPtr(Elf, "base", base).updateDeclLineNumber(module, decl), - .macho => return @fieldParentPtr(MachO, "base", base).updateDeclLineNumber(module, decl), - .c => return @fieldParentPtr(C, "base", base).updateDeclLineNumber(module, decl), - .wasm => return @fieldParentPtr(Wasm, "base", base).updateDeclLineNumber(module, decl), - .plan9 => return @fieldParentPtr(Plan9, "base", base).updateDeclLineNumber(module, decl), + .coff => return @fieldParentPtr(Coff, "base", base).updateDeclLineNumber(module, decl_index), + .elf => return @fieldParentPtr(Elf, "base", base).updateDeclLineNumber(module, decl_index), + .macho => return @fieldParentPtr(MachO, "base", base).updateDeclLineNumber(module, decl_index), + .c => return @fieldParentPtr(C, "base", base).updateDeclLineNumber(module, decl_index), + .wasm => return @fieldParentPtr(Wasm, "base", base).updateDeclLineNumber(module, decl_index), + .plan9 => return @fieldParentPtr(Plan9, "base", base).updateDeclLineNumber(module, decl_index), .spirv, .nvptx => {}, } } diff --git a/src/link/C.zig b/src/link/C.zig index 8b05b8b22d..02e5cadfbc 100644 --- a/src/link/C.zig +++ b/src/link/C.zig @@ -219,12 +219,12 @@ pub fn updateDecl(self: *C, module: *Module, decl_index: Module.Decl.Index) !voi code.shrinkAndFree(module.gpa, code.items.len); } -pub fn updateDeclLineNumber(self: *C, module: *Module, decl: *Module.Decl) !void { +pub fn updateDeclLineNumber(self: *C, module: *Module, decl_index: Module.Decl.Index) !void { // The C backend does not have the ability to fix line numbers without re-generating // the entire Decl. _ = self; _ = module; - _ = decl; + _ = decl_index; } pub fn flush(self: *C, comp: *Compilation, prog_node: *std.Progress.Node) !void { diff --git a/src/link/Coff.zig b/src/link/Coff.zig index c062276b73..f563a617c7 100644 --- a/src/link/Coff.zig +++ b/src/link/Coff.zig @@ -195,7 +195,6 @@ pub const PtrWidth = enum { }; } }; -pub const SrcFn = void; pub const SymbolWithLoc = struct { // Index into the respective symbol table. @@ -1545,10 +1544,10 @@ pub fn getGlobalSymbol(self: *Coff, name: []const u8) !u32 { return global_index; } -pub fn updateDeclLineNumber(self: *Coff, module: *Module, decl: *Module.Decl) !void { +pub fn updateDeclLineNumber(self: *Coff, module: *Module, decl_index: Module.Decl.Index) !void { _ = self; _ = module; - _ = decl; + _ = decl_index; log.debug("TODO implement updateDeclLineNumber", .{}); } diff --git a/src/link/Dwarf.zig b/src/link/Dwarf.zig index 61ddda3494..e90db2d0df 100644 --- a/src/link/Dwarf.zig +++ b/src/link/Dwarf.zig @@ -27,17 +27,21 @@ bin_file: *File, ptr_width: PtrWidth, target: std.Target, -/// A list of `File.LinkFn` whose Line Number Programs have surplus capacity. -/// This is the same concept as `text_block_free_list`; see those doc comments. -dbg_line_fn_free_list: std.AutoHashMapUnmanaged(*SrcFn, void) = .{}, -dbg_line_fn_first: ?*SrcFn = null, -dbg_line_fn_last: ?*SrcFn = null, +/// A list of `Atom`s whose Line Number Programs have surplus capacity. +/// This is the same concept as `Section.free_list` in Elf; see those doc comments. +src_fn_free_list: std.AutoHashMapUnmanaged(Atom.Index, void) = .{}, +src_fn_first_index: ?Atom.Index = null, +src_fn_last_index: ?Atom.Index = null, +src_fns: std.ArrayListUnmanaged(Atom) = .{}, +src_fn_decls: AtomTable = .{}, /// A list of `Atom`s whose corresponding .debug_info tags have surplus capacity. /// This is the same concept as `text_block_free_list`; see those doc comments. -atom_free_list: std.AutoHashMapUnmanaged(*Atom, void) = .{}, -atom_first: ?*Atom = null, -atom_last: ?*Atom = null, +di_atom_free_list: std.AutoHashMapUnmanaged(Atom.Index, void) = .{}, +di_atom_first_index: ?Atom.Index = null, +di_atom_last_index: ?Atom.Index = null, +di_atoms: std.ArrayListUnmanaged(Atom) = .{}, +di_atom_decls: AtomTable = .{}, abbrev_table_offset: ?u64 = null, @@ -51,22 +55,23 @@ strtab: StringTable(.strtab) = .{}, /// * []file_names di_files: std.AutoArrayHashMapUnmanaged(*const Module.File, void) = .{}, -/// List of atoms that are owned directly by the DWARF module. -/// TODO convert links in DebugInfoAtom into indices and make -/// sure every atom is owned by this module. -managed_atoms: std.ArrayListUnmanaged(*Atom) = .{}, - global_abbrev_relocs: std.ArrayListUnmanaged(AbbrevRelocation) = .{}, -pub const Atom = struct { - /// Previous/next linked list pointers. - /// This is the linked list node for this Decl's corresponding .debug_info tag. - prev: ?*Atom, - next: ?*Atom, - /// Offset into .debug_info pointing to the tag for this Decl. +const AtomTable = std.AutoHashMapUnmanaged(Module.Decl.Index, Atom.Index); + +const Atom = struct { + /// Offset into .debug_info pointing to the tag for this Decl, or + /// offset from the beginning of the Debug Line Program header that contains this function. off: u32, - /// Size of the .debug_info tag for this Decl, not including padding. + /// Size of the .debug_info tag for this Decl, not including padding, or + /// size of the line number program component belonging to this function, not + /// including padding. len: u32, + + prev_index: ?Index, + next_index: ?Index, + + pub const Index = u32; }; /// Represents state of the analysed Decl. @@ -76,6 +81,7 @@ pub const Atom = struct { pub const DeclState = struct { gpa: Allocator, mod: *Module, + di_atom_decls: *const AtomTable, dbg_line: std.ArrayList(u8), dbg_info: std.ArrayList(u8), abbrev_type_arena: std.heap.ArenaAllocator, @@ -89,10 +95,11 @@ pub const DeclState = struct { abbrev_relocs: std.ArrayListUnmanaged(AbbrevRelocation) = .{}, exprloc_relocs: std.ArrayListUnmanaged(ExprlocRelocation) = .{}, - fn init(gpa: Allocator, mod: *Module) DeclState { + fn init(gpa: Allocator, mod: *Module, di_atom_decls: *const AtomTable) DeclState { return .{ .gpa = gpa, .mod = mod, + .di_atom_decls = di_atom_decls, .dbg_line = std.ArrayList(u8).init(gpa), .dbg_info = std.ArrayList(u8).init(gpa), .abbrev_type_arena = std.heap.ArenaAllocator.init(gpa), @@ -120,11 +127,11 @@ pub const DeclState = struct { /// Adds local type relocation of the form: @offset => @this + addend /// @this signifies the offset within the .debug_abbrev section of the containing atom. - fn addTypeRelocLocal(self: *DeclState, atom: *const Atom, offset: u32, addend: u32) !void { + fn addTypeRelocLocal(self: *DeclState, atom_index: Atom.Index, offset: u32, addend: u32) !void { log.debug("{x}: @this + {x}", .{ offset, addend }); try self.abbrev_relocs.append(self.gpa, .{ .target = null, - .atom = atom, + .atom_index = atom_index, .offset = offset, .addend = addend, }); @@ -133,13 +140,13 @@ pub const DeclState = struct { /// Adds global type relocation of the form: @offset => @symbol + 0 /// @symbol signifies a type abbreviation posititioned somewhere in the .debug_abbrev section /// which we use as our target of the relocation. - fn addTypeRelocGlobal(self: *DeclState, atom: *const Atom, ty: Type, offset: u32) !void { + fn addTypeRelocGlobal(self: *DeclState, atom_index: Atom.Index, ty: Type, offset: u32) !void { const resolv = self.abbrev_resolver.getContext(ty, .{ .mod = self.mod, }) orelse blk: { const sym_index = @intCast(u32, self.abbrev_table.items.len); try self.abbrev_table.append(self.gpa, .{ - .atom = atom, + .atom_index = atom_index, .type = ty, .offset = undefined, }); @@ -154,7 +161,7 @@ pub const DeclState = struct { log.debug("{x}: %{d} + 0", .{ offset, resolv }); try self.abbrev_relocs.append(self.gpa, .{ .target = resolv, - .atom = atom, + .atom_index = atom_index, .offset = offset, .addend = 0, }); @@ -163,7 +170,7 @@ pub const DeclState = struct { fn addDbgInfoType( self: *DeclState, module: *Module, - atom: *Atom, + atom_index: Atom.Index, ty: Type, ) error{OutOfMemory}!void { const arena = self.abbrev_type_arena.allocator(); @@ -228,7 +235,7 @@ pub const DeclState = struct { // DW.AT.type, DW.FORM.ref4 var index = dbg_info_buffer.items.len; try dbg_info_buffer.resize(index + 4); - try self.addTypeRelocGlobal(atom, Type.bool, @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, Type.bool, @intCast(u32, index)); // DW.AT.data_member_location, DW.FORM.sdata try dbg_info_buffer.ensureUnusedCapacity(6); dbg_info_buffer.appendAssumeCapacity(0); @@ -240,7 +247,7 @@ pub const DeclState = struct { // DW.AT.type, DW.FORM.ref4 index = dbg_info_buffer.items.len; try dbg_info_buffer.resize(index + 4); - try self.addTypeRelocGlobal(atom, payload_ty, @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, payload_ty, @intCast(u32, index)); // DW.AT.data_member_location, DW.FORM.sdata const offset = abi_size - payload_ty.abiSize(target); try leb128.writeULEB128(dbg_info_buffer.writer(), offset); @@ -271,7 +278,7 @@ pub const DeclState = struct { try dbg_info_buffer.resize(index + 4); var buf = try arena.create(Type.SlicePtrFieldTypeBuffer); const ptr_ty = ty.slicePtrFieldType(buf); - try self.addTypeRelocGlobal(atom, ptr_ty, @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, ptr_ty, @intCast(u32, index)); // DW.AT.data_member_location, DW.FORM.sdata try dbg_info_buffer.ensureUnusedCapacity(6); dbg_info_buffer.appendAssumeCapacity(0); @@ -283,7 +290,7 @@ pub const DeclState = struct { // DW.AT.type, DW.FORM.ref4 index = dbg_info_buffer.items.len; try dbg_info_buffer.resize(index + 4); - try self.addTypeRelocGlobal(atom, Type.usize, @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, Type.usize, @intCast(u32, index)); // DW.AT.data_member_location, DW.FORM.sdata try dbg_info_buffer.ensureUnusedCapacity(2); dbg_info_buffer.appendAssumeCapacity(ptr_bytes); @@ -295,7 +302,7 @@ pub const DeclState = struct { // DW.AT.type, DW.FORM.ref4 const index = dbg_info_buffer.items.len; try dbg_info_buffer.resize(index + 4); - try self.addTypeRelocGlobal(atom, ty.childType(), @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, ty.childType(), @intCast(u32, index)); } }, .Array => { @@ -306,13 +313,13 @@ pub const DeclState = struct { // DW.AT.type, DW.FORM.ref4 var index = dbg_info_buffer.items.len; try dbg_info_buffer.resize(index + 4); - try self.addTypeRelocGlobal(atom, ty.childType(), @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, ty.childType(), @intCast(u32, index)); // DW.AT.subrange_type try dbg_info_buffer.append(@enumToInt(AbbrevKind.array_dim)); // DW.AT.type, DW.FORM.ref4 index = dbg_info_buffer.items.len; try dbg_info_buffer.resize(index + 4); - try self.addTypeRelocGlobal(atom, Type.usize, @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, Type.usize, @intCast(u32, index)); // DW.AT.count, DW.FORM.udata const len = ty.arrayLenIncludingSentinel(); try leb128.writeULEB128(dbg_info_buffer.writer(), len); @@ -340,7 +347,7 @@ pub const DeclState = struct { // DW.AT.type, DW.FORM.ref4 var index = dbg_info_buffer.items.len; try dbg_info_buffer.resize(index + 4); - try self.addTypeRelocGlobal(atom, field, @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, field, @intCast(u32, index)); // DW.AT.data_member_location, DW.FORM.sdata const field_off = ty.structFieldOffset(field_index, target); try leb128.writeULEB128(dbg_info_buffer.writer(), field_off); @@ -372,7 +379,7 @@ pub const DeclState = struct { // DW.AT.type, DW.FORM.ref4 var index = dbg_info_buffer.items.len; try dbg_info_buffer.resize(index + 4); - try self.addTypeRelocGlobal(atom, field.ty, @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, field.ty, @intCast(u32, index)); // DW.AT.data_member_location, DW.FORM.sdata const field_off = ty.structFieldOffset(field_index, target); try leb128.writeULEB128(dbg_info_buffer.writer(), field_off); @@ -455,7 +462,7 @@ pub const DeclState = struct { // DW.AT.type, DW.FORM.ref4 const inner_union_index = dbg_info_buffer.items.len; try dbg_info_buffer.resize(inner_union_index + 4); - try self.addTypeRelocLocal(atom, @intCast(u32, inner_union_index), 5); + try self.addTypeRelocLocal(atom_index, @intCast(u32, inner_union_index), 5); // DW.AT.data_member_location, DW.FORM.sdata try leb128.writeULEB128(dbg_info_buffer.writer(), payload_offset); } @@ -482,7 +489,7 @@ pub const DeclState = struct { // DW.AT.type, DW.FORM.ref4 const index = dbg_info_buffer.items.len; try dbg_info_buffer.resize(index + 4); - try self.addTypeRelocGlobal(atom, field.ty, @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, field.ty, @intCast(u32, index)); // DW.AT.data_member_location, DW.FORM.sdata try dbg_info_buffer.append(0); } @@ -499,7 +506,7 @@ pub const DeclState = struct { // DW.AT.type, DW.FORM.ref4 const index = dbg_info_buffer.items.len; try dbg_info_buffer.resize(index + 4); - try self.addTypeRelocGlobal(atom, union_obj.tag_ty, @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, union_obj.tag_ty, @intCast(u32, index)); // DW.AT.data_member_location, DW.FORM.sdata try leb128.writeULEB128(dbg_info_buffer.writer(), tag_offset); @@ -542,7 +549,7 @@ pub const DeclState = struct { // DW.AT.type, DW.FORM.ref4 var index = dbg_info_buffer.items.len; try dbg_info_buffer.resize(index + 4); - try self.addTypeRelocGlobal(atom, payload_ty, @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, payload_ty, @intCast(u32, index)); // DW.AT.data_member_location, DW.FORM.sdata try leb128.writeULEB128(dbg_info_buffer.writer(), payload_off); @@ -555,7 +562,7 @@ pub const DeclState = struct { // DW.AT.type, DW.FORM.ref4 index = dbg_info_buffer.items.len; try dbg_info_buffer.resize(index + 4); - try self.addTypeRelocGlobal(atom, error_ty, @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, error_ty, @intCast(u32, index)); // DW.AT.data_member_location, DW.FORM.sdata try leb128.writeULEB128(dbg_info_buffer.writer(), error_off); @@ -588,12 +595,11 @@ pub const DeclState = struct { self: *DeclState, name: [:0]const u8, ty: Type, - tag: File.Tag, owner_decl: Module.Decl.Index, loc: DbgInfoLoc, ) error{OutOfMemory}!void { const dbg_info = &self.dbg_info; - const atom = getDbgInfoAtom(tag, self.mod, owner_decl); + const atom_index = self.di_atom_decls.get(owner_decl).?; const name_with_null = name.ptr[0 .. name.len + 1]; switch (loc) { @@ -638,7 +644,7 @@ pub const DeclState = struct { try dbg_info.ensureUnusedCapacity(5 + name_with_null.len); const index = dbg_info.items.len; try dbg_info.resize(index + 4); // dw.at.type, dw.form.ref4 - try self.addTypeRelocGlobal(atom, ty, @intCast(u32, index)); // DW.AT.type, DW.FORM.ref4 + try self.addTypeRelocGlobal(atom_index, ty, @intCast(u32, index)); // DW.AT.type, DW.FORM.ref4 dbg_info.appendSliceAssumeCapacity(name_with_null); // DW.AT.name, DW.FORM.string } @@ -646,13 +652,12 @@ pub const DeclState = struct { self: *DeclState, name: [:0]const u8, ty: Type, - tag: File.Tag, owner_decl: Module.Decl.Index, is_ptr: bool, loc: DbgInfoLoc, ) error{OutOfMemory}!void { const dbg_info = &self.dbg_info; - const atom = getDbgInfoAtom(tag, self.mod, owner_decl); + const atom_index = self.di_atom_decls.get(owner_decl).?; const name_with_null = name.ptr[0 .. name.len + 1]; try dbg_info.append(@enumToInt(AbbrevKind.variable)); const target = self.mod.getTarget(); @@ -782,7 +787,7 @@ pub const DeclState = struct { try dbg_info.ensureUnusedCapacity(5 + name_with_null.len); const index = dbg_info.items.len; try dbg_info.resize(index + 4); // dw.at.type, dw.form.ref4 - try self.addTypeRelocGlobal(atom, child_ty, @intCast(u32, index)); + try self.addTypeRelocGlobal(atom_index, child_ty, @intCast(u32, index)); dbg_info.appendSliceAssumeCapacity(name_with_null); // DW.AT.name, DW.FORM.string } @@ -815,7 +820,7 @@ pub const DeclState = struct { }; pub const AbbrevEntry = struct { - atom: *const Atom, + atom_index: Atom.Index, type: Type, offset: u32, }; @@ -824,7 +829,7 @@ pub const AbbrevRelocation = struct { /// If target is null, we deal with a local relocation that is based on simple offset + addend /// only. target: ?u32, - atom: *const Atom, + atom_index: Atom.Index, offset: u32, addend: u32, }; @@ -841,26 +846,6 @@ pub const ExprlocRelocation = struct { offset: u32, }; -pub const SrcFn = struct { - /// Offset from the beginning of the Debug Line Program header that contains this function. - off: u32, - /// Size of the line number program component belonging to this function, not - /// including padding. - len: u32, - - /// Points to the previous and next neighbors, based on the offset from .debug_line. - /// This can be used to find, for example, the capacity of this `SrcFn`. - prev: ?*SrcFn, - next: ?*SrcFn, - - pub const empty: SrcFn = .{ - .off = 0, - .len = 0, - .prev = null, - .next = null, - }; -}; - pub const PtrWidth = enum { p32, p64 }; pub const AbbrevKind = enum(u8) { @@ -910,16 +895,18 @@ pub fn init(allocator: Allocator, bin_file: *File, target: std.Target) Dwarf { pub fn deinit(self: *Dwarf) void { const gpa = self.allocator; - self.dbg_line_fn_free_list.deinit(gpa); - self.atom_free_list.deinit(gpa); + + self.src_fn_free_list.deinit(gpa); + self.src_fns.deinit(gpa); + self.src_fn_decls.deinit(gpa); + + self.di_atom_free_list.deinit(gpa); + self.di_atoms.deinit(gpa); + self.di_atom_decls.deinit(gpa); + self.strtab.deinit(gpa); self.di_files.deinit(gpa); self.global_abbrev_relocs.deinit(gpa); - - for (self.managed_atoms.items) |atom| { - gpa.destroy(atom); - } - self.managed_atoms.deinit(gpa); } /// Initializes Decl's state and its matching output buffers. @@ -935,15 +922,19 @@ pub fn initDeclState(self: *Dwarf, mod: *Module, decl_index: Module.Decl.Index) log.debug("initDeclState {s}{*}", .{ decl_name, decl }); const gpa = self.allocator; - var decl_state = DeclState.init(gpa, mod); + var decl_state = DeclState.init(gpa, mod, &self.di_atom_decls); errdefer decl_state.deinit(); const dbg_line_buffer = &decl_state.dbg_line; const dbg_info_buffer = &decl_state.dbg_info; + const di_atom_index = try self.getOrCreateAtomForDecl(.di_atom, decl_index); + assert(decl.has_tv); switch (decl.ty.zigTypeTag()) { .Fn => { + _ = try self.getOrCreateAtomForDecl(.src_fn, decl_index); + // For functions we need to add a prologue to the debug line program. try dbg_line_buffer.ensureTotalCapacity(26); @@ -1003,8 +994,7 @@ pub fn initDeclState(self: *Dwarf, mod: *Module, decl_index: Module.Decl.Index) dbg_info_buffer.items.len += 4; // DW.AT.high_pc, DW.FORM.data4 // if (fn_ret_has_bits) { - const atom = getDbgInfoAtom(self.bin_file.tag, mod, decl_index); - try decl_state.addTypeRelocGlobal(atom, fn_ret_type, @intCast(u32, dbg_info_buffer.items.len)); + try decl_state.addTypeRelocGlobal(di_atom_index, fn_ret_type, @intCast(u32, dbg_info_buffer.items.len)); dbg_info_buffer.items.len += 4; // DW.AT.type, DW.FORM.ref4 } @@ -1076,26 +1066,23 @@ pub fn commitDeclState( // This logic is nearly identical to the logic below in `updateDeclDebugInfo` for // `TextBlock` and the .debug_info. If you are editing this logic, you // probably need to edit that logic too. - const src_fn = switch (self.bin_file.tag) { - .elf => &decl.fn_link.elf, - .macho => &decl.fn_link.macho, - .wasm => &decl.fn_link.wasm.src_fn, - else => unreachable, // TODO - }; + const src_fn_index = self.src_fn_decls.get(decl_index).?; + const src_fn = self.getAtomPtr(.src_fn, src_fn_index); src_fn.len = @intCast(u32, dbg_line_buffer.items.len); - if (self.dbg_line_fn_last) |last| blk: { - if (src_fn == last) break :blk; - if (src_fn.next) |next| { + if (self.src_fn_last_index) |last_index| blk: { + if (src_fn_index == last_index) break :blk; + if (src_fn.next_index) |next_index| { + const next = self.getAtomPtr(.src_fn, next_index); // Update existing function - non-last item. if (src_fn.off + src_fn.len + min_nop_size > next.off) { // It grew too big, so we move it to a new location. - if (src_fn.prev) |prev| { - self.dbg_line_fn_free_list.put(gpa, prev, {}) catch {}; - prev.next = src_fn.next; + if (src_fn.prev_index) |prev_index| { + self.src_fn_free_list.put(gpa, prev_index, {}) catch {}; + self.getAtomPtr(.src_fn, prev_index).next_index = src_fn.next_index; } - next.prev = src_fn.prev; - src_fn.next = null; + next.prev_index = src_fn.prev_index; + src_fn.next_index = null; // Populate where it used to be with NOPs. switch (self.bin_file.tag) { .elf => { @@ -1118,33 +1105,42 @@ pub fn commitDeclState( else => unreachable, } // TODO Look at the free list before appending at the end. - src_fn.prev = last; - last.next = src_fn; - self.dbg_line_fn_last = src_fn; + src_fn.prev_index = last_index; + const last = self.getAtomPtr(.src_fn, last_index); + last.next_index = src_fn_index; + self.src_fn_last_index = src_fn_index; src_fn.off = last.off + padToIdeal(last.len); } - } else if (src_fn.prev == null) { + } else if (src_fn.prev_index == null) { // Append new function. // TODO Look at the free list before appending at the end. - src_fn.prev = last; - last.next = src_fn; - self.dbg_line_fn_last = src_fn; + src_fn.prev_index = last_index; + const last = self.getAtomPtr(.src_fn, last_index); + last.next_index = src_fn_index; + self.src_fn_last_index = src_fn_index; src_fn.off = last.off + padToIdeal(last.len); } } else { // This is the first function of the Line Number Program. - self.dbg_line_fn_first = src_fn; - self.dbg_line_fn_last = src_fn; + self.src_fn_first_index = src_fn_index; + self.src_fn_last_index = src_fn_index; src_fn.off = padToIdeal(self.dbgLineNeededHeaderBytes(&[0][]u8{}, &[0][]u8{})); } - const last_src_fn = self.dbg_line_fn_last.?; + const last_src_fn_index = self.src_fn_last_index.?; + const last_src_fn = self.getAtom(.src_fn, last_src_fn_index); const needed_size = last_src_fn.off + last_src_fn.len; - const prev_padding_size: u32 = if (src_fn.prev) |prev| src_fn.off - (prev.off + prev.len) else 0; - const next_padding_size: u32 = if (src_fn.next) |next| next.off - (src_fn.off + src_fn.len) else 0; + const prev_padding_size: u32 = if (src_fn.prev_index) |prev_index| blk: { + const prev = self.getAtom(.src_fn, prev_index); + break :blk src_fn.off - (prev.off + prev.len); + } else 0; + const next_padding_size: u32 = if (src_fn.next_index) |next_index| blk: { + const next = self.getAtom(.src_fn, next_index); + break :blk next.off - (src_fn.off + src_fn.len); + } else 0; // We only have support for one compilation unit so far, so the offsets are directly // from the .debug_line section. @@ -1213,7 +1209,7 @@ pub fn commitDeclState( if (dbg_info_buffer.items.len == 0) return; - const atom = getDbgInfoAtom(self.bin_file.tag, module, decl_index); + const di_atom_index = self.di_atom_decls.get(decl_index).?; if (decl_state.abbrev_table.items.len > 0) { // Now we emit the .debug_info types of the Decl. These will count towards the size of // the buffer, so we have to do it before computing the offset, and we can't perform the actual @@ -1235,12 +1231,12 @@ pub fn commitDeclState( if (deferred) continue; symbol.offset = @intCast(u32, dbg_info_buffer.items.len); - try decl_state.addDbgInfoType(module, atom, ty); + try decl_state.addDbgInfoType(module, di_atom_index, ty); } } log.debug("updateDeclDebugInfoAllocation for '{s}'", .{decl.name}); - try self.updateDeclDebugInfoAllocation(atom, @intCast(u32, dbg_info_buffer.items.len)); + try self.updateDeclDebugInfoAllocation(di_atom_index, @intCast(u32, dbg_info_buffer.items.len)); while (decl_state.abbrev_relocs.popOrNull()) |reloc| { if (reloc.target) |target| { @@ -1261,11 +1257,12 @@ pub fn commitDeclState( try self.global_abbrev_relocs.append(gpa, .{ .target = null, .offset = reloc.offset, - .atom = reloc.atom, + .atom_index = reloc.atom_index, .addend = reloc.addend, }); } else { - const value = symbol.atom.off + symbol.offset + reloc.addend; + const atom = self.getAtom(.di_atom, symbol.atom_index); + const value = atom.off + symbol.offset + reloc.addend; log.debug("{x}: [() => {x}] (%{d}, '{}')", .{ reloc.offset, value, target, ty.fmtDebug() }); mem.writeInt( u32, @@ -1275,10 +1272,11 @@ pub fn commitDeclState( ); } } else { + const atom = self.getAtom(.di_atom, reloc.atom_index); mem.writeInt( u32, dbg_info_buffer.items[reloc.offset..][0..@sizeOf(u32)], - reloc.atom.off + reloc.offset + reloc.addend, + atom.off + reloc.offset + reloc.addend, target_endian, ); } @@ -1294,7 +1292,7 @@ pub fn commitDeclState( .got_load => .got_load, }, .target = reloc.target, - .offset = reloc.offset + atom.off, + .offset = reloc.offset + self.getAtom(.di_atom, di_atom_index).off, .addend = 0, .prev_vaddr = 0, }); @@ -1304,10 +1302,10 @@ pub fn commitDeclState( } log.debug("writeDeclDebugInfo for '{s}", .{decl.name}); - try self.writeDeclDebugInfo(atom, dbg_info_buffer.items); + try self.writeDeclDebugInfo(di_atom_index, dbg_info_buffer.items); } -fn updateDeclDebugInfoAllocation(self: *Dwarf, atom: *Atom, len: u32) !void { +fn updateDeclDebugInfoAllocation(self: *Dwarf, atom_index: Atom.Index, len: u32) !void { const tracy = trace(@src()); defer tracy.end(); @@ -1316,19 +1314,21 @@ fn updateDeclDebugInfoAllocation(self: *Dwarf, atom: *Atom, len: u32) !void { // probably need to edit that logic too. const gpa = self.allocator; + const atom = self.getAtomPtr(.di_atom, atom_index); atom.len = len; - if (self.atom_last) |last| blk: { - if (atom == last) break :blk; - if (atom.next) |next| { + if (self.di_atom_last_index) |last_index| blk: { + if (atom_index == last_index) break :blk; + if (atom.next_index) |next_index| { + const next = self.getAtomPtr(.di_atom, next_index); // Update existing Decl - non-last item. if (atom.off + atom.len + min_nop_size > next.off) { // It grew too big, so we move it to a new location. - if (atom.prev) |prev| { - self.atom_free_list.put(gpa, prev, {}) catch {}; - prev.next = atom.next; + if (atom.prev_index) |prev_index| { + self.di_atom_free_list.put(gpa, prev_index, {}) catch {}; + self.getAtomPtr(.di_atom, prev_index).next_index = atom.next_index; } - next.prev = atom.prev; - atom.next = null; + next.prev_index = atom.prev_index; + atom.next_index = null; // Populate where it used to be with NOPs. switch (self.bin_file.tag) { .elf => { @@ -1351,31 +1351,33 @@ fn updateDeclDebugInfoAllocation(self: *Dwarf, atom: *Atom, len: u32) !void { else => unreachable, } // TODO Look at the free list before appending at the end. - atom.prev = last; - last.next = atom; - self.atom_last = atom; + atom.prev_index = last_index; + const last = self.getAtomPtr(.di_atom, last_index); + last.next_index = atom_index; + self.di_atom_last_index = atom_index; atom.off = last.off + padToIdeal(last.len); } - } else if (atom.prev == null) { + } else if (atom.prev_index == null) { // Append new Decl. // TODO Look at the free list before appending at the end. - atom.prev = last; - last.next = atom; - self.atom_last = atom; + atom.prev_index = last_index; + const last = self.getAtomPtr(.di_atom, last_index); + last.next_index = atom_index; + self.di_atom_last_index = atom_index; atom.off = last.off + padToIdeal(last.len); } } else { // This is the first Decl of the .debug_info - self.atom_first = atom; - self.atom_last = atom; + self.di_atom_first_index = atom_index; + self.di_atom_last_index = atom_index; atom.off = @intCast(u32, padToIdeal(self.dbgInfoHeaderBytes())); } } -fn writeDeclDebugInfo(self: *Dwarf, atom: *Atom, dbg_info_buf: []const u8) !void { +fn writeDeclDebugInfo(self: *Dwarf, atom_index: Atom.Index, dbg_info_buf: []const u8) !void { const tracy = trace(@src()); defer tracy.end(); @@ -1384,14 +1386,22 @@ fn writeDeclDebugInfo(self: *Dwarf, atom: *Atom, dbg_info_buf: []const u8) !void // probably need to edit that logic too. const gpa = self.allocator; - const last_decl = self.atom_last.?; + const atom = self.getAtom(.di_atom, atom_index); + const last_decl_index = self.di_atom_last_index.?; + const last_decl = self.getAtom(.di_atom, last_decl_index); // +1 for a trailing zero to end the children of the decl tag. const needed_size = last_decl.off + last_decl.len + 1; - const prev_padding_size: u32 = if (atom.prev) |prev| atom.off - (prev.off + prev.len) else 0; - const next_padding_size: u32 = if (atom.next) |next| next.off - (atom.off + atom.len) else 0; + const prev_padding_size: u32 = if (atom.prev_index) |prev_index| blk: { + const prev = self.getAtom(.di_atom, prev_index); + break :blk atom.off - (prev.off + prev.len); + } else 0; + const next_padding_size: u32 = if (atom.next_index) |next_index| blk: { + const next = self.getAtom(.di_atom, next_index); + break :blk next.off - (atom.off + atom.len); + } else 0; // To end the children of the decl tag. - const trailing_zero = atom.next == null; + const trailing_zero = atom.next_index == null; // We only have support for one compilation unit so far, so the offsets are directly // from the .debug_info section. @@ -1459,10 +1469,15 @@ fn writeDeclDebugInfo(self: *Dwarf, atom: *Atom, dbg_info_buf: []const u8) !void } } -pub fn updateDeclLineNumber(self: *Dwarf, decl: *const Module.Decl) !void { +pub fn updateDeclLineNumber(self: *Dwarf, module: *Module, decl_index: Module.Decl.Index) !void { const tracy = trace(@src()); defer tracy.end(); + const atom_index = try self.getOrCreateAtomForDecl(.src_fn, decl_index); + const atom = self.getAtom(.src_fn, atom_index); + if (atom.len == 0) return; + + const decl = module.declPtr(decl_index); const func = decl.val.castTag(.function).?.data; log.debug("decl.src_line={d}, func.lbrace_line={d}, func.rbrace_line={d}", .{ decl.src_line, @@ -1477,78 +1492,80 @@ pub fn updateDeclLineNumber(self: *Dwarf, decl: *const Module.Decl) !void { .elf => { const elf_file = self.bin_file.cast(File.Elf).?; const shdr = elf_file.sections.items(.shdr)[elf_file.debug_line_section_index.?]; - const file_pos = shdr.sh_offset + decl.fn_link.elf.off + self.getRelocDbgLineOff(); + const file_pos = shdr.sh_offset + atom.off + self.getRelocDbgLineOff(); try elf_file.base.file.?.pwriteAll(&data, file_pos); }, .macho => { const d_sym = self.bin_file.cast(File.MachO).?.getDebugSymbols().?; const sect = d_sym.getSection(d_sym.debug_line_section_index.?); - const file_pos = sect.offset + decl.fn_link.macho.off + self.getRelocDbgLineOff(); + const file_pos = sect.offset + atom.off + self.getRelocDbgLineOff(); try d_sym.file.pwriteAll(&data, file_pos); }, .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; - const offset = decl.fn_link.wasm.src_fn.off + self.getRelocDbgLineOff(); - const atom = wasm_file.debug_line_atom.?; - mem.copy(u8, atom.code.items[offset..], &data); + const offset = atom.off + self.getRelocDbgLineOff(); + const atom_ = wasm_file.debug_line_atom.?; + mem.copy(u8, atom_.code.items[offset..], &data); }, else => unreachable, } } -pub fn freeAtom(self: *Dwarf, atom: *Atom) void { - if (self.atom_first == atom) { - self.atom_first = atom.next; - } - if (self.atom_last == atom) { - // TODO shrink the .debug_info section size here - self.atom_last = atom.prev; - } - - if (atom.prev) |prev| { - prev.next = atom.next; - - // TODO the free list logic like we do for text blocks above - } else { - atom.prev = null; - } - - if (atom.next) |next| { - next.prev = atom.prev; - } else { - atom.next = null; - } -} - -pub fn freeDecl(self: *Dwarf, decl: *Module.Decl) void { - // TODO make this logic match freeTextBlock. Maybe abstract the logic out since the same thing - // is desired for both. +pub fn freeDecl(self: *Dwarf, decl_index: Module.Decl.Index) void { const gpa = self.allocator; - const fn_link = switch (self.bin_file.tag) { - .elf => &decl.fn_link.elf, - .macho => &decl.fn_link.macho, - .wasm => &decl.fn_link.wasm.src_fn, - else => unreachable, - }; - _ = self.dbg_line_fn_free_list.remove(fn_link); - if (fn_link.prev) |prev| { - self.dbg_line_fn_free_list.put(gpa, prev, {}) catch {}; - prev.next = fn_link.next; - if (fn_link.next) |next| { - next.prev = prev; - } else { - self.dbg_line_fn_last = prev; + // Free SrcFn atom + if (self.src_fn_decls.fetchRemove(decl_index)) |kv| { + const src_fn_index = kv.value; + const src_fn = self.getAtom(.src_fn, src_fn_index); + _ = self.src_fn_free_list.remove(src_fn_index); + + if (src_fn.prev_index) |prev_index| { + self.src_fn_free_list.put(gpa, prev_index, {}) catch {}; + const prev = self.getAtomPtr(.src_fn, prev_index); + prev.next_index = src_fn.next_index; + if (src_fn.next_index) |next_index| { + self.getAtomPtr(.src_fn, next_index).prev_index = prev_index; + } else { + self.src_fn_last_index = prev_index; + } + } else if (src_fn.next_index) |next_index| { + self.src_fn_first_index = next_index; + self.getAtomPtr(.src_fn, next_index).prev_index = null; + } + if (self.src_fn_first_index == src_fn_index) { + self.src_fn_first_index = src_fn.next_index; + } + if (self.src_fn_last_index == src_fn_index) { + self.src_fn_last_index = src_fn.prev_index; } - } else if (fn_link.next) |next| { - self.dbg_line_fn_first = next; - next.prev = null; } - if (self.dbg_line_fn_first == fn_link) { - self.dbg_line_fn_first = fn_link.next; - } - if (self.dbg_line_fn_last == fn_link) { - self.dbg_line_fn_last = fn_link.prev; + + // Free DI atom + if (self.di_atom_decls.fetchRemove(decl_index)) |kv| { + const di_atom_index = kv.value; + const di_atom = self.getAtomPtr(.di_atom, di_atom_index); + + if (self.di_atom_first_index == di_atom_index) { + self.di_atom_first_index = di_atom.next_index; + } + if (self.di_atom_last_index == di_atom_index) { + // TODO shrink the .debug_info section size here + self.di_atom_last_index = di_atom.prev_index; + } + + if (di_atom.prev_index) |prev_index| { + self.getAtomPtr(.di_atom, prev_index).next_index = di_atom.next_index; + // TODO the free list logic like we do for SrcFn above + } else { + di_atom.prev_index = null; + } + + if (di_atom.next_index) |next_index| { + self.getAtomPtr(.di_atom, next_index).prev_index = di_atom.prev_index; + } else { + di_atom.next_index = null; + } } } @@ -2276,10 +2293,14 @@ pub fn writeDbgLineHeader(self: *Dwarf) !void { const needed_with_padding = padToIdeal(needed_bytes); const delta = needed_with_padding - dbg_line_prg_off; - var src_fn = self.dbg_line_fn_first.?; - const last_fn = self.dbg_line_fn_last.?; + const first_fn_index = self.src_fn_first_index.?; + const first_fn = self.getAtom(.src_fn, first_fn_index); + const last_fn_index = self.src_fn_last_index.?; + const last_fn = self.getAtom(.src_fn, last_fn_index); - var buffer = try gpa.alloc(u8, last_fn.off + last_fn.len - src_fn.off); + var src_fn_index = first_fn_index; + + var buffer = try gpa.alloc(u8, last_fn.off + last_fn.len - first_fn.off); defer gpa.free(buffer); switch (self.bin_file.tag) { @@ -2288,7 +2309,7 @@ pub fn writeDbgLineHeader(self: *Dwarf) !void { const shdr_index = elf_file.debug_line_section_index.?; const needed_size = elf_file.sections.items(.shdr)[shdr_index].sh_size + delta; try elf_file.growNonAllocSection(shdr_index, needed_size, 1, true); - const file_pos = elf_file.sections.items(.shdr)[shdr_index].sh_offset + src_fn.off; + const file_pos = elf_file.sections.items(.shdr)[shdr_index].sh_offset + first_fn.off; const amt = try elf_file.base.file.?.preadAll(buffer, file_pos); if (amt != buffer.len) return error.InputOutput; @@ -2300,7 +2321,7 @@ pub fn writeDbgLineHeader(self: *Dwarf) !void { const sect_index = d_sym.debug_line_section_index.?; const needed_size = @intCast(u32, d_sym.getSection(sect_index).size + delta); try d_sym.growSection(sect_index, needed_size, true); - const file_pos = d_sym.getSection(sect_index).offset + src_fn.off; + const file_pos = d_sym.getSection(sect_index).offset + first_fn.off; const amt = try d_sym.file.preadAll(buffer, file_pos); if (amt != buffer.len) return error.InputOutput; @@ -2310,18 +2331,19 @@ pub fn writeDbgLineHeader(self: *Dwarf) !void { .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; const debug_line = &wasm_file.debug_line_atom.?.code; - mem.copy(u8, buffer, debug_line.items[src_fn.off..]); + mem.copy(u8, buffer, debug_line.items[first_fn.off..]); try debug_line.resize(self.allocator, debug_line.items.len + delta); - mem.copy(u8, debug_line.items[src_fn.off + delta ..], buffer); + mem.copy(u8, debug_line.items[first_fn.off + delta ..], buffer); }, else => unreachable, } while (true) { + const src_fn = self.getAtomPtr(.src_fn, src_fn_index); src_fn.off += delta; - if (src_fn.next) |next| { - src_fn = next; + if (src_fn.next_index) |next_index| { + src_fn_index = next_index; } else break; } } @@ -2367,22 +2389,26 @@ pub fn writeDbgLineHeader(self: *Dwarf) !void { } fn getDebugInfoOff(self: Dwarf) ?u32 { - const first = self.atom_first orelse return null; + const first_index = self.di_atom_first_index orelse return null; + const first = self.getAtom(.di_atom, first_index); return first.off; } fn getDebugInfoEnd(self: Dwarf) ?u32 { - const last = self.atom_last orelse return null; + const last_index = self.di_atom_last_index orelse return null; + const last = self.getAtom(.di_atom, last_index); return last.off + last.len; } fn getDebugLineProgramOff(self: Dwarf) ?u32 { - const first = self.dbg_line_fn_first orelse return null; + const first_index = self.src_fn_first_index orelse return null; + const first = self.getAtom(.src_fn, first_index); return first.off; } fn getDebugLineProgramEnd(self: Dwarf) ?u32 { - const last = self.dbg_line_fn_last orelse return null; + const last_index = self.src_fn_last_index orelse return null; + const last = self.getAtom(.src_fn, last_index); return last.off + last.len; } @@ -2457,23 +2483,14 @@ pub fn flushModule(self: *Dwarf, module: *Module) !void { } error_set.names = names; - const atom = try gpa.create(Atom); - errdefer gpa.destroy(atom); - atom.* = .{ - .prev = null, - .next = null, - .off = 0, - .len = 0, - }; - var dbg_info_buffer = std.ArrayList(u8).init(arena); try addDbgInfoErrorSet(arena, module, error_ty, self.target, &dbg_info_buffer); - try self.managed_atoms.append(gpa, atom); + const di_atom_index = try self.createAtom(.di_atom); log.debug("updateDeclDebugInfoAllocation in flushModule", .{}); - try self.updateDeclDebugInfoAllocation(atom, @intCast(u32, dbg_info_buffer.items.len)); + try self.updateDeclDebugInfoAllocation(di_atom_index, @intCast(u32, dbg_info_buffer.items.len)); log.debug("writeDeclDebugInfo in flushModule", .{}); - try self.writeDeclDebugInfo(atom, dbg_info_buffer.items); + try self.writeDeclDebugInfo(di_atom_index, dbg_info_buffer.items); const file_pos = blk: { switch (self.bin_file.tag) { @@ -2494,22 +2511,23 @@ pub fn flushModule(self: *Dwarf, module: *Module) !void { }; var buf: [@sizeOf(u32)]u8 = undefined; - mem.writeInt(u32, &buf, atom.off, self.target.cpu.arch.endian()); + mem.writeInt(u32, &buf, self.getAtom(.di_atom, di_atom_index).off, self.target.cpu.arch.endian()); while (self.global_abbrev_relocs.popOrNull()) |reloc| { + const atom = self.getAtom(.di_atom, reloc.atom_index); switch (self.bin_file.tag) { .elf => { const elf_file = self.bin_file.cast(File.Elf).?; - try elf_file.base.file.?.pwriteAll(&buf, file_pos + reloc.atom.off + reloc.offset); + try elf_file.base.file.?.pwriteAll(&buf, file_pos + atom.off + reloc.offset); }, .macho => { const d_sym = self.bin_file.cast(File.MachO).?.getDebugSymbols().?; - try d_sym.file.pwriteAll(&buf, file_pos + reloc.atom.off + reloc.offset); + try d_sym.file.pwriteAll(&buf, file_pos + atom.off + reloc.offset); }, .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; const debug_info = wasm_file.debug_info_atom.?.code; - mem.copy(u8, debug_info.items[reloc.atom.off + reloc.offset ..], &buf); + mem.copy(u8, debug_info.items[atom.off + reloc.offset ..], &buf); }, else => unreachable, } @@ -2627,12 +2645,62 @@ fn addDbgInfoErrorSet( try dbg_info_buffer.append(0); } -fn getDbgInfoAtom(tag: File.Tag, mod: *Module, decl_index: Module.Decl.Index) *Atom { - const decl = mod.declPtr(decl_index); - return switch (tag) { - .elf => unreachable, - .macho => unreachable, - .wasm => &decl.link.wasm.dbg_info_atom, - else => unreachable, +const Kind = enum { src_fn, di_atom }; + +fn createAtom(self: *Dwarf, comptime kind: Kind) !Atom.Index { + const index = blk: { + switch (kind) { + .src_fn => { + const index = @intCast(Atom.Index, self.src_fns.items.len); + _ = try self.src_fns.addOne(self.allocator); + break :blk index; + }, + .di_atom => { + const index = @intCast(Atom.Index, self.di_atoms.items.len); + _ = try self.di_atoms.addOne(self.allocator); + break :blk index; + }, + } + }; + const atom = self.getAtomPtr(kind, index); + atom.* = .{ + .off = 0, + .len = 0, + .prev_index = null, + .next_index = null, + }; + return index; +} + +fn getOrCreateAtomForDecl(self: *Dwarf, comptime kind: Kind, decl_index: Module.Decl.Index) !Atom.Index { + switch (kind) { + .src_fn => { + const gop = try self.src_fn_decls.getOrPut(self.allocator, decl_index); + if (!gop.found_existing) { + gop.value_ptr.* = try self.createAtom(kind); + } + return gop.value_ptr.*; + }, + .di_atom => { + const gop = try self.di_atom_decls.getOrPut(self.allocator, decl_index); + if (!gop.found_existing) { + gop.value_ptr.* = try self.createAtom(kind); + } + return gop.value_ptr.*; + }, + } +} + +fn getAtom(self: *const Dwarf, comptime kind: Kind, index: Atom.Index) Atom { + return switch (kind) { + .src_fn => self.src_fns.items[index], + .di_atom => self.di_atoms.items[index], + }; +} + +fn getAtomPtr(self: *Dwarf, comptime kind: Kind, index: Atom.Index) *Atom { + return switch (kind) { + .src_fn => &self.src_fns.items[index], + .di_atom => &self.di_atoms.items[index], }; } diff --git a/src/link/Elf.zig b/src/link/Elf.zig index 01326fb82e..3e0c6d2b57 100644 --- a/src/link/Elf.zig +++ b/src/link/Elf.zig @@ -344,9 +344,9 @@ pub fn deinit(self: *Elf) void { self.relocs.deinit(gpa); } - // if (self.dwarf) |*dw| { - // dw.deinit(); - // } + if (self.dwarf) |*dw| { + dw.deinit(); + } } pub fn getDeclVAddr(self: *Elf, decl_index: Module.Decl.Index, reloc_info: File.RelocInfo) !u64 { @@ -685,146 +685,146 @@ pub fn populateMissingMetadata(self: *Elf) !void { try self.writeSymbol(0); } - // if (self.dwarf) |*dw| { - // if (self.debug_str_section_index == null) { - // self.debug_str_section_index = @intCast(u16, self.sections.slice().len); - // assert(dw.strtab.buffer.items.len == 0); - // try dw.strtab.buffer.append(gpa, 0); - // try self.sections.append(gpa, .{ - // .shdr = .{ - // .sh_name = try self.shstrtab.insert(gpa, ".debug_str"), - // .sh_type = elf.SHT_PROGBITS, - // .sh_flags = elf.SHF_MERGE | elf.SHF_STRINGS, - // .sh_addr = 0, - // .sh_offset = 0, - // .sh_size = 0, - // .sh_link = 0, - // .sh_info = 0, - // .sh_addralign = 1, - // .sh_entsize = 1, - // }, - // .phdr_index = undefined, - // }); - // self.debug_strtab_dirty = true; - // self.shdr_table_dirty = true; - // } + if (self.dwarf) |*dw| { + if (self.debug_str_section_index == null) { + self.debug_str_section_index = @intCast(u16, self.sections.slice().len); + assert(dw.strtab.buffer.items.len == 0); + try dw.strtab.buffer.append(gpa, 0); + try self.sections.append(gpa, .{ + .shdr = .{ + .sh_name = try self.shstrtab.insert(gpa, ".debug_str"), + .sh_type = elf.SHT_PROGBITS, + .sh_flags = elf.SHF_MERGE | elf.SHF_STRINGS, + .sh_addr = 0, + .sh_offset = 0, + .sh_size = 0, + .sh_link = 0, + .sh_info = 0, + .sh_addralign = 1, + .sh_entsize = 1, + }, + .phdr_index = undefined, + }); + self.debug_strtab_dirty = true; + self.shdr_table_dirty = true; + } - // if (self.debug_info_section_index == null) { - // self.debug_info_section_index = @intCast(u16, self.sections.slice().len); + if (self.debug_info_section_index == null) { + self.debug_info_section_index = @intCast(u16, self.sections.slice().len); - // const file_size_hint = 200; - // const p_align = 1; - // const off = self.findFreeSpace(file_size_hint, p_align); - // log.debug("found .debug_info free space 0x{x} to 0x{x}", .{ - // off, - // off + file_size_hint, - // }); - // try self.sections.append(gpa, .{ - // .shdr = .{ - // .sh_name = try self.shstrtab.insert(gpa, ".debug_info"), - // .sh_type = elf.SHT_PROGBITS, - // .sh_flags = 0, - // .sh_addr = 0, - // .sh_offset = off, - // .sh_size = file_size_hint, - // .sh_link = 0, - // .sh_info = 0, - // .sh_addralign = p_align, - // .sh_entsize = 0, - // }, - // .phdr_index = undefined, - // }); - // self.shdr_table_dirty = true; - // self.debug_info_header_dirty = true; - // } + const file_size_hint = 200; + const p_align = 1; + const off = self.findFreeSpace(file_size_hint, p_align); + log.debug("found .debug_info free space 0x{x} to 0x{x}", .{ + off, + off + file_size_hint, + }); + try self.sections.append(gpa, .{ + .shdr = .{ + .sh_name = try self.shstrtab.insert(gpa, ".debug_info"), + .sh_type = elf.SHT_PROGBITS, + .sh_flags = 0, + .sh_addr = 0, + .sh_offset = off, + .sh_size = file_size_hint, + .sh_link = 0, + .sh_info = 0, + .sh_addralign = p_align, + .sh_entsize = 0, + }, + .phdr_index = undefined, + }); + self.shdr_table_dirty = true; + self.debug_info_header_dirty = true; + } - // if (self.debug_abbrev_section_index == null) { - // self.debug_abbrev_section_index = @intCast(u16, self.sections.slice().len); + if (self.debug_abbrev_section_index == null) { + self.debug_abbrev_section_index = @intCast(u16, self.sections.slice().len); - // const file_size_hint = 128; - // const p_align = 1; - // const off = self.findFreeSpace(file_size_hint, p_align); - // log.debug("found .debug_abbrev free space 0x{x} to 0x{x}", .{ - // off, - // off + file_size_hint, - // }); - // try self.sections.append(gpa, .{ - // .shdr = .{ - // .sh_name = try self.shstrtab.insert(gpa, ".debug_abbrev"), - // .sh_type = elf.SHT_PROGBITS, - // .sh_flags = 0, - // .sh_addr = 0, - // .sh_offset = off, - // .sh_size = file_size_hint, - // .sh_link = 0, - // .sh_info = 0, - // .sh_addralign = p_align, - // .sh_entsize = 0, - // }, - // .phdr_index = undefined, - // }); - // self.shdr_table_dirty = true; - // self.debug_abbrev_section_dirty = true; - // } + const file_size_hint = 128; + const p_align = 1; + const off = self.findFreeSpace(file_size_hint, p_align); + log.debug("found .debug_abbrev free space 0x{x} to 0x{x}", .{ + off, + off + file_size_hint, + }); + try self.sections.append(gpa, .{ + .shdr = .{ + .sh_name = try self.shstrtab.insert(gpa, ".debug_abbrev"), + .sh_type = elf.SHT_PROGBITS, + .sh_flags = 0, + .sh_addr = 0, + .sh_offset = off, + .sh_size = file_size_hint, + .sh_link = 0, + .sh_info = 0, + .sh_addralign = p_align, + .sh_entsize = 0, + }, + .phdr_index = undefined, + }); + self.shdr_table_dirty = true; + self.debug_abbrev_section_dirty = true; + } - // if (self.debug_aranges_section_index == null) { - // self.debug_aranges_section_index = @intCast(u16, self.sections.slice().len); + if (self.debug_aranges_section_index == null) { + self.debug_aranges_section_index = @intCast(u16, self.sections.slice().len); - // const file_size_hint = 160; - // const p_align = 16; - // const off = self.findFreeSpace(file_size_hint, p_align); - // log.debug("found .debug_aranges free space 0x{x} to 0x{x}", .{ - // off, - // off + file_size_hint, - // }); - // try self.sections.append(gpa, .{ - // .shdr = .{ - // .sh_name = try self.shstrtab.insert(gpa, ".debug_aranges"), - // .sh_type = elf.SHT_PROGBITS, - // .sh_flags = 0, - // .sh_addr = 0, - // .sh_offset = off, - // .sh_size = file_size_hint, - // .sh_link = 0, - // .sh_info = 0, - // .sh_addralign = p_align, - // .sh_entsize = 0, - // }, - // .phdr_index = undefined, - // }); - // self.shdr_table_dirty = true; - // self.debug_aranges_section_dirty = true; - // } + const file_size_hint = 160; + const p_align = 16; + const off = self.findFreeSpace(file_size_hint, p_align); + log.debug("found .debug_aranges free space 0x{x} to 0x{x}", .{ + off, + off + file_size_hint, + }); + try self.sections.append(gpa, .{ + .shdr = .{ + .sh_name = try self.shstrtab.insert(gpa, ".debug_aranges"), + .sh_type = elf.SHT_PROGBITS, + .sh_flags = 0, + .sh_addr = 0, + .sh_offset = off, + .sh_size = file_size_hint, + .sh_link = 0, + .sh_info = 0, + .sh_addralign = p_align, + .sh_entsize = 0, + }, + .phdr_index = undefined, + }); + self.shdr_table_dirty = true; + self.debug_aranges_section_dirty = true; + } - // if (self.debug_line_section_index == null) { - // self.debug_line_section_index = @intCast(u16, self.sections.slice().len); + if (self.debug_line_section_index == null) { + self.debug_line_section_index = @intCast(u16, self.sections.slice().len); - // const file_size_hint = 250; - // const p_align = 1; - // const off = self.findFreeSpace(file_size_hint, p_align); - // log.debug("found .debug_line free space 0x{x} to 0x{x}", .{ - // off, - // off + file_size_hint, - // }); - // try self.sections.append(gpa, .{ - // .shdr = .{ - // .sh_name = try self.shstrtab.insert(gpa, ".debug_line"), - // .sh_type = elf.SHT_PROGBITS, - // .sh_flags = 0, - // .sh_addr = 0, - // .sh_offset = off, - // .sh_size = file_size_hint, - // .sh_link = 0, - // .sh_info = 0, - // .sh_addralign = p_align, - // .sh_entsize = 0, - // }, - // .phdr_index = undefined, - // }); - // self.shdr_table_dirty = true; - // self.debug_line_header_dirty = true; - // } - // } + const file_size_hint = 250; + const p_align = 1; + const off = self.findFreeSpace(file_size_hint, p_align); + log.debug("found .debug_line free space 0x{x} to 0x{x}", .{ + off, + off + file_size_hint, + }); + try self.sections.append(gpa, .{ + .shdr = .{ + .sh_name = try self.shstrtab.insert(gpa, ".debug_line"), + .sh_type = elf.SHT_PROGBITS, + .sh_flags = 0, + .sh_addr = 0, + .sh_offset = off, + .sh_size = file_size_hint, + .sh_link = 0, + .sh_info = 0, + .sh_addralign = p_align, + .sh_entsize = 0, + }, + .phdr_index = undefined, + }); + self.shdr_table_dirty = true; + self.debug_line_header_dirty = true; + } + } const shsize: u64 = switch (self.ptr_width) { .p32 => @sizeOf(elf.Elf32_Shdr), @@ -956,26 +956,25 @@ pub fn growNonAllocSection( } pub fn markDirty(self: *Elf, shdr_index: u16, phdr_index: ?u16) void { - _ = shdr_index; self.shdr_table_dirty = true; // TODO look into only writing one section if (phdr_index) |_| { self.phdr_table_dirty = true; // TODO look into making only the one program header dirty } - // if (self.dwarf) |_| { - // if (self.debug_info_section_index.? == shdr_index) { - // self.debug_info_header_dirty = true; - // } else if (self.debug_line_section_index.? == shdr_index) { - // self.debug_line_header_dirty = true; - // } else if (self.debug_abbrev_section_index.? == shdr_index) { - // self.debug_abbrev_section_dirty = true; - // } else if (self.debug_str_section_index.? == shdr_index) { - // self.debug_strtab_dirty = true; - // } else if (self.debug_aranges_section_index.? == shdr_index) { - // self.debug_aranges_section_dirty = true; - // } - // } + if (self.dwarf) |_| { + if (self.debug_info_section_index.? == shdr_index) { + self.debug_info_header_dirty = true; + } else if (self.debug_line_section_index.? == shdr_index) { + self.debug_line_header_dirty = true; + } else if (self.debug_abbrev_section_index.? == shdr_index) { + self.debug_abbrev_section_dirty = true; + } else if (self.debug_str_section_index.? == shdr_index) { + self.debug_strtab_dirty = true; + } else if (self.debug_aranges_section_index.? == shdr_index) { + self.debug_aranges_section_dirty = true; + } + } } pub fn flush(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node) link.File.FlushError!void { @@ -1015,14 +1014,13 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node // TODO This linker code currently assumes there is only 1 compilation unit and it // corresponds to the Zig source code. const module = self.base.options.module orelse return error.LinkingWithoutZigSourceUnimplemented; - _ = module; const target_endian = self.base.options.target.cpu.arch.endian(); const foreign_endian = target_endian != builtin.cpu.arch.endian(); - // if (self.dwarf) |*dw| { - // try dw.flushModule(module); - // } + if (self.dwarf) |*dw| { + try dw.flushModule(module); + } { var it = self.relocs.iterator(); @@ -1068,43 +1066,43 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node self.logSymtab(); } - // if (self.dwarf) |*dw| { - // if (self.debug_abbrev_section_dirty) { - // try dw.writeDbgAbbrev(); - // if (!self.shdr_table_dirty) { - // // Then it won't get written with the others and we need to do it. - // try self.writeSectHeader(self.debug_abbrev_section_index.?); - // } - // self.debug_abbrev_section_dirty = false; - // } + if (self.dwarf) |*dw| { + if (self.debug_abbrev_section_dirty) { + try dw.writeDbgAbbrev(); + if (!self.shdr_table_dirty) { + // Then it won't get written with the others and we need to do it. + try self.writeSectHeader(self.debug_abbrev_section_index.?); + } + self.debug_abbrev_section_dirty = false; + } - // if (self.debug_info_header_dirty) { - // // Currently only one compilation unit is supported, so the address range is simply - // // identical to the main program header virtual address and memory size. - // const text_phdr = &self.program_headers.items[self.phdr_load_re_index.?]; - // const low_pc = text_phdr.p_vaddr; - // const high_pc = text_phdr.p_vaddr + text_phdr.p_memsz; - // try dw.writeDbgInfoHeader(module, low_pc, high_pc); - // self.debug_info_header_dirty = false; - // } + if (self.debug_info_header_dirty) { + // Currently only one compilation unit is supported, so the address range is simply + // identical to the main program header virtual address and memory size. + const text_phdr = &self.program_headers.items[self.phdr_load_re_index.?]; + const low_pc = text_phdr.p_vaddr; + const high_pc = text_phdr.p_vaddr + text_phdr.p_memsz; + try dw.writeDbgInfoHeader(module, low_pc, high_pc); + self.debug_info_header_dirty = false; + } - // if (self.debug_aranges_section_dirty) { - // // Currently only one compilation unit is supported, so the address range is simply - // // identical to the main program header virtual address and memory size. - // const text_phdr = &self.program_headers.items[self.phdr_load_re_index.?]; - // try dw.writeDbgAranges(text_phdr.p_vaddr, text_phdr.p_memsz); - // if (!self.shdr_table_dirty) { - // // Then it won't get written with the others and we need to do it. - // try self.writeSectHeader(self.debug_aranges_section_index.?); - // } - // self.debug_aranges_section_dirty = false; - // } + if (self.debug_aranges_section_dirty) { + // Currently only one compilation unit is supported, so the address range is simply + // identical to the main program header virtual address and memory size. + const text_phdr = &self.program_headers.items[self.phdr_load_re_index.?]; + try dw.writeDbgAranges(text_phdr.p_vaddr, text_phdr.p_memsz); + if (!self.shdr_table_dirty) { + // Then it won't get written with the others and we need to do it. + try self.writeSectHeader(self.debug_aranges_section_index.?); + } + self.debug_aranges_section_dirty = false; + } - // if (self.debug_line_header_dirty) { - // try dw.writeDbgLineHeader(); - // self.debug_line_header_dirty = false; - // } - // } + if (self.debug_line_header_dirty) { + try dw.writeDbgLineHeader(); + self.debug_line_header_dirty = false; + } + } if (self.phdr_table_dirty) { const phsize: u64 = switch (self.ptr_width) { @@ -1162,15 +1160,15 @@ pub fn flushModule(self: *Elf, comp: *Compilation, prog_node: *std.Progress.Node } } - // if (self.dwarf) |dwarf| { - // const shdr_index = self.debug_str_section_index.?; - // if (self.debug_strtab_dirty or dwarf.strtab.buffer.items.len != self.sections.items(.shdr)[shdr_index].sh_size) { - // try self.growNonAllocSection(shdr_index, dwarf.strtab.buffer.items.len, 1, false); - // const debug_strtab_sect = self.sections.items(.shdr)[shdr_index]; - // try self.base.file.?.pwriteAll(dwarf.strtab.buffer.items, debug_strtab_sect.sh_offset); - // self.debug_strtab_dirty = false; - // } - // } + if (self.dwarf) |dwarf| { + const shdr_index = self.debug_str_section_index.?; + if (self.debug_strtab_dirty or dwarf.strtab.buffer.items.len != self.sections.items(.shdr)[shdr_index].sh_size) { + try self.growNonAllocSection(shdr_index, dwarf.strtab.buffer.items.len, 1, false); + const debug_strtab_sect = self.sections.items(.shdr)[shdr_index]; + try self.base.file.?.pwriteAll(dwarf.strtab.buffer.items, debug_strtab_sect.sh_offset); + self.debug_strtab_dirty = false; + } + } if (self.shdr_table_dirty) { const shsize: u64 = switch (self.ptr_width) { @@ -2100,10 +2098,6 @@ fn freeAtom(self: *Elf, atom_index: Atom.Index) void { self.getAtomPtr(atom_index).local_sym_index = 0; self.offset_table_free_list.append(self.base.allocator, atom.offset_table_index) catch {}; - - // if (self.dwarf) |*dw| { - // dw.freeAtom(&atom.dbg_info_atom); - // } } fn shrinkAtom(self: *Elf, atom_index: Atom.Index, new_block_size: u64) void { @@ -2133,7 +2127,6 @@ pub fn createAtom(self: *Elf) !Atom.Index { .offset_table_index = offset_table_index, .prev_index = null, .next_index = null, - .dbg_info_atom = undefined, }; log.debug("creating ATOM(%{d}) at index {d}", .{ local_sym_index, atom_index }); return atom_index; @@ -2219,16 +2212,16 @@ fn allocateAtom(self: *Elf, atom_index: Atom.Index, new_block_size: u64, alignme try self.growAllocSection(sym.st_shndx, needed_size); maybe_last_atom_index.* = atom_index; - // if (self.dwarf) |_| { - // // The .debug_info section has `low_pc` and `high_pc` values which is the virtual address - // // range of the compilation unit. When we expand the text section, this range changes, - // // so the DW_TAG.compile_unit tag of the .debug_info section becomes dirty. - // self.debug_info_header_dirty = true; - // // This becomes dirty for the same reason. We could potentially make this more - // // fine-grained with the addition of support for more compilation units. It is planned to - // // model each package as a different compilation unit. - // self.debug_aranges_section_dirty = true; - // } + if (self.dwarf) |_| { + // The .debug_info section has `low_pc` and `high_pc` values which is the virtual address + // range of the compilation unit. When we expand the text section, this range changes, + // so the DW_TAG.compile_unit tag of the .debug_info section becomes dirty. + self.debug_info_header_dirty = true; + // This becomes dirty for the same reason. We could potentially make this more + // fine-grained with the addition of support for more compilation units. It is planned to + // model each package as a different compilation unit. + self.debug_aranges_section_dirty = true; + } } shdr.sh_addralign = math.max(shdr.sh_addralign, alignment); @@ -2333,9 +2326,9 @@ pub fn freeDecl(self: *Elf, decl_index: Module.Decl.Index) void { kv.value.exports.deinit(self.base.allocator); } - // if (self.dwarf) |*dw| { - // dw.freeDecl(decl); - // } + if (self.dwarf) |*dw| { + dw.freeDecl(decl_index); + } } pub fn getOrCreateAtomForDecl(self: *Elf, decl_index: Module.Decl.Index) !Atom.Index { @@ -2471,15 +2464,15 @@ pub fn updateFunc(self: *Elf, module: *Module, func: *Module.Fn, air: Air, liven var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); - // var decl_state: ?Dwarf.DeclState = if (self.dwarf) |*dw| try dw.initDeclState(module, decl_index) else null; - // defer if (decl_state) |*ds| ds.deinit(); + var decl_state: ?Dwarf.DeclState = if (self.dwarf) |*dw| try dw.initDeclState(module, decl_index) else null; + defer if (decl_state) |*ds| ds.deinit(); - // const res = if (decl_state) |*ds| - // try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .{ - // .dwarf = ds, - // }) - // else - const res = try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .none); + const res = if (decl_state) |*ds| + try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .{ + .dwarf = ds, + }) + else + try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .none); const code = switch (res) { .ok => code_buffer.items, @@ -2490,16 +2483,15 @@ pub fn updateFunc(self: *Elf, module: *Module, func: *Module.Fn, air: Air, liven }, }; const local_sym = try self.updateDeclCode(decl_index, code, elf.STT_FUNC); - _ = local_sym; - // if (decl_state) |*ds| { - // try self.dwarf.?.commitDeclState( - // module, - // decl_index, - // local_sym.st_value, - // local_sym.st_size, - // ds, - // ); - // } + if (decl_state) |*ds| { + try self.dwarf.?.commitDeclState( + module, + decl_index, + local_sym.st_value, + local_sym.st_size, + ds, + ); + } // Since we updated the vaddr and the size, each corresponding export // symbol also needs to be updated. @@ -2536,27 +2528,27 @@ pub fn updateDecl(self: *Elf, module: *Module, decl_index: Module.Decl.Index) !v var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); - // var decl_state: ?Dwarf.DeclState = if (self.dwarf) |*dw| try dw.initDeclState(module, decl_index) else null; - // defer if (decl_state) |*ds| ds.deinit(); + var decl_state: ?Dwarf.DeclState = if (self.dwarf) |*dw| try dw.initDeclState(module, decl_index) else null; + defer if (decl_state) |*ds| ds.deinit(); // TODO implement .debug_info for global variables const decl_val = if (decl.val.castTag(.variable)) |payload| payload.data.init else decl.val; - // const res = if (decl_state) |*ds| - // try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ - // .ty = decl.ty, - // .val = decl_val, - // }, &code_buffer, .{ - // .dwarf = ds, - // }, .{ - // .parent_atom_index = atom.getSymbolIndex().?, - // }) - // else - const res = try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ - .ty = decl.ty, - .val = decl_val, - }, &code_buffer, .none, .{ - .parent_atom_index = atom.getSymbolIndex().?, - }); + const res = if (decl_state) |*ds| + try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ + .ty = decl.ty, + .val = decl_val, + }, &code_buffer, .{ + .dwarf = ds, + }, .{ + .parent_atom_index = atom.getSymbolIndex().?, + }) + else + try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ + .ty = decl.ty, + .val = decl_val, + }, &code_buffer, .none, .{ + .parent_atom_index = atom.getSymbolIndex().?, + }); const code = switch (res) { .ok => code_buffer.items, @@ -2568,16 +2560,15 @@ pub fn updateDecl(self: *Elf, module: *Module, decl_index: Module.Decl.Index) !v }; const local_sym = try self.updateDeclCode(decl_index, code, elf.STT_OBJECT); - _ = local_sym; - // if (decl_state) |*ds| { - // try self.dwarf.?.commitDeclState( - // module, - // decl_index, - // local_sym.st_value, - // local_sym.st_size, - // ds, - // ); - // } + if (decl_state) |*ds| { + try self.dwarf.?.commitDeclState( + module, + decl_index, + local_sym.st_value, + local_sym.st_size, + ds, + ); + } // Since we updated the vaddr and the size, each corresponding export // symbol also needs to be updated. @@ -2737,19 +2728,20 @@ pub fn updateDeclExports( } /// Must be called only after a successful call to `updateDecl`. -pub fn updateDeclLineNumber(self: *Elf, mod: *Module, decl: *const Module.Decl) !void { +pub fn updateDeclLineNumber(self: *Elf, mod: *Module, decl_index: Module.Decl.Index) !void { const tracy = trace(@src()); defer tracy.end(); + const decl = mod.declPtr(decl_index); const decl_name = try decl.getFullyQualifiedName(mod); defer self.base.allocator.free(decl_name); log.debug("updateDeclLineNumber {s}{*}", .{ decl_name, decl }); if (self.llvm_object) |_| return; - // if (self.dwarf) |*dw| { - // try dw.updateDeclLineNumber(decl); - // } + if (self.dwarf) |*dw| { + try dw.updateDeclLineNumber(mod, decl_index); + } } pub fn deleteDeclExport(self: *Elf, decl_index: Module.Decl.Index, name: []const u8) void { diff --git a/src/link/Elf/Atom.zig b/src/link/Elf/Atom.zig index 24cf19432c..4ab304ef71 100644 --- a/src/link/Elf/Atom.zig +++ b/src/link/Elf/Atom.zig @@ -4,7 +4,6 @@ const std = @import("std"); const assert = std.debug.assert; const elf = std.elf; -const Dwarf = @import("../Dwarf.zig"); const Elf = @import("../Elf.zig"); /// Each decl always gets a local symbol with the fully qualified name. @@ -23,8 +22,6 @@ offset_table_index: u32, prev_index: ?Index, next_index: ?Index, -dbg_info_atom: Dwarf.Atom, - pub const Index = u32; pub const Reloc = struct { diff --git a/src/link/MachO.zig b/src/link/MachO.zig index 42aaa3a275..22eb58775b 100644 --- a/src/link/MachO.zig +++ b/src/link/MachO.zig @@ -472,9 +472,9 @@ pub fn flushModule(self: *MachO, comp: *Compilation, prog_node: *std.Progress.No const module = self.base.options.module orelse return error.LinkingWithoutZigSourceUnimplemented; - // if (self.d_sym) |*d_sym| { - // try d_sym.dwarf.flushModule(module); - // } + if (self.d_sym) |*d_sym| { + try d_sym.dwarf.flushModule(module); + } var libs = std.StringArrayHashMap(link.SystemLib).init(arena); try resolveLibSystem( @@ -664,10 +664,10 @@ pub fn flushModule(self: *MachO, comp: *Compilation, prog_node: *std.Progress.No try self.writeCodeSignature(comp, csig); // code signing always comes last } - // if (self.d_sym) |*d_sym| { - // // Flush debug symbols bundle. - // try d_sym.flushModule(self); - // } + if (self.d_sym) |*d_sym| { + // Flush debug symbols bundle. + try d_sym.flushModule(self); + } // if (build_options.enable_link_snapshots) { // if (self.base.options.enable_link_snapshots) @@ -1089,7 +1089,6 @@ pub fn createAtom(self: *MachO) !Atom.Index { .alignment = 0, .prev_index = null, .next_index = null, - .dbg_info_atom = undefined, }; log.debug("creating ATOM(%{d}) at index {d}", .{ sym_index, atom_index }); return atom_index; @@ -1724,9 +1723,9 @@ pub fn deinit(self: *MachO) void { if (self.llvm_object) |llvm_object| llvm_object.destroy(gpa); } - // if (self.d_sym) |*d_sym| { - // d_sym.deinit(); - // } + if (self.d_sym) |*d_sym| { + d_sym.deinit(); + } self.got_entries.deinit(gpa); self.got_entries_free_list.deinit(gpa); @@ -1804,9 +1803,8 @@ pub fn deinit(self: *MachO) void { } fn freeAtom(self: *MachO, atom_index: Atom.Index) void { - log.debug("freeAtom {d}", .{atom_index}); - const gpa = self.base.allocator; + log.debug("freeAtom {d}", .{atom_index}); // Remove any relocs and base relocs associated with this Atom Atom.freeRelocations(self, atom_index); @@ -1876,9 +1874,9 @@ fn freeAtom(self: *MachO, atom_index: Atom.Index) void { }; _ = self.got_entries_table.remove(got_target); - // if (self.d_sym) |*d_sym| { - // d_sym.swapRemoveRelocs(sym_index); - // } + if (self.d_sym) |*d_sym| { + d_sym.swapRemoveRelocs(sym_index); + } log.debug(" adding GOT index {d} to free list (target local@{d})", .{ got_index, sym_index }); } @@ -1887,10 +1885,6 @@ fn freeAtom(self: *MachO, atom_index: Atom.Index) void { _ = self.atom_by_index_table.remove(sym_index); log.debug(" adding local symbol index {d} to free list", .{sym_index}); self.getAtomPtr(atom_index).sym_index = 0; - - // if (self.d_sym) |*d_sym| { - // d_sym.dwarf.freeAtom(&atom.dbg_info_atom); - // } } fn shrinkAtom(self: *MachO, atom_index: Atom.Index, new_block_size: u64) void { @@ -2020,23 +2014,22 @@ pub fn updateFunc(self: *MachO, module: *Module, func: *Module.Fn, air: Air, liv Atom.freeRelocations(self, atom_index); const atom = self.getAtom(atom_index); - _ = atom; var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); - // var decl_state = if (self.d_sym) |*d_sym| - // try d_sym.dwarf.initDeclState(module, decl_index) - // else - // null; - // defer if (decl_state) |*ds| ds.deinit(); + var decl_state = if (self.d_sym) |*d_sym| + try d_sym.dwarf.initDeclState(module, decl_index) + else + null; + defer if (decl_state) |*ds| ds.deinit(); - // const res = if (decl_state) |*ds| - // try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .{ - // .dwarf = ds, - // }) - // else - const res = try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .none); + const res = if (decl_state) |*ds| + try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .{ + .dwarf = ds, + }) + else + try codegen.generateFunction(&self.base, decl.srcLoc(), func, air, liveness, &code_buffer, .none); const code = switch (res) { .ok => code_buffer.items, @@ -2048,11 +2041,10 @@ pub fn updateFunc(self: *MachO, module: *Module, func: *Module.Fn, air: Air, liv }; const addr = try self.updateDeclCode(decl_index, code); - _ = addr; - // if (decl_state) |*ds| { - // try self.d_sym.?.dwarf.commitDeclState(module, decl_index, addr, atom.size, ds); - // } + if (decl_state) |*ds| { + try self.d_sym.?.dwarf.commitDeclState(module, decl_index, addr, atom.size, ds); + } // Since we updated the vaddr and the size, each corresponding export symbol also // needs to be updated. @@ -2154,29 +2146,29 @@ pub fn updateDecl(self: *MachO, module: *Module, decl_index: Module.Decl.Index) var code_buffer = std.ArrayList(u8).init(self.base.allocator); defer code_buffer.deinit(); - // var decl_state: ?Dwarf.DeclState = if (self.d_sym) |*d_sym| - // try d_sym.dwarf.initDeclState(module, decl_index) - // else - // null; - // defer if (decl_state) |*ds| ds.deinit(); + var decl_state: ?Dwarf.DeclState = if (self.d_sym) |*d_sym| + try d_sym.dwarf.initDeclState(module, decl_index) + else + null; + defer if (decl_state) |*ds| ds.deinit(); const decl_val = if (decl.val.castTag(.variable)) |payload| payload.data.init else decl.val; - // const res = if (decl_state) |*ds| - // try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ - // .ty = decl.ty, - // .val = decl_val, - // }, &code_buffer, .{ - // .dwarf = ds, - // }, .{ - // .parent_atom_index = atom.getSymbolIndex().?, - // }) - // else - const res = try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ - .ty = decl.ty, - .val = decl_val, - }, &code_buffer, .none, .{ - .parent_atom_index = atom.getSymbolIndex().?, - }); + const res = if (decl_state) |*ds| + try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ + .ty = decl.ty, + .val = decl_val, + }, &code_buffer, .{ + .dwarf = ds, + }, .{ + .parent_atom_index = atom.getSymbolIndex().?, + }) + else + try codegen.generateSymbol(&self.base, decl.srcLoc(), .{ + .ty = decl.ty, + .val = decl_val, + }, &code_buffer, .none, .{ + .parent_atom_index = atom.getSymbolIndex().?, + }); const code = switch (res) { .ok => code_buffer.items, @@ -2187,11 +2179,10 @@ pub fn updateDecl(self: *MachO, module: *Module, decl_index: Module.Decl.Index) }, }; const addr = try self.updateDeclCode(decl_index, code); - _ = addr; - // if (decl_state) |*ds| { - // try self.d_sym.?.dwarf.commitDeclState(module, decl_index, addr, atom.size, ds); - // } + if (decl_state) |*ds| { + try self.d_sym.?.dwarf.commitDeclState(module, decl_index, addr, atom.size, ds); + } // Since we updated the vaddr and the size, each corresponding export symbol also // needs to be updated. @@ -2432,13 +2423,10 @@ fn updateDeclCode(self: *MachO, decl_index: Module.Decl.Index, code: []const u8) return atom.getSymbol(self).n_value; } -pub fn updateDeclLineNumber(self: *MachO, module: *Module, decl: *const Module.Decl) !void { - _ = decl; - _ = self; - _ = module; - // if (self.d_sym) |*d_sym| { - // try d_sym.dwarf.updateDeclLineNumber(decl); - // } +pub fn updateDeclLineNumber(self: *MachO, module: *Module, decl_index: Module.Decl.Index) !void { + if (self.d_sym) |*d_sym| { + try d_sym.dwarf.updateDeclLineNumber(module, decl_index); + } } pub fn updateDeclExports( @@ -2611,9 +2599,9 @@ pub fn freeDecl(self: *MachO, decl_index: Module.Decl.Index) void { kv.value.exports.deinit(self.base.allocator); } - // if (self.d_sym) |*d_sym| { - // d_sym.dwarf.freeDecl(decl); - // } + if (self.d_sym) |*d_sym| { + d_sym.dwarf.freeDecl(decl_index); + } } pub fn getDeclVAddr(self: *MachO, decl_index: Module.Decl.Index, reloc_info: File.RelocInfo) !u64 { diff --git a/src/link/MachO/Atom.zig b/src/link/MachO/Atom.zig index 401d71813c..5fb94b7c13 100644 --- a/src/link/MachO/Atom.zig +++ b/src/link/MachO/Atom.zig @@ -13,7 +13,6 @@ const trace = @import("../../tracy.zig").trace; const Allocator = mem.Allocator; const Arch = std.Target.Cpu.Arch; -const Dwarf = @import("../Dwarf.zig"); const MachO = @import("../MachO.zig"); const Relocation = @import("Relocation.zig"); const SymbolWithLoc = MachO.SymbolWithLoc; @@ -43,8 +42,6 @@ alignment: u32, next_index: ?Index, prev_index: ?Index, -dbg_info_atom: Dwarf.Atom, - pub const Index = u32; pub const Binding = struct { diff --git a/src/link/Plan9.zig b/src/link/Plan9.zig index 20f540022a..87e3ca5c22 100644 --- a/src/link/Plan9.zig +++ b/src/link/Plan9.zig @@ -1018,10 +1018,10 @@ pub fn writeSyms(self: *Plan9, buf: *std.ArrayList(u8)) !void { } /// Must be called only after a successful call to `updateDecl`. -pub fn updateDeclLineNumber(self: *Plan9, mod: *Module, decl: *const Module.Decl) !void { +pub fn updateDeclLineNumber(self: *Plan9, mod: *Module, decl_index: Module.Decl.Index) !void { _ = self; _ = mod; - _ = decl; + _ = decl_index; } pub fn getDeclVAddr( diff --git a/src/link/Wasm.zig b/src/link/Wasm.zig index 31dfb87659..ee4518796e 100644 --- a/src/link/Wasm.zig +++ b/src/link/Wasm.zig @@ -183,13 +183,9 @@ pub const Segment = struct { pub const FnData = struct { /// Reference to the wasm type that represents this function. type_index: u32, - /// Contains debug information related to this function. - /// For Wasm, the offset is relative to the code-section. - src_fn: Dwarf.SrcFn, pub const empty: FnData = .{ .type_index = undefined, - .src_fn = Dwarf.SrcFn.empty, }; }; @@ -1122,17 +1118,18 @@ pub fn updateDecl(wasm: *Wasm, mod: *Module, decl_index: Module.Decl.Index) !voi return wasm.finishUpdateDecl(decl, code); } -pub fn updateDeclLineNumber(wasm: *Wasm, mod: *Module, decl: *const Module.Decl) !void { +pub fn updateDeclLineNumber(wasm: *Wasm, mod: *Module, decl_index: Module.Decl.Index) !void { if (wasm.llvm_object) |_| return; if (wasm.dwarf) |*dw| { const tracy = trace(@src()); defer tracy.end(); + const decl = mod.declPtr(decl_index); const decl_name = try decl.getFullyQualifiedName(mod); defer wasm.base.allocator.free(decl_name); log.debug("updateDeclLineNumber {s}{*}", .{ decl_name, decl }); - try dw.updateDeclLineNumber(decl); + try dw.updateDeclLineNumber(mod, decl_index); } } @@ -1460,10 +1457,9 @@ pub fn freeDecl(wasm: *Wasm, decl_index: Module.Decl.Index) void { _ = wasm.resolved_symbols.swapRemove(atom.symbolLoc()); _ = wasm.symbol_atom.remove(atom.symbolLoc()); - if (wasm.dwarf) |*dwarf| { - dwarf.freeDecl(decl); - dwarf.freeAtom(&atom.dbg_info_atom); - } + // if (wasm.dwarf) |*dwarf| { + // dwarf.freeDecl(decl_index); + // } atom.deinit(wasm.base.allocator); } @@ -1882,7 +1878,6 @@ fn initializeCallCtorsFunction(wasm: *Wasm) !void { .next = null, .prev = null, .code = function_body.moveToUnmanaged(), - .dbg_info_atom = undefined, }; try wasm.managed_atoms.append(wasm.base.allocator, atom); try wasm.appendAtomAtIndex(wasm.code_section_index.?, atom); diff --git a/src/link/Wasm/Atom.zig b/src/link/Wasm/Atom.zig index 20f847e475..554f98b5ca 100644 --- a/src/link/Wasm/Atom.zig +++ b/src/link/Wasm/Atom.zig @@ -4,7 +4,6 @@ const std = @import("std"); const types = @import("types.zig"); const Wasm = @import("../Wasm.zig"); const Symbol = @import("Symbol.zig"); -const Dwarf = @import("../Dwarf.zig"); const leb = std.leb; const log = std.log.scoped(.link); @@ -39,9 +38,6 @@ prev: ?*Atom, /// When the parent atom is being freed, it will also do so for all local atoms. locals: std.ArrayListUnmanaged(Atom) = .{}, -/// Represents the debug Atom that holds all debug information of this Atom. -dbg_info_atom: Dwarf.Atom, - /// Represents a default empty wasm `Atom` pub const empty: Atom = .{ .alignment = 0, @@ -51,7 +47,6 @@ pub const empty: Atom = .{ .prev = null, .size = 0, .sym_index = 0, - .dbg_info_atom = undefined, }; /// Frees all resources owned by this `Atom`. From e0f3975fc8a7afd8a613802321fd46e64d8970d5 Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Wed, 1 Feb 2023 16:01:43 +0100 Subject: [PATCH 65/84] link: make SpirV atoms fully owned by the linker --- src/Module.zig | 19 +++---------------- src/codegen/spirv.zig | 30 +++++++++++++++++++----------- src/link.zig | 2 +- src/link/SpirV.zig | 18 +++++++----------- 4 files changed, 30 insertions(+), 39 deletions(-) diff --git a/src/Module.zig b/src/Module.zig index eb947a6977..bfeeea51e8 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -5183,20 +5183,7 @@ fn scanDecl(iter: *ScanDeclIter, decl_sub_index: usize, flags: u4) Allocator.Err decl.zir_decl_index = @intCast(u32, decl_sub_index); if (decl.getFunction()) |_| { switch (comp.bin_file.tag) { - .coff => { - // TODO Implement for COFF - }, - .elf => { - // TODO Look into detecting when this would be unnecessary by storing enough state - // in `Decl` to notice that the line number did not change. - comp.work_queue.writeItemAssumeCapacity(.{ .update_line_number = decl_index }); - }, - .macho => { - // TODO Look into detecting when this would be unnecessary by storing enough state - // in `Decl` to notice that the line number did not change. - comp.work_queue.writeItemAssumeCapacity(.{ .update_line_number = decl_index }); - }, - .plan9 => { + .coff, .elf, .macho, .plan9 => { // TODO Look into detecting when this would be unnecessary by storing enough state // in `Decl` to notice that the line number did not change. comp.work_queue.writeItemAssumeCapacity(.{ .update_line_number = decl_index }); @@ -5290,7 +5277,7 @@ pub fn clearDecl( .plan9 => .{ .plan9 = {} }, .c => .{ .c = {} }, .wasm => .{ .wasm = link.File.Wasm.FnData.empty }, - .spirv => .{ .spirv = .{} }, + .spirv => .{ .spirv = {} }, .nvptx => .{ .nvptx = {} }, }; } @@ -5710,7 +5697,7 @@ pub fn allocateNewDecl( .plan9 => .{ .plan9 = {} }, .c => .{ .c = {} }, .wasm => .{ .wasm = link.File.Wasm.FnData.empty }, - .spirv => .{ .spirv = .{} }, + .spirv => .{ .spirv = {} }, .nvptx => .{ .nvptx = {} }, }, .generation = 0, diff --git a/src/codegen/spirv.zig b/src/codegen/spirv.zig index e1af8c847f..c5a3d57d07 100644 --- a/src/codegen/spirv.zig +++ b/src/codegen/spirv.zig @@ -49,7 +49,7 @@ pub const DeclGen = struct { spv: *SpvModule, /// The decl we are currently generating code for. - decl: *Decl, + decl_index: Decl.Index, /// The intermediate code of the declaration we are currently generating. Note: If /// the declaration is not a function, this value will be undefined! @@ -59,6 +59,8 @@ pub const DeclGen = struct { /// Note: If the declaration is not a function, this value will be undefined! liveness: Liveness, + ids: *const std.AutoHashMap(Decl.Index, IdResult), + /// An array of function argument result-ids. Each index corresponds with the /// function argument of the same index. args: std.ArrayListUnmanaged(IdRef) = .{}, @@ -133,14 +135,20 @@ pub const DeclGen = struct { /// Initialize the common resources of a DeclGen. Some fields are left uninitialized, /// only set when `gen` is called. - pub fn init(allocator: Allocator, module: *Module, spv: *SpvModule) DeclGen { + pub fn init( + allocator: Allocator, + module: *Module, + spv: *SpvModule, + ids: *const std.AutoHashMap(Decl.Index, IdResult), + ) DeclGen { return .{ .gpa = allocator, .module = module, .spv = spv, - .decl = undefined, + .decl_index = undefined, .air = undefined, .liveness = undefined, + .ids = ids, .next_arg_index = undefined, .current_block_label_id = undefined, .error_msg = undefined, @@ -150,9 +158,9 @@ pub const DeclGen = struct { /// Generate the code for `decl`. If a reportable error occurred during code generation, /// a message is returned by this function. Callee owns the memory. If this function /// returns such a reportable error, it is valid to be called again for a different decl. - pub fn gen(self: *DeclGen, decl: *Decl, air: Air, liveness: Liveness) !?*Module.ErrorMsg { + pub fn gen(self: *DeclGen, decl_index: Decl.Index, air: Air, liveness: Liveness) !?*Module.ErrorMsg { // Reset internal resources, we don't want to re-allocate these. - self.decl = decl; + self.decl_index = decl_index; self.air = air; self.liveness = liveness; self.args.items.len = 0; @@ -194,7 +202,7 @@ pub const DeclGen = struct { pub fn fail(self: *DeclGen, comptime format: []const u8, args: anytype) Error { @setCold(true); const src = LazySrcLoc.nodeOffset(0); - const src_loc = src.toSrcLoc(self.decl); + const src_loc = src.toSrcLoc(self.module.declPtr(self.decl_index)); assert(self.error_msg == null); self.error_msg = try Module.ErrorMsg.create(self.module.gpa, src_loc, format, args); return error.CodegenFail; @@ -332,7 +340,7 @@ pub const DeclGen = struct { }; const decl = self.module.declPtr(fn_decl_index); self.module.markDeclAlive(decl); - return decl.fn_link.spirv.id.toRef(); + return self.ids.get(fn_decl_index).?.toRef(); } const target = self.getTarget(); @@ -553,8 +561,8 @@ pub const DeclGen = struct { } fn genDecl(self: *DeclGen) !void { - const decl = self.decl; - const result_id = decl.fn_link.spirv.id; + const result_id = self.ids.get(self.decl_index).?; + const decl = self.module.declPtr(self.decl_index); if (decl.val.castTag(.function)) |_| { assert(decl.ty.zigTypeTag() == .Fn); @@ -945,7 +953,7 @@ pub const DeclGen = struct { fn airDbgStmt(self: *DeclGen, inst: Air.Inst.Index) !void { const dbg_stmt = self.air.instructions.items(.data)[inst].dbg_stmt; - const src_fname_id = try self.spv.resolveSourceFileName(self.decl); + const src_fname_id = try self.spv.resolveSourceFileName(self.module.declPtr(self.decl_index)); try self.func.body.emit(self.spv.gpa, .OpLine, .{ .file = src_fname_id, .line = dbg_stmt.line, @@ -1106,7 +1114,7 @@ pub const DeclGen = struct { assert(as.errors.items.len != 0); assert(self.error_msg == null); const loc = LazySrcLoc.nodeOffset(0); - const src_loc = loc.toSrcLoc(self.decl); + const src_loc = loc.toSrcLoc(self.module.declPtr(self.decl_index)); self.error_msg = try Module.ErrorMsg.create(self.module.gpa, src_loc, "failed to assemble SPIR-V inline assembly", .{}); const notes = try self.module.gpa.alloc(Module.ErrorMsg, as.errors.items.len); diff --git a/src/link.zig b/src/link.zig index 3dd182b586..450a008cea 100644 --- a/src/link.zig +++ b/src/link.zig @@ -279,7 +279,7 @@ pub const File = struct { plan9: void, c: void, wasm: Wasm.FnData, - spirv: SpirV.FnData, + spirv: void, nvptx: void, }; diff --git a/src/link/SpirV.zig b/src/link/SpirV.zig index 7dbd3a42ce..14a29e4498 100644 --- a/src/link/SpirV.zig +++ b/src/link/SpirV.zig @@ -42,13 +42,6 @@ const SpvModule = @import("../codegen/spirv/Module.zig"); const spec = @import("../codegen/spirv/spec.zig"); const IdResult = spec.IdResult; -// TODO: Should this struct be used at all rather than just a hashmap of aux data for every decl? -pub const FnData = struct { - // We're going to fill these in flushModule, and we're going to fill them unconditionally, - // so just set it to undefined. - id: IdResult = undefined, -}; - base: link.File, /// This linker backend does not try to incrementally link output SPIR-V code. @@ -209,16 +202,19 @@ pub fn flushModule(self: *SpirV, comp: *Compilation, prog_node: *std.Progress.No // so that we can access them before processing them. // TODO: We're allocating an ID unconditionally now, are there // declarations which don't generate a result? - // TODO: fn_link is used here, but thats probably not the right field. It will work anyway though. + var ids = std.AutoHashMap(Module.Decl.Index, IdResult).init(self.base.allocator); + defer ids.deinit(); + try ids.ensureTotalCapacity(@intCast(u32, self.decl_table.count())); + for (self.decl_table.keys()) |decl_index| { const decl = module.declPtr(decl_index); if (decl.has_tv) { - decl.fn_link.spirv.id = spv.allocId(); + ids.putAssumeCapacityNoClobber(decl_index, spv.allocId()); } } // Now, actually generate the code for all declarations. - var decl_gen = codegen.DeclGen.init(self.base.allocator, module, &spv); + var decl_gen = codegen.DeclGen.init(self.base.allocator, module, &spv, &ids); defer decl_gen.deinit(); var it = self.decl_table.iterator(); @@ -231,7 +227,7 @@ pub fn flushModule(self: *SpirV, comp: *Compilation, prog_node: *std.Progress.No const liveness = entry.value_ptr.liveness; // Note, if `decl` is not a function, air/liveness may be undefined. - if (try decl_gen.gen(decl, air, liveness)) |msg| { + if (try decl_gen.gen(decl_index, air, liveness)) |msg| { try module.failed_decls.put(module.gpa, decl_index, msg); return; // TODO: Attempt to generate more decls? } From 1aa0f8aa2f382fb56639ea6833a62c4b8b031247 Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Wed, 1 Feb 2023 17:39:07 +0100 Subject: [PATCH 66/84] link: fix pointer invalidation issues in Elf, MachO and Coff --- src/link/Coff.zig | 12 ++++++++---- src/link/Elf.zig | 9 ++++----- src/link/MachO.zig | 4 ++-- 3 files changed, 14 insertions(+), 11 deletions(-) diff --git a/src/link/Coff.zig b/src/link/Coff.zig index f563a617c7..2922e783e1 100644 --- a/src/link/Coff.zig +++ b/src/link/Coff.zig @@ -1035,7 +1035,6 @@ pub fn lowerUnnamedConst(self: *Coff, tv: TypedValue, decl_index: Module.Decl.In const unnamed_consts = gop.value_ptr; const atom_index = try self.createAtom(); - const atom = self.getAtomPtr(atom_index); const sym_name = blk: { const decl_name = try decl.getFullyQualifiedName(mod); @@ -1045,11 +1044,15 @@ pub fn lowerUnnamedConst(self: *Coff, tv: TypedValue, decl_index: Module.Decl.In break :blk try std.fmt.allocPrint(gpa, "__unnamed_{s}_{d}", .{ decl_name, index }); }; defer gpa.free(sym_name); - try self.setSymbolName(atom.getSymbolPtr(self), sym_name); - atom.getSymbolPtr(self).section_number = @intToEnum(coff.SectionNumber, self.rdata_section_index.? + 1); + { + const atom = self.getAtom(atom_index); + const sym = atom.getSymbolPtr(self); + try self.setSymbolName(sym, sym_name); + sym.section_number = @intToEnum(coff.SectionNumber, self.rdata_section_index.? + 1); + } const res = try codegen.generateSymbol(&self.base, decl.srcLoc(), tv, &code_buffer, .none, .{ - .parent_atom_index = atom.getSymbolIndex().?, + .parent_atom_index = self.getAtom(atom_index).getSymbolIndex().?, }); const code = switch (res) { .ok => code_buffer.items, @@ -1062,6 +1065,7 @@ pub fn lowerUnnamedConst(self: *Coff, tv: TypedValue, decl_index: Module.Decl.In }; const required_alignment = tv.ty.abiAlignment(self.base.options.target); + const atom = self.getAtomPtr(atom_index); atom.alignment = required_alignment; atom.size = @intCast(u32, code.len); atom.getSymbolPtr(self).value = try self.allocateAtom(atom_index, atom.size, atom.alignment); diff --git a/src/link/Elf.zig b/src/link/Elf.zig index 3e0c6d2b57..45952da6c0 100644 --- a/src/link/Elf.zig +++ b/src/link/Elf.zig @@ -2600,12 +2600,11 @@ pub fn lowerUnnamedConst(self: *Elf, typed_value: TypedValue, decl_index: Module const name = self.shstrtab.get(name_str_index).?; const atom_index = try self.createAtom(); - const atom = self.getAtomPtr(atom_index); const res = try codegen.generateSymbol(&self.base, decl.srcLoc(), typed_value, &code_buffer, .{ .none = {}, }, .{ - .parent_atom_index = atom.getSymbolIndex().?, + .parent_atom_index = self.getAtom(atom_index).getSymbolIndex().?, }); const code = switch (res) { .ok => code_buffer.items, @@ -2620,7 +2619,7 @@ pub fn lowerUnnamedConst(self: *Elf, typed_value: TypedValue, decl_index: Module const required_alignment = typed_value.ty.abiAlignment(self.base.options.target); const shdr_index = self.rodata_section_index.?; const phdr_index = self.sections.items(.phdr_index)[shdr_index]; - const local_sym = atom.getSymbolPtr(self); + const local_sym = self.getAtom(atom_index).getSymbolPtr(self); local_sym.st_name = name_str_index; local_sym.st_info = (elf.STB_LOCAL << 4) | elf.STT_OBJECT; local_sym.st_other = 0; @@ -2631,14 +2630,14 @@ pub fn lowerUnnamedConst(self: *Elf, typed_value: TypedValue, decl_index: Module log.debug("allocated text block for {s} at 0x{x}", .{ name, local_sym.st_value }); - try self.writeSymbol(atom.getSymbolIndex().?); + try self.writeSymbol(self.getAtom(atom_index).getSymbolIndex().?); try unnamed_consts.append(gpa, atom_index); const section_offset = local_sym.st_value - self.program_headers.items[phdr_index].p_vaddr; const file_offset = self.sections.items(.shdr)[shdr_index].sh_offset + section_offset; try self.base.file.?.pwriteAll(code, file_offset); - return atom.getSymbolIndex().?; + return self.getAtom(atom_index).getSymbolIndex().?; } pub fn updateDeclExports( diff --git a/src/link/MachO.zig b/src/link/MachO.zig index 22eb58775b..24ef275c5b 100644 --- a/src/link/MachO.zig +++ b/src/link/MachO.zig @@ -2079,10 +2079,9 @@ pub fn lowerUnnamedConst(self: *MachO, typed_value: TypedValue, decl_index: Modu log.debug("allocating symbol indexes for {?s}", .{name}); const atom_index = try self.createAtom(); - const atom = self.getAtomPtr(atom_index); const res = try codegen.generateSymbol(&self.base, decl.srcLoc(), typed_value, &code_buffer, .none, .{ - .parent_atom_index = atom.getSymbolIndex().?, + .parent_atom_index = self.getAtom(atom_index).getSymbolIndex().?, }); const code = switch (res) { .ok => code_buffer.items, @@ -2095,6 +2094,7 @@ pub fn lowerUnnamedConst(self: *MachO, typed_value: TypedValue, decl_index: Modu }; const required_alignment = typed_value.ty.abiAlignment(self.base.options.target); + const atom = self.getAtomPtr(atom_index); atom.size = code.len; atom.alignment = required_alignment; // TODO: work out logic for disambiguating functions from function pointers From 46f54b23ae604c3f99f51ca719d9085530f6b59c Mon Sep 17 00:00:00 2001 From: Luuk de Gram Date: Wed, 1 Feb 2023 18:55:35 +0100 Subject: [PATCH 67/84] link: make Wasm atoms fully owned by the linker --- src/Module.zig | 6 +- src/Sema.zig | 2 +- src/arch/wasm/CodeGen.zig | 30 +- src/arch/wasm/Emit.zig | 29 +- src/link.zig | 4 +- src/link/Dwarf.zig | 25 +- src/link/Wasm.zig | 520 ++++++++++++++------------- src/link/Wasm/Atom.zig | 44 ++- src/link/Wasm/Object.zig | 15 +- test/link/wasm/export-data/build.zig | 4 +- 10 files changed, 353 insertions(+), 326 deletions(-) diff --git a/src/Module.zig b/src/Module.zig index bfeeea51e8..f84d720d1f 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -5266,7 +5266,7 @@ pub fn clearDecl( .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = {} }, .c => .{ .c = {} }, - .wasm => .{ .wasm = link.File.Wasm.DeclBlock.empty }, + .wasm => .{ .wasm = {} }, .spirv => .{ .spirv = {} }, .nvptx => .{ .nvptx = {} }, }; @@ -5374,7 +5374,7 @@ fn deleteDeclExports(mod: *Module, decl_index: Decl.Index) Allocator.Error!void try macho.deleteDeclExport(decl_index, exp.options.name); } if (mod.comp.bin_file.cast(link.File.Wasm)) |wasm| { - wasm.deleteExport(exp.link.wasm); + wasm.deleteDeclExport(decl_index); } if (mod.comp.bin_file.cast(link.File.Coff)) |coff| { coff.deleteDeclExport(decl_index, exp.options.name); @@ -5686,7 +5686,7 @@ pub fn allocateNewDecl( .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = {} }, .c => .{ .c = {} }, - .wasm => .{ .wasm = link.File.Wasm.DeclBlock.empty }, + .wasm => .{ .wasm = {} }, .spirv => .{ .spirv = {} }, .nvptx => .{ .nvptx = {} }, }, diff --git a/src/Sema.zig b/src/Sema.zig index e54bfc7bd9..4871961753 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -5570,7 +5570,7 @@ pub fn analyzeExport( .macho => .{ .macho = {} }, .plan9 => .{ .plan9 = {} }, .c => .{ .c = {} }, - .wasm => .{ .wasm = .{} }, + .wasm => .{ .wasm = {} }, .spirv => .{ .spirv = {} }, .nvptx => .{ .nvptx = {} }, }, diff --git a/src/arch/wasm/CodeGen.zig b/src/arch/wasm/CodeGen.zig index 8212d281e5..8559a728e5 100644 --- a/src/arch/wasm/CodeGen.zig +++ b/src/arch/wasm/CodeGen.zig @@ -1269,10 +1269,10 @@ fn genFunc(func: *CodeGen) InnerError!void { var emit: Emit = .{ .mir = mir, - .bin_file = &func.bin_file.base, + .bin_file = func.bin_file, .code = func.code, .locals = func.locals.items, - .decl = func.decl, + .decl_index = func.decl_index, .dbg_output = func.debug_output, .prev_di_line = 0, .prev_di_column = 0, @@ -2115,21 +2115,20 @@ fn airCall(func: *CodeGen, inst: Air.Inst.Index, modifier: std.builtin.CallModif const fn_info = fn_ty.fnInfo(); const first_param_sret = firstParamSRet(fn_info.cc, fn_info.return_type, func.target); - const callee: ?*Decl = blk: { + const callee: ?Decl.Index = blk: { const func_val = func.air.value(pl_op.operand) orelse break :blk null; const module = func.bin_file.base.options.module.?; if (func_val.castTag(.function)) |function| { - const decl = module.declPtr(function.data.owner_decl); - try decl.link.wasm.ensureInitialized(func.bin_file); - break :blk decl; + _ = try func.bin_file.getOrCreateAtomForDecl(function.data.owner_decl); + break :blk function.data.owner_decl; } else if (func_val.castTag(.extern_fn)) |extern_fn| { const ext_decl = module.declPtr(extern_fn.data.owner_decl); const ext_info = ext_decl.ty.fnInfo(); var func_type = try genFunctype(func.gpa, ext_info.cc, ext_info.param_types, ext_info.return_type, func.target); defer func_type.deinit(func.gpa); - const atom = &ext_decl.link.wasm; - try atom.ensureInitialized(func.bin_file); + const atom_index = try func.bin_file.getOrCreateAtomForDecl(extern_fn.data.owner_decl); + const atom = func.bin_file.getAtomPtr(atom_index); ext_decl.fn_link.wasm.type_index = try func.bin_file.putOrGetFuncType(func_type); try func.bin_file.addOrUpdateImport( mem.sliceTo(ext_decl.name, 0), @@ -2137,11 +2136,10 @@ fn airCall(func: *CodeGen, inst: Air.Inst.Index, modifier: std.builtin.CallModif ext_decl.getExternFn().?.lib_name, ext_decl.fn_link.wasm.type_index, ); - break :blk ext_decl; + break :blk extern_fn.data.owner_decl; } else if (func_val.castTag(.decl_ref)) |decl_ref| { - const decl = module.declPtr(decl_ref.data); - try decl.link.wasm.ensureInitialized(func.bin_file); - break :blk decl; + _ = try func.bin_file.getOrCreateAtomForDecl(decl_ref.data); + break :blk decl_ref.data; } return func.fail("Expected a function, but instead found type '{}'", .{func_val.tag()}); }; @@ -2162,7 +2160,8 @@ fn airCall(func: *CodeGen, inst: Air.Inst.Index, modifier: std.builtin.CallModif } if (callee) |direct| { - try func.addLabel(.call, direct.link.wasm.sym_index); + const atom_index = func.bin_file.decls.get(direct).?; + try func.addLabel(.call, func.bin_file.getAtom(atom_index).sym_index); } else { // in this case we call a function pointer // so load its value onto the stack @@ -2758,9 +2757,10 @@ fn lowerDeclRefValue(func: *CodeGen, tv: TypedValue, decl_index: Module.Decl.Ind } module.markDeclAlive(decl); - try decl.link.wasm.ensureInitialized(func.bin_file); + const atom_index = try func.bin_file.getOrCreateAtomForDecl(decl_index); + const atom = func.bin_file.getAtom(atom_index); - const target_sym_index = decl.link.wasm.sym_index; + const target_sym_index = atom.sym_index; if (decl.ty.zigTypeTag() == .Fn) { try func.bin_file.addTableFunction(target_sym_index); return WValue{ .function_index = target_sym_index }; diff --git a/src/arch/wasm/Emit.zig b/src/arch/wasm/Emit.zig index 71d21d2797..a340ac5da8 100644 --- a/src/arch/wasm/Emit.zig +++ b/src/arch/wasm/Emit.zig @@ -11,8 +11,8 @@ const leb128 = std.leb; /// Contains our list of instructions mir: Mir, -/// Reference to the file handler -bin_file: *link.File, +/// Reference to the Wasm module linker +bin_file: *link.File.Wasm, /// Possible error message. When set, the value is allocated and /// must be freed manually. error_msg: ?*Module.ErrorMsg = null, @@ -21,7 +21,7 @@ code: *std.ArrayList(u8), /// List of allocated locals. locals: []const u8, /// The declaration that code is being generated for. -decl: *Module.Decl, +decl_index: Module.Decl.Index, // Debug information /// Holds the debug information for this emission @@ -252,8 +252,8 @@ fn offset(self: Emit) u32 { fn fail(emit: *Emit, comptime format: []const u8, args: anytype) InnerError { @setCold(true); std.debug.assert(emit.error_msg == null); - // TODO: Determine the source location. - emit.error_msg = try Module.ErrorMsg.create(emit.bin_file.allocator, emit.decl.srcLoc(), format, args); + const mod = emit.bin_file.base.options.module.?; + emit.error_msg = try Module.ErrorMsg.create(emit.bin_file.base.allocator, mod.declPtr(emit.decl_index).srcLoc(), format, args); return error.EmitFail; } @@ -304,8 +304,9 @@ fn emitGlobal(emit: *Emit, tag: Mir.Inst.Tag, inst: Mir.Inst.Index) !void { const global_offset = emit.offset(); try emit.code.appendSlice(&buf); - // globals can have index 0 as it represents the stack pointer - try emit.decl.link.wasm.relocs.append(emit.bin_file.allocator, .{ + const atom_index = emit.bin_file.decls.get(emit.decl_index).?; + const atom = emit.bin_file.getAtomPtr(atom_index); + try atom.relocs.append(emit.bin_file.base.allocator, .{ .index = label, .offset = global_offset, .relocation_type = .R_WASM_GLOBAL_INDEX_LEB, @@ -361,7 +362,9 @@ fn emitCall(emit: *Emit, inst: Mir.Inst.Index) !void { try emit.code.appendSlice(&buf); if (label != 0) { - try emit.decl.link.wasm.relocs.append(emit.bin_file.allocator, .{ + const atom_index = emit.bin_file.decls.get(emit.decl_index).?; + const atom = emit.bin_file.getAtomPtr(atom_index); + try atom.relocs.append(emit.bin_file.base.allocator, .{ .offset = call_offset, .index = label, .relocation_type = .R_WASM_FUNCTION_INDEX_LEB, @@ -387,7 +390,9 @@ fn emitFunctionIndex(emit: *Emit, inst: Mir.Inst.Index) !void { try emit.code.appendSlice(&buf); if (symbol_index != 0) { - try emit.decl.link.wasm.relocs.append(emit.bin_file.allocator, .{ + const atom_index = emit.bin_file.decls.get(emit.decl_index).?; + const atom = emit.bin_file.getAtomPtr(atom_index); + try atom.relocs.append(emit.bin_file.base.allocator, .{ .offset = index_offset, .index = symbol_index, .relocation_type = .R_WASM_TABLE_INDEX_SLEB, @@ -399,7 +404,7 @@ fn emitMemAddress(emit: *Emit, inst: Mir.Inst.Index) !void { const extra_index = emit.mir.instructions.items(.data)[inst].payload; const mem = emit.mir.extraData(Mir.Memory, extra_index).data; const mem_offset = emit.offset() + 1; - const is_wasm32 = emit.bin_file.options.target.cpu.arch == .wasm32; + const is_wasm32 = emit.bin_file.base.options.target.cpu.arch == .wasm32; if (is_wasm32) { try emit.code.append(std.wasm.opcode(.i32_const)); var buf: [5]u8 = undefined; @@ -413,7 +418,9 @@ fn emitMemAddress(emit: *Emit, inst: Mir.Inst.Index) !void { } if (mem.pointer != 0) { - try emit.decl.link.wasm.relocs.append(emit.bin_file.allocator, .{ + const atom_index = emit.bin_file.decls.get(emit.decl_index).?; + const atom = emit.bin_file.getAtomPtr(atom_index); + try atom.relocs.append(emit.bin_file.base.allocator, .{ .offset = mem_offset, .index = mem.pointer, .relocation_type = if (is_wasm32) .R_WASM_MEMORY_ADDR_LEB else .R_WASM_MEMORY_ADDR_LEB64, diff --git a/src/link.zig b/src/link.zig index 450a008cea..0a3226f004 100644 --- a/src/link.zig +++ b/src/link.zig @@ -267,7 +267,7 @@ pub const File = struct { macho: void, plan9: void, c: void, - wasm: Wasm.DeclBlock, + wasm: void, spirv: void, nvptx: void, }; @@ -289,7 +289,7 @@ pub const File = struct { macho: void, plan9: void, c: void, - wasm: Wasm.Export, + wasm: void, spirv: void, nvptx: void, }; diff --git a/src/link/Dwarf.zig b/src/link/Dwarf.zig index e90db2d0df..a3d0aa8a53 100644 --- a/src/link/Dwarf.zig +++ b/src/link/Dwarf.zig @@ -1099,7 +1099,7 @@ pub fn commitDeclState( }, .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; - const debug_line = wasm_file.debug_line_atom.?.code; + const debug_line = wasm_file.getAtomPtr(wasm_file.debug_line_atom.?).code; writeDbgLineNopsBuffered(debug_line.items, src_fn.off, 0, &.{}, src_fn.len); }, else => unreachable, @@ -1177,7 +1177,7 @@ pub fn commitDeclState( .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; - const atom = wasm_file.debug_line_atom.?; + const atom = wasm_file.getAtomPtr(wasm_file.debug_line_atom.?); const debug_line = &atom.code; const segment_size = debug_line.items.len; if (needed_size != segment_size) { @@ -1345,7 +1345,8 @@ fn updateDeclDebugInfoAllocation(self: *Dwarf, atom_index: Atom.Index, len: u32) }, .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; - const debug_info = &wasm_file.debug_info_atom.?.code; + const debug_info_index = wasm_file.debug_info_atom.?; + const debug_info = &wasm_file.getAtomPtr(debug_info_index).code; try writeDbgInfoNopsToArrayList(gpa, debug_info, atom.off, 0, &.{0}, atom.len, false); }, else => unreachable, @@ -1441,7 +1442,7 @@ fn writeDeclDebugInfo(self: *Dwarf, atom_index: Atom.Index, dbg_info_buf: []cons .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; const info_atom = wasm_file.debug_info_atom.?; - const debug_info = &info_atom.code; + const debug_info = &wasm_file.getAtomPtr(info_atom).code; const segment_size = debug_info.items.len; if (needed_size != segment_size) { log.debug(" needed size does not equal allocated size: {d}", .{needed_size}); @@ -1504,8 +1505,8 @@ pub fn updateDeclLineNumber(self: *Dwarf, module: *Module, decl_index: Module.De .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; const offset = atom.off + self.getRelocDbgLineOff(); - const atom_ = wasm_file.debug_line_atom.?; - mem.copy(u8, atom_.code.items[offset..], &data); + const line_atom_index = wasm_file.debug_line_atom.?; + mem.copy(u8, wasm_file.getAtomPtr(line_atom_index).code.items[offset..], &data); }, else => unreachable, } @@ -1722,7 +1723,7 @@ pub fn writeDbgAbbrev(self: *Dwarf) !void { }, .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; - const debug_abbrev = &wasm_file.debug_abbrev_atom.?.code; + const debug_abbrev = &wasm_file.getAtomPtr(wasm_file.debug_abbrev_atom.?).code; try debug_abbrev.resize(wasm_file.base.allocator, needed_size); mem.copy(u8, debug_abbrev.items, &abbrev_buf); }, @@ -1835,7 +1836,7 @@ pub fn writeDbgInfoHeader(self: *Dwarf, module: *Module, low_pc: u64, high_pc: u }, .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; - const debug_info = &wasm_file.debug_info_atom.?.code; + const debug_info = &wasm_file.getAtomPtr(wasm_file.debug_info_atom.?).code; try writeDbgInfoNopsToArrayList(self.allocator, debug_info, 0, 0, di_buf.items, jmp_amt, false); }, else => unreachable, @@ -2156,7 +2157,7 @@ pub fn writeDbgAranges(self: *Dwarf, addr: u64, size: u64) !void { }, .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; - const debug_ranges = &wasm_file.debug_ranges_atom.?.code; + const debug_ranges = &wasm_file.getAtomPtr(wasm_file.debug_ranges_atom.?).code; try debug_ranges.resize(wasm_file.base.allocator, needed_size); mem.copy(u8, debug_ranges.items, di_buf.items); }, @@ -2330,7 +2331,7 @@ pub fn writeDbgLineHeader(self: *Dwarf) !void { }, .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; - const debug_line = &wasm_file.debug_line_atom.?.code; + const debug_line = &wasm_file.getAtomPtr(wasm_file.debug_line_atom.?).code; mem.copy(u8, buffer, debug_line.items[first_fn.off..]); try debug_line.resize(self.allocator, debug_line.items.len + delta); mem.copy(u8, debug_line.items[first_fn.off + delta ..], buffer); @@ -2381,7 +2382,7 @@ pub fn writeDbgLineHeader(self: *Dwarf) !void { }, .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; - const debug_line = wasm_file.debug_line_atom.?.code; + const debug_line = &wasm_file.getAtomPtr(wasm_file.debug_line_atom.?).code; writeDbgLineNopsBuffered(debug_line.items, 0, 0, di_buf.items, jmp_amt); }, else => unreachable, @@ -2526,7 +2527,7 @@ pub fn flushModule(self: *Dwarf, module: *Module) !void { }, .wasm => { const wasm_file = self.bin_file.cast(File.Wasm).?; - const debug_info = wasm_file.debug_info_atom.?.code; + const debug_info = wasm_file.getAtomPtr(wasm_file.debug_info_atom.?).code; mem.copy(u8, debug_info.items[atom.off + reloc.offset ..], &buf); }, else => unreachable, diff --git a/src/link/Wasm.zig b/src/link/Wasm.zig index ee4518796e..b06703ed61 100644 --- a/src/link/Wasm.zig +++ b/src/link/Wasm.zig @@ -9,7 +9,7 @@ const fs = std.fs; const leb = std.leb; const log = std.log.scoped(.link); -const Atom = @import("Wasm/Atom.zig"); +pub const Atom = @import("Wasm/Atom.zig"); const Dwarf = @import("Dwarf.zig"); const Module = @import("../Module.zig"); const Compilation = @import("../Compilation.zig"); @@ -31,10 +31,7 @@ const Object = @import("Wasm/Object.zig"); const Archive = @import("Wasm/Archive.zig"); const types = @import("Wasm/types.zig"); -pub const base_tag = link.File.Tag.wasm; - -/// deprecated: Use `@import("Wasm/Atom.zig");` -pub const DeclBlock = Atom; +pub const base_tag: link.File.Tag = .wasm; base: link.File, /// Output name of the file @@ -47,18 +44,16 @@ llvm_object: ?*LlvmObject = null, /// TODO: Allow setting this through a flag? host_name: []const u8 = "env", /// List of all `Decl` that are currently alive. -/// This is ment for bookkeeping so we can safely cleanup all codegen memory -/// when calling `deinit` -decls: std.AutoHashMapUnmanaged(Module.Decl.Index, void) = .{}, +/// Each index maps to the corresponding `Atom.Index`. +decls: std.AutoHashMapUnmanaged(Module.Decl.Index, Atom.Index) = .{}, /// List of all symbols generated by Zig code. symbols: std.ArrayListUnmanaged(Symbol) = .{}, /// List of symbol indexes which are free to be used. symbols_free_list: std.ArrayListUnmanaged(u32) = .{}, /// Maps atoms to their segment index -atoms: std.AutoHashMapUnmanaged(u32, *Atom) = .{}, -/// Atoms managed and created by the linker. This contains atoms -/// from object files, and not Atoms generated by a Decl. -managed_atoms: std.ArrayListUnmanaged(*Atom) = .{}, +atoms: std.AutoHashMapUnmanaged(u32, Atom.Index) = .{}, +/// List of all atoms. +managed_atoms: std.ArrayListUnmanaged(Atom) = .{}, /// Represents the index into `segments` where the 'code' section /// lives. code_section_index: ?u32 = null, @@ -148,7 +143,7 @@ undefs: std.StringArrayHashMapUnmanaged(SymbolLoc) = .{}, /// Maps a symbol's location to an atom. This can be used to find meta /// data of a symbol, such as its size, or its offset to perform a relocation. /// Undefined (and synthetic) symbols do not have an Atom and therefore cannot be mapped. -symbol_atom: std.AutoHashMapUnmanaged(SymbolLoc, *Atom) = .{}, +symbol_atom: std.AutoHashMapUnmanaged(SymbolLoc, Atom.Index) = .{}, /// Maps a symbol's location to its export name, which may differ from the decl's name /// which does the exporting. /// Note: The value represents the offset into the string table, rather than the actual string. @@ -165,14 +160,14 @@ error_table_symbol: ?u32 = null, // unit contains Zig code. The lifetime of these atoms are extended // until the end of the compiler's lifetime. Meaning they're not freed // during `flush()` in incremental-mode. -debug_info_atom: ?*Atom = null, -debug_line_atom: ?*Atom = null, -debug_loc_atom: ?*Atom = null, -debug_ranges_atom: ?*Atom = null, -debug_abbrev_atom: ?*Atom = null, -debug_str_atom: ?*Atom = null, -debug_pubnames_atom: ?*Atom = null, -debug_pubtypes_atom: ?*Atom = null, +debug_info_atom: ?Atom.Index = null, +debug_line_atom: ?Atom.Index = null, +debug_loc_atom: ?Atom.Index = null, +debug_ranges_atom: ?Atom.Index = null, +debug_abbrev_atom: ?Atom.Index = null, +debug_str_atom: ?Atom.Index = null, +debug_pubnames_atom: ?Atom.Index = null, +debug_pubtypes_atom: ?Atom.Index = null, pub const Segment = struct { alignment: u32, @@ -430,10 +425,10 @@ pub fn openPath(allocator: Allocator, sub_path: []const u8, options: link.Option // at the end during `initializeCallCtorsFunction`. } - if (!options.strip and options.module != null) { - wasm_bin.dwarf = Dwarf.init(allocator, &wasm_bin.base, options.target); - try wasm_bin.initDebugSections(); - } + // if (!options.strip and options.module != null) { + // wasm_bin.dwarf = Dwarf.init(allocator, &wasm_bin.base, options.target); + // try wasm_bin.initDebugSections(); + // } return wasm_bin; } @@ -474,6 +469,7 @@ fn createSyntheticSymbol(wasm: *Wasm, name: []const u8, tag: Symbol.Tag) !Symbol try wasm.globals.put(wasm.base.allocator, name_offset, loc); return loc; } + /// Initializes symbols and atoms for the debug sections /// Initialization is only done when compiling Zig code. /// When Zig is invoked as a linker instead, the atoms @@ -516,6 +512,36 @@ fn parseObjectFile(wasm: *Wasm, path: []const u8) !bool { return true; } +/// For a given `Module.Decl.Index` returns its corresponding `Atom.Index`. +/// When the index was not found, a new `Atom` will be created, and its index will be returned. +/// The newly created Atom is empty with default fields as specified by `Atom.empty`. +pub fn getOrCreateAtomForDecl(wasm: *Wasm, decl_index: Module.Decl.Index) !Atom.Index { + const gop = try wasm.decls.getOrPut(wasm.base.allocator, decl_index); + if (!gop.found_existing) { + gop.value_ptr.* = try wasm.createAtom(); + } + return gop.value_ptr.*; +} + +/// Creates a new empty `Atom` and returns its `Atom.Index` +fn createAtom(wasm: *Wasm) !Atom.Index { + const index = @intCast(Atom.Index, wasm.managed_atoms.items.len); + const atom = try wasm.managed_atoms.addOne(wasm.base.allocator); + atom.* = Atom.empty; + atom.sym_index = try wasm.allocateSymbol(); + try wasm.symbol_atom.putNoClobber(wasm.base.allocator, .{ .file = null, .index = atom.sym_index }, index); + + return index; +} + +pub inline fn getAtom(wasm: *const Wasm, index: Atom.Index) Atom { + return wasm.managed_atoms.items[index]; +} + +pub inline fn getAtomPtr(wasm: *Wasm, index: Atom.Index) *Atom { + return &wasm.managed_atoms.items[index]; +} + /// Parses an archive file and will then parse each object file /// that was found in the archive file. /// Returns false when the file is not an archive file. @@ -857,15 +883,16 @@ fn resolveLazySymbols(wasm: *Wasm) !void { try wasm.discarded.putNoClobber(wasm.base.allocator, kv.value, loc); _ = wasm.resolved_symbols.swapRemove(loc); // we don't want to emit this symbol, only use it for relocations. - const atom = try wasm.base.allocator.create(Atom); - errdefer wasm.base.allocator.destroy(atom); - try wasm.managed_atoms.append(wasm.base.allocator, atom); + // TODO: Can we use `createAtom` here while also re-using the symbol + // from `createSyntheticSymbol`. + const atom_index = @intCast(Atom.Index, wasm.managed_atoms.items.len); + const atom = try wasm.managed_atoms.addOne(wasm.base.allocator); atom.* = Atom.empty; atom.sym_index = loc.index; atom.alignment = 1; - try wasm.parseAtom(atom, .{ .data = .synthetic }); - try wasm.symbol_atom.putNoClobber(wasm.base.allocator, loc, atom); + try wasm.parseAtom(atom_index, .{ .data = .synthetic }); + try wasm.symbol_atom.putNoClobber(wasm.base.allocator, loc, atom_index); } if (wasm.undefs.fetchSwapRemove("__heap_end")) |kv| { @@ -873,15 +900,14 @@ fn resolveLazySymbols(wasm: *Wasm) !void { try wasm.discarded.putNoClobber(wasm.base.allocator, kv.value, loc); _ = wasm.resolved_symbols.swapRemove(loc); - const atom = try wasm.base.allocator.create(Atom); - errdefer wasm.base.allocator.destroy(atom); - try wasm.managed_atoms.append(wasm.base.allocator, atom); + const atom_index = @intCast(Atom.Index, wasm.managed_atoms.items.len); + const atom = try wasm.managed_atoms.addOne(wasm.base.allocator); atom.* = Atom.empty; atom.sym_index = loc.index; atom.alignment = 1; - try wasm.parseAtom(atom, .{ .data = .synthetic }); - try wasm.symbol_atom.putNoClobber(wasm.base.allocator, loc, atom); + try wasm.parseAtom(atom_index, .{ .data = .synthetic }); + try wasm.symbol_atom.putNoClobber(wasm.base.allocator, loc, atom_index); } } @@ -920,16 +946,6 @@ pub fn deinit(wasm: *Wasm) void { if (wasm.llvm_object) |llvm_object| llvm_object.destroy(gpa); } - if (wasm.base.options.module) |mod| { - var decl_it = wasm.decls.keyIterator(); - while (decl_it.next()) |decl_index_ptr| { - const decl = mod.declPtr(decl_index_ptr.*); - decl.link.wasm.deinit(gpa); - } - } else { - assert(wasm.decls.count() == 0); - } - for (wasm.func_types.items) |*func_type| { func_type.deinit(gpa); } @@ -954,9 +970,8 @@ pub fn deinit(wasm: *Wasm) void { wasm.symbol_atom.deinit(gpa); wasm.export_names.deinit(gpa); wasm.atoms.deinit(gpa); - for (wasm.managed_atoms.items) |managed_atom| { - managed_atom.deinit(gpa); - gpa.destroy(managed_atom); + for (wasm.managed_atoms.items) |*managed_atom| { + managed_atom.deinit(wasm); } wasm.managed_atoms.deinit(gpa); wasm.segments.deinit(gpa); @@ -1014,18 +1029,24 @@ pub fn updateFunc(wasm: *Wasm, mod: *Module, func: *Module.Fn, air: Air, livenes const decl_index = func.owner_decl; const decl = mod.declPtr(decl_index); - const atom = &decl.link.wasm; - try atom.ensureInitialized(wasm); - const gop = try wasm.decls.getOrPut(wasm.base.allocator, decl_index); - if (gop.found_existing) { - atom.clear(); - } else gop.value_ptr.* = {}; + const atom_index = try wasm.getOrCreateAtomForDecl(decl_index); + const atom = wasm.getAtomPtr(atom_index); + atom.clear(); - var decl_state: ?Dwarf.DeclState = if (wasm.dwarf) |*dwarf| try dwarf.initDeclState(mod, decl_index) else null; - defer if (decl_state) |*ds| ds.deinit(); + // var decl_state: ?Dwarf.DeclState = if (wasm.dwarf) |*dwarf| try dwarf.initDeclState(mod, decl_index) else null; + // defer if (decl_state) |*ds| ds.deinit(); var code_writer = std.ArrayList(u8).init(wasm.base.allocator); defer code_writer.deinit(); + // const result = try codegen.generateFunction( + // &wasm.base, + // decl.srcLoc(), + // func, + // air, + // liveness, + // &code_writer, + // if (decl_state) |*ds| .{ .dwarf = ds } else .none, + // ); const result = try codegen.generateFunction( &wasm.base, decl.srcLoc(), @@ -1033,7 +1054,7 @@ pub fn updateFunc(wasm: *Wasm, mod: *Module, func: *Module.Fn, air: Air, livenes air, liveness, &code_writer, - if (decl_state) |*ds| .{ .dwarf = ds } else .none, + .none, ); const code = switch (result) { @@ -1045,19 +1066,19 @@ pub fn updateFunc(wasm: *Wasm, mod: *Module, func: *Module.Fn, air: Air, livenes }, }; - if (wasm.dwarf) |*dwarf| { - try dwarf.commitDeclState( - mod, - decl_index, - // Actual value will be written after relocation. - // For Wasm, this is the offset relative to the code section - // which isn't known until flush(). - 0, - code.len, - &decl_state.?, - ); - } - return wasm.finishUpdateDecl(decl, code); + // if (wasm.dwarf) |*dwarf| { + // try dwarf.commitDeclState( + // mod, + // decl_index, + // // Actual value will be written after relocation. + // // For Wasm, this is the offset relative to the code section + // // which isn't known until flush(). + // 0, + // code.len, + // &decl_state.?, + // ); + // } + return wasm.finishUpdateDecl(decl_index, code); } // Generate code for the Decl, storing it in memory to be later written to @@ -1080,17 +1101,14 @@ pub fn updateDecl(wasm: *Wasm, mod: *Module, decl_index: Module.Decl.Index) !voi return; } - const atom = &decl.link.wasm; - try atom.ensureInitialized(wasm); - const gop = try wasm.decls.getOrPut(wasm.base.allocator, decl_index); - if (gop.found_existing) { - atom.clear(); - } else gop.value_ptr.* = {}; + const atom_index = try wasm.getOrCreateAtomForDecl(decl_index); + const atom = wasm.getAtomPtr(atom_index); + atom.clear(); if (decl.isExtern()) { const variable = decl.getVariable().?; const name = mem.sliceTo(decl.name, 0); - return wasm.addOrUpdateImport(name, decl.link.wasm.sym_index, variable.lib_name, null); + return wasm.addOrUpdateImport(name, atom.sym_index, variable.lib_name, null); } const val = if (decl.val.castTag(.variable)) |payload| payload.data.init else decl.val; @@ -1103,7 +1121,7 @@ pub fn updateDecl(wasm: *Wasm, mod: *Module, decl_index: Module.Decl.Index) !voi .{ .ty = decl.ty, .val = val }, &code_writer, .none, - .{ .parent_atom_index = decl.link.wasm.sym_index }, + .{ .parent_atom_index = atom.sym_index }, ); const code = switch (res) { @@ -1115,7 +1133,7 @@ pub fn updateDecl(wasm: *Wasm, mod: *Module, decl_index: Module.Decl.Index) !voi }, }; - return wasm.finishUpdateDecl(decl, code); + return wasm.finishUpdateDecl(decl_index, code); } pub fn updateDeclLineNumber(wasm: *Wasm, mod: *Module, decl_index: Module.Decl.Index) !void { @@ -1133,9 +1151,11 @@ pub fn updateDeclLineNumber(wasm: *Wasm, mod: *Module, decl_index: Module.Decl.I } } -fn finishUpdateDecl(wasm: *Wasm, decl: *Module.Decl, code: []const u8) !void { +fn finishUpdateDecl(wasm: *Wasm, decl_index: Module.Decl.Index, code: []const u8) !void { const mod = wasm.base.options.module.?; - const atom: *Atom = &decl.link.wasm; + const decl = mod.declPtr(decl_index); + const atom_index = wasm.decls.get(decl_index).?; + const atom = wasm.getAtomPtr(atom_index); const symbol = &wasm.symbols.items[atom.sym_index]; const full_name = try decl.getFullyQualifiedName(mod); defer wasm.base.allocator.free(full_name); @@ -1201,48 +1221,51 @@ pub fn lowerUnnamedConst(wasm: *Wasm, tv: TypedValue, decl_index: Module.Decl.In const decl = mod.declPtr(decl_index); // Create and initialize a new local symbol and atom - const local_index = decl.link.wasm.locals.items.len; + const atom_index = try wasm.createAtom(); + const parent_atom_index = try wasm.getOrCreateAtomForDecl(decl_index); + const parent_atom = wasm.getAtomPtr(parent_atom_index); + const local_index = parent_atom.locals.items.len; + try parent_atom.locals.append(wasm.base.allocator, atom_index); const fqdn = try decl.getFullyQualifiedName(mod); defer wasm.base.allocator.free(fqdn); const name = try std.fmt.allocPrintZ(wasm.base.allocator, "__unnamed_{s}_{d}", .{ fqdn, local_index }); defer wasm.base.allocator.free(name); - - const atom = try decl.link.wasm.locals.addOne(wasm.base.allocator); - atom.* = Atom.empty; - try atom.ensureInitialized(wasm); - atom.alignment = tv.ty.abiAlignment(wasm.base.options.target); - wasm.symbols.items[atom.sym_index] = .{ - .name = try wasm.string_table.put(wasm.base.allocator, name), - .flags = @enumToInt(Symbol.Flag.WASM_SYM_BINDING_LOCAL), - .tag = .data, - .index = undefined, - }; - - try wasm.resolved_symbols.putNoClobber(wasm.base.allocator, atom.symbolLoc(), {}); - var value_bytes = std.ArrayList(u8).init(wasm.base.allocator); defer value_bytes.deinit(); - const result = try codegen.generateSymbol( - &wasm.base, - decl.srcLoc(), - tv, - &value_bytes, - .none, - .{ - .parent_atom_index = atom.sym_index, - .addend = null, - }, - ); - const code = switch (result) { - .ok => value_bytes.items, - .fail => |em| { - decl.analysis = .codegen_failure; - try mod.failed_decls.put(mod.gpa, decl_index, em); - return error.AnalysisFail; - }, + const code = code: { + const atom = wasm.getAtomPtr(atom_index); + atom.alignment = tv.ty.abiAlignment(wasm.base.options.target); + wasm.symbols.items[atom.sym_index] = .{ + .name = try wasm.string_table.put(wasm.base.allocator, name), + .flags = @enumToInt(Symbol.Flag.WASM_SYM_BINDING_LOCAL), + .tag = .data, + .index = undefined, + }; + try wasm.resolved_symbols.putNoClobber(wasm.base.allocator, atom.symbolLoc(), {}); + + const result = try codegen.generateSymbol( + &wasm.base, + decl.srcLoc(), + tv, + &value_bytes, + .none, + .{ + .parent_atom_index = atom.sym_index, + .addend = null, + }, + ); + break :code switch (result) { + .ok => value_bytes.items, + .fail => |em| { + decl.analysis = .codegen_failure; + try mod.failed_decls.put(mod.gpa, decl_index, em); + return error.AnalysisFail; + }, + }; }; + const atom = wasm.getAtomPtr(atom_index); atom.size = @intCast(u32, code.len); try atom.code.appendSlice(wasm.base.allocator, code); return atom.sym_index; @@ -1290,10 +1313,13 @@ pub fn getDeclVAddr( ) !u64 { const mod = wasm.base.options.module.?; const decl = mod.declPtr(decl_index); - try decl.link.wasm.ensureInitialized(wasm); - const target_symbol_index = decl.link.wasm.sym_index; + + const target_atom_index = try wasm.getOrCreateAtomForDecl(decl_index); + const target_symbol_index = wasm.getAtom(target_atom_index).sym_index; + assert(reloc_info.parent_atom_index != 0); - const atom = wasm.symbol_atom.get(.{ .file = null, .index = reloc_info.parent_atom_index }).?; + const atom_index = wasm.symbol_atom.get(.{ .file = null, .index = reloc_info.parent_atom_index }).?; + const atom = wasm.getAtomPtr(atom_index); const is_wasm32 = wasm.base.options.target.cpu.arch == .wasm32; if (decl.ty.zigTypeTag() == .Fn) { assert(reloc_info.addend == 0); // addend not allowed for function relocations @@ -1321,9 +1347,10 @@ pub fn getDeclVAddr( return target_symbol_index; } -pub fn deleteExport(wasm: *Wasm, exp: Export) void { +pub fn deleteDeclExport(wasm: *Wasm, decl_index: Module.Decl.Index) void { if (wasm.llvm_object) |_| return; - const sym_index = exp.sym_index orelse return; + const atom_index = wasm.decls.get(decl_index) orelse return; + const sym_index = wasm.getAtom(atom_index).sym_index; const loc: SymbolLoc = .{ .file = null, .index = sym_index }; const symbol = loc.getSymbol(wasm); const symbol_name = wasm.string_table.get(symbol.name); @@ -1349,7 +1376,8 @@ pub fn updateDeclExports( } const decl = mod.declPtr(decl_index); - if (decl.link.wasm.getSymbolIndex() == null) return; // unititialized + const atom_index = try wasm.getOrCreateAtomForDecl(decl_index); + const atom = wasm.getAtom(atom_index); for (exports) |exp| { if (exp.options.section) |section| { @@ -1364,7 +1392,7 @@ pub fn updateDeclExports( const export_name = try wasm.string_table.put(wasm.base.allocator, exp.options.name); if (wasm.globals.getPtr(export_name)) |existing_loc| { - if (existing_loc.index == decl.link.wasm.sym_index) continue; + if (existing_loc.index == atom.sym_index) continue; const existing_sym: Symbol = existing_loc.getSymbol(wasm).*; const exp_is_weak = exp.options.linkage == .Internal or exp.options.linkage == .Weak; @@ -1385,15 +1413,16 @@ pub fn updateDeclExports( } else if (exp_is_weak) { continue; // to-be-exported symbol is weak, so we keep the existing symbol } else { - existing_loc.index = decl.link.wasm.sym_index; + // TODO: Revisit this, why was this needed? + existing_loc.index = atom.sym_index; existing_loc.file = null; - exp.link.wasm.sym_index = existing_loc.index; + // exp.link.wasm.sym_index = existing_loc.index; } } - const exported_decl = mod.declPtr(exp.exported_decl); - const sym_index = exported_decl.link.wasm.sym_index; - const sym_loc = exported_decl.link.wasm.symbolLoc(); + const exported_atom_index = try wasm.getOrCreateAtomForDecl(exp.exported_decl); + const exported_atom = wasm.getAtom(exported_atom_index); + const sym_loc = exported_atom.symbolLoc(); const symbol = sym_loc.getSymbol(wasm); switch (exp.options.linkage) { .Internal => { @@ -1429,7 +1458,6 @@ pub fn updateDeclExports( // if the symbol was previously undefined, remove it as an import _ = wasm.imports.remove(sym_loc); _ = wasm.undefs.swapRemove(exp.options.name); - exp.link.wasm.sym_index = sym_index; } } @@ -1439,11 +1467,13 @@ pub fn freeDecl(wasm: *Wasm, decl_index: Module.Decl.Index) void { } const mod = wasm.base.options.module.?; const decl = mod.declPtr(decl_index); - const atom = &decl.link.wasm; + const atom_index = wasm.decls.get(decl_index).?; + const atom = wasm.getAtomPtr(atom_index); wasm.symbols_free_list.append(wasm.base.allocator, atom.sym_index) catch {}; _ = wasm.decls.remove(decl_index); wasm.symbols.items[atom.sym_index].tag = .dead; - for (atom.locals.items) |local_atom| { + for (atom.locals.items) |local_atom_index| { + const local_atom = wasm.getAtom(local_atom_index); const local_symbol = &wasm.symbols.items[local_atom.sym_index]; local_symbol.tag = .dead; // also for any local symbol wasm.symbols_free_list.append(wasm.base.allocator, local_atom.sym_index) catch {}; @@ -1461,7 +1491,16 @@ pub fn freeDecl(wasm: *Wasm, decl_index: Module.Decl.Index) void { // dwarf.freeDecl(decl_index); // } - atom.deinit(wasm.base.allocator); + if (atom.next) |next_atom_index| { + const next_atom = wasm.getAtomPtr(next_atom_index); + next_atom.prev = atom.prev; + atom.next = null; + } + if (atom.prev) |prev_index| { + const prev_atom = wasm.getAtomPtr(prev_index); + prev_atom.next = atom.next; + atom.prev = null; + } } /// Appends a new entry to the indirect function table @@ -1583,7 +1622,8 @@ const Kind = union(enum) { }; /// Parses an Atom and inserts its metadata into the corresponding sections. -fn parseAtom(wasm: *Wasm, atom: *Atom, kind: Kind) !void { +fn parseAtom(wasm: *Wasm, atom_index: Atom.Index, kind: Kind) !void { + const atom = wasm.getAtomPtr(atom_index); const symbol = (SymbolLoc{ .file = null, .index = atom.sym_index }).getSymbol(wasm); const final_index: u32 = switch (kind) { .function => |fn_data| result: { @@ -1658,18 +1698,20 @@ fn parseAtom(wasm: *Wasm, atom: *Atom, kind: Kind) !void { const segment: *Segment = &wasm.segments.items[final_index]; segment.alignment = std.math.max(segment.alignment, atom.alignment); - try wasm.appendAtomAtIndex(final_index, atom); + try wasm.appendAtomAtIndex(final_index, atom_index); } /// From a given index, append the given `Atom` at the back of the linked list. /// Simply inserts it into the map of atoms when it doesn't exist yet. -pub fn appendAtomAtIndex(wasm: *Wasm, index: u32, atom: *Atom) !void { - if (wasm.atoms.getPtr(index)) |last| { - last.*.next = atom; - atom.prev = last.*; - last.* = atom; +pub fn appendAtomAtIndex(wasm: *Wasm, index: u32, atom_index: Atom.Index) !void { + const atom = wasm.getAtomPtr(atom_index); + if (wasm.atoms.getPtr(index)) |last_index_ptr| { + const last = wasm.getAtomPtr(last_index_ptr.*); + last.*.next = atom_index; + atom.prev = last_index_ptr.*; + last_index_ptr.* = atom_index; } else { - try wasm.atoms.putNoClobber(wasm.base.allocator, index, atom); + try wasm.atoms.putNoClobber(wasm.base.allocator, index, atom_index); } } @@ -1679,16 +1721,17 @@ fn allocateDebugAtoms(wasm: *Wasm) !void { if (wasm.dwarf == null) return; const allocAtom = struct { - fn f(bin: *Wasm, maybe_index: *?u32, atom: *Atom) !void { + fn f(bin: *Wasm, maybe_index: *?u32, atom_index: Atom.Index) !void { const index = maybe_index.* orelse idx: { const index = @intCast(u32, bin.segments.items.len); try bin.appendDummySegment(); maybe_index.* = index; break :idx index; }; + const atom = bin.getAtomPtr(atom_index); atom.size = @intCast(u32, atom.code.items.len); bin.symbols.items[atom.sym_index].index = index; - try bin.appendAtomAtIndex(index, atom); + try bin.appendAtomAtIndex(index, atom_index); } }.f; @@ -1710,15 +1753,16 @@ fn allocateAtoms(wasm: *Wasm) !void { var it = wasm.atoms.iterator(); while (it.next()) |entry| { const segment = &wasm.segments.items[entry.key_ptr.*]; - var atom: *Atom = entry.value_ptr.*.getFirst(); + var atom_index = entry.value_ptr.*; var offset: u32 = 0; while (true) { + const atom = wasm.getAtomPtr(atom_index); const symbol_loc = atom.symbolLoc(); if (wasm.code_section_index) |index| { if (index == entry.key_ptr.*) { if (!wasm.resolved_symbols.contains(symbol_loc)) { // only allocate resolved function body's. - atom = atom.next orelse break; + atom_index = atom.prev orelse break; continue; } } @@ -1732,8 +1776,7 @@ fn allocateAtoms(wasm: *Wasm) !void { atom.size, }); offset += atom.size; - try wasm.symbol_atom.put(wasm.base.allocator, symbol_loc, atom); // Update atom pointers - atom = atom.next orelse break; + atom_index = atom.prev orelse break; } segment.size = std.mem.alignForwardGeneric(u32, offset, segment.alignment); } @@ -1867,8 +1910,8 @@ fn initializeCallCtorsFunction(wasm: *Wasm) !void { symbol.index = func_index; // create the atom that will be output into the final binary - const atom = try wasm.base.allocator.create(Atom); - errdefer wasm.base.allocator.destroy(atom); + const atom_index = @intCast(Atom.Index, wasm.managed_atoms.items.len); + const atom = try wasm.managed_atoms.addOne(wasm.base.allocator); atom.* = .{ .size = @intCast(u32, function_body.items.len), .offset = 0, @@ -1879,13 +1922,13 @@ fn initializeCallCtorsFunction(wasm: *Wasm) !void { .prev = null, .code = function_body.moveToUnmanaged(), }; - try wasm.managed_atoms.append(wasm.base.allocator, atom); - try wasm.appendAtomAtIndex(wasm.code_section_index.?, atom); - try wasm.symbol_atom.putNoClobber(wasm.base.allocator, loc, atom); + try wasm.appendAtomAtIndex(wasm.code_section_index.?, atom_index); + try wasm.symbol_atom.putNoClobber(wasm.base.allocator, loc, atom_index); // `allocateAtoms` has already been called, set the atom's offset manually. // This is fine to do manually as we insert the atom at the very end. - atom.offset = atom.prev.?.offset + atom.prev.?.size; + const prev_atom = wasm.getAtom(atom.prev.?); + atom.offset = prev_atom.offset + prev_atom.size; } fn setupImports(wasm: *Wasm) !void { @@ -2088,7 +2131,8 @@ fn setupExports(wasm: *Wasm) !void { break :blk try wasm.string_table.put(wasm.base.allocator, sym_name); }; const exp: types.Export = if (symbol.tag == .data) exp: { - const atom = wasm.symbol_atom.get(sym_loc).?; + const atom_index = wasm.symbol_atom.get(sym_loc).?; + const atom = wasm.getAtom(atom_index); const va = atom.getVA(wasm, symbol); const global_index = @intCast(u32, wasm.imported_globals_count + wasm.wasm_globals.items.len); try wasm.wasm_globals.append(wasm.base.allocator, .{ @@ -2193,7 +2237,8 @@ fn setupMemory(wasm: *Wasm) !void { const segment_index = wasm.data_segments.get(".synthetic").?; const segment = &wasm.segments.items[segment_index]; segment.offset = 0; // for simplicity we store the entire VA into atom's offset. - const atom = wasm.symbol_atom.get(loc).?; + const atom_index = wasm.symbol_atom.get(loc).?; + const atom = wasm.getAtomPtr(atom_index); atom.offset = @intCast(u32, mem.alignForwardGeneric(u64, memory_ptr, heap_alignment)); } @@ -2226,7 +2271,8 @@ fn setupMemory(wasm: *Wasm) !void { const segment_index = wasm.data_segments.get(".synthetic").?; const segment = &wasm.segments.items[segment_index]; segment.offset = 0; - const atom = wasm.symbol_atom.get(loc).?; + const atom_index = wasm.symbol_atom.get(loc).?; + const atom = wasm.getAtomPtr(atom_index); atom.offset = @intCast(u32, memory_ptr); } @@ -2352,15 +2398,14 @@ pub fn getErrorTableSymbol(wasm: *Wasm) !u32 { // and then return said symbol's index. The final table will be populated // during `flush` when we know all possible error names. - // As sym_index '0' is reserved, we use it for our stack pointer symbol - const symbol_index = wasm.symbols_free_list.popOrNull() orelse blk: { - const index = @intCast(u32, wasm.symbols.items.len); - _ = try wasm.symbols.addOne(wasm.base.allocator); - break :blk index; - }; + const atom_index = try wasm.createAtom(); + const atom = wasm.getAtomPtr(atom_index); + const slice_ty = Type.initTag(.const_slice_u8_sentinel_0); + atom.alignment = slice_ty.abiAlignment(wasm.base.options.target); + const sym_index = atom.sym_index; const sym_name = try wasm.string_table.put(wasm.base.allocator, "__zig_err_name_table"); - const symbol = &wasm.symbols.items[symbol_index]; + const symbol = &wasm.symbols.items[sym_index]; symbol.* = .{ .name = sym_name, .tag = .data, @@ -2369,20 +2414,11 @@ pub fn getErrorTableSymbol(wasm: *Wasm) !u32 { }; symbol.setFlag(.WASM_SYM_VISIBILITY_HIDDEN); - const slice_ty = Type.initTag(.const_slice_u8_sentinel_0); + try wasm.resolved_symbols.put(wasm.base.allocator, atom.symbolLoc(), {}); - const atom = try wasm.base.allocator.create(Atom); - atom.* = Atom.empty; - atom.sym_index = symbol_index; - atom.alignment = slice_ty.abiAlignment(wasm.base.options.target); - try wasm.managed_atoms.append(wasm.base.allocator, atom); - const loc = atom.symbolLoc(); - try wasm.resolved_symbols.put(wasm.base.allocator, loc, {}); - try wasm.symbol_atom.put(wasm.base.allocator, loc, atom); - - log.debug("Error name table was created with symbol index: ({d})", .{symbol_index}); - wasm.error_table_symbol = symbol_index; - return symbol_index; + log.debug("Error name table was created with symbol index: ({d})", .{sym_index}); + wasm.error_table_symbol = sym_index; + return sym_index; } /// Populates the error name table, when `error_table_symbol` is not null. @@ -2391,22 +2427,17 @@ pub fn getErrorTableSymbol(wasm: *Wasm) !u32 { /// The table is what is being pointed to within the runtime bodies that are generated. fn populateErrorNameTable(wasm: *Wasm) !void { const symbol_index = wasm.error_table_symbol orelse return; - const atom: *Atom = wasm.symbol_atom.get(.{ .file = null, .index = symbol_index }).?; + const atom_index = wasm.symbol_atom.get(.{ .file = null, .index = symbol_index }).?; + const atom = wasm.getAtomPtr(atom_index); + // Rather than creating a symbol for each individual error name, // we create a symbol for the entire region of error names. We then calculate // the pointers into the list using addends which are appended to the relocation. - const names_atom = try wasm.base.allocator.create(Atom); - names_atom.* = Atom.empty; - try wasm.managed_atoms.append(wasm.base.allocator, names_atom); - const names_symbol_index = wasm.symbols_free_list.popOrNull() orelse blk: { - const index = @intCast(u32, wasm.symbols.items.len); - _ = try wasm.symbols.addOne(wasm.base.allocator); - break :blk index; - }; - names_atom.sym_index = names_symbol_index; + const names_atom_index = try wasm.createAtom(); + const names_atom = wasm.getAtomPtr(names_atom_index); names_atom.alignment = 1; const sym_name = try wasm.string_table.put(wasm.base.allocator, "__zig_err_names"); - const names_symbol = &wasm.symbols.items[names_symbol_index]; + const names_symbol = &wasm.symbols.items[names_atom.sym_index]; names_symbol.* = .{ .name = sym_name, .tag = .data, @@ -2430,7 +2461,7 @@ fn populateErrorNameTable(wasm: *Wasm) !void { try atom.code.writer(wasm.base.allocator).writeIntLittle(u32, len - 1); // create relocation to the error name try atom.relocs.append(wasm.base.allocator, .{ - .index = names_symbol_index, + .index = names_atom.sym_index, .relocation_type = .R_WASM_MEMORY_ADDR_I32, .offset = offset, .addend = @intCast(i32, addend), @@ -2449,61 +2480,53 @@ fn populateErrorNameTable(wasm: *Wasm) !void { const name_loc = names_atom.symbolLoc(); try wasm.resolved_symbols.put(wasm.base.allocator, name_loc, {}); - try wasm.symbol_atom.put(wasm.base.allocator, name_loc, names_atom); + try wasm.symbol_atom.put(wasm.base.allocator, name_loc, names_atom_index); // link the atoms with the rest of the binary so they can be allocated // and relocations will be performed. - try wasm.parseAtom(atom, .{ .data = .read_only }); - try wasm.parseAtom(names_atom, .{ .data = .read_only }); + try wasm.parseAtom(atom_index, .{ .data = .read_only }); + try wasm.parseAtom(names_atom_index, .{ .data = .read_only }); } /// From a given index variable, creates a new debug section. /// This initializes the index, appends a new segment, /// and finally, creates a managed `Atom`. -pub fn createDebugSectionForIndex(wasm: *Wasm, index: *?u32, name: []const u8) !*Atom { +pub fn createDebugSectionForIndex(wasm: *Wasm, index: *?u32, name: []const u8) !Atom.Index { const new_index = @intCast(u32, wasm.segments.items.len); index.* = new_index; try wasm.appendDummySegment(); - const sym_index = wasm.symbols_free_list.popOrNull() orelse idx: { - const tmp_index = @intCast(u32, wasm.symbols.items.len); - _ = try wasm.symbols.addOne(wasm.base.allocator); - break :idx tmp_index; - }; - wasm.symbols.items[sym_index] = .{ + const atom_index = try wasm.createAtom(); + const atom = wasm.getAtomPtr(atom_index); + wasm.symbols.items[atom.sym_index] = .{ .tag = .section, .name = try wasm.string_table.put(wasm.base.allocator, name), .index = 0, .flags = @enumToInt(Symbol.Flag.WASM_SYM_BINDING_LOCAL), }; - const atom = try wasm.base.allocator.create(Atom); - atom.* = Atom.empty; atom.alignment = 1; // debug sections are always 1-byte-aligned - atom.sym_index = sym_index; - try wasm.managed_atoms.append(wasm.base.allocator, atom); - try wasm.symbol_atom.put(wasm.base.allocator, atom.symbolLoc(), atom); - return atom; + return atom_index; } fn resetState(wasm: *Wasm) void { for (wasm.segment_info.values()) |segment_info| { wasm.base.allocator.free(segment_info.name); } - if (wasm.base.options.module) |mod| { - var decl_it = wasm.decls.keyIterator(); - while (decl_it.next()) |decl_index_ptr| { - const decl = mod.declPtr(decl_index_ptr.*); - const atom = &decl.link.wasm; - atom.next = null; - atom.prev = null; - for (atom.locals.items) |*local_atom| { - local_atom.next = null; - local_atom.prev = null; - } + var atom_it = wasm.decls.valueIterator(); + while (atom_it.next()) |atom_index| { + const atom = wasm.getAtomPtr(atom_index.*); + atom.next = null; + atom.prev = null; + + for (atom.locals.items) |local_atom_index| { + const local_atom = wasm.getAtomPtr(local_atom_index); + local_atom.next = null; + local_atom.prev = null; } } + wasm.functions.clearRetainingCapacity(); wasm.exports.clearRetainingCapacity(); wasm.segments.clearRetainingCapacity(); @@ -2800,28 +2823,29 @@ pub fn flushModule(wasm: *Wasm, comp: *Compilation, prog_node: *std.Progress.Nod try wasm.setupStart(); try wasm.setupImports(); if (wasm.base.options.module) |mod| { - var decl_it = wasm.decls.keyIterator(); - while (decl_it.next()) |decl_index_ptr| { - const decl = mod.declPtr(decl_index_ptr.*); + var decl_it = wasm.decls.iterator(); + while (decl_it.next()) |entry| { + const decl = mod.declPtr(entry.key_ptr.*); if (decl.isExtern()) continue; - const atom = &decl.*.link.wasm; + const atom_index = entry.value_ptr.*; if (decl.ty.zigTypeTag() == .Fn) { - try wasm.parseAtom(atom, .{ .function = decl.fn_link.wasm }); + try wasm.parseAtom(atom_index, .{ .function = decl.fn_link.wasm }); } else if (decl.getVariable()) |variable| { if (!variable.is_mutable) { - try wasm.parseAtom(atom, .{ .data = .read_only }); + try wasm.parseAtom(atom_index, .{ .data = .read_only }); } else if (variable.init.isUndefDeep()) { - try wasm.parseAtom(atom, .{ .data = .uninitialized }); + try wasm.parseAtom(atom_index, .{ .data = .uninitialized }); } else { - try wasm.parseAtom(atom, .{ .data = .initialized }); + try wasm.parseAtom(atom_index, .{ .data = .initialized }); } } else { - try wasm.parseAtom(atom, .{ .data = .read_only }); + try wasm.parseAtom(atom_index, .{ .data = .read_only }); } // also parse atoms for a decl's locals - for (atom.locals.items) |*local_atom| { - try wasm.parseAtom(local_atom, .{ .data = .read_only }); + const atom = wasm.getAtomPtr(atom_index); + for (atom.locals.items) |local_atom_index| { + try wasm.parseAtom(local_atom_index, .{ .data = .read_only }); } } @@ -3066,20 +3090,22 @@ fn writeToFile( var code_section_size: u32 = 0; if (wasm.code_section_index) |code_index| { const header_offset = try reserveVecSectionHeader(&binary_bytes); - var atom: *Atom = wasm.atoms.get(code_index).?.getFirst(); + var atom_index = wasm.atoms.get(code_index).?; // The code section must be sorted in line with the function order. var sorted_atoms = try std.ArrayList(*Atom).initCapacity(wasm.base.allocator, wasm.functions.count()); defer sorted_atoms.deinit(); while (true) { + var atom = wasm.getAtomPtr(atom_index); if (wasm.resolved_symbols.contains(atom.symbolLoc())) { if (!is_obj) { atom.resolveRelocs(wasm); } sorted_atoms.appendAssumeCapacity(atom); } - atom = atom.next orelse break; + // atom = if (atom.prev) |prev| wasm.getAtomPtr(prev) else break; + atom_index = atom.prev orelse break; } const atom_sort_fn = struct { @@ -3119,11 +3145,11 @@ fn writeToFile( // do not output 'bss' section unless we import memory and therefore // want to guarantee the data is zero initialized if (!import_memory and std.mem.eql(u8, entry.key_ptr.*, ".bss")) continue; - const atom_index = entry.value_ptr.*; - const segment = wasm.segments.items[atom_index]; + const segment_index = entry.value_ptr.*; + const segment = wasm.segments.items[segment_index]; if (segment.size == 0) continue; // do not emit empty segments segment_count += 1; - var atom: *Atom = wasm.atoms.getPtr(atom_index).?.*.getFirst(); + var atom_index = wasm.atoms.get(segment_index).?; // flag and index to memory section (currently, there can only be 1 memory section in wasm) try leb.writeULEB128(binary_writer, @as(u32, 0)); @@ -3134,6 +3160,7 @@ fn writeToFile( // fill in the offset table and the data segments var current_offset: u32 = 0; while (true) { + const atom = wasm.getAtomPtr(atom_index); if (!is_obj) { atom.resolveRelocs(wasm); } @@ -3149,8 +3176,8 @@ fn writeToFile( try binary_writer.writeAll(atom.code.items); current_offset += atom.size; - if (atom.next) |next| { - atom = next; + if (atom.prev) |prev| { + atom_index = prev; } else { // also pad with zeroes when last atom to ensure // segments are aligned. @@ -3192,15 +3219,15 @@ fn writeToFile( } if (!wasm.base.options.strip) { - if (wasm.dwarf) |*dwarf| { - const mod = wasm.base.options.module.?; - try dwarf.writeDbgAbbrev(); - // for debug info and ranges, the address is always 0, - // as locations are always offsets relative to 'code' section. - try dwarf.writeDbgInfoHeader(mod, 0, code_section_size); - try dwarf.writeDbgAranges(0, code_section_size); - try dwarf.writeDbgLineHeader(); - } + // if (wasm.dwarf) |*dwarf| { + // const mod = wasm.base.options.module.?; + // try dwarf.writeDbgAbbrev(); + // // for debug info and ranges, the address is always 0, + // // as locations are always offsets relative to 'code' section. + // try dwarf.writeDbgInfoHeader(mod, 0, code_section_size); + // try dwarf.writeDbgAranges(0, code_section_size); + // try dwarf.writeDbgLineHeader(); + // } var debug_bytes = std.ArrayList(u8).init(wasm.base.allocator); defer debug_bytes.deinit(); @@ -3223,11 +3250,11 @@ fn writeToFile( for (debug_sections) |item| { if (item.index) |index| { - var atom = wasm.atoms.get(index).?.getFirst(); + var atom = wasm.getAtomPtr(wasm.atoms.get(index).?); while (true) { atom.resolveRelocs(wasm); try debug_bytes.appendSlice(atom.code.items); - atom = atom.next orelse break; + atom = if (atom.prev) |prev| wasm.getAtomPtr(prev) else break; } try emitDebugSection(&binary_bytes, debug_bytes.items, item.name); debug_bytes.clearRetainingCapacity(); @@ -3959,7 +3986,8 @@ fn emitSymbolTable(wasm: *Wasm, binary_bytes: *std.ArrayList(u8), symbol_table: if (symbol.isDefined()) { try leb.writeULEB128(writer, symbol.index); - const atom = wasm.symbol_atom.get(sym_loc).?; + const atom_index = wasm.symbol_atom.get(sym_loc).?; + const atom = wasm.getAtom(atom_index); try leb.writeULEB128(writer, @as(u32, atom.offset)); try leb.writeULEB128(writer, @as(u32, atom.size)); } @@ -4037,7 +4065,7 @@ fn emitCodeRelocations( const reloc_start = binary_bytes.items.len; var count: u32 = 0; - var atom: *Atom = wasm.atoms.get(code_index).?.getFirst(); + var atom: *Atom = wasm.getAtomPtr(wasm.atoms.get(code_index).?); // for each atom, we calculate the uleb size and append that var size_offset: u32 = 5; // account for code section size leb128 while (true) { @@ -4055,7 +4083,7 @@ fn emitCodeRelocations( } log.debug("Emit relocation: {}", .{relocation}); } - atom = atom.next orelse break; + atom = if (atom.prev) |prev| wasm.getAtomPtr(prev) else break; } if (count == 0) return; var buf: [5]u8 = undefined; @@ -4086,7 +4114,7 @@ fn emitDataRelocations( // for each atom, we calculate the uleb size and append that var size_offset: u32 = 5; // account for code section size leb128 for (wasm.data_segments.values()) |segment_index| { - var atom: *Atom = wasm.atoms.get(segment_index).?.getFirst(); + var atom: *Atom = wasm.getAtomPtr(wasm.atoms.get(segment_index).?); while (true) { size_offset += getULEB128Size(atom.size); for (atom.relocs.items) |relocation| { @@ -4105,7 +4133,7 @@ fn emitDataRelocations( } log.debug("Emit relocation: {}", .{relocation}); } - atom = atom.next orelse break; + atom = if (atom.prev) |prev| wasm.getAtomPtr(prev) else break; } } if (count == 0) return; diff --git a/src/link/Wasm/Atom.zig b/src/link/Wasm/Atom.zig index 554f98b5ca..e719f8dfcc 100644 --- a/src/link/Wasm/Atom.zig +++ b/src/link/Wasm/Atom.zig @@ -29,14 +29,17 @@ file: ?u16, /// Next atom in relation to this atom. /// When null, this atom is the last atom -next: ?*Atom, +next: ?Atom.Index, /// Previous atom in relation to this atom. /// is null when this atom is the first in its order -prev: ?*Atom, +prev: ?Atom.Index, /// Contains atoms local to a decl, all managed by this `Atom`. /// When the parent atom is being freed, it will also do so for all local atoms. -locals: std.ArrayListUnmanaged(Atom) = .{}, +locals: std.ArrayListUnmanaged(Atom.Index) = .{}, + +/// Alias to an unsigned 32-bit integer +pub const Index = u32; /// Represents a default empty wasm `Atom` pub const empty: Atom = .{ @@ -50,14 +53,12 @@ pub const empty: Atom = .{ }; /// Frees all resources owned by this `Atom`. -pub fn deinit(atom: *Atom, gpa: Allocator) void { +pub fn deinit(atom: *Atom, wasm: *Wasm) void { + const gpa = wasm.base.allocator; atom.relocs.deinit(gpa); atom.code.deinit(gpa); - - for (atom.locals.items) |*local| { - local.deinit(gpa); - } atom.locals.deinit(gpa); + atom.* = undefined; } /// Sets the length of relocations and code to '0', @@ -78,24 +79,11 @@ pub fn format(atom: Atom, comptime fmt: []const u8, options: std.fmt.FormatOptio }); } -/// Returns the first `Atom` from a given atom -pub fn getFirst(atom: *Atom) *Atom { - var tmp = atom; - while (tmp.prev) |prev| tmp = prev; - return tmp; -} - /// Returns the location of the symbol that represents this `Atom` pub fn symbolLoc(atom: Atom) Wasm.SymbolLoc { return .{ .file = atom.file, .index = atom.sym_index }; } -pub fn ensureInitialized(atom: *Atom, wasm_bin: *Wasm) !void { - if (atom.getSymbolIndex() != null) return; // already initialized - atom.sym_index = try wasm_bin.allocateSymbol(); - try wasm_bin.symbol_atom.putNoClobber(wasm_bin.base.allocator, atom.symbolLoc(), atom); -} - pub fn getSymbolIndex(atom: Atom) ?u32 { if (atom.sym_index == 0) return null; return atom.sym_index; @@ -198,20 +186,28 @@ fn relocationValue(atom: Atom, relocation: types.Relocation, wasm_bin: *const Wa if (symbol.isUndefined()) { return 0; } - const target_atom = wasm_bin.symbol_atom.get(target_loc).?; + const target_atom_index = wasm_bin.symbol_atom.get(target_loc) orelse { + // this can only occur during incremental-compilation when a relocation + // still points to a freed decl. It is fine to emit the value 0 here + // as no actual code will point towards it. + return 0; + }; + const target_atom = wasm_bin.getAtom(target_atom_index); const va = @intCast(i32, target_atom.getVA(wasm_bin, symbol)); return @intCast(u32, va + relocation.addend); }, .R_WASM_EVENT_INDEX_LEB => return symbol.index, .R_WASM_SECTION_OFFSET_I32 => { - const target_atom = wasm_bin.symbol_atom.get(target_loc).?; + const target_atom_index = wasm_bin.symbol_atom.get(target_loc).?; + const target_atom = wasm_bin.getAtom(target_atom_index); const rel_value = @intCast(i32, target_atom.offset) + relocation.addend; return @intCast(u32, rel_value); }, .R_WASM_FUNCTION_OFFSET_I32 => { - const target_atom = wasm_bin.symbol_atom.get(target_loc) orelse { + const target_atom_index = wasm_bin.symbol_atom.get(target_loc) orelse { return @bitCast(u32, @as(i32, -1)); }; + const target_atom = wasm_bin.getAtom(target_atom_index); const offset: u32 = 11 + Wasm.getULEB128Size(target_atom.size); // Header (11 bytes fixed-size) + body size (leb-encoded) const rel_value = @intCast(i32, target_atom.offset + offset) + relocation.addend; return @intCast(u32, rel_value); diff --git a/src/link/Wasm/Object.zig b/src/link/Wasm/Object.zig index 8f49d68712..7d4f6a4e36 100644 --- a/src/link/Wasm/Object.zig +++ b/src/link/Wasm/Object.zig @@ -901,14 +901,9 @@ pub fn parseIntoAtoms(object: *Object, gpa: Allocator, object_index: u16, wasm_b continue; // found unknown section, so skip parsing into atom as we do not know how to handle it. }; - const atom = try gpa.create(Atom); + const atom_index = @intCast(Atom.Index, wasm_bin.managed_atoms.items.len); + const atom = try wasm_bin.managed_atoms.addOne(gpa); atom.* = Atom.empty; - errdefer { - atom.deinit(gpa); - gpa.destroy(atom); - } - - try wasm_bin.managed_atoms.append(gpa, atom); atom.file = object_index; atom.size = relocatable_data.size; atom.alignment = relocatable_data.getAlignment(object); @@ -938,12 +933,12 @@ pub fn parseIntoAtoms(object: *Object, gpa: Allocator, object_index: u16, wasm_b .index = relocatable_data.getIndex(), })) |symbols| { atom.sym_index = symbols.pop(); - try wasm_bin.symbol_atom.putNoClobber(gpa, atom.symbolLoc(), atom); + try wasm_bin.symbol_atom.putNoClobber(gpa, atom.symbolLoc(), atom_index); // symbols referencing the same atom will be added as alias // or as 'parent' when they are global. while (symbols.popOrNull()) |idx| { - try wasm_bin.symbol_atom.putNoClobber(gpa, .{ .file = atom.file, .index = idx }, atom); + try wasm_bin.symbol_atom.putNoClobber(gpa, .{ .file = atom.file, .index = idx }, atom_index); const alias_symbol = object.symtable[idx]; if (alias_symbol.isGlobal()) { atom.sym_index = idx; @@ -956,7 +951,7 @@ pub fn parseIntoAtoms(object: *Object, gpa: Allocator, object_index: u16, wasm_b segment.alignment = std.math.max(segment.alignment, atom.alignment); } - try wasm_bin.appendAtomAtIndex(final_index, atom); + try wasm_bin.appendAtomAtIndex(final_index, atom_index); log.debug("Parsed into atom: '{s}' at segment index {d}", .{ object.string_table.get(object.symtable[atom.sym_index].name), final_index }); } } diff --git a/test/link/wasm/export-data/build.zig b/test/link/wasm/export-data/build.zig index 283566dab3..db2ca804e8 100644 --- a/test/link/wasm/export-data/build.zig +++ b/test/link/wasm/export-data/build.zig @@ -23,8 +23,8 @@ pub fn build(b: *Builder) void { check_lib.checkNext("type i32"); check_lib.checkNext("mutable false"); check_lib.checkNext("i32.const {bar_address}"); - check_lib.checkComputeCompare("foo_address", .{ .op = .eq, .value = .{ .literal = 0 } }); - check_lib.checkComputeCompare("bar_address", .{ .op = .eq, .value = .{ .literal = 4 } }); + check_lib.checkComputeCompare("foo_address", .{ .op = .eq, .value = .{ .literal = 4 } }); + check_lib.checkComputeCompare("bar_address", .{ .op = .eq, .value = .{ .literal = 0 } }); check_lib.checkStart("Section export"); check_lib.checkNext("entries 3"); From beb20d29db3fe945746581eba5d2f2cae1403cdb Mon Sep 17 00:00:00 2001 From: Jakub Konka Date: Wed, 1 Feb 2023 19:32:54 +0100 Subject: [PATCH 68/84] link: remove union types which are now internal to backends --- src/Module.zig | 56 +++++---------------------------------- src/Sema.zig | 10 ------- src/arch/wasm/CodeGen.zig | 6 ++--- src/link.zig | 33 ----------------------- src/link/Wasm.zig | 2 +- 5 files changed, 10 insertions(+), 97 deletions(-) diff --git a/src/Module.zig b/src/Module.zig index f84d720d1f..b395c0a950 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -328,8 +328,6 @@ pub const ErrorInt = u32; pub const Export = struct { options: std.builtin.ExportOptions, src: LazySrcLoc, - /// Represents the position of the export, if any, in the output file. - link: link.File.Export, /// The Decl that performs the export. Note that this is *not* the Decl being exported. owner_decl: Decl.Index, /// The Decl containing the export statement. Inline function calls @@ -533,16 +531,8 @@ pub const Decl = struct { /// What kind of a declaration is this. kind: Kind, - /// Represents the position of the code in the output file. - /// This is populated regardless of semantic analysis and code generation. - link: link.File.LinkBlock, - - /// Represents the function in the linked output file, if the `Decl` is a function. - /// This is stored here and not in `Fn` because `Decl` survives across updates but - /// `Fn` does not. - /// TODO Look into making `Fn` a longer lived structure and moving this field there - /// to save on memory usage. - fn_link: link.File.LinkFn, + /// TODO remove this once Wasm backend catches up + fn_link: ?link.File.Wasm.FnData = null, /// The shallow set of other decls whose typed_value could possibly change if this Decl's /// typed_value is modified. @@ -5258,27 +5248,9 @@ pub fn clearDecl( if (decl.ty.isFnOrHasRuntimeBits()) { mod.comp.bin_file.freeDecl(decl_index); - // TODO instead of a union, put this memory trailing Decl objects, - // and allow it to be variably sized. - decl.link = switch (mod.comp.bin_file.tag) { - .coff => .{ .coff = {} }, - .elf => .{ .elf = {} }, - .macho => .{ .macho = {} }, - .plan9 => .{ .plan9 = {} }, - .c => .{ .c = {} }, - .wasm => .{ .wasm = {} }, - .spirv => .{ .spirv = {} }, - .nvptx => .{ .nvptx = {} }, - }; decl.fn_link = switch (mod.comp.bin_file.tag) { - .coff => .{ .coff = {} }, - .elf => .{ .elf = {} }, - .macho => .{ .macho = {} }, - .plan9 => .{ .plan9 = {} }, - .c => .{ .c = {} }, - .wasm => .{ .wasm = link.File.Wasm.FnData.empty }, - .spirv => .{ .spirv = {} }, - .nvptx => .{ .nvptx = {} }, + .wasm => link.File.Wasm.FnData.empty, + else => null, }; } if (decl.getInnerNamespace()) |namespace| { @@ -5680,25 +5652,9 @@ pub fn allocateNewDecl( .deletion_flag = false, .zir_decl_index = 0, .src_scope = src_scope, - .link = switch (mod.comp.bin_file.tag) { - .coff => .{ .coff = {} }, - .elf => .{ .elf = {} }, - .macho => .{ .macho = {} }, - .plan9 => .{ .plan9 = {} }, - .c => .{ .c = {} }, - .wasm => .{ .wasm = {} }, - .spirv => .{ .spirv = {} }, - .nvptx => .{ .nvptx = {} }, - }, .fn_link = switch (mod.comp.bin_file.tag) { - .coff => .{ .coff = {} }, - .elf => .{ .elf = {} }, - .macho => .{ .macho = {} }, - .plan9 => .{ .plan9 = {} }, - .c => .{ .c = {} }, - .wasm => .{ .wasm = link.File.Wasm.FnData.empty }, - .spirv => .{ .spirv = {} }, - .nvptx => .{ .nvptx = {} }, + .wasm => link.File.Wasm.FnData.empty, + else => null, }, .generation = 0, .is_pub = false, diff --git a/src/Sema.zig b/src/Sema.zig index 4871961753..54c3c6dc38 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -5564,16 +5564,6 @@ pub fn analyzeExport( .visibility = borrowed_options.visibility, }, .src = src, - .link = switch (mod.comp.bin_file.tag) { - .coff => .{ .coff = {} }, - .elf => .{ .elf = {} }, - .macho => .{ .macho = {} }, - .plan9 => .{ .plan9 = {} }, - .c => .{ .c = {} }, - .wasm => .{ .wasm = {} }, - .spirv => .{ .spirv = {} }, - .nvptx => .{ .nvptx = {} }, - }, .owner_decl = sema.owner_decl_index, .src_decl = block.src_decl, .exported_decl = exported_decl_index, diff --git a/src/arch/wasm/CodeGen.zig b/src/arch/wasm/CodeGen.zig index 8559a728e5..cf9c741513 100644 --- a/src/arch/wasm/CodeGen.zig +++ b/src/arch/wasm/CodeGen.zig @@ -1194,7 +1194,7 @@ fn genFunc(func: *CodeGen) InnerError!void { const fn_info = func.decl.ty.fnInfo(); var func_type = try genFunctype(func.gpa, fn_info.cc, fn_info.param_types, fn_info.return_type, func.target); defer func_type.deinit(func.gpa); - func.decl.fn_link.wasm.type_index = try func.bin_file.putOrGetFuncType(func_type); + func.decl.fn_link.?.type_index = try func.bin_file.putOrGetFuncType(func_type); var cc_result = try func.resolveCallingConventionValues(func.decl.ty); defer cc_result.deinit(func.gpa); @@ -2129,12 +2129,12 @@ fn airCall(func: *CodeGen, inst: Air.Inst.Index, modifier: std.builtin.CallModif defer func_type.deinit(func.gpa); const atom_index = try func.bin_file.getOrCreateAtomForDecl(extern_fn.data.owner_decl); const atom = func.bin_file.getAtomPtr(atom_index); - ext_decl.fn_link.wasm.type_index = try func.bin_file.putOrGetFuncType(func_type); + ext_decl.fn_link.?.type_index = try func.bin_file.putOrGetFuncType(func_type); try func.bin_file.addOrUpdateImport( mem.sliceTo(ext_decl.name, 0), atom.getSymbolIndex().?, ext_decl.getExternFn().?.lib_name, - ext_decl.fn_link.wasm.type_index, + ext_decl.fn_link.?.type_index, ); break :blk extern_fn.data.owner_decl; } else if (func_val.castTag(.decl_ref)) |decl_ref| { diff --git a/src/link.zig b/src/link.zig index 0a3226f004..2b3ce51667 100644 --- a/src/link.zig +++ b/src/link.zig @@ -261,39 +261,6 @@ pub const File = struct { /// of this linking operation. lock: ?Cache.Lock = null, - pub const LinkBlock = union { - elf: void, - coff: void, - macho: void, - plan9: void, - c: void, - wasm: void, - spirv: void, - nvptx: void, - }; - - pub const LinkFn = union { - elf: void, - coff: void, - macho: void, - plan9: void, - c: void, - wasm: Wasm.FnData, - spirv: void, - nvptx: void, - }; - - pub const Export = union { - elf: void, - coff: void, - macho: void, - plan9: void, - c: void, - wasm: void, - spirv: void, - nvptx: void, - }; - /// Attempts incremental linking, if the file already exists. If /// incremental linking fails, falls back to truncating the file and /// rewriting it. A malicious file is detected as incremental link failure diff --git a/src/link/Wasm.zig b/src/link/Wasm.zig index b06703ed61..17391b017a 100644 --- a/src/link/Wasm.zig +++ b/src/link/Wasm.zig @@ -2829,7 +2829,7 @@ pub fn flushModule(wasm: *Wasm, comp: *Compilation, prog_node: *std.Progress.Nod if (decl.isExtern()) continue; const atom_index = entry.value_ptr.*; if (decl.ty.zigTypeTag() == .Fn) { - try wasm.parseAtom(atom_index, .{ .function = decl.fn_link.wasm }); + try wasm.parseAtom(atom_index, .{ .function = decl.fn_link.? }); } else if (decl.getVariable()) |variable| { if (!variable.is_mutable) { try wasm.parseAtom(atom_index, .{ .data = .read_only }); From 490addde278001694d554a9a9fe2eb8235831143 Mon Sep 17 00:00:00 2001 From: Veikka Tuominen Date: Wed, 1 Feb 2023 20:50:43 +0200 Subject: [PATCH 69/84] Sema: fix error location on comptime arg to typed generic param Closes #14505 --- src/Sema.zig | 13 +++++++++++- ...omptime_arg_to_generic_fn_callee_error.zig | 21 +++++++++++++++++++ 2 files changed, 33 insertions(+), 1 deletion(-) create mode 100644 test/cases/compile_errors/comptime_arg_to_generic_fn_callee_error.zig diff --git a/src/Sema.zig b/src/Sema.zig index d306c68e08..4615c5b162 100644 --- a/src/Sema.zig +++ b/src/Sema.zig @@ -9015,7 +9015,18 @@ fn zirParam( if (is_comptime and sema.preallocated_new_func != null) { // We have a comptime value for this parameter so it should be elided from the // function type of the function instruction in this block. - const coerced_arg = try sema.coerce(block, param_ty, arg, src); + const coerced_arg = sema.coerce(block, param_ty, arg, .unneeded) catch |err| switch (err) { + error.NeededSourceLocation => { + // We are instantiating a generic function and a comptime arg + // cannot be coerced to the param type, but since we don't + // have the callee source location return `GenericPoison` + // so that the instantiation is failed and the coercion + // is handled by comptime call logic instead. + assert(sema.is_generic_instantiation); + return error.GenericPoison; + }, + else => return err, + }; sema.inst_map.putAssumeCapacity(inst, coerced_arg); return; } diff --git a/test/cases/compile_errors/comptime_arg_to_generic_fn_callee_error.zig b/test/cases/compile_errors/comptime_arg_to_generic_fn_callee_error.zig new file mode 100644 index 0000000000..efc3f556a9 --- /dev/null +++ b/test/cases/compile_errors/comptime_arg_to_generic_fn_callee_error.zig @@ -0,0 +1,21 @@ +const std = @import("std"); +const MyStruct = struct { + a: i32, + b: i32, + + pub fn getA(self: *List) i32 { + return self.items(.c); + } +}; +const List = std.MultiArrayList(MyStruct); +pub export fn entry() void { + var list = List{}; + _ = MyStruct.getA(&list); +} + +// error +// backend=stage2 +// target=native +// +// :7:28: error: no field named 'c' in enum 'meta.FieldEnum(tmp.MyStruct)' +// :?:?: note: enum declared here From 3c8d9681946630a1d953cb2c37cad248c7445093 Mon Sep 17 00:00:00 2001 From: ominitay <37453713+ominitay@users.noreply.github.com> Date: Sun, 31 Jul 2022 22:58:04 +0100 Subject: [PATCH 70/84] fmt: Make default_max_depth configurable --- lib/std/fmt.zig | 11 ++++++----- lib/std/std.zig | 5 +++++ 2 files changed, 11 insertions(+), 5 deletions(-) diff --git a/lib/std/fmt.zig b/lib/std/fmt.zig index 94b25c79a1..f2ee24a9e3 100644 --- a/lib/std/fmt.zig +++ b/lib/std/fmt.zig @@ -1,11 +1,12 @@ const std = @import("std.zig"); +const builtin = @import("builtin"); + const io = std.io; const math = std.math; const assert = std.debug.assert; const mem = std.mem; const unicode = std.unicode; const meta = std.meta; -const builtin = @import("builtin"); const errol = @import("fmt/errol.zig"); const lossyCast = std.math.lossyCast; const expectFmt = std.testing.expectFmt; @@ -190,7 +191,7 @@ pub fn format( .precision = precision, }, writer, - default_max_depth, + std.options.fmt_max_depth, ); } @@ -2140,15 +2141,15 @@ test "buffer" { { var buf1: [32]u8 = undefined; var fbs = std.io.fixedBufferStream(&buf1); - try formatType(1234, "", FormatOptions{}, fbs.writer(), default_max_depth); + try formatType(1234, "", FormatOptions{}, fbs.writer(), std.options.fmt_max_depth); try std.testing.expect(mem.eql(u8, fbs.getWritten(), "1234")); fbs.reset(); - try formatType('a', "c", FormatOptions{}, fbs.writer(), default_max_depth); + try formatType('a', "c", FormatOptions{}, fbs.writer(), std.options.fmt_max_depth); try std.testing.expect(mem.eql(u8, fbs.getWritten(), "a")); fbs.reset(); - try formatType(0b1100, "b", FormatOptions{}, fbs.writer(), default_max_depth); + try formatType(0b1100, "b", FormatOptions{}, fbs.writer(), std.options.fmt_max_depth); try std.testing.expect(mem.eql(u8, fbs.getWritten(), "1100")); } } diff --git a/lib/std/std.zig b/lib/std/std.zig index 40ba896569..e02be2ebaf 100644 --- a/lib/std/std.zig +++ b/lib/std/std.zig @@ -153,6 +153,11 @@ pub const options = struct { else log.defaultLog; + pub const fmt_max_depth = if (@hasDecl(options_override, "fmt_max_depth")) + options_override.fmt_max_depth + else + fmt.default_max_depth; + pub const cryptoRandomSeed: fn (buffer: []u8) void = if (@hasDecl(options_override, "cryptoRandomSeed")) options_override.cryptoRandomSeed else From 86ec26b1f00ce9ee2a9d559a1ca0415d05a9b908 Mon Sep 17 00:00:00 2001 From: Evan Typanski Date: Sat, 28 Jan 2023 11:53:38 -0500 Subject: [PATCH 71/84] translate-c: Fix types on assign expression bool --- src/translate_c.zig | 5 ++++- test/translate_c.zig | 16 ++++++++++++++++ 2 files changed, 20 insertions(+), 1 deletion(-) diff --git a/src/translate_c.zig b/src/translate_c.zig index 47a21f5b5c..a6715d161c 100644 --- a/src/translate_c.zig +++ b/src/translate_c.zig @@ -4519,7 +4519,10 @@ fn transCreateNodeAssign( defer block_scope.deinit(); const tmp = try block_scope.makeMangledName(c, "tmp"); - const rhs_node = try transExpr(c, &block_scope.base, rhs, .used); + var rhs_node = try transExpr(c, &block_scope.base, rhs, .used); + if (!exprIsBooleanType(lhs) and isBoolRes(rhs_node)) { + rhs_node = try Tag.bool_to_int.create(c.arena, rhs_node); + } const tmp_decl = try Tag.var_simple.create(c.arena, .{ .name = tmp, .init = rhs_node }); try block_scope.statements.append(tmp_decl); diff --git a/test/translate_c.zig b/test/translate_c.zig index 4ecb6835f5..d2db895a5a 100644 --- a/test/translate_c.zig +++ b/test/translate_c.zig @@ -3900,4 +3900,20 @@ pub fn addCases(cases: *tests.TranslateCContext) void { \\pub const ZERO = @as(c_int, 0); \\pub const WORLD = @as(c_int, 0o0000123); }); + + cases.add("Assign expression from bool to int", + \\void foo(void) { + \\ int a; + \\ if (a = 1 > 0) {} + \\} + , &[_][]const u8{ + \\pub export fn foo() void { + \\ var a: c_int = undefined; + \\ if ((blk: { + \\ const tmp = @boolToInt(@as(c_int, 1) > @as(c_int, 0)); + \\ a = tmp; + \\ break :blk tmp; + \\ }) != 0) {} + \\} + }); } From 1fba88450db12f184d76f0651f7ca933322c1fc0 Mon Sep 17 00:00:00 2001 From: Josh Holland Date: Fri, 27 Jan 2023 18:29:28 +0000 Subject: [PATCH 72/84] langref: add paragraph and examples about indexing non-ASCII strings PR #10610 addressed most of the points from #1854. This additional paragraph and examples covers the OMISSIONS section clarifying issues about indexing into non-ASCII strings (whether valid UTF-8 or not). I think this finally closes #1854. --- doc/langref.html.in | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/doc/langref.html.in b/doc/langref.html.in index 00a263bae2..2e16c0c9e6 100644 --- a/doc/langref.html.in +++ b/doc/langref.html.in @@ -871,6 +871,13 @@ pub fn main() void { However, it is possible to embed non-UTF-8 bytes into a string literal using \xNN notation.

+ Indexing into a string containing non-ASCII bytes will return individual bytes, whether valid + UTF-8 or not. + The {#link|Zig Standard Library#} provides routines for checking the validity of UTF-8 encoded + strings, accessing their code points and other encoding/decoding related tasks in + {#syntax#}std.unicode{#endsyntax#}. +

+

Unicode code point literals have type {#syntax#}comptime_int{#endsyntax#}, the same as {#link|Integer Literals#}. All {#link|Escape Sequences#} are valid in both string literals and Unicode code point literals. @@ -894,9 +901,12 @@ pub fn main() void { print("{}\n", .{'e' == '\x65'}); // true print("{d}\n", .{'\u{1f4a9}'}); // 128169 print("{d}\n", .{'💯'}); // 128175 - print("{}\n", .{mem.eql(u8, "hello", "h\x65llo")}); // true - print("0x{x}\n", .{"\xff"[0]}); // non-UTF-8 strings are possible with \xNN notation. print("{u}\n", .{'âš¡'}); + print("{}\n", .{mem.eql(u8, "hello", "h\x65llo")}); // true + print("{}\n", .{mem.eql(u8, "💯", "\xf0\x9f\x92\xaf")}); // also true + const invalid_utf8 = "\xff\xfe"; // non-UTF-8 strings are possible with \xNN notation. + print("0x{x}\n", .{invalid_utf8[1]}); // indexing them returns individual bytes... + print("0x{x}\n", .{"💯"[1]}); // ...as does indexing part-way through non-ASCII characters } {#code_end#} {#see_also|Arrays|Source Encoding#} From 629c3108aa71f94bd26dba8d4f20c9f3a3945bd4 Mon Sep 17 00:00:00 2001 From: Veikka Tuominen Date: Wed, 1 Feb 2023 21:41:02 +0200 Subject: [PATCH 73/84] AstGen: fix orelse type coercion in call arguments Closes #14506 --- src/AstGen.zig | 8 +++++++- test/behavior/basic.zig | 18 ++++++++++++++++++ 2 files changed, 25 insertions(+), 1 deletion(-) diff --git a/src/AstGen.zig b/src/AstGen.zig index a5667ce9e8..10673a2b37 100644 --- a/src/AstGen.zig +++ b/src/AstGen.zig @@ -8721,6 +8721,7 @@ fn callExpr( defer arg_block.unstack(); // `call_inst` is reused to provide the param type. + arg_block.rl_ty_inst = call_inst; const arg_ref = try expr(&arg_block, &arg_block.base, .{ .rl = .{ .coerced_ty = call_inst }, .ctx = .fn_arg }, param_node); _ = try arg_block.addBreak(.break_inline, call_index, arg_ref); @@ -10869,7 +10870,12 @@ const GenZir = struct { // we emit ZIR for the block break instructions to have the result values, // and then rvalue() on that to pass the value to the result location. switch (parent_ri.rl) { - .ty, .coerced_ty => |ty_inst| { + .coerced_ty => |ty_inst| { + // Type coercion needs to happend before breaks. + gz.rl_ty_inst = ty_inst; + gz.break_result_info = .{ .rl = .{ .ty = ty_inst } }; + }, + .ty => |ty_inst| { gz.rl_ty_inst = ty_inst; gz.break_result_info = parent_ri; }, diff --git a/test/behavior/basic.zig b/test/behavior/basic.zig index 8a97b3cbcd..b82bfab99e 100644 --- a/test/behavior/basic.zig +++ b/test/behavior/basic.zig @@ -1125,3 +1125,21 @@ test "returning an opaque type from a function" { }; try expect(S.foo(123).b == 123); } + +test "orelse coercion as function argument" { + if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; // TODO + if (builtin.zig_backend == .stage2_arm) return error.SkipZigTest; // TODO + + const Loc = struct { start: i32 = -1 }; + const Container = struct { + a: ?Loc = null, + fn init(a: Loc) @This() { + return .{ + .a = a, + }; + } + }; + var optional: ?Loc = .{}; + var foo = Container.init(optional orelse .{}); + try expect(foo.a.?.start == -1); +} From ea6e0e33a7630fb78550a5567a98420c3377350c Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Wed, 1 Feb 2023 18:42:29 -0700 Subject: [PATCH 74/84] zig build: add executable bit and file path to package hash Unfortunately, due to the Windows equivalent of executable permissions being a bit tricky, there is follow-up work to be done. What is done in this commit is the hash modifications. At the fetch layer, executable bits inside packages are ignored. In the hash computation layer, executable bit is implemented for POSIX but not yet for Windows. This means that the hash will not break again in the future for packages that do not have any executable files, but it will break for packages that do. This is a hash-breaking change. Closes #14308 --- lib/std/fs/file.zig | 3 ++- lib/std/tar.zig | 23 +++++++++++++++++++++++ src/Package.zig | 24 +++++++++++++++++++++++- 3 files changed, 48 insertions(+), 2 deletions(-) diff --git a/lib/std/fs/file.zig b/lib/std/fs/file.zig index a6ecc37d92..1ba4bc18fd 100644 --- a/lib/std/fs/file.zig +++ b/lib/std/fs/file.zig @@ -179,7 +179,7 @@ pub const File = struct { lock_nonblocking: bool = false, /// For POSIX systems this is the file system mode the file will - /// be created with. + /// be created with. On other systems this is always 0. mode: Mode = default_mode, /// Setting this to `.blocking` prevents `O.NONBLOCK` from being passed even @@ -307,6 +307,7 @@ pub const File = struct { /// is unique to each filesystem. inode: INode, size: u64, + /// This is available on POSIX systems and is always 0 otherwise. mode: Mode, kind: Kind, diff --git a/lib/std/tar.zig b/lib/std/tar.zig index 4f6a77c6ba..91772d7319 100644 --- a/lib/std/tar.zig +++ b/lib/std/tar.zig @@ -1,6 +1,18 @@ pub const Options = struct { /// Number of directory levels to skip when extracting files. strip_components: u32 = 0, + /// How to handle the "mode" property of files from within the tar file. + mode_mode: ModeMode = .executable_bit_only, + + const ModeMode = enum { + /// The mode from the tar file is completely ignored. Files are created + /// with the default mode when creating files. + ignore, + /// The mode from the tar file is inspected for the owner executable bit + /// only. This bit is copied to the group and other executable bits. + /// Other bits of the mode are left as the default when creating files. + executable_bit_only, + }; }; pub const Header = struct { @@ -72,6 +84,17 @@ pub const Header = struct { }; pub fn pipeToFileSystem(dir: std.fs.Dir, reader: anytype, options: Options) !void { + switch (options.mode_mode) { + .ignore => {}, + .executable_bit_only => { + // This code does not look at the mode bits yet. To implement this feature, + // the implementation must be adjusted to look at the mode, and check the + // user executable bit, then call fchmod on newly created files when + // the executable bit is supposed to be set. + // It also needs to properly deal with ACLs on Windows. + @panic("TODO: unimplemented: tar ModeMode.executable_bit_only"); + }, + } var file_name_buffer: [255]u8 = undefined; var buffer: [512 * 8]u8 = undefined; var start: usize = 0; diff --git a/src/Package.zig b/src/Package.zig index ebe84b8444..0f036b9ef5 100644 --- a/src/Package.zig +++ b/src/Package.zig @@ -1,5 +1,6 @@ const Package = @This(); +const builtin = @import("builtin"); const std = @import("std"); const fs = std.fs; const mem = std.mem; @@ -440,6 +441,12 @@ fn unpackTarball( try std.tar.pipeToFileSystem(out_dir, decompress.reader(), .{ .strip_components = 1, + // TODO: we would like to set this to executable_bit_only, but two + // things need to happen before that: + // 1. the tar implementation needs to support it + // 2. the hashing algorithm here needs to support detecting the is_executable + // bit on Windows from the ACLs (see the isExecutable function). + .mode_mode = .ignore, }); } @@ -468,7 +475,7 @@ const HashedFile = struct { hash: [Hash.digest_length]u8, failure: Error!void, - const Error = fs.File.OpenError || fs.File.ReadError; + const Error = fs.File.OpenError || fs.File.ReadError || fs.File.StatError; fn lessThan(context: void, lhs: *const HashedFile, rhs: *const HashedFile) bool { _ = context; @@ -544,6 +551,8 @@ fn hashFileFallible(dir: fs.Dir, hashed_file: *HashedFile) HashedFile.Error!void var buf: [8000]u8 = undefined; var file = try dir.openFile(hashed_file.path, .{}); var hasher = Hash.init(.{}); + hasher.update(hashed_file.path); + hasher.update(&.{ 0, @boolToInt(try isExecutable(file)) }); while (true) { const bytes_read = try file.read(&buf); if (bytes_read == 0) break; @@ -552,6 +561,19 @@ fn hashFileFallible(dir: fs.Dir, hashed_file: *HashedFile) HashedFile.Error!void hasher.final(&hashed_file.hash); } +fn isExecutable(file: fs.File) !bool { + if (builtin.os.tag == .windows) { + // TODO check the ACL on Windows. + // Until this is implemented, this could be a false negative on + // Windows, which is why we do not yet set executable_bit_only above + // when unpacking the tarball. + return false; + } else { + const stat = try file.stat(); + return (stat.mode & std.os.S.IXUSR) != 0; + } +} + const hex_charset = "0123456789abcdef"; fn hex64(x: u64) [16]u8 { From 24ff8a1a5fc00c405e5506251f11d23653d6c8b5 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Wed, 1 Feb 2023 20:02:35 -0700 Subject: [PATCH 75/84] zig build: use multihash for the hash field https://multiformats.io/multihash/ Still, only SHA2-256 is supported. This is only intended to future-proof the hash field of the manifest. closes #14284 --- src/Package.zig | 76 +++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 67 insertions(+), 9 deletions(-) diff --git a/src/Package.zig b/src/Package.zig index 0f036b9ef5..35b1ff5056 100644 --- a/src/Package.zig +++ b/src/Package.zig @@ -299,16 +299,37 @@ fn fetchAndUnpack( // Check if the expected_hash is already present in the global package // cache, and thereby avoid both fetching and unpacking. if (expected_hash) |h| cached: { - if (h.len != 2 * Hash.digest_length) { + const hex_multihash_len = 2 * multihash_len; + if (h.len >= 2) { + const their_multihash_func = std.fmt.parseInt(u8, h[0..2], 16) catch |err| { + return reportError( + ini, + comp_directory, + h.ptr, + "invalid multihash value: unable to parse hash function: {s}", + .{@errorName(err)}, + ); + }; + if (@intToEnum(MultihashFunction, their_multihash_func) != multihash_function) { + return reportError( + ini, + comp_directory, + h.ptr, + "unsupported hash function: only sha2-256 is supported", + .{}, + ); + } + } + if (h.len != hex_multihash_len) { return reportError( ini, comp_directory, h.ptr, "wrong hash size. expected: {d}, found: {d}", - .{ Hash.digest_length, h.len }, + .{ hex_multihash_len, h.len }, ); } - const hex_digest = h[0 .. 2 * Hash.digest_length]; + const hex_digest = h[0..hex_multihash_len]; const pkg_dir_sub_path = "p" ++ s ++ hex_digest; var pkg_dir = global_cache_directory.handle.openDir(pkg_dir_sub_path, .{}) catch |err| switch (err) { error.FileNotFound => break :cached, @@ -397,8 +418,8 @@ fn fetchAndUnpack( const pkg_dir_sub_path = "p" ++ s ++ hexDigest(actual_hash); try renameTmpIntoCache(global_cache_directory.handle, tmp_dir_sub_path, pkg_dir_sub_path); + const actual_hex = hexDigest(actual_hash); if (expected_hash) |h| { - const actual_hex = hexDigest(actual_hash); if (!mem.eql(u8, h, &actual_hex)) { return reportError( ini, @@ -414,7 +435,7 @@ fn fetchAndUnpack( comp_directory, url.ptr, "url field is missing corresponding hash field: hash={s}", - .{std.fmt.fmtSliceHexLower(&actual_hash)}, + .{&actual_hex}, ); } @@ -592,11 +613,30 @@ test hex64 { try std.testing.expectEqualStrings("[00efcdab78563412]", s); } -fn hexDigest(digest: [Hash.digest_length]u8) [Hash.digest_length * 2]u8 { - var result: [Hash.digest_length * 2]u8 = undefined; +const multihash_function: MultihashFunction = switch (Hash) { + std.crypto.hash.sha2.Sha256 => .@"sha2-256", + else => @compileError("unreachable"), +}; +comptime { + // We avoid unnecessary uleb128 code in hexDigest by asserting here the + // values are small enough to be contained in the one-byte encoding. + assert(@enumToInt(multihash_function) < 127); + assert(Hash.digest_length < 127); +} +const multihash_len = 1 + 1 + Hash.digest_length; + +fn hexDigest(digest: [Hash.digest_length]u8) [multihash_len * 2]u8 { + var result: [multihash_len * 2]u8 = undefined; + + result[0] = hex_charset[@enumToInt(multihash_function) >> 4]; + result[1] = hex_charset[@enumToInt(multihash_function) & 15]; + + result[2] = hex_charset[Hash.digest_length >> 4]; + result[3] = hex_charset[Hash.digest_length & 15]; + for (digest) |byte, i| { - result[i * 2 + 0] = hex_charset[byte >> 4]; - result[i * 2 + 1] = hex_charset[byte & 15]; + result[4 + i * 2] = hex_charset[byte >> 4]; + result[5 + i * 2] = hex_charset[byte & 15]; } return result; } @@ -629,3 +669,21 @@ fn renameTmpIntoCache( break; } } + +const MultihashFunction = enum(u16) { + identity = 0x00, + sha1 = 0x11, + @"sha2-256" = 0x12, + @"sha2-512" = 0x13, + @"sha3-512" = 0x14, + @"sha3-384" = 0x15, + @"sha3-256" = 0x16, + @"sha3-224" = 0x17, + @"sha2-384" = 0x20, + @"sha2-256-trunc254-padded" = 0x1012, + @"sha2-224" = 0x1013, + @"sha2-512-224" = 0x1014, + @"sha2-512-256" = 0x1015, + @"blake2b-256" = 0xb220, + _, +}; From 72a7e3dc5e3d2128f4d95b7ba9554ea2e6e35139 Mon Sep 17 00:00:00 2001 From: praschke Date: Wed, 1 Feb 2023 20:52:06 +0000 Subject: [PATCH 76/84] mingw: stop using K&R-style function definitions this patch is from upstream, to fix -Wdeprecated-non-prototypes issues. K&R-style has apparently been deprecated since even C89, and C2x will be repurposing the syntax space. this warning triggers when the change would affect the meaning of the code. --- lib/libc/mingw/misc/strtoimax.c | 5 +---- lib/libc/mingw/misc/strtoumax.c | 5 +---- lib/libc/mingw/misc/wcstoimax.c | 5 +---- lib/libc/mingw/misc/wcstoumax.c | 5 +---- 4 files changed, 4 insertions(+), 16 deletions(-) diff --git a/lib/libc/mingw/misc/strtoimax.c b/lib/libc/mingw/misc/strtoimax.c index eef5da97cc..9e75f8a275 100644 --- a/lib/libc/mingw/misc/strtoimax.c +++ b/lib/libc/mingw/misc/strtoimax.c @@ -31,10 +31,7 @@ #define valid(n, b) ((n) >= 0 && (n) < (b)) intmax_t -strtoimax(nptr, endptr, base) - register const char * __restrict__ nptr; - char ** __restrict__ endptr; - register int base; +strtoimax(const char * __restrict__ nptr, char ** __restrict__ endptr, int base) { register uintmax_t accum; /* accumulates converted value */ register int n; /* numeral from digit character */ diff --git a/lib/libc/mingw/misc/strtoumax.c b/lib/libc/mingw/misc/strtoumax.c index e86cd76132..2c24db14d8 100644 --- a/lib/libc/mingw/misc/strtoumax.c +++ b/lib/libc/mingw/misc/strtoumax.c @@ -31,10 +31,7 @@ #define valid(n, b) ((n) >= 0 && (n) < (b)) uintmax_t -strtoumax(nptr, endptr, base) - register const char * __restrict__ nptr; - char ** __restrict__ endptr; - register int base; +strtoumax(const char * __restrict__ nptr, char ** __restrict__ endptr, int base) { register uintmax_t accum; /* accumulates converted value */ register uintmax_t next; /* for computing next value of accum */ diff --git a/lib/libc/mingw/misc/wcstoimax.c b/lib/libc/mingw/misc/wcstoimax.c index 9821cf07cc..99e97b9214 100644 --- a/lib/libc/mingw/misc/wcstoimax.c +++ b/lib/libc/mingw/misc/wcstoimax.c @@ -33,10 +33,7 @@ #define valid(n, b) ((n) >= 0 && (n) < (b)) intmax_t -wcstoimax(nptr, endptr, base) - register const wchar_t * __restrict__ nptr; - wchar_t ** __restrict__ endptr; - register int base; +wcstoimax(const wchar_t * __restrict__ nptr, wchar_t ** __restrict__ endptr, int base) { register uintmax_t accum; /* accumulates converted value */ register int n; /* numeral from digit character */ diff --git a/lib/libc/mingw/misc/wcstoumax.c b/lib/libc/mingw/misc/wcstoumax.c index 0f1ed540c2..97f2c30833 100644 --- a/lib/libc/mingw/misc/wcstoumax.c +++ b/lib/libc/mingw/misc/wcstoumax.c @@ -33,10 +33,7 @@ #define valid(n, b) ((n) >= 0 && (n) < (b)) uintmax_t -wcstoumax(nptr, endptr, base) - register const wchar_t * __restrict__ nptr; - wchar_t ** __restrict__ endptr; - register int base; +wcstoumax(const wchar_t * __restrict__ nptr, wchar_t ** __restrict__ endptr, int base) { register uintmax_t accum; /* accumulates converted value */ register uintmax_t next; /* for computing next value of accum */ From e712d5f03e6e3ddde6a4a6f7d2d82e786efd543a Mon Sep 17 00:00:00 2001 From: Kirk Scheibelhut Date: Wed, 1 Feb 2023 10:15:58 -0800 Subject: [PATCH 77/84] remove reference to removed addTestExe --- lib/std/Build/InstallArtifactStep.zig | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lib/std/Build/InstallArtifactStep.zig b/lib/std/Build/InstallArtifactStep.zig index 8ee739a41c..c419c85fdf 100644 --- a/lib/std/Build/InstallArtifactStep.zig +++ b/lib/std/Build/InstallArtifactStep.zig @@ -23,7 +23,7 @@ pub fn create(builder: *std.Build, artifact: *CompileStep) *InstallArtifactStep .artifact = artifact, .dest_dir = artifact.override_dest_dir orelse switch (artifact.kind) { .obj => @panic("Cannot install a .obj build artifact."), - .@"test" => @panic("Cannot install a test build artifact, use addTestExe instead."), + .@"test" => @panic("Cannot install a .test build artifact, use .test_exe instead."), .exe, .test_exe => InstallDir{ .bin = {} }, .lib => InstallDir{ .lib = {} }, }, From c3abb63fe99eb7091e5841f8e65f197b77d868a8 Mon Sep 17 00:00:00 2001 From: Krzysztof Wolicki Der Teufel Date: Thu, 2 Feb 2023 14:46:42 +0100 Subject: [PATCH 78/84] autodoc: Added `@qualCast` builtin function handling --- lib/docs/main.js | 4 ++++ src/Autodoc.zig | 1 + 2 files changed, 5 insertions(+) diff --git a/lib/docs/main.js b/lib/docs/main.js index d488d018a6..62af5866b6 100644 --- a/lib/docs/main.js +++ b/lib/docs/main.js @@ -1354,6 +1354,10 @@ const NAV_MODES = { payloadHtml += "ptrCast"; break; } + case "qual_cast": { + payloadHtml += "qualCast"; + break; + } case "truncate": { payloadHtml += "truncate"; break; diff --git a/src/Autodoc.zig b/src/Autodoc.zig index 8afc9c859b..0798ec198f 100644 --- a/src/Autodoc.zig +++ b/src/Autodoc.zig @@ -1400,6 +1400,7 @@ fn walkInstruction( .float_cast, .int_cast, .ptr_cast, + .qual_cast, .truncate, .align_cast, .has_decl, From 03cdb4fb5853109e46bdc08d8a849a23780093ae Mon Sep 17 00:00:00 2001 From: Jan Philipp Hafer Date: Thu, 26 Jan 2023 22:44:39 +0100 Subject: [PATCH 79/84] compiler_rt: make README visually nice and improve explanations This commit makes the text more dense with sources, noes the outstanding audit and adds an explanation of the table before converting everything to markdown tables. For the status a checkmark or cross in utf8 encoding are used and the input and output sizes of all operations are given inclusive comments for understanding of the routines. This should document all compiler_rt integer and float routines, but does not include a documentation of existing ieee floating and math routines. --- lib/compiler_rt/README.md | 977 ++++++++++++++++++++------------------ 1 file changed, 520 insertions(+), 457 deletions(-) diff --git a/lib/compiler_rt/README.md b/lib/compiler_rt/README.md index b2c6a10695..8e838dfced 100644 --- a/lib/compiler_rt/README.md +++ b/lib/compiler_rt/README.md @@ -27,482 +27,545 @@ then statically linked and therefore is a transparent dependency for the programmer. For details see `../compiler_rt.zig`. -The routines in this folder are listed below. -Routines are annotated as `type source routine // description`, with `routine` -being the name used in aforementioned `compiler_rt.zig`. -`dev` means deviating from compiler_rt, `port` ported, `source` is the -information source for the implementation, `none` means unimplemented. -Some examples for the naming convention are: -- dev source name_routine, name_routine2 various implementations for performance, simplicity etc -- port llvm compiler-rt library routines from [LLVM](http://compiler-rt.llvm.org/) - * LLVM emits library calls to compiler-rt, if the hardware lacks functionality -- port musl libc routines from [musl](https://musl.libc.org/) -If the library or information source is uncommon, use the entry `other` for `source`. -Please do not break the search by inserting entries in another format than `impl space source`. - Bugs should be solved by trying to duplicate the bug upstream, if possible. * If the bug exists upstream, get it fixed upstream and port the fix downstream to Zig. * If the bug only exists in Zig, use the corresponding C code and debug both implementations side by side to figure out what is wrong. -## Integer library routines +Routines with status are given below. Sources were besides +"The Art of Computer Programming" by Donald E. Knuth, "HackersDelight" by Henry S. Warren, +"Bit Twiddling Hacks" collected by Sean Eron Anderson, "Berkeley SoftFloat" by John R. Hauser, +LLVM "compiler-rt" as it was MIT-licensed, "musl libc" and thoughts + work of contributors. -#### Integer Bit operations +The compiler-rt routines have not yet been audited. +See https://github.com/ziglang/zig/issues/1504. -- dev HackersDelight __clzsi2 // count leading zeros -- dev HackersDelight __clzdi2 // count leading zeros -- dev HackersDelight __clzti2 // count leading zeros -- dev HackersDelight __ctzsi2 // count trailing zeros -- dev HackersDelight __ctzdi2 // count trailing zeros -- dev HackersDelight __ctzti2 // count trailing zeros -- dev __ctzsi2 __ffssi2 // find least significant 1 bit -- dev __ctzsi2 __ffsdi2 // find least significant 1 bit -- dev __ctzsi2 __ffsti2 // find least significant 1 bit -- dev BitTwiddlingHacks __paritysi2 // bit parity -- dev BitTwiddlingHacks __paritydi2 // bit parity -- dev BitTwiddlingHacks __parityti2 // bit parity -- dev TAOCP __popcountsi2 // bit population -- dev TAOCP __popcountdi2 // bit population -- dev TAOCP __popcountti2 // bit population -- dev other __bswapsi2 // a byteswapped -- dev other __bswapdi2 // a byteswapped -- dev other __bswapti2 // a byteswapped +From left to right the columns mean 1. if the routine is implemented (✗ or ✓), +2. the name, 3. input (`a`), 4. input (`b`), 5. return value, +6. an explanation of the functionality, .. to repeat the comment from the +column a row above and/or additional return values. +Some routines have more extensive comments supplemented with a reference text. -#### Integer Comparison +Integer and Float Operations -- port llvm __cmpsi2 // a,b: i32, (a 0, (a==b) -> 1, (a>b) -> 2 -- port llvm __cmpdi2 // a,b: i64 -- port llvm __cmpti2 // a,b: i128 -- port llvm __ucmpsi2 // a,b: u32, (a 0, (a==b) -> 1, (a>b) -> 2 -- port llvm __ucmpdi2 // a,b: u64 -- port llvm __ucmpti2 // a,b: u128 +| Done | Name | a | b | Out | Comment | +| ------ | ------------- | ---- | ---- | ---- | ------------------------------ | +| | | | | | **Integer Bit Operations** | +| ✓ | __clzsi2 | u32 | ∅ | i32 | count leading zeroes | +| ✓ | __clzdi2 | u64 | ∅ | i32 | count leading zeroes | +| ✓ | __clzti2 | u128 | ∅ | i32 | count trailing zeros | +| ✓ | __ctzsi2 | u32 | ∅ | i32 | count trailing zeros | +| ✓ | __ctzdi2 | u64 | ∅ | i32 | count trailing zeros | +| ✓ | __ctzti2 | u128 | ∅ | i32 | count leading zeroes | +| ✓ | __ffssi2 | u32 | ∅ | i32 | count leading zeroes | +| ✓ | __ffsdi2 | u64 | ∅ | i32 | count leading zeroes | +| ✓ | __ffsti2 | u128 | ∅ | i32 | count leading zeroes | +| ✓ | __paritysi2 | u32 | ∅ | i32 | find least significant 1 bit | +| ✓ | __paritydi2 | u64 | ∅ | i32 | find least significant 1 bit | +| ✓ | __parityti2 | u128 | ∅ | i32 | find least significant 1 bit | +| ✓ | __popcountsi2 | u32 | ∅ | i32 | bit population | +| ✓ | __popcountdi2 | u64 | ∅ | i32 | bit population | +| ✓ | __popcountti2 | u128 | ∅ | i32 | bit population | +| ✓ | __bswapsi2 | u32 | ∅ | i32 | bit parity | +| ✓ | __bswapdi2 | u64 | ∅ | i32 | bit parity | +| ✓ | __bswapti2 | u128 | ∅ | i32 | bit parity | +| | | | | | **Integer Comparison** | +| ✓ | __cmpsi2 | i32 | i32 | i32 | `(a 0, (a==b) -> 1, (a>b) -> 2` | +| ✓ | __cmpdi2 | i64 | i64 | i32 | .. | +| ✓ | __cmpti2 | i128 | i128 | i32 | .. | +| ✓ | __ucmpsi2 | i32 | i32 | i32 | `(a 0, (a==b) -> 1, (a>b) -> 2` | +| ✓ | __ucmpdi2 | i64 | i64 | i32 | .. | +| ✓ | __ucmpti2 | i128 | i128 | i32 | .. | +| | | | | | **Integer Arithmetic** | +| ✗ | __ashlsi3 | i32 | i32 | i32 | `a << b` [^unused_rl78] | +| ✓ | __ashldi3 | i64 | i32 | i64 | .. | +| ✓ | __ashlti3 | i128 | i32 | i128 | .. | +| ✓ | __aeabi_llsl | i32 | i32 | i32 | .. ARM | +| ✗ | __ashrsi3 | i32 | i32 | i32 | `a >> b` arithmetic (sign fill) [^unused_rl78] | +| ✓ | __ashrdi3 | i64 | i32 | i64 | .. | +| ✓ | __ashrti3 | i128 | i32 | i128 | .. | +| ✓ | __aeabi_lasr | i64 | i32 | i64 | .. ARM | +| ✗ | __lshrsi3 | i32 | i32 | i32 | `a >> b` logical (zero fill) [^unused_rl78] | +| ✓ | __lshrdi3 | i64 | i32 | i64 | .. | +| ✓ | __lshrti3 | i128 | i32 | i128 | .. | +| ✓ | __aeabi_llsr | i64 | i32 | i64 | .. ARM | +| ✓ | __negsi2 | i32 | i32 | i32 | `-a` [^libgcc_compat] | +| ✓ | __negdi2 | i64 | i64 | i64 | .. | +| ✓ | __negti2 | i128 | i128 | i128 | .. | +| ✓ | __mulsi3 | i32 | i32 | i32 | `a * b` | +| ✓ | __muldi3 | i64 | i64 | i64 | .. | +| ✓ | __multi3 | i128 | i128 | i128 | .. | +| ✓ | __divsi3 | i32 | i32 | i32 | `a / b` | +| ✓ | __divdi3 | i64 | i64 | i64 | .. | +| ✓ | __divti3 | i128 | i128 | i128 | .. | +| ✓ | __aeabi_idiv | i32 | i32 | i32 | .. ARM | +| ✓ | __udivsi3 | u32 | u32 | u32 | `a / b` | +| ✓ | __udivdi3 | u64 | u64 | u64 | .. | +| ✓ | __udivti3 | u128 | u128 | u128 | .. | +| ✓ | __aeabi_uidiv | i32 | i32 | i32 | .. ARM | +| ✓ | __modsi3 | i32 | i32 | i32 | `a % b` | +| ✓ | __moddi3 | i64 | i64 | i64 | .. | +| ✓ | __modti3 | i128 | i128 | i128 | .. | +| ✓ | __umodsi3 | u32 | u32 | u32 | `a % b` | +| ✓ | __umoddi3 | u64 | u64 | u64 | .. | +| ✓ | __umodti3 | u128 | u128 | u128 | .. | +| ✓ | __udivmodsi4 | u32 | u32 | u32 | `a / b, rem.* = a % b` | +| ✓ | __udivmoddi4 | u64 | u64 | u64 | .. | +| ✓ | __udivmodti4 | u128 | u128 | u128 | .. | +| ✓ | __divmodsi4 | i32 | i32 | i32 | `a / b, rem.* = a % b` | +| ✓ | __divmoddi4 | i64 | i64 | i64 | .. | +| ✗ | __divmodti4 | i128 | i128 | i128 | .. [^libgcc_compat] | +| | | | | | **Integer Arithmetic with Trapping Overflow**| +| ✓ | __absvsi2 | i32 | i32 | i32 | abs(a) | +| ✓ | __absvdi2 | i64 | i64 | i64 | .. | +| ✓ | __absvti2 | i128 | i128 | i128 | .. | +| ✓ | __negvsi2 | i32 | i32 | i32 | `-a` [^libgcc_compat] | +| ✓ | __negvdi2 | i64 | i64 | i64 | .. | +| ✓ | __negvti2 | i128 | i128 | i128 | .. | +| ✗ | __addvsi3 | i32 | i32 | i32 | `a + b` | +| ✗ | __addvdi3 | i64 | i64 | i64 | .. | +| ✗ | __addvti3 | i128 | i128 | i128 | .. | +| ✗ | __subvsi3 | i32 | i32 | i32 | `a - b` | +| ✗ | __subvdi3 | i64 | i64 | i64 | .. | +| ✗ | __subvti3 | i128 | i128 | i128 | .. | +| ✗ | __mulvsi3 | i32 | i32 | i32 | `a * b` | +| ✗ | __mulvdi3 | i64 | i64 | i64 | .. | +| ✗ | __mulvti3 | i128 | i128 | i128 | .. | +| | | | | | **Integer Arithmetic which Return on Overflow** [^noptr_faster] | +| ✓ | __addosi4 | i32 | i32 | i32 | `a + b`, overflow->ov.*=1 else 0 [^perf_addition] | +| ✓ | __addodi4 | i64 | i64 | i64 | .. | +| ✓ | __addoti4 | i128 | i128 | i128 | .. | +| ✓ | __subosi4 | i32 | i32 | i32 | `a - b`, overflow->ov.*=1 else 0 [^perf_addition] | +| ✓ | __subodi4 | i64 | i64 | i64 | .. | +| ✓ | __suboti4 | i128 | i128 | i128 | .. | +| ✓ | __mulosi4 | i32 | i32 | i32 | `a * b`, overflow->ov.*=1 else 0 | +| ✓ | __mulodi4 | i64 | i64 | i64 | .. | +| ✓ | __muloti4 | i128 | i128 | i128 | .. | +| | | | | | **Float Conversion** | +| ✓ | __extendsfdf2 | f32 | ∅ | f64 | .. | +| ✓ | __extendsftf2 | f32 | ∅ | f128 | .. | +| ✓ | __extendsfxf2 | f32 | ∅ | f80 | .. | +| ✓ | __extenddftf2 | f64 | ∅ | f128 | .. | +| ✓ | __extenddfxf2 | f64 | ∅ | f80 | .. | +| ✓ | __truncsfhf2 | f32 | ∅ | f16 | rounding towards zero | +| ✓ | __truncdfhf2 | f64 | ∅ | f16 | .. | +| ✓ | __truncdfsf2 | f64 | ∅ | f32 | .. | +| ✓ | __trunctfhf2 | f128 | ∅ | f16 | .. | +| ✓ | __trunctfsf2 | f128 | ∅ | f32 | .. | +| ✓ | __trunctfdf2 | f128 | ∅ | f64 | .. | +| ✓ | __trunctfxf2 | f128 | ∅ | f80 | .. | +| ✓ | __truncxfhf2 | f80 | ∅ | f16 | .. | +| ✓ | __truncxfsf2 | f80 | ∅ | f32 | .. | +| ✓ | __truncxfdf2 | f80 | ∅ | f64 | .. | +| ✓ | __aeabi_f2h | f32 | ∅ | f16 | .. ARM | +| ✓ | __gnu_f2h_ieee | f32 | ∅ | f16 | ..GNU naming convention | +| ✓ | __aeabi_d2h | f64 | ∅ | f16 | .. ARM | +| ✓ | __aeabi_d2f | f64 | ∅ | f32 | .. ARM | +| ✓ | __trunckfsf2 | f128 | ∅ | f32 | .. PPC | +| ✓ | _Qp_qtos |*f128 | ∅ | f32 | .. SPARC | +| ✓ | __trunckfdf2 | f128 | ∅ | f64 | .. PPC | +| ✓ | _Qp_qtod |*f128 | ∅ | f64 | .. SPARC | +| ✓ | __fixhfsi | f16 | ∅ | i32 | rounding towards zero | +| ✓ | __fixsfsi | f32 | ∅ | i32 | .. | +| ✓ | __fixdfsi | f64 | ∅ | i32 | .. | +| ✓ | __fixtfsi | f128 | ∅ | i32 | .. | +| ✓ | __fixxfsi | f80 | ∅ | i32 | .. | +| ✓ | __fixhfdi | f16 | ∅ | i64 | .. | +| ✓ | __fixsfdi | f32 | ∅ | i64 | .. | +| ✓ | __fixdfdi | f64 | ∅ | i64 | .. | +| ✓ | __fixtfdi | f128 | ∅ | i64 | .. | +| ✓ | __fixxfdi | f80 | ∅ | i64 | .. | +| ✓ | __fixhfti | f16 | ∅ | i128 | .. | +| ✓ | __fixsfti | f32 | ∅ | i128 | .. | +| ✓ | __fixdfti | f64 | ∅ | i128 | .. | +| ✓ | __fixtfti | f128 | ∅ | i128 | .. | +| ✓ | __fixxfti | f80 | ∅ | i128 | .. | +| ✓ | __fixunshfsi | f16 | ∅ | u32 | rounding towards zero. negative values become 0. | +| ✓ | __fixunssfsi | f32 | ∅ | u32 | .. | +| ✓ | __fixunsdfsi | f64 | ∅ | u32 | .. | +| ✓ | __fixunstfsi | f128 | ∅ | u32 | .. | +| ✓ | __fixunsxfsi | f80 | ∅ | u32 | .. | +| ✓ | __fixunshfdi | f16 | ∅ | u64 | .. | +| ✓ | __fixunssfdi | f32 | ∅ | u64 | .. | +| ✓ | __fixunsdfdi | f64 | ∅ | u64 | .. | +| ✓ | __fixunstfdi | f128 | ∅ | u64 | .. | +| ✓ | __fixunsxfdi | f80 | ∅ | u64 | .. | +| ✓ | __fixunshfti | f16 | ∅ | u128 | .. | +| ✓ | __fixunssfti | f32 | ∅ | u128 | .. | +| ✓ | __fixunsdfti | f64 | ∅ | u128 | .. | +| ✓ | __fixunstfti | f128 | ∅ | u128 | .. | +| ✓ | __fixunsxfti | f80 | ∅ | u128 | .. | +| ✓ | __floatsihf | i32 | ∅ | f16 | int_to_float conversions | +| ✓ | __floatsisf | i32 | ∅ | f32 | .. | +| ✓ | __floatsidf | i32 | ∅ | f64 | .. | +| ✓ | __floatsitf | i32 | ∅ | f128 | .. | +| ✓ | __floatsixf | i32 | ∅ | f80 | .. | +| ✓ | __floatdisf | i64 | ∅ | f32 | .. | +| ✓ | __floatdidf | i64 | ∅ | f64 | .. | +| ✓ | __floatditf | i64 | ∅ | f128 | .. | +| ✓ | __floatdixf | i64 | ∅ | f80 | .. | +| ✓ | __floattihf | i128 | ∅ | f16 | .. | +| ✓ | __floattisf | i128 | ∅ | f32 | .. | +| ✓ | __floattidf | i128 | ∅ | f64 | .. | +| ✓ | __floattitf | i128 | ∅ | f128 | .. | +| ✓ | __floattixf | i128 | ∅ | f80 | .. | +| ✓ | __floatunsihf | u32 | ∅ | f16 | uint_to_float conversions | +| ✓ | __floatunsisf | u32 | ∅ | f32 | .. | +| ✓ | __floatunsidf | u32 | ∅ | f64 | .. | +| ✓ | __floatunsitf | u32 | ∅ | f128 | .. | +| ✓ | __floatunsixf | u32 | ∅ | f80 | .. | +| ✓ | __floatundihf | u64 | ∅ | f16 | .. | +| ✓ | __floatundisf | u64 | ∅ | f32 | .. | +| ✓ | __floatundidf | u64 | ∅ | f64 | .. | +| ✓ | __floatunditf | u64 | ∅ | f128 | .. | +| ✓ | __floatundixf | u64 | ∅ | f80 | .. | +| ✓ | __floatuntihf | u128 | ∅ | f16 | .. | +| ✓ | __floatuntisf | u128 | ∅ | f32 | .. | +| ✓ | __floatuntidf | u128 | ∅ | f64 | .. | +| ✓ | __floatuntitf | u128 | ∅ | f128 | .. | +| ✓ | __floatuntixf | u128 | ∅ | f80 | .. | +| | | | | | **Float Comparison** | +| ✓ | __cmphf2 | f16 | f16 | i32 | `(a-1, (a==b)->0, (a>b)->1, Nan->1` | +| ✓ | __cmpsf2 | f32 | f32 | i32 | exported from __lesf2, __ledf2, __letf2 (below) | +| ✓ | __cmpdf2 | f64 | f64 | i32 | But: if NaN is a possibility, use another routine. | +| ✓ | __cmptf2 | f128 | f128 | i32 | .. | +| ✓ | __cmpxf2 | f80 | f80 | i32 | .. | +| ✓ | _Qp_cmp |*f128 |*f128 | i32 | .. SPARC | +| ✓ | __unordhf2 | f16 | f16 | i32 | `(a==+-NaN or b==+-NaN) -> !=0, else -> 0` | +| ✓ | __unordsf2 | f32 | f32 | i32 | .. | +| ✓ | __unorddf2 | f64 | f64 | i32 | Note: only reliable for (input!=NaN) | +| ✓ | __unordtf2 | f128 | f128 | i32 | .. | +| ✓ | __unordxf2 | f80 | f80 | i32 | .. | +| ✓ | __aeabi_fcmpun | f32 | f32 | i32 | .. ARM | +| ✓ | __aeabi_dcmpun | f32 | f32 | i32 | .. ARM | +| ✓ | __unordkf2 | f128 | f128 | i32 | .. PPC | +| ✓ | __eqhf2 | f16 | f16 | i32 | `(a!=NaN) and (b!=Nan) and (a==b) -> output=0` | +| ✓ | __eqsf2 | f32 | f32 | i32 | .. | +| ✓ | __eqdf2 | f64 | f64 | i32 | .. | +| ✓ | __eqtf2 | f128 | f128 | i32 | .. | +| ✓ | __eqxf2 | f80 | f80 | i32 | .. | +| ✓ | __aeabi_fcmpeq | f32 | f32 | i32 | .. ARM | +| ✓ | __aeabi_dcmpeq | f32 | f32 | i32 | .. ARM | +| ✓ | __eqkf2 | f128 | f128 | i32 | .. PPC | +| ✓ | _Qp_feq |*f128 |*f128 | bool | .. SPARC | +| ✓ | __nehf2 | f16 | f16 | i32 | `(a==NaN) or (b==Nan) or (a!=b) -> output!=0` | +| ✓ | __nesf2 | f32 | f32 | i32 | Note: __eqXf2 and __neXf2 have same return value | +| ✓ | __nedf2 | f64 | f64 | i32 | .. | +| ✓ | __netf2 | f128 | f128 | i32 | .. | +| ✓ | __nexf2 | f80 | f80 | i32 | .. | +| ✓ | __nekf2 | f128 | f128 | i32 | .. PPC | +| ✓ | _Qp_fne |*f128 |*f128 | bool | .. SPARC | +| ✓ | __gehf2 | f16 | f16 | i32 | `(a!=Nan) and (b!=Nan) and (a>=b) -> output>=0` | +| ✓ | __gesf2 | f32 | f32 | i32 | .. | +| ✓ | __gedf2 | f64 | f64 | i32 | .. | +| ✓ | __getf2 | f128 | f128 | i32 | .. | +| ✓ | __gexf2 | f80 | f80 | i32 | .. | +| ✓ | __gekf2 | f128 | f128 | i32 | .. PPC | +| ✓ | _Qp_fge |*f128 |*f128 | bool | .. SPARC | +| ✓ | __lthf2 | f16 | f16 | i32 | `(a!=Nan) and (b!=Nan) and (a output<0` | +| ✓ | __ltsf2 | f32 | f32 | i32 | .. | +| ✓ | __ltdf2 | f64 | f64 | i32 | .. | +| ✓ | __lttf2 | f128 | f128 | i32 | .. | +| ✓ | __ltxf2 | f80 | f80 | i32 | .. | +| ✓ | __ltkf2 | f128 | f128 | i32 | .. PPC | +| ✓ | __aeabi_fcmplt | f32 | f32 | i32 | .. ARM | +| ✓ | __aeabi_dcmplt | f32 | f32 | i32 | .. ARM | +| ✓ | _Qp_flt |*f128 |*f128 | bool | .. SPARC | +| ✓ | __lehf2 | f16 | f16 | i32 | `(a!=Nan) and (b!=Nan) and (a<=b) -> output<=0` | +| ✓ | __lesf2 | f32 | f32 | i32 | .. | +| ✓ | __ledf2 | f64 | f64 | i32 | .. | +| ✓ | __letf2 | f128 | f128 | i32 | .. | +| ✓ | __lexf2 | f80 | f80 | i32 | .. | +| ✓ | __aeabi_fcmple | f32 | f32 | i32 | .. ARM | +| ✓ | __aeabi_dcmple | f32 | f32 | i32 | .. ARM | +| ✓ | __lekf2 | f128 | f128 | i32 | .. PPC | +| ✓ | _Qp_fle |*f128 |*f128 | bool | .. SPARC | +| ✓ | __gthf2 | f16 | f16 | i32 | `(a!=Nan) and (b!=Nan) and (a>b) -> output>0` | +| ✓ | __gtsf2 | f32 | f32 | i32 | .. | +| ✓ | __gtdf2 | f64 | f64 | i32 | .. | +| ✓ | __gttf2 | f128 | f128 | i32 | .. | +| ✓ | __gtxf2 | f80 | f80 | i32 | .. | +| ✓ | __gtkf2 | f128 | f128 | i32 | .. PPC | +| ✓ | _Qp_fgt |*f128 |*f128 | bool | .. SPARC | +| | | | | | **Float Arithmetic** | +| ✓ | __addhf3 | f32 | f32 | f32 | `a + b` | +| ✓ | __addsf3 | f32 | f32 | f32 | .. | +| ✓ | __adddf3 | f64 | f64 | f64 | .. | +| ✓ | __addtf3 | f128 | f128 | f128 | .. | +| ✓ | __addxf3 | f80 | f80 | f80 | .. | +| ✓ | __aeabi_fadd | f32 | f32 | f32 | .. ARM | +| ✓ | __aeabi_dadd | f64 | f64 | f64 | .. ARM | +| ✓ | __addkf3 | f128 | f128 | f128 | .. PPC | +| ✓ | _Qp_add |*f128 |*f128 | void | .. SPARC args *c,*a,*b c=a+b | +| ✓ | __subhf3 | f32 | f32 | f32 | `a - b` | +| ✓ | __subsf3 | f32 | f32 | f32 | .. | +| ✓ | __subdf3 | f64 | f64 | f64 | .. | +| ✓ | __subtf3 | f128 | f128 | f128 | .. | +| ✓ | __subxf3 | f80 | f80 | f80 | .. | +| ✓ | __aeabi_fsub | f32 | f32 | f32 | .. ARM | +| ✓ | __aeabi_dsub | f64 | f64 | f64 | .. ARM | +| ✓ | __subkf3 | f128 | f128 | f128 | .. PPC | +| ✓ | _Qp_sub |*f128 |*f128 | void | .. SPARC args *c,*a,*b c=a-b | +| ✓ | __mulhf3 | f32 | f32 | f32 | `a * b` | +| ✓ | __mulsf3 | f32 | f32 | f32 | .. | +| ✓ | __muldf3 | f64 | f64 | f64 | .. | +| ✓ | __multf3 | f128 | f128 | f128 | .. | +| ✓ | __mulxf3 | f80 | f80 | f80 | .. | +| ✓ | __aeabi_fmul | f32 | f32 | f32 | .. ARM | +| ✓ | __aeabi_dmul | f64 | f64 | f64 | .. ARM | +| ✓ | __mulkf3 | f128 | f128 | f128 | .. PPC | +| ✓ | _Qp_mul |*f128 |*f128 | void | .. SPARC args *c,*a,*b c=a*b | +| ✓ | __divsf3 | f32 | f32 | f32 | `a / b` | +| ✓ | __divdf3 | f64 | f64 | f64 | .. | +| ✓ | __divtf3 | f128 | f128 | f128 | .. | +| ✓ | __divxf3 | f80 | f80 | f80 | .. | +| ✓ | __aeabi_fdiv | f32 | f32 | f32 | .. ARM | +| ✓ | __aeabi_ddiv | f64 | f64 | f64 | .. ARM | +| ✓ | __divkf3 | f128 | f128 | f128 | .. PPC | +| ✓ | _Qp_div |*f128 |*f128 | void | .. SPARC args *c,*a,*b c=a*b | +| ✓ | __negsf2 | f32 | ∅ | f32[^unused_rl78] | -a (can be lowered directly to a xor) | +| ✓ | __negdf2 | f64 | ∅ | f64 | .. | +| ✓ | __negtf2 | f128 | ∅ | f128 | .. | +| ✓ | __negxf2 | f80 | ∅ | f80 | .. | +| | | | | | **Floating point raised to integer power** | +| ✗ | __powihf2 | f16 | f16 | f16 | `a ^ b` | +| ✗ | __powisf2 | f32 | f32 | f32 | .. | +| ✗ | __powidf2 | f64 | f64 | f64 | .. | +| ✗ | __powitf2 | f128 | f128 | f128 | .. | +| ✗ | __powixf2 | f80 | f80 | f80 | .. | +| ✓ | __mulhc3 | all4 | f16 | f16 | `(a+ib) * (c+id)` | +| ✓ | __mulsc3 | all4 | f32 | f32 | .. | +| ✓ | __muldc3 | all4 | f64 | f64 | .. | +| ✓ | __multc3 | all4 | f128 | f128 | .. | +| ✓ | __mulxc3 | all4 | f80 | f80 | .. | +| ✓ | __divhc3 | all4 | f16 | f16 | `(a+ib) / (c+id)` | +| ✓ | __divsc3 | all4 | f32 | f32 | .. | +| ✓ | __divdc3 | all4 | f64 | f64 | .. | +| ✓ | __divtc3 | all4 | f128 | f128 | .. | +| ✓ | __divxc3 | all4 | f80 | f80 | .. | -#### Integer Arithmetic +[^unused_rl78]: Unused in LLVM, but used for example by rl78. +[^libgcc_compat]: Unused in backends and for symbol-level compatibility with libgcc. +[^noptr_faster]: Operations without pointer and without C struct semantics lead to better optimizations. +[^perf_addition]: Has better performance than standard method due to 2s complement semantics. +Not provided by LLVM and libgcc. -- none none __ashlsi3 // a,b: i32, a << b unused in llvm, TODO (e.g. used by rl78) -- port llvm __ashldi3 // a,b: u64 -- port llvm __ashlti3 // a,b: u128 -- none none __ashrsi3 // a,b: i32, a >> b arithmetic (sign fill) TODO (e.g. used by rl78) -- port llvm __ashrdi3 // .. -- port llvm __ashrti3 // -- none none __lshrsi3 // a,b: i32, a >> b logical (zero fill) TODO (e.g. used by rl78) -- port llvm __lshrdi3 // -- port llvm __lshrti3 // -- port llvm __negdi2 // a: i32, -a, symbol-level compatibility with libgcc -- port llvm __negti2 // unnecessary: unused in backends -- port llvm __mulsi3 // a,b: i32, a * b -- port llvm __muldi3 // -- port llvm __multi3 // -- port llvm __divsi3 // a,b: i32, a / b -- port llvm __divdi3 // -- port llvm __divti3 // -- port llvm __udivsi3 // a,b: u32, a / b -- port llvm __udivdi3 // -- port llvm __udivti3 // -- port llvm __modsi3 // a,b: i32, a % b -- port llvm __moddi3 // -- port llvm __modti3 // -- port llvm __umodsi3 // a,b: u32, a % b -- port llvm __umoddi3 // -- port llvm __umodti3 // -- port llvm __udivmoddi4 // a,b: u32, a / b, rem.* = a % b unsigned -- port llvm __udivmodti4 // -- port llvm __udivmodsi4 // -- port llvm __divmodsi4 // a,b: i32, a / b, rem.* = a % b signed, ARM -- port llvm __divmoddi4 // - -#### Integer Arithmetic with trapping overflow - -- dev BitTwiddlingHacks __absvsi2 // abs(a) -- dev BitTwiddlingHacks __absvdi2 // abs(a) -- dev BitTwiddlingHacks __absvti2 // abs(a) -- port llvm __negvsi2 // -a symbol-level compatibility: libgcc -- port llvm __negvdi2 // -a unnecessary: unused in backends -- port llvm __negvti2 // -a -- TODO upstreaming __addvsi3..__mulvti3 after testing panics works -- dev HackersDelight __addvsi3 // a + b -- dev HackersDelight __addvdi3 // -- dev HackersDelight __addvti3 // -- dev HackersDelight __subvsi3 // a - b -- dev HackersDelight __subvdi3 // -- dev HackersDelight __subvti3 // -- dev HackersDelight __mulvsi3 // a * b -- dev HackersDelight __mulvdi3 // -- dev HackersDelight __mulvti3 // - -#### Integer Arithmetic which returns if overflow (would be faster without pointer) - -- dev HackersDelight __addosi4 // a + b, overflow->ov.*=1 else 0 -- dev HackersDelight __addodi4 // (completeness + performance, llvm does not use them) -- dev HackersDelight __addoti4 // -- dev HackersDelight __subosi4 // a - b, overflow->ov.*=1 else 0 -- dev HackersDelight __subodi4 // (completeness + performance, llvm does not use them) -- dev HackersDelight __suboti4 // -- dev HackersDelight __mulosi4 // a * b, overflow->ov.*=1 else 0 -- dev HackersDelight __mulodi4 // (required by llvm) -- dev HackersDelight __muloti4 // - -## Float library routines - -TODO: review source of implementation - -#### Float Conversion - -- dev other __extendsfdf2 // a: f32 -> f64, TODO: missing tests -- dev other __extendsftf2 // a: f32 -> f128 -- dev llvm __extendsfxf2 // a: f32 -> f80, TODO: missing tests -- dev other __extenddftf2 // a: f64 -> f128 -- dev llvm __extenddfxf2 // a: f64 -> f80 -- dev other __truncdfsf2 // a: f64 -> f32, rounding towards zero -- dev other __trunctfdf2 // a: f128-> f64 -- dev other __trunctfsf2 // a: f128-> f32 -- dev llvm __truncxfsf2 // a: f80 -> f32, TODO: missing tests -- dev llvm __truncxfdf2 // a: f80 -> f64, TODO: missing tests - -- dev unclear __fixsfsi // a: f32 -> i32, rounding towards zero -- dev unclear __fixdfsi // a: f64 -> i32 -- dev unclear __fixtfsi // a: f128-> i32 -- dev unclear __fixxfsi // a: f80 -> i32, TODO: missing tests -- dev unclear __fixsfdi // a: f32 -> i64, rounding towards zero -- dev unclear __fixdfdi // .. -- dev unclear __fixtfdi // -- dev unclear __fixxfdi // TODO: missing tests -- dev unclear __fixsfti // a: f32 -> i128, rounding towards zero -- dev unclear __fixdfti // .. -- dev unclear __fixtfdi // -- dev unclear __fixxfti // TODO: missing tests - -- dev unclear __fixunssfsi // a: f32 -> u32, rounding towards zero. negative values become 0. -- dev unclear __fixunsdfsi // .. -- dev unclear __fixunstfsi // -- dev unclear __fixunsxfsi // TODO: missing tests -- dev unclear __fixunssfdi // a: f32 -> u64, rounding towards zero. negative values become 0. -- dev unclear __fixunsdfdi // -- dev unclear __fixunstfdi // -- dev unclear __fixunsxfdi // TODO: missing tests -- dev unclear __fixunssfti // a: f32 -> u128, rounding towards zero. negative values become 0. -- dev unclear __fixunsdfti // -- dev unclear __fixunstfdi // -- dev unclear __fixunsxfti // TODO: some more tests needed for base coverage - -- dev unclear __floatsisf // a: i32 -> f32 -- dev unclear __floatsidf // a: i32 -> f64, TODO: missing tests -- dev unclear __floatsitf // .. -- dev unclear __floatsixf // TODO: missing tests -- dev unclear __floatdisf // a: i64 -> f32 -- dev unclear __floatdidf // -- dev unclear __floatditf // -- dev unclear __floatdixf // TODO: missing tests -- dev unclear __floattisf // a: i128-> f32 -- dev unclear __floattidf // -- dev unclear __floattitf // -- dev unclear __floattixf // TODO: missing tests - -- dev unclear __floatunsisf // a: u32 -> f32 -- dev unclear __floatunsidf // TODO: missing tests -- dev unclear __floatunsitf // -- dev unclear __floatunsixf // TODO: missing tests -- dev unclear __floatundisf // a: u64 -> f32 -- dev unclear __floatundidf // -- dev unclear __floatunditf // -- dev unclear __floatundixf // TODO: missing tests -- dev unclear __floatuntisf // a: u128-> f32 -- dev unclear __floatuntidf // -- dev unclear __floatuntitf // -- dev unclear __floatuntixf // TODO: missing tests - -#### Float Comparison - -- dev other __cmpsf2 // a,b:f32, (a-1,(a==b)->0,(a>b)->1,Nan->1 -- dev other __cmpdf2 // exported from __lesf2, __ledf2, __letf2 (below) -- dev other __cmptf2 // But: if NaN is a possibility, use another routine. -- dev other __unordsf2 // a,b:f32, (a==+-NaN or b==+-NaN) -> !=0, else -> 0 -- dev other __unorddf2 // __only reliable for (input!=NaN)__ -- dev other __unordtf2 // TODO: missing tests -- dev other __eqsf2 // (a!=NaN) and (b!=Nan) and (a==b) -> output=0 -- dev other __eqdf2 // -- dev other __eqtf2 // -- dev other __nesf2 // (a==NaN) or (b==Nan) or (a!=b) -> output!=0 -- dev other __nedf2 // -- dev other __netf2 // __eqtf2 and __netf2 have same return value -> tested with __eqsf2 -- dev other __gesf2 // (a!=Nan) and (b!=Nan) and (a>=b) -> output>=0 -- dev other __gedf2 // -- dev other __getf2 // TODO: missing tests -- dev other __ltsf2 // (a!=Nan) and (b!=Nan) and (a output<0 -- dev other __ltdf2 // -- dev other __lttf2 // TODO: missing tests -- dev other __lesf2 // (a!=Nan) and (b!=Nan) and (a<=b) -> output<=0 -- dev other __ledf2 // -- dev other __letf2 // TODO: missing tests -- dev other __gtsf2 // (a!=Nan) and (b!=Nan) and (a>b) -> output>0 -- dev other __gtdf2 // -- dev other __gttf2 // TODO: missing tests - -#### Float Arithmetic - -- dev unclear __addsf3 // a + b f32, TODO: missing tests -- dev unclear __adddf3 // a + b f64, TODO: missing tests -- dev unclear __addtf3 // a + b f128 -- dev unclear __addxf3 // a + b f80 -- dev unclear __aeabi_fadd // a + b f64 ARM: AAPCS -- dev unclear __aeabi_dadd // a + b f64 ARM: AAPCS -- dev unclear __subsf3 // a - b, TODO: missing tests -- dev unclear __subdf3 // a - b, TODO: missing tests -- dev unclear __subtf3 // a - b -- dev unclear __subxf3 // a - b f80, TODO: missing tests -- dev unclear __aeabi_fsub // a - b f64 ARM: AAPCS -- dev unclear __aeabi_dsub // a - b f64 ARM: AAPCS -- dev unclear __mulsf3 // a * b, TODO: missing tests -- dev unclear __muldf3 // a * b, TODO: missing tests -- dev unclear __multf3 // a * b -- dev unclear __mulxf3 // a * b -- dev unclear __divsf3 // a / b, TODO: review tests -- dev unclear __divdf3 // a / b, TODO: review tests -- dev unclear __divtf3 // a / b -- dev unclear __divxf3 // a / b -- dev unclear __negsf2 // -a symbol-level compatibility: libgcc uses this for the rl78 -- dev unclear __negdf2 // -a unnecessary: can be lowered directly to a xor -- dev unclear __negtf2 // -a, TODO: missing tests -- dev unclear __negxf2 // -a, TODO: missing tests - -#### Floating point raised to integer power -- dev unclear __powisf2 // a ^ b, TODO -- dev unclear __powidf2 // -- dev unclear __powitf2 // -- dev unclear __powixf2 // -- dev unclear __mulsc3 // (a+ib) * (c+id) -- dev unclear __muldc3 // -- dev unclear __multc3 // -- dev unclear __mulxc3 // -- dev unclear __divsc3 // (a+ib) * / (c+id) -- dev unclear __divdc3 // -- dev unclear __divtc3 // -- dev unclear __divxc3 // - -## Decimal float library routines +Decimal float library routines BID means Binary Integer Decimal encoding, DPD means Densely Packed Decimal encoding. BID should be only chosen for binary data, DPD for decimal data (ASCII, Unicode etc). -If possible, use BCD instead of DPD to represent numbers not accurately representable -in binary like the number 0.2. +For example the number 0.2 is not accurately representable in binary data. -All routines are TODO. +| Done | Name | a | b | Out | Comment | +| ------ | ------------- | --------- | --------- | --------- | ---------------------------- | +| | | | | | **Decimal Float Conversion** | +| ✗ | __dpd_extendsddd2 | dec32 | ∅ | dec64 | conversion | +| ✗ | __bid_extendsddd2 | dec32 | ∅ | dec64 | .. | +| ✗ | __dpd_extendsdtd2 | dec32 | ∅ | dec128| .. | +| ✗ | __bid_extendsdtd2 | dec32 | ∅ | dec128| .. | +| ✗ | __dpd_extendddtd2 | dec64 | ∅ | dec128| .. | +| ✗ | __bid_extendddtd2 | dec64 | ∅ | dec128| .. | +| ✗ | __dpd_truncddsd2 | dec64 | ∅ | dec32 | .. | +| ✗ | __bid_truncddsd2 | dec64 | ∅ | dec32 | .. | +| ✗ | __dpd_trunctdsd2 | dec128 | ∅ | dec32 | .. | +| ✗ | __bid_trunctdsd2 | dec128 | ∅ | dec32 | .. | +| ✗ | __dpd_trunctddd2 | dec128 | ∅ | dec64 | .. | +| ✗ | __bid_trunctddd2 | dec128 | ∅ | dec64 | .. | +| ✗ | __dpd_extendsfdd | float | ∅ | dec64 | .. | +| ✗ | __bid_extendsfdd | float | ∅ | dec64 | .. | +| ✗ | __dpd_extendsftd | float | ∅ | dec128| .. | +| ✗ | __bid_extendsftd | float | ∅ | dec128| .. | +| ✗ | __dpd_extenddftd | double | ∅ | dec128| .. | +| ✗ | __bid_extenddftd | double | ∅ | dec128| .. | +| ✗ | __dpd_extendxftd |long double | ∅ | dec128| .. | +| ✗ | __bid_extendxftd |long double | ∅ | dec128| .. | +| ✗ | __dpd_truncdfsd | double | ∅ | dec32 | .. | +| ✗ | __bid_truncdfsd | double | ∅ | dec32 | .. | +| ✗ | __dpd_truncxfsd |long double | ∅ | dec32 | .. | +| ✗ | __bid_truncxfsd |long double | ∅ | dec32 | .. | +| ✗ | __dpd_trunctfsd |long double | ∅ | dec32 | .. | +| ✗ | __bid_trunctfsd |long double | ∅ | dec32 | .. | +| ✗ | __dpd_truncxfdd |long double | ∅ | dec64 | .. | +| ✗ | __bid_truncxfdd |long double | ∅ | dec64 | .. | +| ✗ | __dpd_trunctfdd |long double | ∅ | dec64 | .. | +| ✗ | __bid_trunctfdd |long double | ∅ | dec64 | .. | +| ✗ | __dpd_truncddsf | dec64 | ∅ | float | .. | +| ✗ | __bid_truncddsf | dec64 | ∅ | float | .. | +| ✗ | __dpd_trunctdsf | dec128 | ∅ | float | .. | +| ✗ | __bid_trunctdsf | dec128 | ∅ | float | .. | +| ✗ | __dpd_extendsddf | dec32 | ∅ | double| .. | +| ✗ | __bid_extendsddf | dec32 | ∅ | double| .. | +| ✗ | __dpd_trunctddf | dec128 | ∅ | double| .. | +| ✗ | __bid_trunctddf | dec128 | ∅ | double| .. | +| ✗ | __dpd_extendsdxf | dec32 | ∅ |long double| .. | +| ✗ | __bid_extendsdxf | dec32 | ∅ |long double| .. | +| ✗ | __dpd_extendddxf | dec64 | ∅ |long double| .. | +| ✗ | __bid_extendddxf | dec64 | ∅ |long double| .. | +| ✗ | __dpd_trunctdxf | dec128 | ∅ |long double| .. | +| ✗ | __bid_trunctdxf | dec128 | ∅ |long double| .. | +| ✗ | __dpd_extendsdtf | dec32 | ∅ |long double| .. | +| ✗ | __bid_extendsdtf | dec32 | ∅ |long double| .. | +| ✗ | __dpd_extendddtf | dec64 | ∅ |long double| .. | +| ✗ | __bid_extendddtf | dec64 | ∅ |long double| .. | +| ✗ | __dpd_extendsfsd | float | ∅ | dec32 | same size conversions | +| ✗ | __bid_extendsfsd | float | ∅ | dec32 | .. | +| ✗ | __dpd_extenddfdd | double | ∅ | dec64 | .. | +| ✗ | __bid_extenddfdd | double | ∅ | dec64 | .. | +| ✗ | __dpd_extendtftd |long double | ∅ | dec128| .. | +| ✗ | __bid_extendtftd |long double | ∅ | dec128| .. | +| ✗ | __dpd_truncsdsf | dec32 | ∅ | float | .. | +| ✗ | __bid_truncsdsf | dec32 | ∅ | float | .. | +| ✗ | __dpd_truncdddf | dec64 | ∅ | float | conversion | +| ✗ | __bid_truncdddf | dec64 | ∅ | float | .. | +| ✗ | __dpd_trunctdtf | dec128 | ∅ |long double| .. | +| ✗ | __bid_trunctdtf | dec128 | ∅ |long double| .. | +| ✗ | __dpd_fixsdsi | dec32 | ∅ | int | .. | +| ✗ | __bid_fixsdsi | dec32 | ∅ | int | .. | +| ✗ | __dpd_fixddsi | dec64 | ∅ | int | .. | +| ✗ | __bid_fixddsi | dec64 | ∅ | int | .. | +| ✗ | __dpd_fixtdsi | dec128 | ∅ | int | .. | +| ✗ | __bid_fixtdsi | dec128 | ∅ | int | .. | +| ✗ | __dpd_fixsddi | dec32 | ∅ | long | .. | +| ✗ | __bid_fixsddi | dec32 | ∅ | long | .. | +| ✗ | __dpd_fixdddi | dec64 | ∅ | long | .. | +| ✗ | __bid_fixdddi | dec64 | ∅ | long | .. | +| ✗ | __dpd_fixtddi | dec128 | ∅ | long | .. | +| ✗ | __bid_fixtddi | dec128 | ∅ | long | .. | +| ✗ | __dpd_fixunssdsi | dec32 | ∅ |unsigned int | .. All negative values become zero. | +| ✗ | __bid_fixunssdsi | dec32 | ∅ |unsigned int | .. | +| ✗ | __dpd_fixunsddsi | dec64 | ∅ |unsigned int | .. | +| ✗ | __bid_fixunsddsi | dec64 | ∅ |unsigned int | .. | +| ✗ | __dpd_fixunstdsi | dec128 | ∅ |unsigned int | .. | +| ✗ | __bid_fixunstdsi | dec128 | ∅ |unsigned int | .. | +| ✗ | __dpd_fixunssddi | dec32 | ∅ |unsigned long| .. | +| ✗ | __bid_fixunssddi | dec32 | ∅ |unsigned long| .. | +| ✗ | __dpd_fixunsdddi | dec64 | ∅ |unsigned long| .. | +| ✗ | __bid_fixunsdddi | dec64 | ∅ |unsigned long| .. | +| ✗ | __dpd_fixunstddi | dec128 | ∅ |unsigned long| .. | +| ✗ | __bid_fixunstddi | dec128 | ∅ |unsigned long| .. | +| ✗ | __dpd_floatsisd | int | ∅ | dec32 | .. | +| ✗ | __bid_floatsisd | int | ∅ | dec32 | .. | +| ✗ | __dpd_floatsidd | int | ∅ | dec64 | .. | +| ✗ | __bid_floatsidd | int | ∅ | dec64 | .. | +| ✗ | __dpd_floatsitd | int | ∅ | dec128 | .. | +| ✗ | __bid_floatsitd | int | ∅ | dec128 | .. | +| ✗ | __dpd_floatdisd | long | ∅ | dec32 | .. | +| ✗ | __bid_floatdisd | long | ∅ | dec32 | .. | +| ✗ | __dpd_floatdidd | long | ∅ | dec64 | .. | +| ✗ | __bid_floatdidd | long | ∅ | dec64 | .. | +| ✗ | __dpd_floatditd | long | ∅ | dec128 | .. | +| ✗ | __bid_floatditd | long | ∅ | dec128 | .. | +| ✗ | __dpd_floatunssisd | unsigned int| ∅ | dec32 | .. | +| ✗ | __bid_floatunssisd | unsigned int| ∅ | dec32 | .. | +| ✗ | __dpd_floatunssidd | unsigned int| ∅ | dec64 | .. | +| ✗ | __bid_floatunssidd | unsigned int| ∅ | dec64 | .. | +| ✗ | __dpd_floatunssitd | unsigned int| ∅ | dec128 | .. | +| ✗ | __bid_floatunssitd | unsigned int| ∅ | dec128 | .. | +| ✗ | __dpd_floatunsdisd |unsigned long| ∅ | dec32 | .. | +| ✗ | __bid_floatunsdisd |unsigned long| ∅ | dec32 | .. | +| ✗ | __dpd_floatunsdidd |unsigned long| ∅ | dec64 | .. | +| ✗ | __bid_floatunsdidd |unsigned long| ∅ | dec64 | .. | +| ✗ | __dpd_floatunsditd |unsigned long| ∅ | dec128 | .. | +| ✗ | __bid_floatunsditd |unsigned long| ∅ | dec128 | .. | +| | | | | | **Decimal Float Comparison** | +| ✗ | __dpd_unordsd2 | dec32 | dec32 | c_int | `a +-NaN or a +-NaN -> 1(nonzero), else -> 0` | +| ✗ | __bid_unordsd2 | dec32 | dec32 | c_int | .. | +| ✗ | __dpd_unorddd2 | dec64 | dec64 | c_int | .. | +| ✗ | __bid_unorddd2 | dec64 | dec64 | c_int | .. | +| ✗ | __dpd_unordtd2 | dec128 | dec128 | c_int | .. | +| ✗ | __bid_unordtd2 | dec128 | dec128 | c_int | .. | +| ✗ | __dpd_eqsd2 | dec32 | dec32 | c_int |`a!=+-NaN and b!=+-Nan and a==b -> 0, else -> 1(nonzero)`| +| ✗ | __bid_eqsd2 | dec32 | dec32 | c_int | .. | +| ✗ | __dpd_eqdd2 | dec64 | dec64 | c_int | .. | +| ✗ | __bid_eqdd2 | dec64 | dec64 | c_int | .. | +| ✗ | __dpd_eqtd2 | dec128 | dec128 | c_int | .. | +| ✗ | __bid_eqtd2 | dec128 | dec128 | c_int | .. | +| ✗ | __dpd_nesd2 | dec32 | dec32 | c_int | `a==+-NaN or b==+-NaN or a!=b -> 1(nonzero), else -> 0` | +| ✗ | __bid_nesd2 | dec32 | dec32 | c_int | .. | +| ✗ | __dpd_nedd2 | dec64 | dec64 | c_int | .. | +| ✗ | __bid_nedd2 | dec64 | dec64 | c_int | .. | +| ✗ | __dpd_netd2 | dec128 | dec128 | c_int | .. | +| ✗ | __bid_netd2 | dec128 | dec128 | c_int | .. | +| ✗ | __dpd_gesd2 | dec32 | dec32 | c_int | `a!=+-NaN and b!=+-NaN and a>=b -> >=0, else -> <0` | +| ✗ | __bid_gesd2 | dec32 | dec32 | c_int | .. | +| ✗ | __dpd_gedd2 | dec64 | dec64 | c_int | .. | +| ✗ | __bid_gedd2 | dec64 | dec64 | c_int | .. | +| ✗ | __dpd_getd2 | dec128 | dec128 | c_int | .. | +| ✗ | __bid_getd2 | dec128 | dec128 | c_int | .. | +| ✗ | __dpd_ltsd2 | dec32 | dec32 | c_int | `a!=+-NaN and b!=+-NaN and a <0, else -> >=0` | +| ✗ | __bid_ltsd2 | dec32 | dec32 | c_int | .. | +| ✗ | __dpd_ltdd2 | dec64 | dec64 | c_int | .. | +| ✗ | __bid_ltdd2 | dec64 | dec64 | c_int | .. | +| ✗ | __dpd_lttd2 | dec128 | dec128 | c_int | .. | +| ✗ | __bid_lttd2 | dec128 | dec128 | c_int | .. | +| ✗ | __dpd_lesd2 | dec32 | dec32 | c_int | `a!=+-NaN and b!=+-NaN and a<=b -> <=0, else -> >=0` | +| ✗ | __bid_lesd2 | dec32 | dec32 | c_int | .. | +| ✗ | __dpd_ledd2 | dec64 | dec64 | c_int | .. | +| ✗ | __bid_ledd2 | dec64 | dec64 | c_int | .. | +| ✗ | __dpd_letd2 | dec128 | dec128 | c_int | .. | +| ✗ | __bid_letd2 | dec128 | dec128 | c_int | .. | +| ✗ | __dpd_gtsd2 | dec32 | dec32 | c_int | `a!=+-NaN and b!=+-NaN and a>b -> >0, else -> <=0` | +| ✗ | __bid_gtsd2 | dec32 | dec32 | c_int | .. | +| ✗ | __dpd_gtdd2 | dec64 | dec64 | c_int | .. | +| ✗ | __bid_gtdd2 | dec64 | dec64 | c_int | .. | +| ✗ | __dpd_gttd2 | dec128 | dec128 | c_int | .. | +| ✗ | __bid_gttd2 | dec128 | dec128 | c_int | .. | +| | | | | | **Decimal Float Arithmetic**[^options] | +| ✗ | __dpd_addsd3 | dec32 | dec32 | dec32 |`a + b`| +| ✗ | __bid_addsd3 | dec32 | dec32 | dec32 | .. | +| ✗ | __dpd_adddd3 | dec64 | dec64 | dec64 | .. | +| ✗ | __bid_adddd3 | dec64 | dec64 | dec64 | .. | +| ✗ | __dpd_addtd3 | dec128 | dec128 | dec128 | .. | +| ✗ | __bid_addtd3 | dec128 | dec128 | dec128 | .. | +| ✗ | __dpd_subsd3 | dec32 | dec32 | dec32 |`a - b`| +| ✗ | __bid_subsd3 | dec32 | dec32 | dec32 | .. | +| ✗ | __dpd_subdd3 | dec64 | dec64 | dec64 | .. | +| ✗ | __bid_subdd3 | dec64 | dec64 | dec64 | .. | +| ✗ | __dpd_subtd3 | dec128 | dec128 | dec128 | .. | +| ✗ | __bid_subtd3 | dec128 | dec128 | dec128 | .. | +| ✗ | __dpd_mulsd3 | dec32 | dec32 | dec32 |`a * b`| +| ✗ | __bid_mulsd3 | dec32 | dec32 | dec32 | .. | +| ✗ | __dpd_muldd3 | dec64 | dec64 | dec64 | .. | +| ✗ | __bid_muldd3 | dec64 | dec64 | dec64 | .. | +| ✗ | __dpd_multd3 | dec128 | dec128 | dec128 | .. | +| ✗ | __bid_multd3 | dec128 | dec128 | dec128 | .. | +| ✗ | __dpd_divsd3 | dec32 | dec32 | dec32 |`a / b`| +| ✗ | __bid_divsd3 | dec32 | dec32 | dec32 | .. | +| ✗ | __dpd_divdd3 | dec64 | dec64 | dec64 | .. | +| ✗ | __bid_divdd3 | dec64 | dec64 | dec64 | .. | +| ✗ | __dpd_divtd3 | dec128 | dec128 | dec128 | .. | +| ✗ | __bid_divtd3 | dec128 | dec128 | dec128 | .. | +| ✗ | __dpd_negsd2 | dec32 | dec32 | dec32 | `-a` | +| ✗ | __bid_negsd2 | dec32 | dec32 | dec32 | .. | +| ✗ | __dpd_negdd2 | dec64 | dec64 | dec64 | .. | +| ✗ | __bid_negdd2 | dec64 | dec64 | dec64 | .. | +| ✗ | __dpd_negtd2 | dec128 | dec128 | dec128 | .. | +| ✗ | __bid_negtd2 | dec128 | dec128 | dec128 | .. | -#### Decimal float Conversion +[^options]: These numbers include options with routines for +-0 and +-Nan. -- __dpd_extendsddd2 // dec32->dec64 -- __bid_extendsddd2 // dec32->dec64 -- __dpd_extendsdtd2 // dec32->dec128 -- __bid_extendsdtd2 // dec32->dec128 -- __dpd_extendddtd2 // dec64->dec128 -- __bid_extendddtd2 // dec64->dec128 -- __dpd_truncddsd2 // dec64->dec32 -- __bid_truncddsd2 // dec64->dec32 -- __dpd_trunctdsd2 // dec128->dec32 -- __bid_trunctdsd2 // dec128->dec32 -- __dpd_trunctddd2 // dec128->dec64 -- __bid_trunctddd2 // dec128->dec64 +Fixed-point fractional library routines -- __dpd_extendsfdd // float->dec64 -- __bid_extendsfdd // float->dec64 -- __dpd_extendsftd // float->dec128 -- __bid_extendsftd // float->dec128 -- __dpd_extenddftd // double->dec128 -- __bid_extenddftd // double->dec128 -- __dpd_extendxftd // long double->dec128 -- __bid_extendxftd // long double->dec128 -- __dpd_truncdfsd // double->dec32 -- __bid_truncdfsd // double->dec32 -- __dpd_truncxfsd // long double->dec32 -- __bid_truncxfsd // long double->dec32 -- __dpd_trunctfsd // long double->dec32 -- __bid_trunctfsd // long double->dec32 -- __dpd_truncxfdd // long double->dec64 -- __bid_truncxfdd // long double->dec64 -- __dpd_trunctfdd // long double->dec64 -- __bid_trunctfdd // long double->dec64 +TODO brief explanation + implementation -- __dpd_truncddsf // dec64->float -- __bid_truncddsf // dec64->float -- __dpd_trunctdsf // dec128->float -- __bid_trunctdsf // dec128->float -- __dpd_extendsddf // dec32->double -- __bid_extendsddf // dec32->double -- __dpd_trunctddf // dec128->double -- __bid_trunctddf // dec128->double -- __dpd_extendsdxf // dec32->long double -- __bid_extendsdxf // dec32->long double -- __dpd_extendddxf // dec64->long double -- __bid_extendddxf // dec64->long double -- __dpd_trunctdxf // dec128->long double -- __bid_trunctdxf // dec128->long double -- __dpd_extendsdtf // dec32->long double -- __bid_extendsdtf // dec32->long double -- __dpd_extendddtf // dec64->long double -- __bid_extendddtf // dec64->long double +| Done | Name | a | b | Out | Comment | +| ------ | ------------- | --------- | --------- | --------- | -------------------------- | +| | | | | | **Fixed-Point Fractional** | -Same size conversion: -- __dpd_extendsfsd // float->dec32 -- __bid_extendsfsd // float->dec32 -- __dpd_extenddfdd // double->dec64 -- __bid_extenddfdd // double->dec64 -- __dpd_extendtftd //long double->dec128 -- __bid_extendtftd //long double->dec128 -- __dpd_truncsdsf // dec32->float -- __bid_truncsdsf // dec32->float -- __dpd_truncdddf // dec64->float -- __bid_truncdddf // dec64->float -- __dpd_trunctdtf // dec128->long double -- __bid_trunctdtf // dec128->long double +Further content: +- aarch64 outline atomics +- atomics +- msvc things like _alldiv, _aulldiv, _allrem +- clear cache +- tls emulation +- math routines (cos, sin, tan, ceil, floor, exp, exp2, fabs, log, log10, log2, sincos, sqrt) +- bcmp +- ieee float routines (fma, fmax, fmin, fmod, fabs, float rounding, ) +- arm routines (memory routines + memclr [setting to 0], divmod routines and stubs for unwind_cpp) +- memory routines (memcmp, memcpy, memset, memmove) +- objective-c __isPlatformVersionAtLeast check +- stack probe routines -- __dpd_fixsdsi // dec32->int -- __bid_fixsdsi // dec32->int -- __dpd_fixddsi // dec64->int -- __bid_fixddsi // dec64->int -- __dpd_fixtdsi // dec128->int -- __bid_fixtdsi // dec128->int +Future work -- __dpd_fixsddi // dec32->long -- __bid_fixsddi // dec32->long -- __dpd_fixdddi // dec64->long -- __bid_fixdddi // dec64->long -- __dpd_fixtddi // dec128->long -- __bid_fixtddi // dec128->long - -- __dpd_fixunssdsi // dec32->unsigned int, All negative values become zero. -- __bid_fixunssdsi // dec32->unsigned int -- __dpd_fixunsddsi // dec64->unsigned int -- __bid_fixunsddsi // dec64->unsigned int -- __dpd_fixunstdsi // dec128->unsigned int -- __bid_fixunstdsi // dec128->unsigned int - -- __dpd_fixunssddi // dec32->unsigned long, All negative values become zero. -- __bid_fixunssddi // dec32->unsigned long -- __dpd_fixunsdddi // dec64->unsigned long -- __bid_fixunsdddi // dec64->unsigned long -- __dpd_fixunstddi // dec128->unsigned long -- __bid_fixunstddi // dec128->unsigned long - -- __dpd_floatsisd // int->dec32 -- __bid_floatsisd // int->dec32 -- __dpd_floatsidd // int->dec64 -- __bid_floatsidd // int->dec64 -- __dpd_floatsitd // int->dec128 -- __bid_floatsitd // int->dec128 - -- __dpd_floatdisd // long->dec32 -- __bid_floatdisd // long->dec32 -- __dpd_floatdidd // long->dec64 -- __bid_floatdidd // long->dec64 -- __dpd_floatditd // long->dec128 -- __bid_floatditd // long->dec128 - -- __dpd_floatunssisd // unsigned int->dec32 -- __bid_floatunssisd // unsigned int->dec32 -- __dpd_floatunssidd // unsigned int->dec64 -- __bid_floatunssidd // unsigned int->dec64 -- __dpd_floatunssitd // unsigned int->dec128 -- __bid_floatunssitd // unsigned int->dec128 - -- __dpd_floatunsdisd // unsigned long->dec32 -- __bid_floatunsdisd // unsigned long->dec32 -- __dpd_floatunsdidd // unsigned long->dec64 -- __bid_floatunsdidd // unsigned long->dec64 -- __dpd_floatunsditd // unsigned long->dec128 -- __bid_floatunsditd // unsigned long->dec128 - -#### Decimal float Comparison - -All decimal float comparison routines return c_int. - -- __dpd_unordsd2 // a,b: dec32, a +-NaN or a +-NaN -> 1(nonzero), else -> 0 -- __bid_unordsd2 // a,b: dec32 -- __dpd_unorddd2 // a,b: dec64 -- __bid_unorddd2 // a,b: dec64 -- __dpd_unordtd2 // a,b: dec128 -- __bid_unordtd2 // a,b: dec128 - -- __dpd_eqsd2 // a,b: dec32, a!=+-NaN and b!=+-Nan and a==b -> 0, else -> 1(nonzero) -- __bid_eqsd2 // a,b: dec32 -- __dpd_eqdd2 // a,b: dec64 -- __bid_eqdd2 // a,b: dec64 -- __dpd_eqtd2 // a,b: dec128 -- __bid_eqtd2 // a,b: dec128 - -- __dpd_nesd2 // a,b: dec32, a==+-NaN or b==+-NaN or a!=b -> 1(nonzero), else -> 0 -- __bid_nesd2 // a,b: dec32 -- __dpd_nedd2 // a,b: dec64 -- __bid_nedd2 // a,b: dec64 -- __dpd_netd2 // a,b: dec128 -- __bid_netd2 // a,b: dec128 - -- __dpd_gesd2 // a,b: dec32, a!=+-NaN and b!=+-NaN and a>=b -> >=0, else -> <0 -- __bid_gesd2 // a,b: dec32 -- __dpd_gedd2 // a,b: dec64 -- __bid_gedd2 // a,b: dec64 -- __dpd_getd2 // a,b: dec128 -- __bid_getd2 // a,b: dec128 - -- __dpd_ltsd2 // a,b: dec32, a!=+-NaN and b!=+-NaN and a <0, else -> >=0 -- __bid_ltsd2 // a,b: dec32 -- __dpd_ltdd2 // a,b: dec64 -- __bid_ltdd2 // a,b: dec64 -- __dpd_lttd2 // a,b: dec128 -- __bid_lttd2 // a,b: dec128 - -- __dpd_lesd2 // a,b: dec32, a!=+-NaN and b!=+-NaN and a<=b -> <=0, else -> >=0 -- __bid_lesd2 // a,b: dec32 -- __dpd_ledd2 // a,b: dec64 -- __bid_ledd2 // a,b: dec64 -- __dpd_letd2 // a,b: dec128 -- __bid_letd2 // a,b: dec128 - -- __dpd_gtsd2 // a,b: dec32, a!=+-NaN and b!=+-NaN and a>b -> >0, else -> <=0 -- __bid_gtsd2 // a,b: dec32 -- __dpd_gtdd2 // a,b: dec64 -- __bid_gtdd2 // a,b: dec64 -- __dpd_gttd2 // a,b: dec128 -- __bid_gttd2 // a,b: dec128 - -#### Decimal float Arithmetic - -These numbers include options with routines for +-0 and +-Nan. - -- __dpd_addsd3 // a,b: dec32 -> dec32, a + b -- __bid_addsd3 // a,b: dec32 -> dec32 -- __dpd_adddd3 // a,b: dec64 -> dec64 -- __bid_adddd3 // a,b: dec64 -> dec64 -- __dpd_addtd3 // a,b: dec128-> dec128 -- __bid_addtd3 // a,b: dec128-> dec128 -- __dpd_subsd3 // a,b: dec32, a - b -- __bid_subsd3 // a,b: dec32 -> dec32 -- __dpd_subdd3 // a,b: dec64 .. -- __bid_subdd3 // a,b: dec64 -- __dpd_subtd3 // a,b: dec128 -- __bid_subtd3 // a,b: dec128 -- __dpd_mulsd3 // a,b: dec32, a * b -- __bid_mulsd3 // a,b: dec32 -> dec32 -- __dpd_muldd3 // a,b: dec64 .. -- __bid_muldd3 // a,b: dec64 -- __dpd_multd3 // a,b: dec128 -- __bid_multd3 // a,b: dec128 -- __dpd_divsd3 // a,b: dec32, a / b -- __bid_divsd3 // a,b: dec32 -> dec32 -- __dpd_divdd3 // a,b: dec64 .. -- __bid_divdd3 // a,b: dec64 -- __dpd_divtd3 // a,b: dec128 -- __bid_divtd3 // a,b: dec128 -- __dpd_negsd2 // a,b: dec32, -a -- __bid_negsd2 // a,b: dec32 -> dec32 -- __dpd_negdd2 // a,b: dec64 .. -- __bid_negdd2 // a,b: dec64 -- __dpd_negtd2 // a,b: dec128 -- __bid_negtd2 // a,b: dec128 - -## Fixed-point fractional library routines - -TODO - -Too unclear for work items: -- Miscellaneous routines => unclear, if supported (cache control and stack functions) -- Zig-specific language runtime features, for example "Arbitrary length integer library routines" +Arbitrary length integer library routines From 873bb29c984b976021fb9ca95ad3298e03a8b3ff Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Thu, 2 Feb 2023 17:32:06 -0700 Subject: [PATCH 80/84] introduce ZON: Zig Object Notation * std.zig.parse is moved to std.zig.Ast.parse * the new function has an additional parameter that requires passing Mode.zig or Mode.zon * moved parser.zig code to Parse.zig * added parseZon function next to parseRoot function --- CMakeLists.txt | 2 +- lib/std/Build/OptionsStep.zig | 2 +- lib/std/zig.zig | 1 - lib/std/zig/Ast.zig | 78 +- lib/std/zig/Parse.zig | 3816 ++++++++++++++++++++++++++++++++ lib/std/zig/parse.zig | 3852 --------------------------------- lib/std/zig/parser_test.zig | 4 +- lib/std/zig/perf_test.zig | 3 +- src/Module.zig | 6 +- src/main.zig | 10 +- 10 files changed, 3898 insertions(+), 3876 deletions(-) create mode 100644 lib/std/zig/Parse.zig delete mode 100644 lib/std/zig/parse.zig diff --git a/CMakeLists.txt b/CMakeLists.txt index 8a9de7bdc1..f8029fdcde 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -513,7 +513,7 @@ set(ZIG_STAGE2_SOURCES "${CMAKE_SOURCE_DIR}/lib/std/zig/Ast.zig" "${CMAKE_SOURCE_DIR}/lib/std/zig/CrossTarget.zig" "${CMAKE_SOURCE_DIR}/lib/std/zig/c_builtins.zig" - "${CMAKE_SOURCE_DIR}/lib/std/zig/parse.zig" + "${CMAKE_SOURCE_DIR}/lib/std/zig/Parse.zig" "${CMAKE_SOURCE_DIR}/lib/std/zig/render.zig" "${CMAKE_SOURCE_DIR}/lib/std/zig/string_literal.zig" "${CMAKE_SOURCE_DIR}/lib/std/zig/system.zig" diff --git a/lib/std/Build/OptionsStep.zig b/lib/std/Build/OptionsStep.zig index a353737512..c1d2c8454a 100644 --- a/lib/std/Build/OptionsStep.zig +++ b/lib/std/Build/OptionsStep.zig @@ -367,5 +367,5 @@ test "OptionsStep" { \\ , options.contents.items); - _ = try std.zig.parse(arena.allocator(), try options.contents.toOwnedSliceSentinel(0)); + _ = try std.zig.Ast.parse(arena.allocator(), try options.contents.toOwnedSliceSentinel(0), .zig); } diff --git a/lib/std/zig.zig b/lib/std/zig.zig index bce8f6ce3c..f85cf75e60 100644 --- a/lib/std/zig.zig +++ b/lib/std/zig.zig @@ -8,7 +8,6 @@ pub const Tokenizer = tokenizer.Tokenizer; pub const fmtId = fmt.fmtId; pub const fmtEscapes = fmt.fmtEscapes; pub const isValidId = fmt.isValidId; -pub const parse = @import("zig/parse.zig").parse; pub const string_literal = @import("zig/string_literal.zig"); pub const number_literal = @import("zig/number_literal.zig"); pub const primitives = @import("zig/primitives.zig"); diff --git a/lib/std/zig/Ast.zig b/lib/std/zig/Ast.zig index f312093aa3..a9a02606eb 100644 --- a/lib/std/zig/Ast.zig +++ b/lib/std/zig/Ast.zig @@ -11,13 +11,6 @@ extra_data: []Node.Index, errors: []const Error, -const std = @import("../std.zig"); -const assert = std.debug.assert; -const testing = std.testing; -const mem = std.mem; -const Token = std.zig.Token; -const Ast = @This(); - pub const TokenIndex = u32; pub const ByteOffset = u32; @@ -34,7 +27,7 @@ pub const Location = struct { line_end: usize, }; -pub fn deinit(tree: *Ast, gpa: mem.Allocator) void { +pub fn deinit(tree: *Ast, gpa: Allocator) void { tree.tokens.deinit(gpa); tree.nodes.deinit(gpa); gpa.free(tree.extra_data); @@ -48,11 +41,69 @@ pub const RenderError = error{ OutOfMemory, }; +pub const Mode = enum { zig, zon }; + +/// Result should be freed with tree.deinit() when there are +/// no more references to any of the tokens or nodes. +pub fn parse(gpa: Allocator, source: [:0]const u8, mode: Mode) Allocator.Error!Ast { + var tokens = Ast.TokenList{}; + defer tokens.deinit(gpa); + + // Empirically, the zig std lib has an 8:1 ratio of source bytes to token count. + const estimated_token_count = source.len / 8; + try tokens.ensureTotalCapacity(gpa, estimated_token_count); + + var tokenizer = std.zig.Tokenizer.init(source); + while (true) { + const token = tokenizer.next(); + try tokens.append(gpa, .{ + .tag = token.tag, + .start = @intCast(u32, token.loc.start), + }); + if (token.tag == .eof) break; + } + + var parser: Parse = .{ + .source = source, + .gpa = gpa, + .token_tags = tokens.items(.tag), + .token_starts = tokens.items(.start), + .errors = .{}, + .nodes = .{}, + .extra_data = .{}, + .scratch = .{}, + .tok_i = 0, + }; + defer parser.errors.deinit(gpa); + defer parser.nodes.deinit(gpa); + defer parser.extra_data.deinit(gpa); + defer parser.scratch.deinit(gpa); + + // Empirically, Zig source code has a 2:1 ratio of tokens to AST nodes. + // Make sure at least 1 so we can use appendAssumeCapacity on the root node below. + const estimated_node_count = (tokens.len + 2) / 2; + try parser.nodes.ensureTotalCapacity(gpa, estimated_node_count); + + switch (mode) { + .zig => try parser.parseRoot(), + .zon => try parser.parseZon(), + } + + // TODO experiment with compacting the MultiArrayList slices here + return Ast{ + .source = source, + .tokens = tokens.toOwnedSlice(), + .nodes = parser.nodes.toOwnedSlice(), + .extra_data = try parser.extra_data.toOwnedSlice(gpa), + .errors = try parser.errors.toOwnedSlice(gpa), + }; +} + /// `gpa` is used for allocating the resulting formatted source code, as well as /// for allocating extra stack memory if needed, because this function utilizes recursion. /// Note: that's not actually true yet, see https://github.com/ziglang/zig/issues/1006. /// Caller owns the returned slice of bytes, allocated with `gpa`. -pub fn render(tree: Ast, gpa: mem.Allocator) RenderError![]u8 { +pub fn render(tree: Ast, gpa: Allocator) RenderError![]u8 { var buffer = std.ArrayList(u8).init(gpa); defer buffer.deinit(); @@ -3347,3 +3398,12 @@ pub const Node = struct { rparen: TokenIndex, }; }; + +const std = @import("../std.zig"); +const assert = std.debug.assert; +const testing = std.testing; +const mem = std.mem; +const Token = std.zig.Token; +const Ast = @This(); +const Allocator = std.mem.Allocator; +const Parse = @import("Parse.zig"); diff --git a/lib/std/zig/Parse.zig b/lib/std/zig/Parse.zig new file mode 100644 index 0000000000..f599a08f55 --- /dev/null +++ b/lib/std/zig/Parse.zig @@ -0,0 +1,3816 @@ +//! Represents in-progress parsing, will be converted to an Ast after completion. + +pub const Error = error{ParseError} || Allocator.Error; + +gpa: Allocator, +source: []const u8, +token_tags: []const Token.Tag, +token_starts: []const Ast.ByteOffset, +tok_i: TokenIndex, +errors: std.ArrayListUnmanaged(AstError), +nodes: Ast.NodeList, +extra_data: std.ArrayListUnmanaged(Node.Index), +scratch: std.ArrayListUnmanaged(Node.Index), + +const SmallSpan = union(enum) { + zero_or_one: Node.Index, + multi: Node.SubRange, +}; + +const Members = struct { + len: usize, + lhs: Node.Index, + rhs: Node.Index, + trailing: bool, + + fn toSpan(self: Members, p: *Parse) !Node.SubRange { + if (self.len <= 2) { + const nodes = [2]Node.Index{ self.lhs, self.rhs }; + return p.listToSpan(nodes[0..self.len]); + } else { + return Node.SubRange{ .start = self.lhs, .end = self.rhs }; + } + } +}; + +fn listToSpan(p: *Parse, list: []const Node.Index) !Node.SubRange { + try p.extra_data.appendSlice(p.gpa, list); + return Node.SubRange{ + .start = @intCast(Node.Index, p.extra_data.items.len - list.len), + .end = @intCast(Node.Index, p.extra_data.items.len), + }; +} + +fn addNode(p: *Parse, elem: Ast.NodeList.Elem) Allocator.Error!Node.Index { + const result = @intCast(Node.Index, p.nodes.len); + try p.nodes.append(p.gpa, elem); + return result; +} + +fn setNode(p: *Parse, i: usize, elem: Ast.NodeList.Elem) Node.Index { + p.nodes.set(i, elem); + return @intCast(Node.Index, i); +} + +fn reserveNode(p: *Parse, tag: Ast.Node.Tag) !usize { + try p.nodes.resize(p.gpa, p.nodes.len + 1); + p.nodes.items(.tag)[p.nodes.len - 1] = tag; + return p.nodes.len - 1; +} + +fn unreserveNode(p: *Parse, node_index: usize) void { + if (p.nodes.len == node_index) { + p.nodes.resize(p.gpa, p.nodes.len - 1) catch unreachable; + } else { + // There is zombie node left in the tree, let's make it as inoffensive as possible + // (sadly there's no no-op node) + p.nodes.items(.tag)[node_index] = .unreachable_literal; + p.nodes.items(.main_token)[node_index] = p.tok_i; + } +} + +fn addExtra(p: *Parse, extra: anytype) Allocator.Error!Node.Index { + const fields = std.meta.fields(@TypeOf(extra)); + try p.extra_data.ensureUnusedCapacity(p.gpa, fields.len); + const result = @intCast(u32, p.extra_data.items.len); + inline for (fields) |field| { + comptime assert(field.type == Node.Index); + p.extra_data.appendAssumeCapacity(@field(extra, field.name)); + } + return result; +} + +fn warnExpected(p: *Parse, expected_token: Token.Tag) error{OutOfMemory}!void { + @setCold(true); + try p.warnMsg(.{ + .tag = .expected_token, + .token = p.tok_i, + .extra = .{ .expected_tag = expected_token }, + }); +} + +fn warn(p: *Parse, error_tag: AstError.Tag) error{OutOfMemory}!void { + @setCold(true); + try p.warnMsg(.{ .tag = error_tag, .token = p.tok_i }); +} + +fn warnMsg(p: *Parse, msg: Ast.Error) error{OutOfMemory}!void { + @setCold(true); + switch (msg.tag) { + .expected_semi_after_decl, + .expected_semi_after_stmt, + .expected_comma_after_field, + .expected_comma_after_arg, + .expected_comma_after_param, + .expected_comma_after_initializer, + .expected_comma_after_switch_prong, + .expected_semi_or_else, + .expected_semi_or_lbrace, + .expected_token, + .expected_block, + .expected_block_or_assignment, + .expected_block_or_expr, + .expected_block_or_field, + .expected_expr, + .expected_expr_or_assignment, + .expected_fn, + .expected_inlinable, + .expected_labelable, + .expected_param_list, + .expected_prefix_expr, + .expected_primary_type_expr, + .expected_pub_item, + .expected_return_type, + .expected_suffix_op, + .expected_type_expr, + .expected_var_decl, + .expected_var_decl_or_fn, + .expected_loop_payload, + .expected_container, + => if (msg.token != 0 and !p.tokensOnSameLine(msg.token - 1, msg.token)) { + var copy = msg; + copy.token_is_prev = true; + copy.token -= 1; + return p.errors.append(p.gpa, copy); + }, + else => {}, + } + try p.errors.append(p.gpa, msg); +} + +fn fail(p: *Parse, tag: Ast.Error.Tag) error{ ParseError, OutOfMemory } { + @setCold(true); + return p.failMsg(.{ .tag = tag, .token = p.tok_i }); +} + +fn failExpected(p: *Parse, expected_token: Token.Tag) error{ ParseError, OutOfMemory } { + @setCold(true); + return p.failMsg(.{ + .tag = .expected_token, + .token = p.tok_i, + .extra = .{ .expected_tag = expected_token }, + }); +} + +fn failMsg(p: *Parse, msg: Ast.Error) error{ ParseError, OutOfMemory } { + @setCold(true); + try p.warnMsg(msg); + return error.ParseError; +} + +/// Root <- skip container_doc_comment? ContainerMembers eof +pub fn parseRoot(p: *Parse) !void { + // Root node must be index 0. + p.nodes.appendAssumeCapacity(.{ + .tag = .root, + .main_token = 0, + .data = undefined, + }); + const root_members = try p.parseContainerMembers(); + const root_decls = try root_members.toSpan(p); + if (p.token_tags[p.tok_i] != .eof) { + try p.warnExpected(.eof); + } + p.nodes.items(.data)[0] = .{ + .lhs = root_decls.start, + .rhs = root_decls.end, + }; +} + +/// Parse in ZON mode. Subset of the language. +/// TODO: set a flag in Parse struct, and honor that flag +/// by emitting compilation errors when non-zon nodes are encountered. +pub fn parseZon(p: *Parse) !void { + const node_index = p.parseExpr() catch |err| switch (err) { + error.ParseError => { + assert(p.errors.items.len > 0); + return; + }, + else => |e| return e, + }; + assert(node_index == 0); + if (p.token_tags[p.tok_i] != .eof) { + try p.warnExpected(.eof); + } +} + +/// ContainerMembers <- ContainerDeclarations (ContainerField COMMA)* (ContainerField / ContainerDeclarations) +/// +/// ContainerDeclarations +/// <- TestDecl ContainerDeclarations +/// / ComptimeDecl ContainerDeclarations +/// / doc_comment? KEYWORD_pub? Decl ContainerDeclarations +/// / +/// +/// ComptimeDecl <- KEYWORD_comptime Block +fn parseContainerMembers(p: *Parse) !Members { + const scratch_top = p.scratch.items.len; + defer p.scratch.shrinkRetainingCapacity(scratch_top); + + var field_state: union(enum) { + /// No fields have been seen. + none, + /// Currently parsing fields. + seen, + /// Saw fields and then a declaration after them. + /// Payload is first token of previous declaration. + end: Node.Index, + /// There was a declaration between fields, don't report more errors. + err, + } = .none; + + var last_field: TokenIndex = undefined; + + // Skip container doc comments. + while (p.eatToken(.container_doc_comment)) |_| {} + + var trailing = false; + while (true) { + const doc_comment = try p.eatDocComments(); + + switch (p.token_tags[p.tok_i]) { + .keyword_test => { + if (doc_comment) |some| { + try p.warnMsg(.{ .tag = .test_doc_comment, .token = some }); + } + const test_decl_node = try p.expectTestDeclRecoverable(); + if (test_decl_node != 0) { + if (field_state == .seen) { + field_state = .{ .end = test_decl_node }; + } + try p.scratch.append(p.gpa, test_decl_node); + } + trailing = false; + }, + .keyword_comptime => switch (p.token_tags[p.tok_i + 1]) { + .l_brace => { + if (doc_comment) |some| { + try p.warnMsg(.{ .tag = .comptime_doc_comment, .token = some }); + } + const comptime_token = p.nextToken(); + const block = p.parseBlock() catch |err| switch (err) { + error.OutOfMemory => return error.OutOfMemory, + error.ParseError => blk: { + p.findNextContainerMember(); + break :blk null_node; + }, + }; + if (block != 0) { + const comptime_node = try p.addNode(.{ + .tag = .@"comptime", + .main_token = comptime_token, + .data = .{ + .lhs = block, + .rhs = undefined, + }, + }); + if (field_state == .seen) { + field_state = .{ .end = comptime_node }; + } + try p.scratch.append(p.gpa, comptime_node); + } + trailing = false; + }, + else => { + const identifier = p.tok_i; + defer last_field = identifier; + const container_field = p.expectContainerField() catch |err| switch (err) { + error.OutOfMemory => return error.OutOfMemory, + error.ParseError => { + p.findNextContainerMember(); + continue; + }, + }; + switch (field_state) { + .none => field_state = .seen, + .err, .seen => {}, + .end => |node| { + try p.warnMsg(.{ + .tag = .decl_between_fields, + .token = p.nodes.items(.main_token)[node], + }); + try p.warnMsg(.{ + .tag = .previous_field, + .is_note = true, + .token = last_field, + }); + try p.warnMsg(.{ + .tag = .next_field, + .is_note = true, + .token = identifier, + }); + // Continue parsing; error will be reported later. + field_state = .err; + }, + } + try p.scratch.append(p.gpa, container_field); + switch (p.token_tags[p.tok_i]) { + .comma => { + p.tok_i += 1; + trailing = true; + continue; + }, + .r_brace, .eof => { + trailing = false; + break; + }, + else => {}, + } + // There is not allowed to be a decl after a field with no comma. + // Report error but recover parser. + try p.warn(.expected_comma_after_field); + p.findNextContainerMember(); + }, + }, + .keyword_pub => { + p.tok_i += 1; + const top_level_decl = try p.expectTopLevelDeclRecoverable(); + if (top_level_decl != 0) { + if (field_state == .seen) { + field_state = .{ .end = top_level_decl }; + } + try p.scratch.append(p.gpa, top_level_decl); + } + trailing = p.token_tags[p.tok_i - 1] == .semicolon; + }, + .keyword_usingnamespace => { + const node = try p.expectUsingNamespaceRecoverable(); + if (node != 0) { + if (field_state == .seen) { + field_state = .{ .end = node }; + } + try p.scratch.append(p.gpa, node); + } + trailing = p.token_tags[p.tok_i - 1] == .semicolon; + }, + .keyword_const, + .keyword_var, + .keyword_threadlocal, + .keyword_export, + .keyword_extern, + .keyword_inline, + .keyword_noinline, + .keyword_fn, + => { + const top_level_decl = try p.expectTopLevelDeclRecoverable(); + if (top_level_decl != 0) { + if (field_state == .seen) { + field_state = .{ .end = top_level_decl }; + } + try p.scratch.append(p.gpa, top_level_decl); + } + trailing = p.token_tags[p.tok_i - 1] == .semicolon; + }, + .eof, .r_brace => { + if (doc_comment) |tok| { + try p.warnMsg(.{ + .tag = .unattached_doc_comment, + .token = tok, + }); + } + break; + }, + else => { + const c_container = p.parseCStyleContainer() catch |err| switch (err) { + error.OutOfMemory => return error.OutOfMemory, + error.ParseError => false, + }; + if (c_container) continue; + + const identifier = p.tok_i; + defer last_field = identifier; + const container_field = p.expectContainerField() catch |err| switch (err) { + error.OutOfMemory => return error.OutOfMemory, + error.ParseError => { + p.findNextContainerMember(); + continue; + }, + }; + switch (field_state) { + .none => field_state = .seen, + .err, .seen => {}, + .end => |node| { + try p.warnMsg(.{ + .tag = .decl_between_fields, + .token = p.nodes.items(.main_token)[node], + }); + try p.warnMsg(.{ + .tag = .previous_field, + .is_note = true, + .token = last_field, + }); + try p.warnMsg(.{ + .tag = .next_field, + .is_note = true, + .token = identifier, + }); + // Continue parsing; error will be reported later. + field_state = .err; + }, + } + try p.scratch.append(p.gpa, container_field); + switch (p.token_tags[p.tok_i]) { + .comma => { + p.tok_i += 1; + trailing = true; + continue; + }, + .r_brace, .eof => { + trailing = false; + break; + }, + else => {}, + } + // There is not allowed to be a decl after a field with no comma. + // Report error but recover parser. + try p.warn(.expected_comma_after_field); + if (p.token_tags[p.tok_i] == .semicolon and p.token_tags[identifier] == .identifier) { + try p.warnMsg(.{ + .tag = .var_const_decl, + .is_note = true, + .token = identifier, + }); + } + p.findNextContainerMember(); + continue; + }, + } + } + + const items = p.scratch.items[scratch_top..]; + switch (items.len) { + 0 => return Members{ + .len = 0, + .lhs = 0, + .rhs = 0, + .trailing = trailing, + }, + 1 => return Members{ + .len = 1, + .lhs = items[0], + .rhs = 0, + .trailing = trailing, + }, + 2 => return Members{ + .len = 2, + .lhs = items[0], + .rhs = items[1], + .trailing = trailing, + }, + else => { + const span = try p.listToSpan(items); + return Members{ + .len = items.len, + .lhs = span.start, + .rhs = span.end, + .trailing = trailing, + }; + }, + } +} + +/// Attempts to find next container member by searching for certain tokens +fn findNextContainerMember(p: *Parse) void { + var level: u32 = 0; + while (true) { + const tok = p.nextToken(); + switch (p.token_tags[tok]) { + // Any of these can start a new top level declaration. + .keyword_test, + .keyword_comptime, + .keyword_pub, + .keyword_export, + .keyword_extern, + .keyword_inline, + .keyword_noinline, + .keyword_usingnamespace, + .keyword_threadlocal, + .keyword_const, + .keyword_var, + .keyword_fn, + => { + if (level == 0) { + p.tok_i -= 1; + return; + } + }, + .identifier => { + if (p.token_tags[tok + 1] == .comma and level == 0) { + p.tok_i -= 1; + return; + } + }, + .comma, .semicolon => { + // this decl was likely meant to end here + if (level == 0) { + return; + } + }, + .l_paren, .l_bracket, .l_brace => level += 1, + .r_paren, .r_bracket => { + if (level != 0) level -= 1; + }, + .r_brace => { + if (level == 0) { + // end of container, exit + p.tok_i -= 1; + return; + } + level -= 1; + }, + .eof => { + p.tok_i -= 1; + return; + }, + else => {}, + } + } +} + +/// Attempts to find the next statement by searching for a semicolon +fn findNextStmt(p: *Parse) void { + var level: u32 = 0; + while (true) { + const tok = p.nextToken(); + switch (p.token_tags[tok]) { + .l_brace => level += 1, + .r_brace => { + if (level == 0) { + p.tok_i -= 1; + return; + } + level -= 1; + }, + .semicolon => { + if (level == 0) { + return; + } + }, + .eof => { + p.tok_i -= 1; + return; + }, + else => {}, + } + } +} + +/// TestDecl <- KEYWORD_test (STRINGLITERALSINGLE / IDENTIFIER)? Block +fn expectTestDecl(p: *Parse) !Node.Index { + const test_token = p.assertToken(.keyword_test); + const name_token = switch (p.token_tags[p.nextToken()]) { + .string_literal, .identifier => p.tok_i - 1, + else => blk: { + p.tok_i -= 1; + break :blk null; + }, + }; + const block_node = try p.parseBlock(); + if (block_node == 0) return p.fail(.expected_block); + return p.addNode(.{ + .tag = .test_decl, + .main_token = test_token, + .data = .{ + .lhs = name_token orelse 0, + .rhs = block_node, + }, + }); +} + +fn expectTestDeclRecoverable(p: *Parse) error{OutOfMemory}!Node.Index { + return p.expectTestDecl() catch |err| switch (err) { + error.OutOfMemory => return error.OutOfMemory, + error.ParseError => { + p.findNextContainerMember(); + return null_node; + }, + }; +} + +/// Decl +/// <- (KEYWORD_export / KEYWORD_extern STRINGLITERALSINGLE? / (KEYWORD_inline / KEYWORD_noinline))? FnProto (SEMICOLON / Block) +/// / (KEYWORD_export / KEYWORD_extern STRINGLITERALSINGLE?)? KEYWORD_threadlocal? VarDecl +/// / KEYWORD_usingnamespace Expr SEMICOLON +fn expectTopLevelDecl(p: *Parse) !Node.Index { + const extern_export_inline_token = p.nextToken(); + var is_extern: bool = false; + var expect_fn: bool = false; + var expect_var_or_fn: bool = false; + switch (p.token_tags[extern_export_inline_token]) { + .keyword_extern => { + _ = p.eatToken(.string_literal); + is_extern = true; + expect_var_or_fn = true; + }, + .keyword_export => expect_var_or_fn = true, + .keyword_inline, .keyword_noinline => expect_fn = true, + else => p.tok_i -= 1, + } + const fn_proto = try p.parseFnProto(); + if (fn_proto != 0) { + switch (p.token_tags[p.tok_i]) { + .semicolon => { + p.tok_i += 1; + return fn_proto; + }, + .l_brace => { + if (is_extern) { + try p.warnMsg(.{ .tag = .extern_fn_body, .token = extern_export_inline_token }); + return null_node; + } + const fn_decl_index = try p.reserveNode(.fn_decl); + errdefer p.unreserveNode(fn_decl_index); + + const body_block = try p.parseBlock(); + assert(body_block != 0); + return p.setNode(fn_decl_index, .{ + .tag = .fn_decl, + .main_token = p.nodes.items(.main_token)[fn_proto], + .data = .{ + .lhs = fn_proto, + .rhs = body_block, + }, + }); + }, + else => { + // Since parseBlock only return error.ParseError on + // a missing '}' we can assume this function was + // supposed to end here. + try p.warn(.expected_semi_or_lbrace); + return null_node; + }, + } + } + if (expect_fn) { + try p.warn(.expected_fn); + return error.ParseError; + } + + const thread_local_token = p.eatToken(.keyword_threadlocal); + const var_decl = try p.parseVarDecl(); + if (var_decl != 0) { + try p.expectSemicolon(.expected_semi_after_decl, false); + return var_decl; + } + if (thread_local_token != null) { + return p.fail(.expected_var_decl); + } + if (expect_var_or_fn) { + return p.fail(.expected_var_decl_or_fn); + } + if (p.token_tags[p.tok_i] != .keyword_usingnamespace) { + return p.fail(.expected_pub_item); + } + return p.expectUsingNamespace(); +} + +fn expectTopLevelDeclRecoverable(p: *Parse) error{OutOfMemory}!Node.Index { + return p.expectTopLevelDecl() catch |err| switch (err) { + error.OutOfMemory => return error.OutOfMemory, + error.ParseError => { + p.findNextContainerMember(); + return null_node; + }, + }; +} + +fn expectUsingNamespace(p: *Parse) !Node.Index { + const usingnamespace_token = p.assertToken(.keyword_usingnamespace); + const expr = try p.expectExpr(); + try p.expectSemicolon(.expected_semi_after_decl, false); + return p.addNode(.{ + .tag = .@"usingnamespace", + .main_token = usingnamespace_token, + .data = .{ + .lhs = expr, + .rhs = undefined, + }, + }); +} + +fn expectUsingNamespaceRecoverable(p: *Parse) error{OutOfMemory}!Node.Index { + return p.expectUsingNamespace() catch |err| switch (err) { + error.OutOfMemory => return error.OutOfMemory, + error.ParseError => { + p.findNextContainerMember(); + return null_node; + }, + }; +} + +/// FnProto <- KEYWORD_fn IDENTIFIER? LPAREN ParamDeclList RPAREN ByteAlign? AddrSpace? LinkSection? CallConv? EXCLAMATIONMARK? TypeExpr +fn parseFnProto(p: *Parse) !Node.Index { + const fn_token = p.eatToken(.keyword_fn) orelse return null_node; + + // We want the fn proto node to be before its children in the array. + const fn_proto_index = try p.reserveNode(.fn_proto); + errdefer p.unreserveNode(fn_proto_index); + + _ = p.eatToken(.identifier); + const params = try p.parseParamDeclList(); + const align_expr = try p.parseByteAlign(); + const addrspace_expr = try p.parseAddrSpace(); + const section_expr = try p.parseLinkSection(); + const callconv_expr = try p.parseCallconv(); + _ = p.eatToken(.bang); + + const return_type_expr = try p.parseTypeExpr(); + if (return_type_expr == 0) { + // most likely the user forgot to specify the return type. + // Mark return type as invalid and try to continue. + try p.warn(.expected_return_type); + } + + if (align_expr == 0 and section_expr == 0 and callconv_expr == 0 and addrspace_expr == 0) { + switch (params) { + .zero_or_one => |param| return p.setNode(fn_proto_index, .{ + .tag = .fn_proto_simple, + .main_token = fn_token, + .data = .{ + .lhs = param, + .rhs = return_type_expr, + }, + }), + .multi => |span| { + return p.setNode(fn_proto_index, .{ + .tag = .fn_proto_multi, + .main_token = fn_token, + .data = .{ + .lhs = try p.addExtra(Node.SubRange{ + .start = span.start, + .end = span.end, + }), + .rhs = return_type_expr, + }, + }); + }, + } + } + switch (params) { + .zero_or_one => |param| return p.setNode(fn_proto_index, .{ + .tag = .fn_proto_one, + .main_token = fn_token, + .data = .{ + .lhs = try p.addExtra(Node.FnProtoOne{ + .param = param, + .align_expr = align_expr, + .addrspace_expr = addrspace_expr, + .section_expr = section_expr, + .callconv_expr = callconv_expr, + }), + .rhs = return_type_expr, + }, + }), + .multi => |span| { + return p.setNode(fn_proto_index, .{ + .tag = .fn_proto, + .main_token = fn_token, + .data = .{ + .lhs = try p.addExtra(Node.FnProto{ + .params_start = span.start, + .params_end = span.end, + .align_expr = align_expr, + .addrspace_expr = addrspace_expr, + .section_expr = section_expr, + .callconv_expr = callconv_expr, + }), + .rhs = return_type_expr, + }, + }); + }, + } +} + +/// VarDecl <- (KEYWORD_const / KEYWORD_var) IDENTIFIER (COLON TypeExpr)? ByteAlign? AddrSpace? LinkSection? (EQUAL Expr)? SEMICOLON +fn parseVarDecl(p: *Parse) !Node.Index { + const mut_token = p.eatToken(.keyword_const) orelse + p.eatToken(.keyword_var) orelse + return null_node; + + _ = try p.expectToken(.identifier); + const type_node: Node.Index = if (p.eatToken(.colon) == null) 0 else try p.expectTypeExpr(); + const align_node = try p.parseByteAlign(); + const addrspace_node = try p.parseAddrSpace(); + const section_node = try p.parseLinkSection(); + const init_node: Node.Index = switch (p.token_tags[p.tok_i]) { + .equal_equal => blk: { + try p.warn(.wrong_equal_var_decl); + p.tok_i += 1; + break :blk try p.expectExpr(); + }, + .equal => blk: { + p.tok_i += 1; + break :blk try p.expectExpr(); + }, + else => 0, + }; + if (section_node == 0 and addrspace_node == 0) { + if (align_node == 0) { + return p.addNode(.{ + .tag = .simple_var_decl, + .main_token = mut_token, + .data = .{ + .lhs = type_node, + .rhs = init_node, + }, + }); + } else if (type_node == 0) { + return p.addNode(.{ + .tag = .aligned_var_decl, + .main_token = mut_token, + .data = .{ + .lhs = align_node, + .rhs = init_node, + }, + }); + } else { + return p.addNode(.{ + .tag = .local_var_decl, + .main_token = mut_token, + .data = .{ + .lhs = try p.addExtra(Node.LocalVarDecl{ + .type_node = type_node, + .align_node = align_node, + }), + .rhs = init_node, + }, + }); + } + } else { + return p.addNode(.{ + .tag = .global_var_decl, + .main_token = mut_token, + .data = .{ + .lhs = try p.addExtra(Node.GlobalVarDecl{ + .type_node = type_node, + .align_node = align_node, + .addrspace_node = addrspace_node, + .section_node = section_node, + }), + .rhs = init_node, + }, + }); + } +} + +/// ContainerField +/// <- doc_comment? KEYWORD_comptime? IDENTIFIER (COLON TypeExpr)? ByteAlign? (EQUAL Expr)? +/// / doc_comment? KEYWORD_comptime? (IDENTIFIER COLON)? !KEYWORD_fn TypeExpr ByteAlign? (EQUAL Expr)? +fn expectContainerField(p: *Parse) !Node.Index { + var main_token = p.tok_i; + _ = p.eatToken(.keyword_comptime); + const tuple_like = p.token_tags[p.tok_i] != .identifier or p.token_tags[p.tok_i + 1] != .colon; + if (!tuple_like) { + main_token = p.assertToken(.identifier); + } + + var align_expr: Node.Index = 0; + var type_expr: Node.Index = 0; + if (p.eatToken(.colon) != null or tuple_like) { + type_expr = try p.expectTypeExpr(); + align_expr = try p.parseByteAlign(); + } + + const value_expr: Node.Index = if (p.eatToken(.equal) == null) 0 else try p.expectExpr(); + + if (align_expr == 0) { + return p.addNode(.{ + .tag = .container_field_init, + .main_token = main_token, + .data = .{ + .lhs = type_expr, + .rhs = value_expr, + }, + }); + } else if (value_expr == 0) { + return p.addNode(.{ + .tag = .container_field_align, + .main_token = main_token, + .data = .{ + .lhs = type_expr, + .rhs = align_expr, + }, + }); + } else { + return p.addNode(.{ + .tag = .container_field, + .main_token = main_token, + .data = .{ + .lhs = type_expr, + .rhs = try p.addExtra(Node.ContainerField{ + .value_expr = value_expr, + .align_expr = align_expr, + }), + }, + }); + } +} + +/// Statement +/// <- KEYWORD_comptime? VarDecl +/// / KEYWORD_comptime BlockExprStatement +/// / KEYWORD_nosuspend BlockExprStatement +/// / KEYWORD_suspend BlockExprStatement +/// / KEYWORD_defer BlockExprStatement +/// / KEYWORD_errdefer Payload? BlockExprStatement +/// / IfStatement +/// / LabeledStatement +/// / SwitchExpr +/// / AssignExpr SEMICOLON +fn parseStatement(p: *Parse, allow_defer_var: bool) Error!Node.Index { + const comptime_token = p.eatToken(.keyword_comptime); + + if (allow_defer_var) { + const var_decl = try p.parseVarDecl(); + if (var_decl != 0) { + try p.expectSemicolon(.expected_semi_after_decl, true); + return var_decl; + } + } + + if (comptime_token) |token| { + return p.addNode(.{ + .tag = .@"comptime", + .main_token = token, + .data = .{ + .lhs = try p.expectBlockExprStatement(), + .rhs = undefined, + }, + }); + } + + switch (p.token_tags[p.tok_i]) { + .keyword_nosuspend => { + return p.addNode(.{ + .tag = .@"nosuspend", + .main_token = p.nextToken(), + .data = .{ + .lhs = try p.expectBlockExprStatement(), + .rhs = undefined, + }, + }); + }, + .keyword_suspend => { + const token = p.nextToken(); + const block_expr = try p.expectBlockExprStatement(); + return p.addNode(.{ + .tag = .@"suspend", + .main_token = token, + .data = .{ + .lhs = block_expr, + .rhs = undefined, + }, + }); + }, + .keyword_defer => if (allow_defer_var) return p.addNode(.{ + .tag = .@"defer", + .main_token = p.nextToken(), + .data = .{ + .lhs = undefined, + .rhs = try p.expectBlockExprStatement(), + }, + }), + .keyword_errdefer => if (allow_defer_var) return p.addNode(.{ + .tag = .@"errdefer", + .main_token = p.nextToken(), + .data = .{ + .lhs = try p.parsePayload(), + .rhs = try p.expectBlockExprStatement(), + }, + }), + .keyword_switch => return p.expectSwitchExpr(), + .keyword_if => return p.expectIfStatement(), + .keyword_enum, .keyword_struct, .keyword_union => { + const identifier = p.tok_i + 1; + if (try p.parseCStyleContainer()) { + // Return something so that `expectStatement` is happy. + return p.addNode(.{ + .tag = .identifier, + .main_token = identifier, + .data = .{ + .lhs = undefined, + .rhs = undefined, + }, + }); + } + }, + else => {}, + } + + const labeled_statement = try p.parseLabeledStatement(); + if (labeled_statement != 0) return labeled_statement; + + const assign_expr = try p.parseAssignExpr(); + if (assign_expr != 0) { + try p.expectSemicolon(.expected_semi_after_stmt, true); + return assign_expr; + } + + return null_node; +} + +fn expectStatement(p: *Parse, allow_defer_var: bool) !Node.Index { + const statement = try p.parseStatement(allow_defer_var); + if (statement == 0) { + return p.fail(.expected_statement); + } + return statement; +} + +/// If a parse error occurs, reports an error, but then finds the next statement +/// and returns that one instead. If a parse error occurs but there is no following +/// statement, returns 0. +fn expectStatementRecoverable(p: *Parse) Error!Node.Index { + while (true) { + return p.expectStatement(true) catch |err| switch (err) { + error.OutOfMemory => return error.OutOfMemory, + error.ParseError => { + p.findNextStmt(); // Try to skip to the next statement. + switch (p.token_tags[p.tok_i]) { + .r_brace => return null_node, + .eof => return error.ParseError, + else => continue, + } + }, + }; + } +} + +/// IfStatement +/// <- IfPrefix BlockExpr ( KEYWORD_else Payload? Statement )? +/// / IfPrefix AssignExpr ( SEMICOLON / KEYWORD_else Payload? Statement ) +fn expectIfStatement(p: *Parse) !Node.Index { + const if_token = p.assertToken(.keyword_if); + _ = try p.expectToken(.l_paren); + const condition = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + _ = try p.parsePtrPayload(); + + // TODO propose to change the syntax so that semicolons are always required + // inside if statements, even if there is an `else`. + var else_required = false; + const then_expr = blk: { + const block_expr = try p.parseBlockExpr(); + if (block_expr != 0) break :blk block_expr; + const assign_expr = try p.parseAssignExpr(); + if (assign_expr == 0) { + return p.fail(.expected_block_or_assignment); + } + if (p.eatToken(.semicolon)) |_| { + return p.addNode(.{ + .tag = .if_simple, + .main_token = if_token, + .data = .{ + .lhs = condition, + .rhs = assign_expr, + }, + }); + } + else_required = true; + break :blk assign_expr; + }; + _ = p.eatToken(.keyword_else) orelse { + if (else_required) { + try p.warn(.expected_semi_or_else); + } + return p.addNode(.{ + .tag = .if_simple, + .main_token = if_token, + .data = .{ + .lhs = condition, + .rhs = then_expr, + }, + }); + }; + _ = try p.parsePayload(); + const else_expr = try p.expectStatement(false); + return p.addNode(.{ + .tag = .@"if", + .main_token = if_token, + .data = .{ + .lhs = condition, + .rhs = try p.addExtra(Node.If{ + .then_expr = then_expr, + .else_expr = else_expr, + }), + }, + }); +} + +/// LabeledStatement <- BlockLabel? (Block / LoopStatement) +fn parseLabeledStatement(p: *Parse) !Node.Index { + const label_token = p.parseBlockLabel(); + const block = try p.parseBlock(); + if (block != 0) return block; + + const loop_stmt = try p.parseLoopStatement(); + if (loop_stmt != 0) return loop_stmt; + + if (label_token != 0) { + const after_colon = p.tok_i; + const node = try p.parseTypeExpr(); + if (node != 0) { + const a = try p.parseByteAlign(); + const b = try p.parseAddrSpace(); + const c = try p.parseLinkSection(); + const d = if (p.eatToken(.equal) == null) 0 else try p.expectExpr(); + if (a != 0 or b != 0 or c != 0 or d != 0) { + return p.failMsg(.{ .tag = .expected_var_const, .token = label_token }); + } + } + return p.failMsg(.{ .tag = .expected_labelable, .token = after_colon }); + } + + return null_node; +} + +/// LoopStatement <- KEYWORD_inline? (ForStatement / WhileStatement) +fn parseLoopStatement(p: *Parse) !Node.Index { + const inline_token = p.eatToken(.keyword_inline); + + const for_statement = try p.parseForStatement(); + if (for_statement != 0) return for_statement; + + const while_statement = try p.parseWhileStatement(); + if (while_statement != 0) return while_statement; + + if (inline_token == null) return null_node; + + // If we've seen "inline", there should have been a "for" or "while" + return p.fail(.expected_inlinable); +} + +/// ForPrefix <- KEYWORD_for LPAREN Expr RPAREN PtrIndexPayload +/// +/// ForStatement +/// <- ForPrefix BlockExpr ( KEYWORD_else Statement )? +/// / ForPrefix AssignExpr ( SEMICOLON / KEYWORD_else Statement ) +fn parseForStatement(p: *Parse) !Node.Index { + const for_token = p.eatToken(.keyword_for) orelse return null_node; + _ = try p.expectToken(.l_paren); + const array_expr = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + const found_payload = try p.parsePtrIndexPayload(); + if (found_payload == 0) try p.warn(.expected_loop_payload); + + // TODO propose to change the syntax so that semicolons are always required + // inside while statements, even if there is an `else`. + var else_required = false; + const then_expr = blk: { + const block_expr = try p.parseBlockExpr(); + if (block_expr != 0) break :blk block_expr; + const assign_expr = try p.parseAssignExpr(); + if (assign_expr == 0) { + return p.fail(.expected_block_or_assignment); + } + if (p.eatToken(.semicolon)) |_| { + return p.addNode(.{ + .tag = .for_simple, + .main_token = for_token, + .data = .{ + .lhs = array_expr, + .rhs = assign_expr, + }, + }); + } + else_required = true; + break :blk assign_expr; + }; + _ = p.eatToken(.keyword_else) orelse { + if (else_required) { + try p.warn(.expected_semi_or_else); + } + return p.addNode(.{ + .tag = .for_simple, + .main_token = for_token, + .data = .{ + .lhs = array_expr, + .rhs = then_expr, + }, + }); + }; + return p.addNode(.{ + .tag = .@"for", + .main_token = for_token, + .data = .{ + .lhs = array_expr, + .rhs = try p.addExtra(Node.If{ + .then_expr = then_expr, + .else_expr = try p.expectStatement(false), + }), + }, + }); +} + +/// WhilePrefix <- KEYWORD_while LPAREN Expr RPAREN PtrPayload? WhileContinueExpr? +/// +/// WhileStatement +/// <- WhilePrefix BlockExpr ( KEYWORD_else Payload? Statement )? +/// / WhilePrefix AssignExpr ( SEMICOLON / KEYWORD_else Payload? Statement ) +fn parseWhileStatement(p: *Parse) !Node.Index { + const while_token = p.eatToken(.keyword_while) orelse return null_node; + _ = try p.expectToken(.l_paren); + const condition = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + _ = try p.parsePtrPayload(); + const cont_expr = try p.parseWhileContinueExpr(); + + // TODO propose to change the syntax so that semicolons are always required + // inside while statements, even if there is an `else`. + var else_required = false; + const then_expr = blk: { + const block_expr = try p.parseBlockExpr(); + if (block_expr != 0) break :blk block_expr; + const assign_expr = try p.parseAssignExpr(); + if (assign_expr == 0) { + return p.fail(.expected_block_or_assignment); + } + if (p.eatToken(.semicolon)) |_| { + if (cont_expr == 0) { + return p.addNode(.{ + .tag = .while_simple, + .main_token = while_token, + .data = .{ + .lhs = condition, + .rhs = assign_expr, + }, + }); + } else { + return p.addNode(.{ + .tag = .while_cont, + .main_token = while_token, + .data = .{ + .lhs = condition, + .rhs = try p.addExtra(Node.WhileCont{ + .cont_expr = cont_expr, + .then_expr = assign_expr, + }), + }, + }); + } + } + else_required = true; + break :blk assign_expr; + }; + _ = p.eatToken(.keyword_else) orelse { + if (else_required) { + try p.warn(.expected_semi_or_else); + } + if (cont_expr == 0) { + return p.addNode(.{ + .tag = .while_simple, + .main_token = while_token, + .data = .{ + .lhs = condition, + .rhs = then_expr, + }, + }); + } else { + return p.addNode(.{ + .tag = .while_cont, + .main_token = while_token, + .data = .{ + .lhs = condition, + .rhs = try p.addExtra(Node.WhileCont{ + .cont_expr = cont_expr, + .then_expr = then_expr, + }), + }, + }); + } + }; + _ = try p.parsePayload(); + const else_expr = try p.expectStatement(false); + return p.addNode(.{ + .tag = .@"while", + .main_token = while_token, + .data = .{ + .lhs = condition, + .rhs = try p.addExtra(Node.While{ + .cont_expr = cont_expr, + .then_expr = then_expr, + .else_expr = else_expr, + }), + }, + }); +} + +/// BlockExprStatement +/// <- BlockExpr +/// / AssignExpr SEMICOLON +fn parseBlockExprStatement(p: *Parse) !Node.Index { + const block_expr = try p.parseBlockExpr(); + if (block_expr != 0) { + return block_expr; + } + const assign_expr = try p.parseAssignExpr(); + if (assign_expr != 0) { + try p.expectSemicolon(.expected_semi_after_stmt, true); + return assign_expr; + } + return null_node; +} + +fn expectBlockExprStatement(p: *Parse) !Node.Index { + const node = try p.parseBlockExprStatement(); + if (node == 0) { + return p.fail(.expected_block_or_expr); + } + return node; +} + +/// BlockExpr <- BlockLabel? Block +fn parseBlockExpr(p: *Parse) Error!Node.Index { + switch (p.token_tags[p.tok_i]) { + .identifier => { + if (p.token_tags[p.tok_i + 1] == .colon and + p.token_tags[p.tok_i + 2] == .l_brace) + { + p.tok_i += 2; + return p.parseBlock(); + } else { + return null_node; + } + }, + .l_brace => return p.parseBlock(), + else => return null_node, + } +} + +/// AssignExpr <- Expr (AssignOp Expr)? +/// +/// AssignOp +/// <- ASTERISKEQUAL +/// / ASTERISKPIPEEQUAL +/// / SLASHEQUAL +/// / PERCENTEQUAL +/// / PLUSEQUAL +/// / PLUSPIPEEQUAL +/// / MINUSEQUAL +/// / MINUSPIPEEQUAL +/// / LARROW2EQUAL +/// / LARROW2PIPEEQUAL +/// / RARROW2EQUAL +/// / AMPERSANDEQUAL +/// / CARETEQUAL +/// / PIPEEQUAL +/// / ASTERISKPERCENTEQUAL +/// / PLUSPERCENTEQUAL +/// / MINUSPERCENTEQUAL +/// / EQUAL +fn parseAssignExpr(p: *Parse) !Node.Index { + const expr = try p.parseExpr(); + if (expr == 0) return null_node; + + const tag: Node.Tag = switch (p.token_tags[p.tok_i]) { + .asterisk_equal => .assign_mul, + .slash_equal => .assign_div, + .percent_equal => .assign_mod, + .plus_equal => .assign_add, + .minus_equal => .assign_sub, + .angle_bracket_angle_bracket_left_equal => .assign_shl, + .angle_bracket_angle_bracket_left_pipe_equal => .assign_shl_sat, + .angle_bracket_angle_bracket_right_equal => .assign_shr, + .ampersand_equal => .assign_bit_and, + .caret_equal => .assign_bit_xor, + .pipe_equal => .assign_bit_or, + .asterisk_percent_equal => .assign_mul_wrap, + .plus_percent_equal => .assign_add_wrap, + .minus_percent_equal => .assign_sub_wrap, + .asterisk_pipe_equal => .assign_mul_sat, + .plus_pipe_equal => .assign_add_sat, + .minus_pipe_equal => .assign_sub_sat, + .equal => .assign, + else => return expr, + }; + return p.addNode(.{ + .tag = tag, + .main_token = p.nextToken(), + .data = .{ + .lhs = expr, + .rhs = try p.expectExpr(), + }, + }); +} + +fn expectAssignExpr(p: *Parse) !Node.Index { + const expr = try p.parseAssignExpr(); + if (expr == 0) { + return p.fail(.expected_expr_or_assignment); + } + return expr; +} + +fn parseExpr(p: *Parse) Error!Node.Index { + return p.parseExprPrecedence(0); +} + +fn expectExpr(p: *Parse) Error!Node.Index { + const node = try p.parseExpr(); + if (node == 0) { + return p.fail(.expected_expr); + } else { + return node; + } +} + +const Assoc = enum { + left, + none, +}; + +const OperInfo = struct { + prec: i8, + tag: Node.Tag, + assoc: Assoc = Assoc.left, +}; + +// A table of binary operator information. Higher precedence numbers are +// stickier. All operators at the same precedence level should have the same +// associativity. +const operTable = std.enums.directEnumArrayDefault(Token.Tag, OperInfo, .{ .prec = -1, .tag = Node.Tag.root }, 0, .{ + .keyword_or = .{ .prec = 10, .tag = .bool_or }, + + .keyword_and = .{ .prec = 20, .tag = .bool_and }, + + .equal_equal = .{ .prec = 30, .tag = .equal_equal, .assoc = Assoc.none }, + .bang_equal = .{ .prec = 30, .tag = .bang_equal, .assoc = Assoc.none }, + .angle_bracket_left = .{ .prec = 30, .tag = .less_than, .assoc = Assoc.none }, + .angle_bracket_right = .{ .prec = 30, .tag = .greater_than, .assoc = Assoc.none }, + .angle_bracket_left_equal = .{ .prec = 30, .tag = .less_or_equal, .assoc = Assoc.none }, + .angle_bracket_right_equal = .{ .prec = 30, .tag = .greater_or_equal, .assoc = Assoc.none }, + + .ampersand = .{ .prec = 40, .tag = .bit_and }, + .caret = .{ .prec = 40, .tag = .bit_xor }, + .pipe = .{ .prec = 40, .tag = .bit_or }, + .keyword_orelse = .{ .prec = 40, .tag = .@"orelse" }, + .keyword_catch = .{ .prec = 40, .tag = .@"catch" }, + + .angle_bracket_angle_bracket_left = .{ .prec = 50, .tag = .shl }, + .angle_bracket_angle_bracket_left_pipe = .{ .prec = 50, .tag = .shl_sat }, + .angle_bracket_angle_bracket_right = .{ .prec = 50, .tag = .shr }, + + .plus = .{ .prec = 60, .tag = .add }, + .minus = .{ .prec = 60, .tag = .sub }, + .plus_plus = .{ .prec = 60, .tag = .array_cat }, + .plus_percent = .{ .prec = 60, .tag = .add_wrap }, + .minus_percent = .{ .prec = 60, .tag = .sub_wrap }, + .plus_pipe = .{ .prec = 60, .tag = .add_sat }, + .minus_pipe = .{ .prec = 60, .tag = .sub_sat }, + + .pipe_pipe = .{ .prec = 70, .tag = .merge_error_sets }, + .asterisk = .{ .prec = 70, .tag = .mul }, + .slash = .{ .prec = 70, .tag = .div }, + .percent = .{ .prec = 70, .tag = .mod }, + .asterisk_asterisk = .{ .prec = 70, .tag = .array_mult }, + .asterisk_percent = .{ .prec = 70, .tag = .mul_wrap }, + .asterisk_pipe = .{ .prec = 70, .tag = .mul_sat }, +}); + +fn parseExprPrecedence(p: *Parse, min_prec: i32) Error!Node.Index { + assert(min_prec >= 0); + var node = try p.parsePrefixExpr(); + if (node == 0) { + return null_node; + } + + var banned_prec: i8 = -1; + + while (true) { + const tok_tag = p.token_tags[p.tok_i]; + const info = operTable[@intCast(usize, @enumToInt(tok_tag))]; + if (info.prec < min_prec) { + break; + } + if (info.prec == banned_prec) { + return p.fail(.chained_comparison_operators); + } + + const oper_token = p.nextToken(); + // Special-case handling for "catch" + if (tok_tag == .keyword_catch) { + _ = try p.parsePayload(); + } + const rhs = try p.parseExprPrecedence(info.prec + 1); + if (rhs == 0) { + try p.warn(.expected_expr); + return node; + } + + { + const tok_len = tok_tag.lexeme().?.len; + const char_before = p.source[p.token_starts[oper_token] - 1]; + const char_after = p.source[p.token_starts[oper_token] + tok_len]; + if (tok_tag == .ampersand and char_after == '&') { + // without types we don't know if '&&' was intended as 'bitwise_and address_of', or a c-style logical_and + // The best the parser can do is recommend changing it to 'and' or ' & &' + try p.warnMsg(.{ .tag = .invalid_ampersand_ampersand, .token = oper_token }); + } else if (std.ascii.isWhitespace(char_before) != std.ascii.isWhitespace(char_after)) { + try p.warnMsg(.{ .tag = .mismatched_binary_op_whitespace, .token = oper_token }); + } + } + + node = try p.addNode(.{ + .tag = info.tag, + .main_token = oper_token, + .data = .{ + .lhs = node, + .rhs = rhs, + }, + }); + + if (info.assoc == Assoc.none) { + banned_prec = info.prec; + } + } + + return node; +} + +/// PrefixExpr <- PrefixOp* PrimaryExpr +/// +/// PrefixOp +/// <- EXCLAMATIONMARK +/// / MINUS +/// / TILDE +/// / MINUSPERCENT +/// / AMPERSAND +/// / KEYWORD_try +/// / KEYWORD_await +fn parsePrefixExpr(p: *Parse) Error!Node.Index { + const tag: Node.Tag = switch (p.token_tags[p.tok_i]) { + .bang => .bool_not, + .minus => .negation, + .tilde => .bit_not, + .minus_percent => .negation_wrap, + .ampersand => .address_of, + .keyword_try => .@"try", + .keyword_await => .@"await", + else => return p.parsePrimaryExpr(), + }; + return p.addNode(.{ + .tag = tag, + .main_token = p.nextToken(), + .data = .{ + .lhs = try p.expectPrefixExpr(), + .rhs = undefined, + }, + }); +} + +fn expectPrefixExpr(p: *Parse) Error!Node.Index { + const node = try p.parsePrefixExpr(); + if (node == 0) { + return p.fail(.expected_prefix_expr); + } + return node; +} + +/// TypeExpr <- PrefixTypeOp* ErrorUnionExpr +/// +/// PrefixTypeOp +/// <- QUESTIONMARK +/// / KEYWORD_anyframe MINUSRARROW +/// / SliceTypeStart (ByteAlign / AddrSpace / KEYWORD_const / KEYWORD_volatile / KEYWORD_allowzero)* +/// / PtrTypeStart (AddrSpace / KEYWORD_align LPAREN Expr (COLON Expr COLON Expr)? RPAREN / KEYWORD_const / KEYWORD_volatile / KEYWORD_allowzero)* +/// / ArrayTypeStart +/// +/// SliceTypeStart <- LBRACKET (COLON Expr)? RBRACKET +/// +/// PtrTypeStart +/// <- ASTERISK +/// / ASTERISK2 +/// / LBRACKET ASTERISK (LETTERC / COLON Expr)? RBRACKET +/// +/// ArrayTypeStart <- LBRACKET Expr (COLON Expr)? RBRACKET +fn parseTypeExpr(p: *Parse) Error!Node.Index { + switch (p.token_tags[p.tok_i]) { + .question_mark => return p.addNode(.{ + .tag = .optional_type, + .main_token = p.nextToken(), + .data = .{ + .lhs = try p.expectTypeExpr(), + .rhs = undefined, + }, + }), + .keyword_anyframe => switch (p.token_tags[p.tok_i + 1]) { + .arrow => return p.addNode(.{ + .tag = .anyframe_type, + .main_token = p.nextToken(), + .data = .{ + .lhs = p.nextToken(), + .rhs = try p.expectTypeExpr(), + }, + }), + else => return p.parseErrorUnionExpr(), + }, + .asterisk => { + const asterisk = p.nextToken(); + const mods = try p.parsePtrModifiers(); + const elem_type = try p.expectTypeExpr(); + if (mods.bit_range_start != 0) { + return p.addNode(.{ + .tag = .ptr_type_bit_range, + .main_token = asterisk, + .data = .{ + .lhs = try p.addExtra(Node.PtrTypeBitRange{ + .sentinel = 0, + .align_node = mods.align_node, + .addrspace_node = mods.addrspace_node, + .bit_range_start = mods.bit_range_start, + .bit_range_end = mods.bit_range_end, + }), + .rhs = elem_type, + }, + }); + } else if (mods.addrspace_node != 0) { + return p.addNode(.{ + .tag = .ptr_type, + .main_token = asterisk, + .data = .{ + .lhs = try p.addExtra(Node.PtrType{ + .sentinel = 0, + .align_node = mods.align_node, + .addrspace_node = mods.addrspace_node, + }), + .rhs = elem_type, + }, + }); + } else { + return p.addNode(.{ + .tag = .ptr_type_aligned, + .main_token = asterisk, + .data = .{ + .lhs = mods.align_node, + .rhs = elem_type, + }, + }); + } + }, + .asterisk_asterisk => { + const asterisk = p.nextToken(); + const mods = try p.parsePtrModifiers(); + const elem_type = try p.expectTypeExpr(); + const inner: Node.Index = inner: { + if (mods.bit_range_start != 0) { + break :inner try p.addNode(.{ + .tag = .ptr_type_bit_range, + .main_token = asterisk, + .data = .{ + .lhs = try p.addExtra(Node.PtrTypeBitRange{ + .sentinel = 0, + .align_node = mods.align_node, + .addrspace_node = mods.addrspace_node, + .bit_range_start = mods.bit_range_start, + .bit_range_end = mods.bit_range_end, + }), + .rhs = elem_type, + }, + }); + } else if (mods.addrspace_node != 0) { + break :inner try p.addNode(.{ + .tag = .ptr_type, + .main_token = asterisk, + .data = .{ + .lhs = try p.addExtra(Node.PtrType{ + .sentinel = 0, + .align_node = mods.align_node, + .addrspace_node = mods.addrspace_node, + }), + .rhs = elem_type, + }, + }); + } else { + break :inner try p.addNode(.{ + .tag = .ptr_type_aligned, + .main_token = asterisk, + .data = .{ + .lhs = mods.align_node, + .rhs = elem_type, + }, + }); + } + }; + return p.addNode(.{ + .tag = .ptr_type_aligned, + .main_token = asterisk, + .data = .{ + .lhs = 0, + .rhs = inner, + }, + }); + }, + .l_bracket => switch (p.token_tags[p.tok_i + 1]) { + .asterisk => { + _ = p.nextToken(); + const asterisk = p.nextToken(); + var sentinel: Node.Index = 0; + if (p.eatToken(.identifier)) |ident| { + const ident_slice = p.source[p.token_starts[ident]..p.token_starts[ident + 1]]; + if (!std.mem.eql(u8, std.mem.trimRight(u8, ident_slice, &std.ascii.whitespace), "c")) { + p.tok_i -= 1; + } + } else if (p.eatToken(.colon)) |_| { + sentinel = try p.expectExpr(); + } + _ = try p.expectToken(.r_bracket); + const mods = try p.parsePtrModifiers(); + const elem_type = try p.expectTypeExpr(); + if (mods.bit_range_start == 0) { + if (sentinel == 0 and mods.addrspace_node == 0) { + return p.addNode(.{ + .tag = .ptr_type_aligned, + .main_token = asterisk, + .data = .{ + .lhs = mods.align_node, + .rhs = elem_type, + }, + }); + } else if (mods.align_node == 0 and mods.addrspace_node == 0) { + return p.addNode(.{ + .tag = .ptr_type_sentinel, + .main_token = asterisk, + .data = .{ + .lhs = sentinel, + .rhs = elem_type, + }, + }); + } else { + return p.addNode(.{ + .tag = .ptr_type, + .main_token = asterisk, + .data = .{ + .lhs = try p.addExtra(Node.PtrType{ + .sentinel = sentinel, + .align_node = mods.align_node, + .addrspace_node = mods.addrspace_node, + }), + .rhs = elem_type, + }, + }); + } + } else { + return p.addNode(.{ + .tag = .ptr_type_bit_range, + .main_token = asterisk, + .data = .{ + .lhs = try p.addExtra(Node.PtrTypeBitRange{ + .sentinel = sentinel, + .align_node = mods.align_node, + .addrspace_node = mods.addrspace_node, + .bit_range_start = mods.bit_range_start, + .bit_range_end = mods.bit_range_end, + }), + .rhs = elem_type, + }, + }); + } + }, + else => { + const lbracket = p.nextToken(); + const len_expr = try p.parseExpr(); + const sentinel: Node.Index = if (p.eatToken(.colon)) |_| + try p.expectExpr() + else + 0; + _ = try p.expectToken(.r_bracket); + if (len_expr == 0) { + const mods = try p.parsePtrModifiers(); + const elem_type = try p.expectTypeExpr(); + if (mods.bit_range_start != 0) { + try p.warnMsg(.{ + .tag = .invalid_bit_range, + .token = p.nodes.items(.main_token)[mods.bit_range_start], + }); + } + if (sentinel == 0 and mods.addrspace_node == 0) { + return p.addNode(.{ + .tag = .ptr_type_aligned, + .main_token = lbracket, + .data = .{ + .lhs = mods.align_node, + .rhs = elem_type, + }, + }); + } else if (mods.align_node == 0 and mods.addrspace_node == 0) { + return p.addNode(.{ + .tag = .ptr_type_sentinel, + .main_token = lbracket, + .data = .{ + .lhs = sentinel, + .rhs = elem_type, + }, + }); + } else { + return p.addNode(.{ + .tag = .ptr_type, + .main_token = lbracket, + .data = .{ + .lhs = try p.addExtra(Node.PtrType{ + .sentinel = sentinel, + .align_node = mods.align_node, + .addrspace_node = mods.addrspace_node, + }), + .rhs = elem_type, + }, + }); + } + } else { + switch (p.token_tags[p.tok_i]) { + .keyword_align, + .keyword_const, + .keyword_volatile, + .keyword_allowzero, + .keyword_addrspace, + => return p.fail(.ptr_mod_on_array_child_type), + else => {}, + } + const elem_type = try p.expectTypeExpr(); + if (sentinel == 0) { + return p.addNode(.{ + .tag = .array_type, + .main_token = lbracket, + .data = .{ + .lhs = len_expr, + .rhs = elem_type, + }, + }); + } else { + return p.addNode(.{ + .tag = .array_type_sentinel, + .main_token = lbracket, + .data = .{ + .lhs = len_expr, + .rhs = try p.addExtra(.{ + .elem_type = elem_type, + .sentinel = sentinel, + }), + }, + }); + } + } + }, + }, + else => return p.parseErrorUnionExpr(), + } +} + +fn expectTypeExpr(p: *Parse) Error!Node.Index { + const node = try p.parseTypeExpr(); + if (node == 0) { + return p.fail(.expected_type_expr); + } + return node; +} + +/// PrimaryExpr +/// <- AsmExpr +/// / IfExpr +/// / KEYWORD_break BreakLabel? Expr? +/// / KEYWORD_comptime Expr +/// / KEYWORD_nosuspend Expr +/// / KEYWORD_continue BreakLabel? +/// / KEYWORD_resume Expr +/// / KEYWORD_return Expr? +/// / BlockLabel? LoopExpr +/// / Block +/// / CurlySuffixExpr +fn parsePrimaryExpr(p: *Parse) !Node.Index { + switch (p.token_tags[p.tok_i]) { + .keyword_asm => return p.expectAsmExpr(), + .keyword_if => return p.parseIfExpr(), + .keyword_break => { + p.tok_i += 1; + return p.addNode(.{ + .tag = .@"break", + .main_token = p.tok_i - 1, + .data = .{ + .lhs = try p.parseBreakLabel(), + .rhs = try p.parseExpr(), + }, + }); + }, + .keyword_continue => { + p.tok_i += 1; + return p.addNode(.{ + .tag = .@"continue", + .main_token = p.tok_i - 1, + .data = .{ + .lhs = try p.parseBreakLabel(), + .rhs = undefined, + }, + }); + }, + .keyword_comptime => { + p.tok_i += 1; + return p.addNode(.{ + .tag = .@"comptime", + .main_token = p.tok_i - 1, + .data = .{ + .lhs = try p.expectExpr(), + .rhs = undefined, + }, + }); + }, + .keyword_nosuspend => { + p.tok_i += 1; + return p.addNode(.{ + .tag = .@"nosuspend", + .main_token = p.tok_i - 1, + .data = .{ + .lhs = try p.expectExpr(), + .rhs = undefined, + }, + }); + }, + .keyword_resume => { + p.tok_i += 1; + return p.addNode(.{ + .tag = .@"resume", + .main_token = p.tok_i - 1, + .data = .{ + .lhs = try p.expectExpr(), + .rhs = undefined, + }, + }); + }, + .keyword_return => { + p.tok_i += 1; + return p.addNode(.{ + .tag = .@"return", + .main_token = p.tok_i - 1, + .data = .{ + .lhs = try p.parseExpr(), + .rhs = undefined, + }, + }); + }, + .identifier => { + if (p.token_tags[p.tok_i + 1] == .colon) { + switch (p.token_tags[p.tok_i + 2]) { + .keyword_inline => { + p.tok_i += 3; + switch (p.token_tags[p.tok_i]) { + .keyword_for => return p.parseForExpr(), + .keyword_while => return p.parseWhileExpr(), + else => return p.fail(.expected_inlinable), + } + }, + .keyword_for => { + p.tok_i += 2; + return p.parseForExpr(); + }, + .keyword_while => { + p.tok_i += 2; + return p.parseWhileExpr(); + }, + .l_brace => { + p.tok_i += 2; + return p.parseBlock(); + }, + else => return p.parseCurlySuffixExpr(), + } + } else { + return p.parseCurlySuffixExpr(); + } + }, + .keyword_inline => { + p.tok_i += 1; + switch (p.token_tags[p.tok_i]) { + .keyword_for => return p.parseForExpr(), + .keyword_while => return p.parseWhileExpr(), + else => return p.fail(.expected_inlinable), + } + }, + .keyword_for => return p.parseForExpr(), + .keyword_while => return p.parseWhileExpr(), + .l_brace => return p.parseBlock(), + else => return p.parseCurlySuffixExpr(), + } +} + +/// IfExpr <- IfPrefix Expr (KEYWORD_else Payload? Expr)? +fn parseIfExpr(p: *Parse) !Node.Index { + return p.parseIf(expectExpr); +} + +/// Block <- LBRACE Statement* RBRACE +fn parseBlock(p: *Parse) !Node.Index { + const lbrace = p.eatToken(.l_brace) orelse return null_node; + const scratch_top = p.scratch.items.len; + defer p.scratch.shrinkRetainingCapacity(scratch_top); + while (true) { + if (p.token_tags[p.tok_i] == .r_brace) break; + const statement = try p.expectStatementRecoverable(); + if (statement == 0) break; + try p.scratch.append(p.gpa, statement); + } + _ = try p.expectToken(.r_brace); + const semicolon = (p.token_tags[p.tok_i - 2] == .semicolon); + const statements = p.scratch.items[scratch_top..]; + switch (statements.len) { + 0 => return p.addNode(.{ + .tag = .block_two, + .main_token = lbrace, + .data = .{ + .lhs = 0, + .rhs = 0, + }, + }), + 1 => return p.addNode(.{ + .tag = if (semicolon) .block_two_semicolon else .block_two, + .main_token = lbrace, + .data = .{ + .lhs = statements[0], + .rhs = 0, + }, + }), + 2 => return p.addNode(.{ + .tag = if (semicolon) .block_two_semicolon else .block_two, + .main_token = lbrace, + .data = .{ + .lhs = statements[0], + .rhs = statements[1], + }, + }), + else => { + const span = try p.listToSpan(statements); + return p.addNode(.{ + .tag = if (semicolon) .block_semicolon else .block, + .main_token = lbrace, + .data = .{ + .lhs = span.start, + .rhs = span.end, + }, + }); + }, + } +} + +/// ForPrefix <- KEYWORD_for LPAREN Expr RPAREN PtrIndexPayload +/// +/// ForExpr <- ForPrefix Expr (KEYWORD_else Expr)? +fn parseForExpr(p: *Parse) !Node.Index { + const for_token = p.eatToken(.keyword_for) orelse return null_node; + _ = try p.expectToken(.l_paren); + const array_expr = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + const found_payload = try p.parsePtrIndexPayload(); + if (found_payload == 0) try p.warn(.expected_loop_payload); + + const then_expr = try p.expectExpr(); + _ = p.eatToken(.keyword_else) orelse { + return p.addNode(.{ + .tag = .for_simple, + .main_token = for_token, + .data = .{ + .lhs = array_expr, + .rhs = then_expr, + }, + }); + }; + const else_expr = try p.expectExpr(); + return p.addNode(.{ + .tag = .@"for", + .main_token = for_token, + .data = .{ + .lhs = array_expr, + .rhs = try p.addExtra(Node.If{ + .then_expr = then_expr, + .else_expr = else_expr, + }), + }, + }); +} + +/// WhilePrefix <- KEYWORD_while LPAREN Expr RPAREN PtrPayload? WhileContinueExpr? +/// +/// WhileExpr <- WhilePrefix Expr (KEYWORD_else Payload? Expr)? +fn parseWhileExpr(p: *Parse) !Node.Index { + const while_token = p.eatToken(.keyword_while) orelse return null_node; + _ = try p.expectToken(.l_paren); + const condition = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + _ = try p.parsePtrPayload(); + const cont_expr = try p.parseWhileContinueExpr(); + + const then_expr = try p.expectExpr(); + _ = p.eatToken(.keyword_else) orelse { + if (cont_expr == 0) { + return p.addNode(.{ + .tag = .while_simple, + .main_token = while_token, + .data = .{ + .lhs = condition, + .rhs = then_expr, + }, + }); + } else { + return p.addNode(.{ + .tag = .while_cont, + .main_token = while_token, + .data = .{ + .lhs = condition, + .rhs = try p.addExtra(Node.WhileCont{ + .cont_expr = cont_expr, + .then_expr = then_expr, + }), + }, + }); + } + }; + _ = try p.parsePayload(); + const else_expr = try p.expectExpr(); + return p.addNode(.{ + .tag = .@"while", + .main_token = while_token, + .data = .{ + .lhs = condition, + .rhs = try p.addExtra(Node.While{ + .cont_expr = cont_expr, + .then_expr = then_expr, + .else_expr = else_expr, + }), + }, + }); +} + +/// CurlySuffixExpr <- TypeExpr InitList? +/// +/// InitList +/// <- LBRACE FieldInit (COMMA FieldInit)* COMMA? RBRACE +/// / LBRACE Expr (COMMA Expr)* COMMA? RBRACE +/// / LBRACE RBRACE +fn parseCurlySuffixExpr(p: *Parse) !Node.Index { + const lhs = try p.parseTypeExpr(); + if (lhs == 0) return null_node; + const lbrace = p.eatToken(.l_brace) orelse return lhs; + + // If there are 0 or 1 items, we can use ArrayInitOne/StructInitOne; + // otherwise we use the full ArrayInit/StructInit. + + const scratch_top = p.scratch.items.len; + defer p.scratch.shrinkRetainingCapacity(scratch_top); + const field_init = try p.parseFieldInit(); + if (field_init != 0) { + try p.scratch.append(p.gpa, field_init); + while (true) { + switch (p.token_tags[p.tok_i]) { + .comma => p.tok_i += 1, + .r_brace => { + p.tok_i += 1; + break; + }, + .colon, .r_paren, .r_bracket => return p.failExpected(.r_brace), + // Likely just a missing comma; give error but continue parsing. + else => try p.warn(.expected_comma_after_initializer), + } + if (p.eatToken(.r_brace)) |_| break; + const next = try p.expectFieldInit(); + try p.scratch.append(p.gpa, next); + } + const comma = (p.token_tags[p.tok_i - 2] == .comma); + const inits = p.scratch.items[scratch_top..]; + switch (inits.len) { + 0 => unreachable, + 1 => return p.addNode(.{ + .tag = if (comma) .struct_init_one_comma else .struct_init_one, + .main_token = lbrace, + .data = .{ + .lhs = lhs, + .rhs = inits[0], + }, + }), + else => return p.addNode(.{ + .tag = if (comma) .struct_init_comma else .struct_init, + .main_token = lbrace, + .data = .{ + .lhs = lhs, + .rhs = try p.addExtra(try p.listToSpan(inits)), + }, + }), + } + } + + while (true) { + if (p.eatToken(.r_brace)) |_| break; + const elem_init = try p.expectExpr(); + try p.scratch.append(p.gpa, elem_init); + switch (p.token_tags[p.tok_i]) { + .comma => p.tok_i += 1, + .r_brace => { + p.tok_i += 1; + break; + }, + .colon, .r_paren, .r_bracket => return p.failExpected(.r_brace), + // Likely just a missing comma; give error but continue parsing. + else => try p.warn(.expected_comma_after_initializer), + } + } + const comma = (p.token_tags[p.tok_i - 2] == .comma); + const inits = p.scratch.items[scratch_top..]; + switch (inits.len) { + 0 => return p.addNode(.{ + .tag = .struct_init_one, + .main_token = lbrace, + .data = .{ + .lhs = lhs, + .rhs = 0, + }, + }), + 1 => return p.addNode(.{ + .tag = if (comma) .array_init_one_comma else .array_init_one, + .main_token = lbrace, + .data = .{ + .lhs = lhs, + .rhs = inits[0], + }, + }), + else => return p.addNode(.{ + .tag = if (comma) .array_init_comma else .array_init, + .main_token = lbrace, + .data = .{ + .lhs = lhs, + .rhs = try p.addExtra(try p.listToSpan(inits)), + }, + }), + } +} + +/// ErrorUnionExpr <- SuffixExpr (EXCLAMATIONMARK TypeExpr)? +fn parseErrorUnionExpr(p: *Parse) !Node.Index { + const suffix_expr = try p.parseSuffixExpr(); + if (suffix_expr == 0) return null_node; + const bang = p.eatToken(.bang) orelse return suffix_expr; + return p.addNode(.{ + .tag = .error_union, + .main_token = bang, + .data = .{ + .lhs = suffix_expr, + .rhs = try p.expectTypeExpr(), + }, + }); +} + +/// SuffixExpr +/// <- KEYWORD_async PrimaryTypeExpr SuffixOp* FnCallArguments +/// / PrimaryTypeExpr (SuffixOp / FnCallArguments)* +/// +/// FnCallArguments <- LPAREN ExprList RPAREN +/// +/// ExprList <- (Expr COMMA)* Expr? +fn parseSuffixExpr(p: *Parse) !Node.Index { + if (p.eatToken(.keyword_async)) |_| { + var res = try p.expectPrimaryTypeExpr(); + while (true) { + const node = try p.parseSuffixOp(res); + if (node == 0) break; + res = node; + } + const lparen = p.eatToken(.l_paren) orelse { + try p.warn(.expected_param_list); + return res; + }; + const scratch_top = p.scratch.items.len; + defer p.scratch.shrinkRetainingCapacity(scratch_top); + while (true) { + if (p.eatToken(.r_paren)) |_| break; + const param = try p.expectExpr(); + try p.scratch.append(p.gpa, param); + switch (p.token_tags[p.tok_i]) { + .comma => p.tok_i += 1, + .r_paren => { + p.tok_i += 1; + break; + }, + .colon, .r_brace, .r_bracket => return p.failExpected(.r_paren), + // Likely just a missing comma; give error but continue parsing. + else => try p.warn(.expected_comma_after_arg), + } + } + const comma = (p.token_tags[p.tok_i - 2] == .comma); + const params = p.scratch.items[scratch_top..]; + switch (params.len) { + 0 => return p.addNode(.{ + .tag = if (comma) .async_call_one_comma else .async_call_one, + .main_token = lparen, + .data = .{ + .lhs = res, + .rhs = 0, + }, + }), + 1 => return p.addNode(.{ + .tag = if (comma) .async_call_one_comma else .async_call_one, + .main_token = lparen, + .data = .{ + .lhs = res, + .rhs = params[0], + }, + }), + else => return p.addNode(.{ + .tag = if (comma) .async_call_comma else .async_call, + .main_token = lparen, + .data = .{ + .lhs = res, + .rhs = try p.addExtra(try p.listToSpan(params)), + }, + }), + } + } + + var res = try p.parsePrimaryTypeExpr(); + if (res == 0) return res; + while (true) { + const suffix_op = try p.parseSuffixOp(res); + if (suffix_op != 0) { + res = suffix_op; + continue; + } + const lparen = p.eatToken(.l_paren) orelse return res; + const scratch_top = p.scratch.items.len; + defer p.scratch.shrinkRetainingCapacity(scratch_top); + while (true) { + if (p.eatToken(.r_paren)) |_| break; + const param = try p.expectExpr(); + try p.scratch.append(p.gpa, param); + switch (p.token_tags[p.tok_i]) { + .comma => p.tok_i += 1, + .r_paren => { + p.tok_i += 1; + break; + }, + .colon, .r_brace, .r_bracket => return p.failExpected(.r_paren), + // Likely just a missing comma; give error but continue parsing. + else => try p.warn(.expected_comma_after_arg), + } + } + const comma = (p.token_tags[p.tok_i - 2] == .comma); + const params = p.scratch.items[scratch_top..]; + res = switch (params.len) { + 0 => try p.addNode(.{ + .tag = if (comma) .call_one_comma else .call_one, + .main_token = lparen, + .data = .{ + .lhs = res, + .rhs = 0, + }, + }), + 1 => try p.addNode(.{ + .tag = if (comma) .call_one_comma else .call_one, + .main_token = lparen, + .data = .{ + .lhs = res, + .rhs = params[0], + }, + }), + else => try p.addNode(.{ + .tag = if (comma) .call_comma else .call, + .main_token = lparen, + .data = .{ + .lhs = res, + .rhs = try p.addExtra(try p.listToSpan(params)), + }, + }), + }; + } +} + +/// PrimaryTypeExpr +/// <- BUILTINIDENTIFIER FnCallArguments +/// / CHAR_LITERAL +/// / ContainerDecl +/// / DOT IDENTIFIER +/// / DOT InitList +/// / ErrorSetDecl +/// / FLOAT +/// / FnProto +/// / GroupedExpr +/// / LabeledTypeExpr +/// / IDENTIFIER +/// / IfTypeExpr +/// / INTEGER +/// / KEYWORD_comptime TypeExpr +/// / KEYWORD_error DOT IDENTIFIER +/// / KEYWORD_anyframe +/// / KEYWORD_unreachable +/// / STRINGLITERAL +/// / SwitchExpr +/// +/// ContainerDecl <- (KEYWORD_extern / KEYWORD_packed)? ContainerDeclAuto +/// +/// ContainerDeclAuto <- ContainerDeclType LBRACE container_doc_comment? ContainerMembers RBRACE +/// +/// InitList +/// <- LBRACE FieldInit (COMMA FieldInit)* COMMA? RBRACE +/// / LBRACE Expr (COMMA Expr)* COMMA? RBRACE +/// / LBRACE RBRACE +/// +/// ErrorSetDecl <- KEYWORD_error LBRACE IdentifierList RBRACE +/// +/// GroupedExpr <- LPAREN Expr RPAREN +/// +/// IfTypeExpr <- IfPrefix TypeExpr (KEYWORD_else Payload? TypeExpr)? +/// +/// LabeledTypeExpr +/// <- BlockLabel Block +/// / BlockLabel? LoopTypeExpr +/// +/// LoopTypeExpr <- KEYWORD_inline? (ForTypeExpr / WhileTypeExpr) +fn parsePrimaryTypeExpr(p: *Parse) !Node.Index { + switch (p.token_tags[p.tok_i]) { + .char_literal => return p.addNode(.{ + .tag = .char_literal, + .main_token = p.nextToken(), + .data = .{ + .lhs = undefined, + .rhs = undefined, + }, + }), + .number_literal => return p.addNode(.{ + .tag = .number_literal, + .main_token = p.nextToken(), + .data = .{ + .lhs = undefined, + .rhs = undefined, + }, + }), + .keyword_unreachable => return p.addNode(.{ + .tag = .unreachable_literal, + .main_token = p.nextToken(), + .data = .{ + .lhs = undefined, + .rhs = undefined, + }, + }), + .keyword_anyframe => return p.addNode(.{ + .tag = .anyframe_literal, + .main_token = p.nextToken(), + .data = .{ + .lhs = undefined, + .rhs = undefined, + }, + }), + .string_literal => { + const main_token = p.nextToken(); + return p.addNode(.{ + .tag = .string_literal, + .main_token = main_token, + .data = .{ + .lhs = undefined, + .rhs = undefined, + }, + }); + }, + + .builtin => return p.parseBuiltinCall(), + .keyword_fn => return p.parseFnProto(), + .keyword_if => return p.parseIf(expectTypeExpr), + .keyword_switch => return p.expectSwitchExpr(), + + .keyword_extern, + .keyword_packed, + => { + p.tok_i += 1; + return p.parseContainerDeclAuto(); + }, + + .keyword_struct, + .keyword_opaque, + .keyword_enum, + .keyword_union, + => return p.parseContainerDeclAuto(), + + .keyword_comptime => return p.addNode(.{ + .tag = .@"comptime", + .main_token = p.nextToken(), + .data = .{ + .lhs = try p.expectTypeExpr(), + .rhs = undefined, + }, + }), + .multiline_string_literal_line => { + const first_line = p.nextToken(); + while (p.token_tags[p.tok_i] == .multiline_string_literal_line) { + p.tok_i += 1; + } + return p.addNode(.{ + .tag = .multiline_string_literal, + .main_token = first_line, + .data = .{ + .lhs = first_line, + .rhs = p.tok_i - 1, + }, + }); + }, + .identifier => switch (p.token_tags[p.tok_i + 1]) { + .colon => switch (p.token_tags[p.tok_i + 2]) { + .keyword_inline => { + p.tok_i += 3; + switch (p.token_tags[p.tok_i]) { + .keyword_for => return p.parseForTypeExpr(), + .keyword_while => return p.parseWhileTypeExpr(), + else => return p.fail(.expected_inlinable), + } + }, + .keyword_for => { + p.tok_i += 2; + return p.parseForTypeExpr(); + }, + .keyword_while => { + p.tok_i += 2; + return p.parseWhileTypeExpr(); + }, + .l_brace => { + p.tok_i += 2; + return p.parseBlock(); + }, + else => return p.addNode(.{ + .tag = .identifier, + .main_token = p.nextToken(), + .data = .{ + .lhs = undefined, + .rhs = undefined, + }, + }), + }, + else => return p.addNode(.{ + .tag = .identifier, + .main_token = p.nextToken(), + .data = .{ + .lhs = undefined, + .rhs = undefined, + }, + }), + }, + .keyword_inline => { + p.tok_i += 1; + switch (p.token_tags[p.tok_i]) { + .keyword_for => return p.parseForTypeExpr(), + .keyword_while => return p.parseWhileTypeExpr(), + else => return p.fail(.expected_inlinable), + } + }, + .keyword_for => return p.parseForTypeExpr(), + .keyword_while => return p.parseWhileTypeExpr(), + .period => switch (p.token_tags[p.tok_i + 1]) { + .identifier => return p.addNode(.{ + .tag = .enum_literal, + .data = .{ + .lhs = p.nextToken(), // dot + .rhs = undefined, + }, + .main_token = p.nextToken(), // identifier + }), + .l_brace => { + const lbrace = p.tok_i + 1; + p.tok_i = lbrace + 1; + + // If there are 0, 1, or 2 items, we can use ArrayInitDotTwo/StructInitDotTwo; + // otherwise we use the full ArrayInitDot/StructInitDot. + + const scratch_top = p.scratch.items.len; + defer p.scratch.shrinkRetainingCapacity(scratch_top); + const field_init = try p.parseFieldInit(); + if (field_init != 0) { + try p.scratch.append(p.gpa, field_init); + while (true) { + switch (p.token_tags[p.tok_i]) { + .comma => p.tok_i += 1, + .r_brace => { + p.tok_i += 1; + break; + }, + .colon, .r_paren, .r_bracket => return p.failExpected(.r_brace), + // Likely just a missing comma; give error but continue parsing. + else => try p.warn(.expected_comma_after_initializer), + } + if (p.eatToken(.r_brace)) |_| break; + const next = try p.expectFieldInit(); + try p.scratch.append(p.gpa, next); + } + const comma = (p.token_tags[p.tok_i - 2] == .comma); + const inits = p.scratch.items[scratch_top..]; + switch (inits.len) { + 0 => unreachable, + 1 => return p.addNode(.{ + .tag = if (comma) .struct_init_dot_two_comma else .struct_init_dot_two, + .main_token = lbrace, + .data = .{ + .lhs = inits[0], + .rhs = 0, + }, + }), + 2 => return p.addNode(.{ + .tag = if (comma) .struct_init_dot_two_comma else .struct_init_dot_two, + .main_token = lbrace, + .data = .{ + .lhs = inits[0], + .rhs = inits[1], + }, + }), + else => { + const span = try p.listToSpan(inits); + return p.addNode(.{ + .tag = if (comma) .struct_init_dot_comma else .struct_init_dot, + .main_token = lbrace, + .data = .{ + .lhs = span.start, + .rhs = span.end, + }, + }); + }, + } + } + + while (true) { + if (p.eatToken(.r_brace)) |_| break; + const elem_init = try p.expectExpr(); + try p.scratch.append(p.gpa, elem_init); + switch (p.token_tags[p.tok_i]) { + .comma => p.tok_i += 1, + .r_brace => { + p.tok_i += 1; + break; + }, + .colon, .r_paren, .r_bracket => return p.failExpected(.r_brace), + // Likely just a missing comma; give error but continue parsing. + else => try p.warn(.expected_comma_after_initializer), + } + } + const comma = (p.token_tags[p.tok_i - 2] == .comma); + const inits = p.scratch.items[scratch_top..]; + switch (inits.len) { + 0 => return p.addNode(.{ + .tag = .struct_init_dot_two, + .main_token = lbrace, + .data = .{ + .lhs = 0, + .rhs = 0, + }, + }), + 1 => return p.addNode(.{ + .tag = if (comma) .array_init_dot_two_comma else .array_init_dot_two, + .main_token = lbrace, + .data = .{ + .lhs = inits[0], + .rhs = 0, + }, + }), + 2 => return p.addNode(.{ + .tag = if (comma) .array_init_dot_two_comma else .array_init_dot_two, + .main_token = lbrace, + .data = .{ + .lhs = inits[0], + .rhs = inits[1], + }, + }), + else => { + const span = try p.listToSpan(inits); + return p.addNode(.{ + .tag = if (comma) .array_init_dot_comma else .array_init_dot, + .main_token = lbrace, + .data = .{ + .lhs = span.start, + .rhs = span.end, + }, + }); + }, + } + }, + else => return null_node, + }, + .keyword_error => switch (p.token_tags[p.tok_i + 1]) { + .l_brace => { + const error_token = p.tok_i; + p.tok_i += 2; + while (true) { + if (p.eatToken(.r_brace)) |_| break; + _ = try p.eatDocComments(); + _ = try p.expectToken(.identifier); + switch (p.token_tags[p.tok_i]) { + .comma => p.tok_i += 1, + .r_brace => { + p.tok_i += 1; + break; + }, + .colon, .r_paren, .r_bracket => return p.failExpected(.r_brace), + // Likely just a missing comma; give error but continue parsing. + else => try p.warn(.expected_comma_after_field), + } + } + return p.addNode(.{ + .tag = .error_set_decl, + .main_token = error_token, + .data = .{ + .lhs = undefined, + .rhs = p.tok_i - 1, // rbrace + }, + }); + }, + else => { + const main_token = p.nextToken(); + const period = p.eatToken(.period); + if (period == null) try p.warnExpected(.period); + const identifier = p.eatToken(.identifier); + if (identifier == null) try p.warnExpected(.identifier); + return p.addNode(.{ + .tag = .error_value, + .main_token = main_token, + .data = .{ + .lhs = period orelse 0, + .rhs = identifier orelse 0, + }, + }); + }, + }, + .l_paren => return p.addNode(.{ + .tag = .grouped_expression, + .main_token = p.nextToken(), + .data = .{ + .lhs = try p.expectExpr(), + .rhs = try p.expectToken(.r_paren), + }, + }), + else => return null_node, + } +} + +fn expectPrimaryTypeExpr(p: *Parse) !Node.Index { + const node = try p.parsePrimaryTypeExpr(); + if (node == 0) { + return p.fail(.expected_primary_type_expr); + } + return node; +} + +/// ForPrefix <- KEYWORD_for LPAREN Expr RPAREN PtrIndexPayload +/// +/// ForTypeExpr <- ForPrefix TypeExpr (KEYWORD_else TypeExpr)? +fn parseForTypeExpr(p: *Parse) !Node.Index { + const for_token = p.eatToken(.keyword_for) orelse return null_node; + _ = try p.expectToken(.l_paren); + const array_expr = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + const found_payload = try p.parsePtrIndexPayload(); + if (found_payload == 0) try p.warn(.expected_loop_payload); + + const then_expr = try p.expectTypeExpr(); + _ = p.eatToken(.keyword_else) orelse { + return p.addNode(.{ + .tag = .for_simple, + .main_token = for_token, + .data = .{ + .lhs = array_expr, + .rhs = then_expr, + }, + }); + }; + const else_expr = try p.expectTypeExpr(); + return p.addNode(.{ + .tag = .@"for", + .main_token = for_token, + .data = .{ + .lhs = array_expr, + .rhs = try p.addExtra(Node.If{ + .then_expr = then_expr, + .else_expr = else_expr, + }), + }, + }); +} + +/// WhilePrefix <- KEYWORD_while LPAREN Expr RPAREN PtrPayload? WhileContinueExpr? +/// +/// WhileTypeExpr <- WhilePrefix TypeExpr (KEYWORD_else Payload? TypeExpr)? +fn parseWhileTypeExpr(p: *Parse) !Node.Index { + const while_token = p.eatToken(.keyword_while) orelse return null_node; + _ = try p.expectToken(.l_paren); + const condition = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + _ = try p.parsePtrPayload(); + const cont_expr = try p.parseWhileContinueExpr(); + + const then_expr = try p.expectTypeExpr(); + _ = p.eatToken(.keyword_else) orelse { + if (cont_expr == 0) { + return p.addNode(.{ + .tag = .while_simple, + .main_token = while_token, + .data = .{ + .lhs = condition, + .rhs = then_expr, + }, + }); + } else { + return p.addNode(.{ + .tag = .while_cont, + .main_token = while_token, + .data = .{ + .lhs = condition, + .rhs = try p.addExtra(Node.WhileCont{ + .cont_expr = cont_expr, + .then_expr = then_expr, + }), + }, + }); + } + }; + _ = try p.parsePayload(); + const else_expr = try p.expectTypeExpr(); + return p.addNode(.{ + .tag = .@"while", + .main_token = while_token, + .data = .{ + .lhs = condition, + .rhs = try p.addExtra(Node.While{ + .cont_expr = cont_expr, + .then_expr = then_expr, + .else_expr = else_expr, + }), + }, + }); +} + +/// SwitchExpr <- KEYWORD_switch LPAREN Expr RPAREN LBRACE SwitchProngList RBRACE +fn expectSwitchExpr(p: *Parse) !Node.Index { + const switch_token = p.assertToken(.keyword_switch); + _ = try p.expectToken(.l_paren); + const expr_node = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + _ = try p.expectToken(.l_brace); + const cases = try p.parseSwitchProngList(); + const trailing_comma = p.token_tags[p.tok_i - 1] == .comma; + _ = try p.expectToken(.r_brace); + + return p.addNode(.{ + .tag = if (trailing_comma) .switch_comma else .@"switch", + .main_token = switch_token, + .data = .{ + .lhs = expr_node, + .rhs = try p.addExtra(Node.SubRange{ + .start = cases.start, + .end = cases.end, + }), + }, + }); +} + +/// AsmExpr <- KEYWORD_asm KEYWORD_volatile? LPAREN Expr AsmOutput? RPAREN +/// +/// AsmOutput <- COLON AsmOutputList AsmInput? +/// +/// AsmInput <- COLON AsmInputList AsmClobbers? +/// +/// AsmClobbers <- COLON StringList +/// +/// StringList <- (STRINGLITERAL COMMA)* STRINGLITERAL? +/// +/// AsmOutputList <- (AsmOutputItem COMMA)* AsmOutputItem? +/// +/// AsmInputList <- (AsmInputItem COMMA)* AsmInputItem? +fn expectAsmExpr(p: *Parse) !Node.Index { + const asm_token = p.assertToken(.keyword_asm); + _ = p.eatToken(.keyword_volatile); + _ = try p.expectToken(.l_paren); + const template = try p.expectExpr(); + + if (p.eatToken(.r_paren)) |rparen| { + return p.addNode(.{ + .tag = .asm_simple, + .main_token = asm_token, + .data = .{ + .lhs = template, + .rhs = rparen, + }, + }); + } + + _ = try p.expectToken(.colon); + + const scratch_top = p.scratch.items.len; + defer p.scratch.shrinkRetainingCapacity(scratch_top); + + while (true) { + const output_item = try p.parseAsmOutputItem(); + if (output_item == 0) break; + try p.scratch.append(p.gpa, output_item); + switch (p.token_tags[p.tok_i]) { + .comma => p.tok_i += 1, + // All possible delimiters. + .colon, .r_paren, .r_brace, .r_bracket => break, + // Likely just a missing comma; give error but continue parsing. + else => try p.warnExpected(.comma), + } + } + if (p.eatToken(.colon)) |_| { + while (true) { + const input_item = try p.parseAsmInputItem(); + if (input_item == 0) break; + try p.scratch.append(p.gpa, input_item); + switch (p.token_tags[p.tok_i]) { + .comma => p.tok_i += 1, + // All possible delimiters. + .colon, .r_paren, .r_brace, .r_bracket => break, + // Likely just a missing comma; give error but continue parsing. + else => try p.warnExpected(.comma), + } + } + if (p.eatToken(.colon)) |_| { + while (p.eatToken(.string_literal)) |_| { + switch (p.token_tags[p.tok_i]) { + .comma => p.tok_i += 1, + .colon, .r_paren, .r_brace, .r_bracket => break, + // Likely just a missing comma; give error but continue parsing. + else => try p.warnExpected(.comma), + } + } + } + } + const rparen = try p.expectToken(.r_paren); + const span = try p.listToSpan(p.scratch.items[scratch_top..]); + return p.addNode(.{ + .tag = .@"asm", + .main_token = asm_token, + .data = .{ + .lhs = template, + .rhs = try p.addExtra(Node.Asm{ + .items_start = span.start, + .items_end = span.end, + .rparen = rparen, + }), + }, + }); +} + +/// AsmOutputItem <- LBRACKET IDENTIFIER RBRACKET STRINGLITERAL LPAREN (MINUSRARROW TypeExpr / IDENTIFIER) RPAREN +fn parseAsmOutputItem(p: *Parse) !Node.Index { + _ = p.eatToken(.l_bracket) orelse return null_node; + const identifier = try p.expectToken(.identifier); + _ = try p.expectToken(.r_bracket); + _ = try p.expectToken(.string_literal); + _ = try p.expectToken(.l_paren); + const type_expr: Node.Index = blk: { + if (p.eatToken(.arrow)) |_| { + break :blk try p.expectTypeExpr(); + } else { + _ = try p.expectToken(.identifier); + break :blk null_node; + } + }; + const rparen = try p.expectToken(.r_paren); + return p.addNode(.{ + .tag = .asm_output, + .main_token = identifier, + .data = .{ + .lhs = type_expr, + .rhs = rparen, + }, + }); +} + +/// AsmInputItem <- LBRACKET IDENTIFIER RBRACKET STRINGLITERAL LPAREN Expr RPAREN +fn parseAsmInputItem(p: *Parse) !Node.Index { + _ = p.eatToken(.l_bracket) orelse return null_node; + const identifier = try p.expectToken(.identifier); + _ = try p.expectToken(.r_bracket); + _ = try p.expectToken(.string_literal); + _ = try p.expectToken(.l_paren); + const expr = try p.expectExpr(); + const rparen = try p.expectToken(.r_paren); + return p.addNode(.{ + .tag = .asm_input, + .main_token = identifier, + .data = .{ + .lhs = expr, + .rhs = rparen, + }, + }); +} + +/// BreakLabel <- COLON IDENTIFIER +fn parseBreakLabel(p: *Parse) !TokenIndex { + _ = p.eatToken(.colon) orelse return @as(TokenIndex, 0); + return p.expectToken(.identifier); +} + +/// BlockLabel <- IDENTIFIER COLON +fn parseBlockLabel(p: *Parse) TokenIndex { + if (p.token_tags[p.tok_i] == .identifier and + p.token_tags[p.tok_i + 1] == .colon) + { + const identifier = p.tok_i; + p.tok_i += 2; + return identifier; + } + return null_node; +} + +/// FieldInit <- DOT IDENTIFIER EQUAL Expr +fn parseFieldInit(p: *Parse) !Node.Index { + if (p.token_tags[p.tok_i + 0] == .period and + p.token_tags[p.tok_i + 1] == .identifier and + p.token_tags[p.tok_i + 2] == .equal) + { + p.tok_i += 3; + return p.expectExpr(); + } else { + return null_node; + } +} + +fn expectFieldInit(p: *Parse) !Node.Index { + if (p.token_tags[p.tok_i] != .period or + p.token_tags[p.tok_i + 1] != .identifier or + p.token_tags[p.tok_i + 2] != .equal) + return p.fail(.expected_initializer); + + p.tok_i += 3; + return p.expectExpr(); +} + +/// WhileContinueExpr <- COLON LPAREN AssignExpr RPAREN +fn parseWhileContinueExpr(p: *Parse) !Node.Index { + _ = p.eatToken(.colon) orelse { + if (p.token_tags[p.tok_i] == .l_paren and + p.tokensOnSameLine(p.tok_i - 1, p.tok_i)) + return p.fail(.expected_continue_expr); + return null_node; + }; + _ = try p.expectToken(.l_paren); + const node = try p.parseAssignExpr(); + if (node == 0) return p.fail(.expected_expr_or_assignment); + _ = try p.expectToken(.r_paren); + return node; +} + +/// LinkSection <- KEYWORD_linksection LPAREN Expr RPAREN +fn parseLinkSection(p: *Parse) !Node.Index { + _ = p.eatToken(.keyword_linksection) orelse return null_node; + _ = try p.expectToken(.l_paren); + const expr_node = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + return expr_node; +} + +/// CallConv <- KEYWORD_callconv LPAREN Expr RPAREN +fn parseCallconv(p: *Parse) !Node.Index { + _ = p.eatToken(.keyword_callconv) orelse return null_node; + _ = try p.expectToken(.l_paren); + const expr_node = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + return expr_node; +} + +/// AddrSpace <- KEYWORD_addrspace LPAREN Expr RPAREN +fn parseAddrSpace(p: *Parse) !Node.Index { + _ = p.eatToken(.keyword_addrspace) orelse return null_node; + _ = try p.expectToken(.l_paren); + const expr_node = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + return expr_node; +} + +/// This function can return null nodes and then still return nodes afterwards, +/// such as in the case of anytype and `...`. Caller must look for rparen to find +/// out when there are no more param decls left. +/// +/// ParamDecl +/// <- doc_comment? (KEYWORD_noalias / KEYWORD_comptime)? (IDENTIFIER COLON)? ParamType +/// / DOT3 +/// +/// ParamType +/// <- KEYWORD_anytype +/// / TypeExpr +fn expectParamDecl(p: *Parse) !Node.Index { + _ = try p.eatDocComments(); + switch (p.token_tags[p.tok_i]) { + .keyword_noalias, .keyword_comptime => p.tok_i += 1, + .ellipsis3 => { + p.tok_i += 1; + return null_node; + }, + else => {}, + } + if (p.token_tags[p.tok_i] == .identifier and + p.token_tags[p.tok_i + 1] == .colon) + { + p.tok_i += 2; + } + switch (p.token_tags[p.tok_i]) { + .keyword_anytype => { + p.tok_i += 1; + return null_node; + }, + else => return p.expectTypeExpr(), + } +} + +/// Payload <- PIPE IDENTIFIER PIPE +fn parsePayload(p: *Parse) !TokenIndex { + _ = p.eatToken(.pipe) orelse return @as(TokenIndex, 0); + const identifier = try p.expectToken(.identifier); + _ = try p.expectToken(.pipe); + return identifier; +} + +/// PtrPayload <- PIPE ASTERISK? IDENTIFIER PIPE +fn parsePtrPayload(p: *Parse) !TokenIndex { + _ = p.eatToken(.pipe) orelse return @as(TokenIndex, 0); + _ = p.eatToken(.asterisk); + const identifier = try p.expectToken(.identifier); + _ = try p.expectToken(.pipe); + return identifier; +} + +/// Returns the first identifier token, if any. +/// +/// PtrIndexPayload <- PIPE ASTERISK? IDENTIFIER (COMMA IDENTIFIER)? PIPE +fn parsePtrIndexPayload(p: *Parse) !TokenIndex { + _ = p.eatToken(.pipe) orelse return @as(TokenIndex, 0); + _ = p.eatToken(.asterisk); + const identifier = try p.expectToken(.identifier); + if (p.eatToken(.comma) != null) { + _ = try p.expectToken(.identifier); + } + _ = try p.expectToken(.pipe); + return identifier; +} + +/// SwitchProng <- KEYWORD_inline? SwitchCase EQUALRARROW PtrIndexPayload? AssignExpr +/// +/// SwitchCase +/// <- SwitchItem (COMMA SwitchItem)* COMMA? +/// / KEYWORD_else +fn parseSwitchProng(p: *Parse) !Node.Index { + const scratch_top = p.scratch.items.len; + defer p.scratch.shrinkRetainingCapacity(scratch_top); + + const is_inline = p.eatToken(.keyword_inline) != null; + + if (p.eatToken(.keyword_else) == null) { + while (true) { + const item = try p.parseSwitchItem(); + if (item == 0) break; + try p.scratch.append(p.gpa, item); + if (p.eatToken(.comma) == null) break; + } + if (scratch_top == p.scratch.items.len) { + if (is_inline) p.tok_i -= 1; + return null_node; + } + } + const arrow_token = try p.expectToken(.equal_angle_bracket_right); + _ = try p.parsePtrIndexPayload(); + + const items = p.scratch.items[scratch_top..]; + switch (items.len) { + 0 => return p.addNode(.{ + .tag = if (is_inline) .switch_case_inline_one else .switch_case_one, + .main_token = arrow_token, + .data = .{ + .lhs = 0, + .rhs = try p.expectAssignExpr(), + }, + }), + 1 => return p.addNode(.{ + .tag = if (is_inline) .switch_case_inline_one else .switch_case_one, + .main_token = arrow_token, + .data = .{ + .lhs = items[0], + .rhs = try p.expectAssignExpr(), + }, + }), + else => return p.addNode(.{ + .tag = if (is_inline) .switch_case_inline else .switch_case, + .main_token = arrow_token, + .data = .{ + .lhs = try p.addExtra(try p.listToSpan(items)), + .rhs = try p.expectAssignExpr(), + }, + }), + } +} + +/// SwitchItem <- Expr (DOT3 Expr)? +fn parseSwitchItem(p: *Parse) !Node.Index { + const expr = try p.parseExpr(); + if (expr == 0) return null_node; + + if (p.eatToken(.ellipsis3)) |token| { + return p.addNode(.{ + .tag = .switch_range, + .main_token = token, + .data = .{ + .lhs = expr, + .rhs = try p.expectExpr(), + }, + }); + } + return expr; +} + +const PtrModifiers = struct { + align_node: Node.Index, + addrspace_node: Node.Index, + bit_range_start: Node.Index, + bit_range_end: Node.Index, +}; + +fn parsePtrModifiers(p: *Parse) !PtrModifiers { + var result: PtrModifiers = .{ + .align_node = 0, + .addrspace_node = 0, + .bit_range_start = 0, + .bit_range_end = 0, + }; + var saw_const = false; + var saw_volatile = false; + var saw_allowzero = false; + var saw_addrspace = false; + while (true) { + switch (p.token_tags[p.tok_i]) { + .keyword_align => { + if (result.align_node != 0) { + try p.warn(.extra_align_qualifier); + } + p.tok_i += 1; + _ = try p.expectToken(.l_paren); + result.align_node = try p.expectExpr(); + + if (p.eatToken(.colon)) |_| { + result.bit_range_start = try p.expectExpr(); + _ = try p.expectToken(.colon); + result.bit_range_end = try p.expectExpr(); + } + + _ = try p.expectToken(.r_paren); + }, + .keyword_const => { + if (saw_const) { + try p.warn(.extra_const_qualifier); + } + p.tok_i += 1; + saw_const = true; + }, + .keyword_volatile => { + if (saw_volatile) { + try p.warn(.extra_volatile_qualifier); + } + p.tok_i += 1; + saw_volatile = true; + }, + .keyword_allowzero => { + if (saw_allowzero) { + try p.warn(.extra_allowzero_qualifier); + } + p.tok_i += 1; + saw_allowzero = true; + }, + .keyword_addrspace => { + if (saw_addrspace) { + try p.warn(.extra_addrspace_qualifier); + } + result.addrspace_node = try p.parseAddrSpace(); + }, + else => return result, + } + } +} + +/// SuffixOp +/// <- LBRACKET Expr (DOT2 (Expr? (COLON Expr)?)?)? RBRACKET +/// / DOT IDENTIFIER +/// / DOTASTERISK +/// / DOTQUESTIONMARK +fn parseSuffixOp(p: *Parse, lhs: Node.Index) !Node.Index { + switch (p.token_tags[p.tok_i]) { + .l_bracket => { + const lbracket = p.nextToken(); + const index_expr = try p.expectExpr(); + + if (p.eatToken(.ellipsis2)) |_| { + const end_expr = try p.parseExpr(); + if (p.eatToken(.colon)) |_| { + const sentinel = try p.expectExpr(); + _ = try p.expectToken(.r_bracket); + return p.addNode(.{ + .tag = .slice_sentinel, + .main_token = lbracket, + .data = .{ + .lhs = lhs, + .rhs = try p.addExtra(Node.SliceSentinel{ + .start = index_expr, + .end = end_expr, + .sentinel = sentinel, + }), + }, + }); + } + _ = try p.expectToken(.r_bracket); + if (end_expr == 0) { + return p.addNode(.{ + .tag = .slice_open, + .main_token = lbracket, + .data = .{ + .lhs = lhs, + .rhs = index_expr, + }, + }); + } + return p.addNode(.{ + .tag = .slice, + .main_token = lbracket, + .data = .{ + .lhs = lhs, + .rhs = try p.addExtra(Node.Slice{ + .start = index_expr, + .end = end_expr, + }), + }, + }); + } + _ = try p.expectToken(.r_bracket); + return p.addNode(.{ + .tag = .array_access, + .main_token = lbracket, + .data = .{ + .lhs = lhs, + .rhs = index_expr, + }, + }); + }, + .period_asterisk => return p.addNode(.{ + .tag = .deref, + .main_token = p.nextToken(), + .data = .{ + .lhs = lhs, + .rhs = undefined, + }, + }), + .invalid_periodasterisks => { + try p.warn(.asterisk_after_ptr_deref); + return p.addNode(.{ + .tag = .deref, + .main_token = p.nextToken(), + .data = .{ + .lhs = lhs, + .rhs = undefined, + }, + }); + }, + .period => switch (p.token_tags[p.tok_i + 1]) { + .identifier => return p.addNode(.{ + .tag = .field_access, + .main_token = p.nextToken(), + .data = .{ + .lhs = lhs, + .rhs = p.nextToken(), + }, + }), + .question_mark => return p.addNode(.{ + .tag = .unwrap_optional, + .main_token = p.nextToken(), + .data = .{ + .lhs = lhs, + .rhs = p.nextToken(), + }, + }), + .l_brace => { + // this a misplaced `.{`, handle the error somewhere else + return null_node; + }, + else => { + p.tok_i += 1; + try p.warn(.expected_suffix_op); + return null_node; + }, + }, + else => return null_node, + } +} + +/// Caller must have already verified the first token. +/// +/// ContainerDeclAuto <- ContainerDeclType LBRACE container_doc_comment? ContainerMembers RBRACE +/// +/// ContainerDeclType +/// <- KEYWORD_struct (LPAREN Expr RPAREN)? +/// / KEYWORD_opaque +/// / KEYWORD_enum (LPAREN Expr RPAREN)? +/// / KEYWORD_union (LPAREN (KEYWORD_enum (LPAREN Expr RPAREN)? / Expr) RPAREN)? +fn parseContainerDeclAuto(p: *Parse) !Node.Index { + const main_token = p.nextToken(); + const arg_expr = switch (p.token_tags[main_token]) { + .keyword_opaque => null_node, + .keyword_struct, .keyword_enum => blk: { + if (p.eatToken(.l_paren)) |_| { + const expr = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + break :blk expr; + } else { + break :blk null_node; + } + }, + .keyword_union => blk: { + if (p.eatToken(.l_paren)) |_| { + if (p.eatToken(.keyword_enum)) |_| { + if (p.eatToken(.l_paren)) |_| { + const enum_tag_expr = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + _ = try p.expectToken(.r_paren); + + _ = try p.expectToken(.l_brace); + const members = try p.parseContainerMembers(); + const members_span = try members.toSpan(p); + _ = try p.expectToken(.r_brace); + return p.addNode(.{ + .tag = switch (members.trailing) { + true => .tagged_union_enum_tag_trailing, + false => .tagged_union_enum_tag, + }, + .main_token = main_token, + .data = .{ + .lhs = enum_tag_expr, + .rhs = try p.addExtra(members_span), + }, + }); + } else { + _ = try p.expectToken(.r_paren); + + _ = try p.expectToken(.l_brace); + const members = try p.parseContainerMembers(); + _ = try p.expectToken(.r_brace); + if (members.len <= 2) { + return p.addNode(.{ + .tag = switch (members.trailing) { + true => .tagged_union_two_trailing, + false => .tagged_union_two, + }, + .main_token = main_token, + .data = .{ + .lhs = members.lhs, + .rhs = members.rhs, + }, + }); + } else { + const span = try members.toSpan(p); + return p.addNode(.{ + .tag = switch (members.trailing) { + true => .tagged_union_trailing, + false => .tagged_union, + }, + .main_token = main_token, + .data = .{ + .lhs = span.start, + .rhs = span.end, + }, + }); + } + } + } else { + const expr = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + break :blk expr; + } + } else { + break :blk null_node; + } + }, + else => { + p.tok_i -= 1; + return p.fail(.expected_container); + }, + }; + _ = try p.expectToken(.l_brace); + const members = try p.parseContainerMembers(); + _ = try p.expectToken(.r_brace); + if (arg_expr == 0) { + if (members.len <= 2) { + return p.addNode(.{ + .tag = switch (members.trailing) { + true => .container_decl_two_trailing, + false => .container_decl_two, + }, + .main_token = main_token, + .data = .{ + .lhs = members.lhs, + .rhs = members.rhs, + }, + }); + } else { + const span = try members.toSpan(p); + return p.addNode(.{ + .tag = switch (members.trailing) { + true => .container_decl_trailing, + false => .container_decl, + }, + .main_token = main_token, + .data = .{ + .lhs = span.start, + .rhs = span.end, + }, + }); + } + } else { + const span = try members.toSpan(p); + return p.addNode(.{ + .tag = switch (members.trailing) { + true => .container_decl_arg_trailing, + false => .container_decl_arg, + }, + .main_token = main_token, + .data = .{ + .lhs = arg_expr, + .rhs = try p.addExtra(Node.SubRange{ + .start = span.start, + .end = span.end, + }), + }, + }); + } +} + +/// Give a helpful error message for those transitioning from +/// C's 'struct Foo {};' to Zig's 'const Foo = struct {};'. +fn parseCStyleContainer(p: *Parse) Error!bool { + const main_token = p.tok_i; + switch (p.token_tags[p.tok_i]) { + .keyword_enum, .keyword_union, .keyword_struct => {}, + else => return false, + } + const identifier = p.tok_i + 1; + if (p.token_tags[identifier] != .identifier) return false; + p.tok_i += 2; + + try p.warnMsg(.{ + .tag = .c_style_container, + .token = identifier, + .extra = .{ .expected_tag = p.token_tags[main_token] }, + }); + try p.warnMsg(.{ + .tag = .zig_style_container, + .is_note = true, + .token = identifier, + .extra = .{ .expected_tag = p.token_tags[main_token] }, + }); + + _ = try p.expectToken(.l_brace); + _ = try p.parseContainerMembers(); + _ = try p.expectToken(.r_brace); + try p.expectSemicolon(.expected_semi_after_decl, true); + return true; +} + +/// Holds temporary data until we are ready to construct the full ContainerDecl AST node. +/// +/// ByteAlign <- KEYWORD_align LPAREN Expr RPAREN +fn parseByteAlign(p: *Parse) !Node.Index { + _ = p.eatToken(.keyword_align) orelse return null_node; + _ = try p.expectToken(.l_paren); + const expr = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + return expr; +} + +/// SwitchProngList <- (SwitchProng COMMA)* SwitchProng? +fn parseSwitchProngList(p: *Parse) !Node.SubRange { + const scratch_top = p.scratch.items.len; + defer p.scratch.shrinkRetainingCapacity(scratch_top); + + while (true) { + const item = try parseSwitchProng(p); + if (item == 0) break; + + try p.scratch.append(p.gpa, item); + + switch (p.token_tags[p.tok_i]) { + .comma => p.tok_i += 1, + // All possible delimiters. + .colon, .r_paren, .r_brace, .r_bracket => break, + // Likely just a missing comma; give error but continue parsing. + else => try p.warn(.expected_comma_after_switch_prong), + } + } + return p.listToSpan(p.scratch.items[scratch_top..]); +} + +/// ParamDeclList <- (ParamDecl COMMA)* ParamDecl? +fn parseParamDeclList(p: *Parse) !SmallSpan { + _ = try p.expectToken(.l_paren); + const scratch_top = p.scratch.items.len; + defer p.scratch.shrinkRetainingCapacity(scratch_top); + var varargs: union(enum) { none, seen, nonfinal: TokenIndex } = .none; + while (true) { + if (p.eatToken(.r_paren)) |_| break; + if (varargs == .seen) varargs = .{ .nonfinal = p.tok_i }; + const param = try p.expectParamDecl(); + if (param != 0) { + try p.scratch.append(p.gpa, param); + } else if (p.token_tags[p.tok_i - 1] == .ellipsis3) { + if (varargs == .none) varargs = .seen; + } + switch (p.token_tags[p.tok_i]) { + .comma => p.tok_i += 1, + .r_paren => { + p.tok_i += 1; + break; + }, + .colon, .r_brace, .r_bracket => return p.failExpected(.r_paren), + // Likely just a missing comma; give error but continue parsing. + else => try p.warn(.expected_comma_after_param), + } + } + if (varargs == .nonfinal) { + try p.warnMsg(.{ .tag = .varargs_nonfinal, .token = varargs.nonfinal }); + } + const params = p.scratch.items[scratch_top..]; + return switch (params.len) { + 0 => SmallSpan{ .zero_or_one = 0 }, + 1 => SmallSpan{ .zero_or_one = params[0] }, + else => SmallSpan{ .multi = try p.listToSpan(params) }, + }; +} + +/// FnCallArguments <- LPAREN ExprList RPAREN +/// +/// ExprList <- (Expr COMMA)* Expr? +fn parseBuiltinCall(p: *Parse) !Node.Index { + const builtin_token = p.assertToken(.builtin); + if (p.token_tags[p.nextToken()] != .l_paren) { + p.tok_i -= 1; + try p.warn(.expected_param_list); + // Pretend this was an identifier so we can continue parsing. + return p.addNode(.{ + .tag = .identifier, + .main_token = builtin_token, + .data = .{ + .lhs = undefined, + .rhs = undefined, + }, + }); + } + const scratch_top = p.scratch.items.len; + defer p.scratch.shrinkRetainingCapacity(scratch_top); + while (true) { + if (p.eatToken(.r_paren)) |_| break; + const param = try p.expectExpr(); + try p.scratch.append(p.gpa, param); + switch (p.token_tags[p.tok_i]) { + .comma => p.tok_i += 1, + .r_paren => { + p.tok_i += 1; + break; + }, + // Likely just a missing comma; give error but continue parsing. + else => try p.warn(.expected_comma_after_arg), + } + } + const comma = (p.token_tags[p.tok_i - 2] == .comma); + const params = p.scratch.items[scratch_top..]; + switch (params.len) { + 0 => return p.addNode(.{ + .tag = .builtin_call_two, + .main_token = builtin_token, + .data = .{ + .lhs = 0, + .rhs = 0, + }, + }), + 1 => return p.addNode(.{ + .tag = if (comma) .builtin_call_two_comma else .builtin_call_two, + .main_token = builtin_token, + .data = .{ + .lhs = params[0], + .rhs = 0, + }, + }), + 2 => return p.addNode(.{ + .tag = if (comma) .builtin_call_two_comma else .builtin_call_two, + .main_token = builtin_token, + .data = .{ + .lhs = params[0], + .rhs = params[1], + }, + }), + else => { + const span = try p.listToSpan(params); + return p.addNode(.{ + .tag = if (comma) .builtin_call_comma else .builtin_call, + .main_token = builtin_token, + .data = .{ + .lhs = span.start, + .rhs = span.end, + }, + }); + }, + } +} + +/// IfPrefix <- KEYWORD_if LPAREN Expr RPAREN PtrPayload? +fn parseIf(p: *Parse, comptime bodyParseFn: fn (p: *Parse) Error!Node.Index) !Node.Index { + const if_token = p.eatToken(.keyword_if) orelse return null_node; + _ = try p.expectToken(.l_paren); + const condition = try p.expectExpr(); + _ = try p.expectToken(.r_paren); + _ = try p.parsePtrPayload(); + + const then_expr = try bodyParseFn(p); + assert(then_expr != 0); + + _ = p.eatToken(.keyword_else) orelse return p.addNode(.{ + .tag = .if_simple, + .main_token = if_token, + .data = .{ + .lhs = condition, + .rhs = then_expr, + }, + }); + _ = try p.parsePayload(); + const else_expr = try bodyParseFn(p); + assert(then_expr != 0); + + return p.addNode(.{ + .tag = .@"if", + .main_token = if_token, + .data = .{ + .lhs = condition, + .rhs = try p.addExtra(Node.If{ + .then_expr = then_expr, + .else_expr = else_expr, + }), + }, + }); +} + +/// Skips over doc comment tokens. Returns the first one, if any. +fn eatDocComments(p: *Parse) !?TokenIndex { + if (p.eatToken(.doc_comment)) |tok| { + var first_line = tok; + if (tok > 0 and tokensOnSameLine(p, tok - 1, tok)) { + try p.warnMsg(.{ + .tag = .same_line_doc_comment, + .token = tok, + }); + first_line = p.eatToken(.doc_comment) orelse return null; + } + while (p.eatToken(.doc_comment)) |_| {} + return first_line; + } + return null; +} + +fn tokensOnSameLine(p: *Parse, token1: TokenIndex, token2: TokenIndex) bool { + return std.mem.indexOfScalar(u8, p.source[p.token_starts[token1]..p.token_starts[token2]], '\n') == null; +} + +fn eatToken(p: *Parse, tag: Token.Tag) ?TokenIndex { + return if (p.token_tags[p.tok_i] == tag) p.nextToken() else null; +} + +fn assertToken(p: *Parse, tag: Token.Tag) TokenIndex { + const token = p.nextToken(); + assert(p.token_tags[token] == tag); + return token; +} + +fn expectToken(p: *Parse, tag: Token.Tag) Error!TokenIndex { + if (p.token_tags[p.tok_i] != tag) { + return p.failMsg(.{ + .tag = .expected_token, + .token = p.tok_i, + .extra = .{ .expected_tag = tag }, + }); + } + return p.nextToken(); +} + +fn expectSemicolon(p: *Parse, error_tag: AstError.Tag, recoverable: bool) Error!void { + if (p.token_tags[p.tok_i] == .semicolon) { + _ = p.nextToken(); + return; + } + try p.warn(error_tag); + if (!recoverable) return error.ParseError; +} + +fn nextToken(p: *Parse) TokenIndex { + const result = p.tok_i; + p.tok_i += 1; + return result; +} + +const null_node: Node.Index = 0; + +const Parse = @This(); +const std = @import("../std.zig"); +const assert = std.debug.assert; +const Allocator = std.mem.Allocator; +const Ast = std.zig.Ast; +const Node = Ast.Node; +const AstError = Ast.Error; +const TokenIndex = Ast.TokenIndex; +const Token = std.zig.Token; + +test { + _ = @import("parser_test.zig"); +} diff --git a/lib/std/zig/parse.zig b/lib/std/zig/parse.zig deleted file mode 100644 index fdb122b19d..0000000000 --- a/lib/std/zig/parse.zig +++ /dev/null @@ -1,3852 +0,0 @@ -const std = @import("../std.zig"); -const assert = std.debug.assert; -const Allocator = std.mem.Allocator; -const Ast = std.zig.Ast; -const Node = Ast.Node; -const AstError = Ast.Error; -const TokenIndex = Ast.TokenIndex; -const Token = std.zig.Token; - -pub const Error = error{ParseError} || Allocator.Error; - -/// Result should be freed with tree.deinit() when there are -/// no more references to any of the tokens or nodes. -pub fn parse(gpa: Allocator, source: [:0]const u8) Allocator.Error!Ast { - var tokens = Ast.TokenList{}; - defer tokens.deinit(gpa); - - // Empirically, the zig std lib has an 8:1 ratio of source bytes to token count. - const estimated_token_count = source.len / 8; - try tokens.ensureTotalCapacity(gpa, estimated_token_count); - - var tokenizer = std.zig.Tokenizer.init(source); - while (true) { - const token = tokenizer.next(); - try tokens.append(gpa, .{ - .tag = token.tag, - .start = @intCast(u32, token.loc.start), - }); - if (token.tag == .eof) break; - } - - var parser: Parser = .{ - .source = source, - .gpa = gpa, - .token_tags = tokens.items(.tag), - .token_starts = tokens.items(.start), - .errors = .{}, - .nodes = .{}, - .extra_data = .{}, - .scratch = .{}, - .tok_i = 0, - }; - defer parser.errors.deinit(gpa); - defer parser.nodes.deinit(gpa); - defer parser.extra_data.deinit(gpa); - defer parser.scratch.deinit(gpa); - - // Empirically, Zig source code has a 2:1 ratio of tokens to AST nodes. - // Make sure at least 1 so we can use appendAssumeCapacity on the root node below. - const estimated_node_count = (tokens.len + 2) / 2; - try parser.nodes.ensureTotalCapacity(gpa, estimated_node_count); - - try parser.parseRoot(); - - // TODO experiment with compacting the MultiArrayList slices here - return Ast{ - .source = source, - .tokens = tokens.toOwnedSlice(), - .nodes = parser.nodes.toOwnedSlice(), - .extra_data = try parser.extra_data.toOwnedSlice(gpa), - .errors = try parser.errors.toOwnedSlice(gpa), - }; -} - -const null_node: Node.Index = 0; - -/// Represents in-progress parsing, will be converted to an Ast after completion. -const Parser = struct { - gpa: Allocator, - source: []const u8, - token_tags: []const Token.Tag, - token_starts: []const Ast.ByteOffset, - tok_i: TokenIndex, - errors: std.ArrayListUnmanaged(AstError), - nodes: Ast.NodeList, - extra_data: std.ArrayListUnmanaged(Node.Index), - scratch: std.ArrayListUnmanaged(Node.Index), - - const SmallSpan = union(enum) { - zero_or_one: Node.Index, - multi: Node.SubRange, - }; - - const Members = struct { - len: usize, - lhs: Node.Index, - rhs: Node.Index, - trailing: bool, - - fn toSpan(self: Members, p: *Parser) !Node.SubRange { - if (self.len <= 2) { - const nodes = [2]Node.Index{ self.lhs, self.rhs }; - return p.listToSpan(nodes[0..self.len]); - } else { - return Node.SubRange{ .start = self.lhs, .end = self.rhs }; - } - } - }; - - fn listToSpan(p: *Parser, list: []const Node.Index) !Node.SubRange { - try p.extra_data.appendSlice(p.gpa, list); - return Node.SubRange{ - .start = @intCast(Node.Index, p.extra_data.items.len - list.len), - .end = @intCast(Node.Index, p.extra_data.items.len), - }; - } - - fn addNode(p: *Parser, elem: Ast.NodeList.Elem) Allocator.Error!Node.Index { - const result = @intCast(Node.Index, p.nodes.len); - try p.nodes.append(p.gpa, elem); - return result; - } - - fn setNode(p: *Parser, i: usize, elem: Ast.NodeList.Elem) Node.Index { - p.nodes.set(i, elem); - return @intCast(Node.Index, i); - } - - fn reserveNode(p: *Parser, tag: Ast.Node.Tag) !usize { - try p.nodes.resize(p.gpa, p.nodes.len + 1); - p.nodes.items(.tag)[p.nodes.len - 1] = tag; - return p.nodes.len - 1; - } - - fn unreserveNode(p: *Parser, node_index: usize) void { - if (p.nodes.len == node_index) { - p.nodes.resize(p.gpa, p.nodes.len - 1) catch unreachable; - } else { - // There is zombie node left in the tree, let's make it as inoffensive as possible - // (sadly there's no no-op node) - p.nodes.items(.tag)[node_index] = .unreachable_literal; - p.nodes.items(.main_token)[node_index] = p.tok_i; - } - } - - fn addExtra(p: *Parser, extra: anytype) Allocator.Error!Node.Index { - const fields = std.meta.fields(@TypeOf(extra)); - try p.extra_data.ensureUnusedCapacity(p.gpa, fields.len); - const result = @intCast(u32, p.extra_data.items.len); - inline for (fields) |field| { - comptime assert(field.type == Node.Index); - p.extra_data.appendAssumeCapacity(@field(extra, field.name)); - } - return result; - } - - fn warnExpected(p: *Parser, expected_token: Token.Tag) error{OutOfMemory}!void { - @setCold(true); - try p.warnMsg(.{ - .tag = .expected_token, - .token = p.tok_i, - .extra = .{ .expected_tag = expected_token }, - }); - } - - fn warn(p: *Parser, error_tag: AstError.Tag) error{OutOfMemory}!void { - @setCold(true); - try p.warnMsg(.{ .tag = error_tag, .token = p.tok_i }); - } - - fn warnMsg(p: *Parser, msg: Ast.Error) error{OutOfMemory}!void { - @setCold(true); - switch (msg.tag) { - .expected_semi_after_decl, - .expected_semi_after_stmt, - .expected_comma_after_field, - .expected_comma_after_arg, - .expected_comma_after_param, - .expected_comma_after_initializer, - .expected_comma_after_switch_prong, - .expected_semi_or_else, - .expected_semi_or_lbrace, - .expected_token, - .expected_block, - .expected_block_or_assignment, - .expected_block_or_expr, - .expected_block_or_field, - .expected_expr, - .expected_expr_or_assignment, - .expected_fn, - .expected_inlinable, - .expected_labelable, - .expected_param_list, - .expected_prefix_expr, - .expected_primary_type_expr, - .expected_pub_item, - .expected_return_type, - .expected_suffix_op, - .expected_type_expr, - .expected_var_decl, - .expected_var_decl_or_fn, - .expected_loop_payload, - .expected_container, - => if (msg.token != 0 and !p.tokensOnSameLine(msg.token - 1, msg.token)) { - var copy = msg; - copy.token_is_prev = true; - copy.token -= 1; - return p.errors.append(p.gpa, copy); - }, - else => {}, - } - try p.errors.append(p.gpa, msg); - } - - fn fail(p: *Parser, tag: Ast.Error.Tag) error{ ParseError, OutOfMemory } { - @setCold(true); - return p.failMsg(.{ .tag = tag, .token = p.tok_i }); - } - - fn failExpected(p: *Parser, expected_token: Token.Tag) error{ ParseError, OutOfMemory } { - @setCold(true); - return p.failMsg(.{ - .tag = .expected_token, - .token = p.tok_i, - .extra = .{ .expected_tag = expected_token }, - }); - } - - fn failMsg(p: *Parser, msg: Ast.Error) error{ ParseError, OutOfMemory } { - @setCold(true); - try p.warnMsg(msg); - return error.ParseError; - } - - /// Root <- skip container_doc_comment? ContainerMembers eof - fn parseRoot(p: *Parser) !void { - // Root node must be index 0. - p.nodes.appendAssumeCapacity(.{ - .tag = .root, - .main_token = 0, - .data = undefined, - }); - const root_members = try p.parseContainerMembers(); - const root_decls = try root_members.toSpan(p); - if (p.token_tags[p.tok_i] != .eof) { - try p.warnExpected(.eof); - } - p.nodes.items(.data)[0] = .{ - .lhs = root_decls.start, - .rhs = root_decls.end, - }; - } - - /// ContainerMembers <- ContainerDeclarations (ContainerField COMMA)* (ContainerField / ContainerDeclarations) - /// - /// ContainerDeclarations - /// <- TestDecl ContainerDeclarations - /// / ComptimeDecl ContainerDeclarations - /// / doc_comment? KEYWORD_pub? Decl ContainerDeclarations - /// / - /// - /// ComptimeDecl <- KEYWORD_comptime Block - fn parseContainerMembers(p: *Parser) !Members { - const scratch_top = p.scratch.items.len; - defer p.scratch.shrinkRetainingCapacity(scratch_top); - - var field_state: union(enum) { - /// No fields have been seen. - none, - /// Currently parsing fields. - seen, - /// Saw fields and then a declaration after them. - /// Payload is first token of previous declaration. - end: Node.Index, - /// There was a declaration between fields, don't report more errors. - err, - } = .none; - - var last_field: TokenIndex = undefined; - - // Skip container doc comments. - while (p.eatToken(.container_doc_comment)) |_| {} - - var trailing = false; - while (true) { - const doc_comment = try p.eatDocComments(); - - switch (p.token_tags[p.tok_i]) { - .keyword_test => { - if (doc_comment) |some| { - try p.warnMsg(.{ .tag = .test_doc_comment, .token = some }); - } - const test_decl_node = try p.expectTestDeclRecoverable(); - if (test_decl_node != 0) { - if (field_state == .seen) { - field_state = .{ .end = test_decl_node }; - } - try p.scratch.append(p.gpa, test_decl_node); - } - trailing = false; - }, - .keyword_comptime => switch (p.token_tags[p.tok_i + 1]) { - .l_brace => { - if (doc_comment) |some| { - try p.warnMsg(.{ .tag = .comptime_doc_comment, .token = some }); - } - const comptime_token = p.nextToken(); - const block = p.parseBlock() catch |err| switch (err) { - error.OutOfMemory => return error.OutOfMemory, - error.ParseError => blk: { - p.findNextContainerMember(); - break :blk null_node; - }, - }; - if (block != 0) { - const comptime_node = try p.addNode(.{ - .tag = .@"comptime", - .main_token = comptime_token, - .data = .{ - .lhs = block, - .rhs = undefined, - }, - }); - if (field_state == .seen) { - field_state = .{ .end = comptime_node }; - } - try p.scratch.append(p.gpa, comptime_node); - } - trailing = false; - }, - else => { - const identifier = p.tok_i; - defer last_field = identifier; - const container_field = p.expectContainerField() catch |err| switch (err) { - error.OutOfMemory => return error.OutOfMemory, - error.ParseError => { - p.findNextContainerMember(); - continue; - }, - }; - switch (field_state) { - .none => field_state = .seen, - .err, .seen => {}, - .end => |node| { - try p.warnMsg(.{ - .tag = .decl_between_fields, - .token = p.nodes.items(.main_token)[node], - }); - try p.warnMsg(.{ - .tag = .previous_field, - .is_note = true, - .token = last_field, - }); - try p.warnMsg(.{ - .tag = .next_field, - .is_note = true, - .token = identifier, - }); - // Continue parsing; error will be reported later. - field_state = .err; - }, - } - try p.scratch.append(p.gpa, container_field); - switch (p.token_tags[p.tok_i]) { - .comma => { - p.tok_i += 1; - trailing = true; - continue; - }, - .r_brace, .eof => { - trailing = false; - break; - }, - else => {}, - } - // There is not allowed to be a decl after a field with no comma. - // Report error but recover parser. - try p.warn(.expected_comma_after_field); - p.findNextContainerMember(); - }, - }, - .keyword_pub => { - p.tok_i += 1; - const top_level_decl = try p.expectTopLevelDeclRecoverable(); - if (top_level_decl != 0) { - if (field_state == .seen) { - field_state = .{ .end = top_level_decl }; - } - try p.scratch.append(p.gpa, top_level_decl); - } - trailing = p.token_tags[p.tok_i - 1] == .semicolon; - }, - .keyword_usingnamespace => { - const node = try p.expectUsingNamespaceRecoverable(); - if (node != 0) { - if (field_state == .seen) { - field_state = .{ .end = node }; - } - try p.scratch.append(p.gpa, node); - } - trailing = p.token_tags[p.tok_i - 1] == .semicolon; - }, - .keyword_const, - .keyword_var, - .keyword_threadlocal, - .keyword_export, - .keyword_extern, - .keyword_inline, - .keyword_noinline, - .keyword_fn, - => { - const top_level_decl = try p.expectTopLevelDeclRecoverable(); - if (top_level_decl != 0) { - if (field_state == .seen) { - field_state = .{ .end = top_level_decl }; - } - try p.scratch.append(p.gpa, top_level_decl); - } - trailing = p.token_tags[p.tok_i - 1] == .semicolon; - }, - .eof, .r_brace => { - if (doc_comment) |tok| { - try p.warnMsg(.{ - .tag = .unattached_doc_comment, - .token = tok, - }); - } - break; - }, - else => { - const c_container = p.parseCStyleContainer() catch |err| switch (err) { - error.OutOfMemory => return error.OutOfMemory, - error.ParseError => false, - }; - if (c_container) continue; - - const identifier = p.tok_i; - defer last_field = identifier; - const container_field = p.expectContainerField() catch |err| switch (err) { - error.OutOfMemory => return error.OutOfMemory, - error.ParseError => { - p.findNextContainerMember(); - continue; - }, - }; - switch (field_state) { - .none => field_state = .seen, - .err, .seen => {}, - .end => |node| { - try p.warnMsg(.{ - .tag = .decl_between_fields, - .token = p.nodes.items(.main_token)[node], - }); - try p.warnMsg(.{ - .tag = .previous_field, - .is_note = true, - .token = last_field, - }); - try p.warnMsg(.{ - .tag = .next_field, - .is_note = true, - .token = identifier, - }); - // Continue parsing; error will be reported later. - field_state = .err; - }, - } - try p.scratch.append(p.gpa, container_field); - switch (p.token_tags[p.tok_i]) { - .comma => { - p.tok_i += 1; - trailing = true; - continue; - }, - .r_brace, .eof => { - trailing = false; - break; - }, - else => {}, - } - // There is not allowed to be a decl after a field with no comma. - // Report error but recover parser. - try p.warn(.expected_comma_after_field); - if (p.token_tags[p.tok_i] == .semicolon and p.token_tags[identifier] == .identifier) { - try p.warnMsg(.{ - .tag = .var_const_decl, - .is_note = true, - .token = identifier, - }); - } - p.findNextContainerMember(); - continue; - }, - } - } - - const items = p.scratch.items[scratch_top..]; - switch (items.len) { - 0 => return Members{ - .len = 0, - .lhs = 0, - .rhs = 0, - .trailing = trailing, - }, - 1 => return Members{ - .len = 1, - .lhs = items[0], - .rhs = 0, - .trailing = trailing, - }, - 2 => return Members{ - .len = 2, - .lhs = items[0], - .rhs = items[1], - .trailing = trailing, - }, - else => { - const span = try p.listToSpan(items); - return Members{ - .len = items.len, - .lhs = span.start, - .rhs = span.end, - .trailing = trailing, - }; - }, - } - } - - /// Attempts to find next container member by searching for certain tokens - fn findNextContainerMember(p: *Parser) void { - var level: u32 = 0; - while (true) { - const tok = p.nextToken(); - switch (p.token_tags[tok]) { - // Any of these can start a new top level declaration. - .keyword_test, - .keyword_comptime, - .keyword_pub, - .keyword_export, - .keyword_extern, - .keyword_inline, - .keyword_noinline, - .keyword_usingnamespace, - .keyword_threadlocal, - .keyword_const, - .keyword_var, - .keyword_fn, - => { - if (level == 0) { - p.tok_i -= 1; - return; - } - }, - .identifier => { - if (p.token_tags[tok + 1] == .comma and level == 0) { - p.tok_i -= 1; - return; - } - }, - .comma, .semicolon => { - // this decl was likely meant to end here - if (level == 0) { - return; - } - }, - .l_paren, .l_bracket, .l_brace => level += 1, - .r_paren, .r_bracket => { - if (level != 0) level -= 1; - }, - .r_brace => { - if (level == 0) { - // end of container, exit - p.tok_i -= 1; - return; - } - level -= 1; - }, - .eof => { - p.tok_i -= 1; - return; - }, - else => {}, - } - } - } - - /// Attempts to find the next statement by searching for a semicolon - fn findNextStmt(p: *Parser) void { - var level: u32 = 0; - while (true) { - const tok = p.nextToken(); - switch (p.token_tags[tok]) { - .l_brace => level += 1, - .r_brace => { - if (level == 0) { - p.tok_i -= 1; - return; - } - level -= 1; - }, - .semicolon => { - if (level == 0) { - return; - } - }, - .eof => { - p.tok_i -= 1; - return; - }, - else => {}, - } - } - } - - /// TestDecl <- KEYWORD_test (STRINGLITERALSINGLE / IDENTIFIER)? Block - fn expectTestDecl(p: *Parser) !Node.Index { - const test_token = p.assertToken(.keyword_test); - const name_token = switch (p.token_tags[p.nextToken()]) { - .string_literal, .identifier => p.tok_i - 1, - else => blk: { - p.tok_i -= 1; - break :blk null; - }, - }; - const block_node = try p.parseBlock(); - if (block_node == 0) return p.fail(.expected_block); - return p.addNode(.{ - .tag = .test_decl, - .main_token = test_token, - .data = .{ - .lhs = name_token orelse 0, - .rhs = block_node, - }, - }); - } - - fn expectTestDeclRecoverable(p: *Parser) error{OutOfMemory}!Node.Index { - return p.expectTestDecl() catch |err| switch (err) { - error.OutOfMemory => return error.OutOfMemory, - error.ParseError => { - p.findNextContainerMember(); - return null_node; - }, - }; - } - - /// Decl - /// <- (KEYWORD_export / KEYWORD_extern STRINGLITERALSINGLE? / (KEYWORD_inline / KEYWORD_noinline))? FnProto (SEMICOLON / Block) - /// / (KEYWORD_export / KEYWORD_extern STRINGLITERALSINGLE?)? KEYWORD_threadlocal? VarDecl - /// / KEYWORD_usingnamespace Expr SEMICOLON - fn expectTopLevelDecl(p: *Parser) !Node.Index { - const extern_export_inline_token = p.nextToken(); - var is_extern: bool = false; - var expect_fn: bool = false; - var expect_var_or_fn: bool = false; - switch (p.token_tags[extern_export_inline_token]) { - .keyword_extern => { - _ = p.eatToken(.string_literal); - is_extern = true; - expect_var_or_fn = true; - }, - .keyword_export => expect_var_or_fn = true, - .keyword_inline, .keyword_noinline => expect_fn = true, - else => p.tok_i -= 1, - } - const fn_proto = try p.parseFnProto(); - if (fn_proto != 0) { - switch (p.token_tags[p.tok_i]) { - .semicolon => { - p.tok_i += 1; - return fn_proto; - }, - .l_brace => { - if (is_extern) { - try p.warnMsg(.{ .tag = .extern_fn_body, .token = extern_export_inline_token }); - return null_node; - } - const fn_decl_index = try p.reserveNode(.fn_decl); - errdefer p.unreserveNode(fn_decl_index); - - const body_block = try p.parseBlock(); - assert(body_block != 0); - return p.setNode(fn_decl_index, .{ - .tag = .fn_decl, - .main_token = p.nodes.items(.main_token)[fn_proto], - .data = .{ - .lhs = fn_proto, - .rhs = body_block, - }, - }); - }, - else => { - // Since parseBlock only return error.ParseError on - // a missing '}' we can assume this function was - // supposed to end here. - try p.warn(.expected_semi_or_lbrace); - return null_node; - }, - } - } - if (expect_fn) { - try p.warn(.expected_fn); - return error.ParseError; - } - - const thread_local_token = p.eatToken(.keyword_threadlocal); - const var_decl = try p.parseVarDecl(); - if (var_decl != 0) { - try p.expectSemicolon(.expected_semi_after_decl, false); - return var_decl; - } - if (thread_local_token != null) { - return p.fail(.expected_var_decl); - } - if (expect_var_or_fn) { - return p.fail(.expected_var_decl_or_fn); - } - if (p.token_tags[p.tok_i] != .keyword_usingnamespace) { - return p.fail(.expected_pub_item); - } - return p.expectUsingNamespace(); - } - - fn expectTopLevelDeclRecoverable(p: *Parser) error{OutOfMemory}!Node.Index { - return p.expectTopLevelDecl() catch |err| switch (err) { - error.OutOfMemory => return error.OutOfMemory, - error.ParseError => { - p.findNextContainerMember(); - return null_node; - }, - }; - } - - fn expectUsingNamespace(p: *Parser) !Node.Index { - const usingnamespace_token = p.assertToken(.keyword_usingnamespace); - const expr = try p.expectExpr(); - try p.expectSemicolon(.expected_semi_after_decl, false); - return p.addNode(.{ - .tag = .@"usingnamespace", - .main_token = usingnamespace_token, - .data = .{ - .lhs = expr, - .rhs = undefined, - }, - }); - } - - fn expectUsingNamespaceRecoverable(p: *Parser) error{OutOfMemory}!Node.Index { - return p.expectUsingNamespace() catch |err| switch (err) { - error.OutOfMemory => return error.OutOfMemory, - error.ParseError => { - p.findNextContainerMember(); - return null_node; - }, - }; - } - - /// FnProto <- KEYWORD_fn IDENTIFIER? LPAREN ParamDeclList RPAREN ByteAlign? AddrSpace? LinkSection? CallConv? EXCLAMATIONMARK? TypeExpr - fn parseFnProto(p: *Parser) !Node.Index { - const fn_token = p.eatToken(.keyword_fn) orelse return null_node; - - // We want the fn proto node to be before its children in the array. - const fn_proto_index = try p.reserveNode(.fn_proto); - errdefer p.unreserveNode(fn_proto_index); - - _ = p.eatToken(.identifier); - const params = try p.parseParamDeclList(); - const align_expr = try p.parseByteAlign(); - const addrspace_expr = try p.parseAddrSpace(); - const section_expr = try p.parseLinkSection(); - const callconv_expr = try p.parseCallconv(); - _ = p.eatToken(.bang); - - const return_type_expr = try p.parseTypeExpr(); - if (return_type_expr == 0) { - // most likely the user forgot to specify the return type. - // Mark return type as invalid and try to continue. - try p.warn(.expected_return_type); - } - - if (align_expr == 0 and section_expr == 0 and callconv_expr == 0 and addrspace_expr == 0) { - switch (params) { - .zero_or_one => |param| return p.setNode(fn_proto_index, .{ - .tag = .fn_proto_simple, - .main_token = fn_token, - .data = .{ - .lhs = param, - .rhs = return_type_expr, - }, - }), - .multi => |span| { - return p.setNode(fn_proto_index, .{ - .tag = .fn_proto_multi, - .main_token = fn_token, - .data = .{ - .lhs = try p.addExtra(Node.SubRange{ - .start = span.start, - .end = span.end, - }), - .rhs = return_type_expr, - }, - }); - }, - } - } - switch (params) { - .zero_or_one => |param| return p.setNode(fn_proto_index, .{ - .tag = .fn_proto_one, - .main_token = fn_token, - .data = .{ - .lhs = try p.addExtra(Node.FnProtoOne{ - .param = param, - .align_expr = align_expr, - .addrspace_expr = addrspace_expr, - .section_expr = section_expr, - .callconv_expr = callconv_expr, - }), - .rhs = return_type_expr, - }, - }), - .multi => |span| { - return p.setNode(fn_proto_index, .{ - .tag = .fn_proto, - .main_token = fn_token, - .data = .{ - .lhs = try p.addExtra(Node.FnProto{ - .params_start = span.start, - .params_end = span.end, - .align_expr = align_expr, - .addrspace_expr = addrspace_expr, - .section_expr = section_expr, - .callconv_expr = callconv_expr, - }), - .rhs = return_type_expr, - }, - }); - }, - } - } - - /// VarDecl <- (KEYWORD_const / KEYWORD_var) IDENTIFIER (COLON TypeExpr)? ByteAlign? AddrSpace? LinkSection? (EQUAL Expr)? SEMICOLON - fn parseVarDecl(p: *Parser) !Node.Index { - const mut_token = p.eatToken(.keyword_const) orelse - p.eatToken(.keyword_var) orelse - return null_node; - - _ = try p.expectToken(.identifier); - const type_node: Node.Index = if (p.eatToken(.colon) == null) 0 else try p.expectTypeExpr(); - const align_node = try p.parseByteAlign(); - const addrspace_node = try p.parseAddrSpace(); - const section_node = try p.parseLinkSection(); - const init_node: Node.Index = switch (p.token_tags[p.tok_i]) { - .equal_equal => blk: { - try p.warn(.wrong_equal_var_decl); - p.tok_i += 1; - break :blk try p.expectExpr(); - }, - .equal => blk: { - p.tok_i += 1; - break :blk try p.expectExpr(); - }, - else => 0, - }; - if (section_node == 0 and addrspace_node == 0) { - if (align_node == 0) { - return p.addNode(.{ - .tag = .simple_var_decl, - .main_token = mut_token, - .data = .{ - .lhs = type_node, - .rhs = init_node, - }, - }); - } else if (type_node == 0) { - return p.addNode(.{ - .tag = .aligned_var_decl, - .main_token = mut_token, - .data = .{ - .lhs = align_node, - .rhs = init_node, - }, - }); - } else { - return p.addNode(.{ - .tag = .local_var_decl, - .main_token = mut_token, - .data = .{ - .lhs = try p.addExtra(Node.LocalVarDecl{ - .type_node = type_node, - .align_node = align_node, - }), - .rhs = init_node, - }, - }); - } - } else { - return p.addNode(.{ - .tag = .global_var_decl, - .main_token = mut_token, - .data = .{ - .lhs = try p.addExtra(Node.GlobalVarDecl{ - .type_node = type_node, - .align_node = align_node, - .addrspace_node = addrspace_node, - .section_node = section_node, - }), - .rhs = init_node, - }, - }); - } - } - - /// ContainerField - /// <- doc_comment? KEYWORD_comptime? IDENTIFIER (COLON TypeExpr)? ByteAlign? (EQUAL Expr)? - /// / doc_comment? KEYWORD_comptime? (IDENTIFIER COLON)? !KEYWORD_fn TypeExpr ByteAlign? (EQUAL Expr)? - fn expectContainerField(p: *Parser) !Node.Index { - var main_token = p.tok_i; - _ = p.eatToken(.keyword_comptime); - const tuple_like = p.token_tags[p.tok_i] != .identifier or p.token_tags[p.tok_i + 1] != .colon; - if (!tuple_like) { - main_token = p.assertToken(.identifier); - } - - var align_expr: Node.Index = 0; - var type_expr: Node.Index = 0; - if (p.eatToken(.colon) != null or tuple_like) { - type_expr = try p.expectTypeExpr(); - align_expr = try p.parseByteAlign(); - } - - const value_expr: Node.Index = if (p.eatToken(.equal) == null) 0 else try p.expectExpr(); - - if (align_expr == 0) { - return p.addNode(.{ - .tag = .container_field_init, - .main_token = main_token, - .data = .{ - .lhs = type_expr, - .rhs = value_expr, - }, - }); - } else if (value_expr == 0) { - return p.addNode(.{ - .tag = .container_field_align, - .main_token = main_token, - .data = .{ - .lhs = type_expr, - .rhs = align_expr, - }, - }); - } else { - return p.addNode(.{ - .tag = .container_field, - .main_token = main_token, - .data = .{ - .lhs = type_expr, - .rhs = try p.addExtra(Node.ContainerField{ - .value_expr = value_expr, - .align_expr = align_expr, - }), - }, - }); - } - } - - /// Statement - /// <- KEYWORD_comptime? VarDecl - /// / KEYWORD_comptime BlockExprStatement - /// / KEYWORD_nosuspend BlockExprStatement - /// / KEYWORD_suspend BlockExprStatement - /// / KEYWORD_defer BlockExprStatement - /// / KEYWORD_errdefer Payload? BlockExprStatement - /// / IfStatement - /// / LabeledStatement - /// / SwitchExpr - /// / AssignExpr SEMICOLON - fn parseStatement(p: *Parser, allow_defer_var: bool) Error!Node.Index { - const comptime_token = p.eatToken(.keyword_comptime); - - if (allow_defer_var) { - const var_decl = try p.parseVarDecl(); - if (var_decl != 0) { - try p.expectSemicolon(.expected_semi_after_decl, true); - return var_decl; - } - } - - if (comptime_token) |token| { - return p.addNode(.{ - .tag = .@"comptime", - .main_token = token, - .data = .{ - .lhs = try p.expectBlockExprStatement(), - .rhs = undefined, - }, - }); - } - - switch (p.token_tags[p.tok_i]) { - .keyword_nosuspend => { - return p.addNode(.{ - .tag = .@"nosuspend", - .main_token = p.nextToken(), - .data = .{ - .lhs = try p.expectBlockExprStatement(), - .rhs = undefined, - }, - }); - }, - .keyword_suspend => { - const token = p.nextToken(); - const block_expr = try p.expectBlockExprStatement(); - return p.addNode(.{ - .tag = .@"suspend", - .main_token = token, - .data = .{ - .lhs = block_expr, - .rhs = undefined, - }, - }); - }, - .keyword_defer => if (allow_defer_var) return p.addNode(.{ - .tag = .@"defer", - .main_token = p.nextToken(), - .data = .{ - .lhs = undefined, - .rhs = try p.expectBlockExprStatement(), - }, - }), - .keyword_errdefer => if (allow_defer_var) return p.addNode(.{ - .tag = .@"errdefer", - .main_token = p.nextToken(), - .data = .{ - .lhs = try p.parsePayload(), - .rhs = try p.expectBlockExprStatement(), - }, - }), - .keyword_switch => return p.expectSwitchExpr(), - .keyword_if => return p.expectIfStatement(), - .keyword_enum, .keyword_struct, .keyword_union => { - const identifier = p.tok_i + 1; - if (try p.parseCStyleContainer()) { - // Return something so that `expectStatement` is happy. - return p.addNode(.{ - .tag = .identifier, - .main_token = identifier, - .data = .{ - .lhs = undefined, - .rhs = undefined, - }, - }); - } - }, - else => {}, - } - - const labeled_statement = try p.parseLabeledStatement(); - if (labeled_statement != 0) return labeled_statement; - - const assign_expr = try p.parseAssignExpr(); - if (assign_expr != 0) { - try p.expectSemicolon(.expected_semi_after_stmt, true); - return assign_expr; - } - - return null_node; - } - - fn expectStatement(p: *Parser, allow_defer_var: bool) !Node.Index { - const statement = try p.parseStatement(allow_defer_var); - if (statement == 0) { - return p.fail(.expected_statement); - } - return statement; - } - - /// If a parse error occurs, reports an error, but then finds the next statement - /// and returns that one instead. If a parse error occurs but there is no following - /// statement, returns 0. - fn expectStatementRecoverable(p: *Parser) Error!Node.Index { - while (true) { - return p.expectStatement(true) catch |err| switch (err) { - error.OutOfMemory => return error.OutOfMemory, - error.ParseError => { - p.findNextStmt(); // Try to skip to the next statement. - switch (p.token_tags[p.tok_i]) { - .r_brace => return null_node, - .eof => return error.ParseError, - else => continue, - } - }, - }; - } - } - - /// IfStatement - /// <- IfPrefix BlockExpr ( KEYWORD_else Payload? Statement )? - /// / IfPrefix AssignExpr ( SEMICOLON / KEYWORD_else Payload? Statement ) - fn expectIfStatement(p: *Parser) !Node.Index { - const if_token = p.assertToken(.keyword_if); - _ = try p.expectToken(.l_paren); - const condition = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - _ = try p.parsePtrPayload(); - - // TODO propose to change the syntax so that semicolons are always required - // inside if statements, even if there is an `else`. - var else_required = false; - const then_expr = blk: { - const block_expr = try p.parseBlockExpr(); - if (block_expr != 0) break :blk block_expr; - const assign_expr = try p.parseAssignExpr(); - if (assign_expr == 0) { - return p.fail(.expected_block_or_assignment); - } - if (p.eatToken(.semicolon)) |_| { - return p.addNode(.{ - .tag = .if_simple, - .main_token = if_token, - .data = .{ - .lhs = condition, - .rhs = assign_expr, - }, - }); - } - else_required = true; - break :blk assign_expr; - }; - _ = p.eatToken(.keyword_else) orelse { - if (else_required) { - try p.warn(.expected_semi_or_else); - } - return p.addNode(.{ - .tag = .if_simple, - .main_token = if_token, - .data = .{ - .lhs = condition, - .rhs = then_expr, - }, - }); - }; - _ = try p.parsePayload(); - const else_expr = try p.expectStatement(false); - return p.addNode(.{ - .tag = .@"if", - .main_token = if_token, - .data = .{ - .lhs = condition, - .rhs = try p.addExtra(Node.If{ - .then_expr = then_expr, - .else_expr = else_expr, - }), - }, - }); - } - - /// LabeledStatement <- BlockLabel? (Block / LoopStatement) - fn parseLabeledStatement(p: *Parser) !Node.Index { - const label_token = p.parseBlockLabel(); - const block = try p.parseBlock(); - if (block != 0) return block; - - const loop_stmt = try p.parseLoopStatement(); - if (loop_stmt != 0) return loop_stmt; - - if (label_token != 0) { - const after_colon = p.tok_i; - const node = try p.parseTypeExpr(); - if (node != 0) { - const a = try p.parseByteAlign(); - const b = try p.parseAddrSpace(); - const c = try p.parseLinkSection(); - const d = if (p.eatToken(.equal) == null) 0 else try p.expectExpr(); - if (a != 0 or b != 0 or c != 0 or d != 0) { - return p.failMsg(.{ .tag = .expected_var_const, .token = label_token }); - } - } - return p.failMsg(.{ .tag = .expected_labelable, .token = after_colon }); - } - - return null_node; - } - - /// LoopStatement <- KEYWORD_inline? (ForStatement / WhileStatement) - fn parseLoopStatement(p: *Parser) !Node.Index { - const inline_token = p.eatToken(.keyword_inline); - - const for_statement = try p.parseForStatement(); - if (for_statement != 0) return for_statement; - - const while_statement = try p.parseWhileStatement(); - if (while_statement != 0) return while_statement; - - if (inline_token == null) return null_node; - - // If we've seen "inline", there should have been a "for" or "while" - return p.fail(.expected_inlinable); - } - - /// ForPrefix <- KEYWORD_for LPAREN Expr RPAREN PtrIndexPayload - /// - /// ForStatement - /// <- ForPrefix BlockExpr ( KEYWORD_else Statement )? - /// / ForPrefix AssignExpr ( SEMICOLON / KEYWORD_else Statement ) - fn parseForStatement(p: *Parser) !Node.Index { - const for_token = p.eatToken(.keyword_for) orelse return null_node; - _ = try p.expectToken(.l_paren); - const array_expr = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - const found_payload = try p.parsePtrIndexPayload(); - if (found_payload == 0) try p.warn(.expected_loop_payload); - - // TODO propose to change the syntax so that semicolons are always required - // inside while statements, even if there is an `else`. - var else_required = false; - const then_expr = blk: { - const block_expr = try p.parseBlockExpr(); - if (block_expr != 0) break :blk block_expr; - const assign_expr = try p.parseAssignExpr(); - if (assign_expr == 0) { - return p.fail(.expected_block_or_assignment); - } - if (p.eatToken(.semicolon)) |_| { - return p.addNode(.{ - .tag = .for_simple, - .main_token = for_token, - .data = .{ - .lhs = array_expr, - .rhs = assign_expr, - }, - }); - } - else_required = true; - break :blk assign_expr; - }; - _ = p.eatToken(.keyword_else) orelse { - if (else_required) { - try p.warn(.expected_semi_or_else); - } - return p.addNode(.{ - .tag = .for_simple, - .main_token = for_token, - .data = .{ - .lhs = array_expr, - .rhs = then_expr, - }, - }); - }; - return p.addNode(.{ - .tag = .@"for", - .main_token = for_token, - .data = .{ - .lhs = array_expr, - .rhs = try p.addExtra(Node.If{ - .then_expr = then_expr, - .else_expr = try p.expectStatement(false), - }), - }, - }); - } - - /// WhilePrefix <- KEYWORD_while LPAREN Expr RPAREN PtrPayload? WhileContinueExpr? - /// - /// WhileStatement - /// <- WhilePrefix BlockExpr ( KEYWORD_else Payload? Statement )? - /// / WhilePrefix AssignExpr ( SEMICOLON / KEYWORD_else Payload? Statement ) - fn parseWhileStatement(p: *Parser) !Node.Index { - const while_token = p.eatToken(.keyword_while) orelse return null_node; - _ = try p.expectToken(.l_paren); - const condition = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - _ = try p.parsePtrPayload(); - const cont_expr = try p.parseWhileContinueExpr(); - - // TODO propose to change the syntax so that semicolons are always required - // inside while statements, even if there is an `else`. - var else_required = false; - const then_expr = blk: { - const block_expr = try p.parseBlockExpr(); - if (block_expr != 0) break :blk block_expr; - const assign_expr = try p.parseAssignExpr(); - if (assign_expr == 0) { - return p.fail(.expected_block_or_assignment); - } - if (p.eatToken(.semicolon)) |_| { - if (cont_expr == 0) { - return p.addNode(.{ - .tag = .while_simple, - .main_token = while_token, - .data = .{ - .lhs = condition, - .rhs = assign_expr, - }, - }); - } else { - return p.addNode(.{ - .tag = .while_cont, - .main_token = while_token, - .data = .{ - .lhs = condition, - .rhs = try p.addExtra(Node.WhileCont{ - .cont_expr = cont_expr, - .then_expr = assign_expr, - }), - }, - }); - } - } - else_required = true; - break :blk assign_expr; - }; - _ = p.eatToken(.keyword_else) orelse { - if (else_required) { - try p.warn(.expected_semi_or_else); - } - if (cont_expr == 0) { - return p.addNode(.{ - .tag = .while_simple, - .main_token = while_token, - .data = .{ - .lhs = condition, - .rhs = then_expr, - }, - }); - } else { - return p.addNode(.{ - .tag = .while_cont, - .main_token = while_token, - .data = .{ - .lhs = condition, - .rhs = try p.addExtra(Node.WhileCont{ - .cont_expr = cont_expr, - .then_expr = then_expr, - }), - }, - }); - } - }; - _ = try p.parsePayload(); - const else_expr = try p.expectStatement(false); - return p.addNode(.{ - .tag = .@"while", - .main_token = while_token, - .data = .{ - .lhs = condition, - .rhs = try p.addExtra(Node.While{ - .cont_expr = cont_expr, - .then_expr = then_expr, - .else_expr = else_expr, - }), - }, - }); - } - - /// BlockExprStatement - /// <- BlockExpr - /// / AssignExpr SEMICOLON - fn parseBlockExprStatement(p: *Parser) !Node.Index { - const block_expr = try p.parseBlockExpr(); - if (block_expr != 0) { - return block_expr; - } - const assign_expr = try p.parseAssignExpr(); - if (assign_expr != 0) { - try p.expectSemicolon(.expected_semi_after_stmt, true); - return assign_expr; - } - return null_node; - } - - fn expectBlockExprStatement(p: *Parser) !Node.Index { - const node = try p.parseBlockExprStatement(); - if (node == 0) { - return p.fail(.expected_block_or_expr); - } - return node; - } - - /// BlockExpr <- BlockLabel? Block - fn parseBlockExpr(p: *Parser) Error!Node.Index { - switch (p.token_tags[p.tok_i]) { - .identifier => { - if (p.token_tags[p.tok_i + 1] == .colon and - p.token_tags[p.tok_i + 2] == .l_brace) - { - p.tok_i += 2; - return p.parseBlock(); - } else { - return null_node; - } - }, - .l_brace => return p.parseBlock(), - else => return null_node, - } - } - - /// AssignExpr <- Expr (AssignOp Expr)? - /// - /// AssignOp - /// <- ASTERISKEQUAL - /// / ASTERISKPIPEEQUAL - /// / SLASHEQUAL - /// / PERCENTEQUAL - /// / PLUSEQUAL - /// / PLUSPIPEEQUAL - /// / MINUSEQUAL - /// / MINUSPIPEEQUAL - /// / LARROW2EQUAL - /// / LARROW2PIPEEQUAL - /// / RARROW2EQUAL - /// / AMPERSANDEQUAL - /// / CARETEQUAL - /// / PIPEEQUAL - /// / ASTERISKPERCENTEQUAL - /// / PLUSPERCENTEQUAL - /// / MINUSPERCENTEQUAL - /// / EQUAL - fn parseAssignExpr(p: *Parser) !Node.Index { - const expr = try p.parseExpr(); - if (expr == 0) return null_node; - - const tag: Node.Tag = switch (p.token_tags[p.tok_i]) { - .asterisk_equal => .assign_mul, - .slash_equal => .assign_div, - .percent_equal => .assign_mod, - .plus_equal => .assign_add, - .minus_equal => .assign_sub, - .angle_bracket_angle_bracket_left_equal => .assign_shl, - .angle_bracket_angle_bracket_left_pipe_equal => .assign_shl_sat, - .angle_bracket_angle_bracket_right_equal => .assign_shr, - .ampersand_equal => .assign_bit_and, - .caret_equal => .assign_bit_xor, - .pipe_equal => .assign_bit_or, - .asterisk_percent_equal => .assign_mul_wrap, - .plus_percent_equal => .assign_add_wrap, - .minus_percent_equal => .assign_sub_wrap, - .asterisk_pipe_equal => .assign_mul_sat, - .plus_pipe_equal => .assign_add_sat, - .minus_pipe_equal => .assign_sub_sat, - .equal => .assign, - else => return expr, - }; - return p.addNode(.{ - .tag = tag, - .main_token = p.nextToken(), - .data = .{ - .lhs = expr, - .rhs = try p.expectExpr(), - }, - }); - } - - fn expectAssignExpr(p: *Parser) !Node.Index { - const expr = try p.parseAssignExpr(); - if (expr == 0) { - return p.fail(.expected_expr_or_assignment); - } - return expr; - } - - fn parseExpr(p: *Parser) Error!Node.Index { - return p.parseExprPrecedence(0); - } - - fn expectExpr(p: *Parser) Error!Node.Index { - const node = try p.parseExpr(); - if (node == 0) { - return p.fail(.expected_expr); - } else { - return node; - } - } - - const Assoc = enum { - left, - none, - }; - - const OperInfo = struct { - prec: i8, - tag: Node.Tag, - assoc: Assoc = Assoc.left, - }; - - // A table of binary operator information. Higher precedence numbers are - // stickier. All operators at the same precedence level should have the same - // associativity. - const operTable = std.enums.directEnumArrayDefault(Token.Tag, OperInfo, .{ .prec = -1, .tag = Node.Tag.root }, 0, .{ - .keyword_or = .{ .prec = 10, .tag = .bool_or }, - - .keyword_and = .{ .prec = 20, .tag = .bool_and }, - - .equal_equal = .{ .prec = 30, .tag = .equal_equal, .assoc = Assoc.none }, - .bang_equal = .{ .prec = 30, .tag = .bang_equal, .assoc = Assoc.none }, - .angle_bracket_left = .{ .prec = 30, .tag = .less_than, .assoc = Assoc.none }, - .angle_bracket_right = .{ .prec = 30, .tag = .greater_than, .assoc = Assoc.none }, - .angle_bracket_left_equal = .{ .prec = 30, .tag = .less_or_equal, .assoc = Assoc.none }, - .angle_bracket_right_equal = .{ .prec = 30, .tag = .greater_or_equal, .assoc = Assoc.none }, - - .ampersand = .{ .prec = 40, .tag = .bit_and }, - .caret = .{ .prec = 40, .tag = .bit_xor }, - .pipe = .{ .prec = 40, .tag = .bit_or }, - .keyword_orelse = .{ .prec = 40, .tag = .@"orelse" }, - .keyword_catch = .{ .prec = 40, .tag = .@"catch" }, - - .angle_bracket_angle_bracket_left = .{ .prec = 50, .tag = .shl }, - .angle_bracket_angle_bracket_left_pipe = .{ .prec = 50, .tag = .shl_sat }, - .angle_bracket_angle_bracket_right = .{ .prec = 50, .tag = .shr }, - - .plus = .{ .prec = 60, .tag = .add }, - .minus = .{ .prec = 60, .tag = .sub }, - .plus_plus = .{ .prec = 60, .tag = .array_cat }, - .plus_percent = .{ .prec = 60, .tag = .add_wrap }, - .minus_percent = .{ .prec = 60, .tag = .sub_wrap }, - .plus_pipe = .{ .prec = 60, .tag = .add_sat }, - .minus_pipe = .{ .prec = 60, .tag = .sub_sat }, - - .pipe_pipe = .{ .prec = 70, .tag = .merge_error_sets }, - .asterisk = .{ .prec = 70, .tag = .mul }, - .slash = .{ .prec = 70, .tag = .div }, - .percent = .{ .prec = 70, .tag = .mod }, - .asterisk_asterisk = .{ .prec = 70, .tag = .array_mult }, - .asterisk_percent = .{ .prec = 70, .tag = .mul_wrap }, - .asterisk_pipe = .{ .prec = 70, .tag = .mul_sat }, - }); - - fn parseExprPrecedence(p: *Parser, min_prec: i32) Error!Node.Index { - assert(min_prec >= 0); - var node = try p.parsePrefixExpr(); - if (node == 0) { - return null_node; - } - - var banned_prec: i8 = -1; - - while (true) { - const tok_tag = p.token_tags[p.tok_i]; - const info = operTable[@intCast(usize, @enumToInt(tok_tag))]; - if (info.prec < min_prec) { - break; - } - if (info.prec == banned_prec) { - return p.fail(.chained_comparison_operators); - } - - const oper_token = p.nextToken(); - // Special-case handling for "catch" - if (tok_tag == .keyword_catch) { - _ = try p.parsePayload(); - } - const rhs = try p.parseExprPrecedence(info.prec + 1); - if (rhs == 0) { - try p.warn(.expected_expr); - return node; - } - - { - const tok_len = tok_tag.lexeme().?.len; - const char_before = p.source[p.token_starts[oper_token] - 1]; - const char_after = p.source[p.token_starts[oper_token] + tok_len]; - if (tok_tag == .ampersand and char_after == '&') { - // without types we don't know if '&&' was intended as 'bitwise_and address_of', or a c-style logical_and - // The best the parser can do is recommend changing it to 'and' or ' & &' - try p.warnMsg(.{ .tag = .invalid_ampersand_ampersand, .token = oper_token }); - } else if (std.ascii.isWhitespace(char_before) != std.ascii.isWhitespace(char_after)) { - try p.warnMsg(.{ .tag = .mismatched_binary_op_whitespace, .token = oper_token }); - } - } - - node = try p.addNode(.{ - .tag = info.tag, - .main_token = oper_token, - .data = .{ - .lhs = node, - .rhs = rhs, - }, - }); - - if (info.assoc == Assoc.none) { - banned_prec = info.prec; - } - } - - return node; - } - - /// PrefixExpr <- PrefixOp* PrimaryExpr - /// - /// PrefixOp - /// <- EXCLAMATIONMARK - /// / MINUS - /// / TILDE - /// / MINUSPERCENT - /// / AMPERSAND - /// / KEYWORD_try - /// / KEYWORD_await - fn parsePrefixExpr(p: *Parser) Error!Node.Index { - const tag: Node.Tag = switch (p.token_tags[p.tok_i]) { - .bang => .bool_not, - .minus => .negation, - .tilde => .bit_not, - .minus_percent => .negation_wrap, - .ampersand => .address_of, - .keyword_try => .@"try", - .keyword_await => .@"await", - else => return p.parsePrimaryExpr(), - }; - return p.addNode(.{ - .tag = tag, - .main_token = p.nextToken(), - .data = .{ - .lhs = try p.expectPrefixExpr(), - .rhs = undefined, - }, - }); - } - - fn expectPrefixExpr(p: *Parser) Error!Node.Index { - const node = try p.parsePrefixExpr(); - if (node == 0) { - return p.fail(.expected_prefix_expr); - } - return node; - } - - /// TypeExpr <- PrefixTypeOp* ErrorUnionExpr - /// - /// PrefixTypeOp - /// <- QUESTIONMARK - /// / KEYWORD_anyframe MINUSRARROW - /// / SliceTypeStart (ByteAlign / AddrSpace / KEYWORD_const / KEYWORD_volatile / KEYWORD_allowzero)* - /// / PtrTypeStart (AddrSpace / KEYWORD_align LPAREN Expr (COLON Expr COLON Expr)? RPAREN / KEYWORD_const / KEYWORD_volatile / KEYWORD_allowzero)* - /// / ArrayTypeStart - /// - /// SliceTypeStart <- LBRACKET (COLON Expr)? RBRACKET - /// - /// PtrTypeStart - /// <- ASTERISK - /// / ASTERISK2 - /// / LBRACKET ASTERISK (LETTERC / COLON Expr)? RBRACKET - /// - /// ArrayTypeStart <- LBRACKET Expr (COLON Expr)? RBRACKET - fn parseTypeExpr(p: *Parser) Error!Node.Index { - switch (p.token_tags[p.tok_i]) { - .question_mark => return p.addNode(.{ - .tag = .optional_type, - .main_token = p.nextToken(), - .data = .{ - .lhs = try p.expectTypeExpr(), - .rhs = undefined, - }, - }), - .keyword_anyframe => switch (p.token_tags[p.tok_i + 1]) { - .arrow => return p.addNode(.{ - .tag = .anyframe_type, - .main_token = p.nextToken(), - .data = .{ - .lhs = p.nextToken(), - .rhs = try p.expectTypeExpr(), - }, - }), - else => return p.parseErrorUnionExpr(), - }, - .asterisk => { - const asterisk = p.nextToken(); - const mods = try p.parsePtrModifiers(); - const elem_type = try p.expectTypeExpr(); - if (mods.bit_range_start != 0) { - return p.addNode(.{ - .tag = .ptr_type_bit_range, - .main_token = asterisk, - .data = .{ - .lhs = try p.addExtra(Node.PtrTypeBitRange{ - .sentinel = 0, - .align_node = mods.align_node, - .addrspace_node = mods.addrspace_node, - .bit_range_start = mods.bit_range_start, - .bit_range_end = mods.bit_range_end, - }), - .rhs = elem_type, - }, - }); - } else if (mods.addrspace_node != 0) { - return p.addNode(.{ - .tag = .ptr_type, - .main_token = asterisk, - .data = .{ - .lhs = try p.addExtra(Node.PtrType{ - .sentinel = 0, - .align_node = mods.align_node, - .addrspace_node = mods.addrspace_node, - }), - .rhs = elem_type, - }, - }); - } else { - return p.addNode(.{ - .tag = .ptr_type_aligned, - .main_token = asterisk, - .data = .{ - .lhs = mods.align_node, - .rhs = elem_type, - }, - }); - } - }, - .asterisk_asterisk => { - const asterisk = p.nextToken(); - const mods = try p.parsePtrModifiers(); - const elem_type = try p.expectTypeExpr(); - const inner: Node.Index = inner: { - if (mods.bit_range_start != 0) { - break :inner try p.addNode(.{ - .tag = .ptr_type_bit_range, - .main_token = asterisk, - .data = .{ - .lhs = try p.addExtra(Node.PtrTypeBitRange{ - .sentinel = 0, - .align_node = mods.align_node, - .addrspace_node = mods.addrspace_node, - .bit_range_start = mods.bit_range_start, - .bit_range_end = mods.bit_range_end, - }), - .rhs = elem_type, - }, - }); - } else if (mods.addrspace_node != 0) { - break :inner try p.addNode(.{ - .tag = .ptr_type, - .main_token = asterisk, - .data = .{ - .lhs = try p.addExtra(Node.PtrType{ - .sentinel = 0, - .align_node = mods.align_node, - .addrspace_node = mods.addrspace_node, - }), - .rhs = elem_type, - }, - }); - } else { - break :inner try p.addNode(.{ - .tag = .ptr_type_aligned, - .main_token = asterisk, - .data = .{ - .lhs = mods.align_node, - .rhs = elem_type, - }, - }); - } - }; - return p.addNode(.{ - .tag = .ptr_type_aligned, - .main_token = asterisk, - .data = .{ - .lhs = 0, - .rhs = inner, - }, - }); - }, - .l_bracket => switch (p.token_tags[p.tok_i + 1]) { - .asterisk => { - _ = p.nextToken(); - const asterisk = p.nextToken(); - var sentinel: Node.Index = 0; - if (p.eatToken(.identifier)) |ident| { - const ident_slice = p.source[p.token_starts[ident]..p.token_starts[ident + 1]]; - if (!std.mem.eql(u8, std.mem.trimRight(u8, ident_slice, &std.ascii.whitespace), "c")) { - p.tok_i -= 1; - } - } else if (p.eatToken(.colon)) |_| { - sentinel = try p.expectExpr(); - } - _ = try p.expectToken(.r_bracket); - const mods = try p.parsePtrModifiers(); - const elem_type = try p.expectTypeExpr(); - if (mods.bit_range_start == 0) { - if (sentinel == 0 and mods.addrspace_node == 0) { - return p.addNode(.{ - .tag = .ptr_type_aligned, - .main_token = asterisk, - .data = .{ - .lhs = mods.align_node, - .rhs = elem_type, - }, - }); - } else if (mods.align_node == 0 and mods.addrspace_node == 0) { - return p.addNode(.{ - .tag = .ptr_type_sentinel, - .main_token = asterisk, - .data = .{ - .lhs = sentinel, - .rhs = elem_type, - }, - }); - } else { - return p.addNode(.{ - .tag = .ptr_type, - .main_token = asterisk, - .data = .{ - .lhs = try p.addExtra(Node.PtrType{ - .sentinel = sentinel, - .align_node = mods.align_node, - .addrspace_node = mods.addrspace_node, - }), - .rhs = elem_type, - }, - }); - } - } else { - return p.addNode(.{ - .tag = .ptr_type_bit_range, - .main_token = asterisk, - .data = .{ - .lhs = try p.addExtra(Node.PtrTypeBitRange{ - .sentinel = sentinel, - .align_node = mods.align_node, - .addrspace_node = mods.addrspace_node, - .bit_range_start = mods.bit_range_start, - .bit_range_end = mods.bit_range_end, - }), - .rhs = elem_type, - }, - }); - } - }, - else => { - const lbracket = p.nextToken(); - const len_expr = try p.parseExpr(); - const sentinel: Node.Index = if (p.eatToken(.colon)) |_| - try p.expectExpr() - else - 0; - _ = try p.expectToken(.r_bracket); - if (len_expr == 0) { - const mods = try p.parsePtrModifiers(); - const elem_type = try p.expectTypeExpr(); - if (mods.bit_range_start != 0) { - try p.warnMsg(.{ - .tag = .invalid_bit_range, - .token = p.nodes.items(.main_token)[mods.bit_range_start], - }); - } - if (sentinel == 0 and mods.addrspace_node == 0) { - return p.addNode(.{ - .tag = .ptr_type_aligned, - .main_token = lbracket, - .data = .{ - .lhs = mods.align_node, - .rhs = elem_type, - }, - }); - } else if (mods.align_node == 0 and mods.addrspace_node == 0) { - return p.addNode(.{ - .tag = .ptr_type_sentinel, - .main_token = lbracket, - .data = .{ - .lhs = sentinel, - .rhs = elem_type, - }, - }); - } else { - return p.addNode(.{ - .tag = .ptr_type, - .main_token = lbracket, - .data = .{ - .lhs = try p.addExtra(Node.PtrType{ - .sentinel = sentinel, - .align_node = mods.align_node, - .addrspace_node = mods.addrspace_node, - }), - .rhs = elem_type, - }, - }); - } - } else { - switch (p.token_tags[p.tok_i]) { - .keyword_align, - .keyword_const, - .keyword_volatile, - .keyword_allowzero, - .keyword_addrspace, - => return p.fail(.ptr_mod_on_array_child_type), - else => {}, - } - const elem_type = try p.expectTypeExpr(); - if (sentinel == 0) { - return p.addNode(.{ - .tag = .array_type, - .main_token = lbracket, - .data = .{ - .lhs = len_expr, - .rhs = elem_type, - }, - }); - } else { - return p.addNode(.{ - .tag = .array_type_sentinel, - .main_token = lbracket, - .data = .{ - .lhs = len_expr, - .rhs = try p.addExtra(.{ - .elem_type = elem_type, - .sentinel = sentinel, - }), - }, - }); - } - } - }, - }, - else => return p.parseErrorUnionExpr(), - } - } - - fn expectTypeExpr(p: *Parser) Error!Node.Index { - const node = try p.parseTypeExpr(); - if (node == 0) { - return p.fail(.expected_type_expr); - } - return node; - } - - /// PrimaryExpr - /// <- AsmExpr - /// / IfExpr - /// / KEYWORD_break BreakLabel? Expr? - /// / KEYWORD_comptime Expr - /// / KEYWORD_nosuspend Expr - /// / KEYWORD_continue BreakLabel? - /// / KEYWORD_resume Expr - /// / KEYWORD_return Expr? - /// / BlockLabel? LoopExpr - /// / Block - /// / CurlySuffixExpr - fn parsePrimaryExpr(p: *Parser) !Node.Index { - switch (p.token_tags[p.tok_i]) { - .keyword_asm => return p.expectAsmExpr(), - .keyword_if => return p.parseIfExpr(), - .keyword_break => { - p.tok_i += 1; - return p.addNode(.{ - .tag = .@"break", - .main_token = p.tok_i - 1, - .data = .{ - .lhs = try p.parseBreakLabel(), - .rhs = try p.parseExpr(), - }, - }); - }, - .keyword_continue => { - p.tok_i += 1; - return p.addNode(.{ - .tag = .@"continue", - .main_token = p.tok_i - 1, - .data = .{ - .lhs = try p.parseBreakLabel(), - .rhs = undefined, - }, - }); - }, - .keyword_comptime => { - p.tok_i += 1; - return p.addNode(.{ - .tag = .@"comptime", - .main_token = p.tok_i - 1, - .data = .{ - .lhs = try p.expectExpr(), - .rhs = undefined, - }, - }); - }, - .keyword_nosuspend => { - p.tok_i += 1; - return p.addNode(.{ - .tag = .@"nosuspend", - .main_token = p.tok_i - 1, - .data = .{ - .lhs = try p.expectExpr(), - .rhs = undefined, - }, - }); - }, - .keyword_resume => { - p.tok_i += 1; - return p.addNode(.{ - .tag = .@"resume", - .main_token = p.tok_i - 1, - .data = .{ - .lhs = try p.expectExpr(), - .rhs = undefined, - }, - }); - }, - .keyword_return => { - p.tok_i += 1; - return p.addNode(.{ - .tag = .@"return", - .main_token = p.tok_i - 1, - .data = .{ - .lhs = try p.parseExpr(), - .rhs = undefined, - }, - }); - }, - .identifier => { - if (p.token_tags[p.tok_i + 1] == .colon) { - switch (p.token_tags[p.tok_i + 2]) { - .keyword_inline => { - p.tok_i += 3; - switch (p.token_tags[p.tok_i]) { - .keyword_for => return p.parseForExpr(), - .keyword_while => return p.parseWhileExpr(), - else => return p.fail(.expected_inlinable), - } - }, - .keyword_for => { - p.tok_i += 2; - return p.parseForExpr(); - }, - .keyword_while => { - p.tok_i += 2; - return p.parseWhileExpr(); - }, - .l_brace => { - p.tok_i += 2; - return p.parseBlock(); - }, - else => return p.parseCurlySuffixExpr(), - } - } else { - return p.parseCurlySuffixExpr(); - } - }, - .keyword_inline => { - p.tok_i += 1; - switch (p.token_tags[p.tok_i]) { - .keyword_for => return p.parseForExpr(), - .keyword_while => return p.parseWhileExpr(), - else => return p.fail(.expected_inlinable), - } - }, - .keyword_for => return p.parseForExpr(), - .keyword_while => return p.parseWhileExpr(), - .l_brace => return p.parseBlock(), - else => return p.parseCurlySuffixExpr(), - } - } - - /// IfExpr <- IfPrefix Expr (KEYWORD_else Payload? Expr)? - fn parseIfExpr(p: *Parser) !Node.Index { - return p.parseIf(expectExpr); - } - - /// Block <- LBRACE Statement* RBRACE - fn parseBlock(p: *Parser) !Node.Index { - const lbrace = p.eatToken(.l_brace) orelse return null_node; - const scratch_top = p.scratch.items.len; - defer p.scratch.shrinkRetainingCapacity(scratch_top); - while (true) { - if (p.token_tags[p.tok_i] == .r_brace) break; - const statement = try p.expectStatementRecoverable(); - if (statement == 0) break; - try p.scratch.append(p.gpa, statement); - } - _ = try p.expectToken(.r_brace); - const semicolon = (p.token_tags[p.tok_i - 2] == .semicolon); - const statements = p.scratch.items[scratch_top..]; - switch (statements.len) { - 0 => return p.addNode(.{ - .tag = .block_two, - .main_token = lbrace, - .data = .{ - .lhs = 0, - .rhs = 0, - }, - }), - 1 => return p.addNode(.{ - .tag = if (semicolon) .block_two_semicolon else .block_two, - .main_token = lbrace, - .data = .{ - .lhs = statements[0], - .rhs = 0, - }, - }), - 2 => return p.addNode(.{ - .tag = if (semicolon) .block_two_semicolon else .block_two, - .main_token = lbrace, - .data = .{ - .lhs = statements[0], - .rhs = statements[1], - }, - }), - else => { - const span = try p.listToSpan(statements); - return p.addNode(.{ - .tag = if (semicolon) .block_semicolon else .block, - .main_token = lbrace, - .data = .{ - .lhs = span.start, - .rhs = span.end, - }, - }); - }, - } - } - - /// ForPrefix <- KEYWORD_for LPAREN Expr RPAREN PtrIndexPayload - /// - /// ForExpr <- ForPrefix Expr (KEYWORD_else Expr)? - fn parseForExpr(p: *Parser) !Node.Index { - const for_token = p.eatToken(.keyword_for) orelse return null_node; - _ = try p.expectToken(.l_paren); - const array_expr = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - const found_payload = try p.parsePtrIndexPayload(); - if (found_payload == 0) try p.warn(.expected_loop_payload); - - const then_expr = try p.expectExpr(); - _ = p.eatToken(.keyword_else) orelse { - return p.addNode(.{ - .tag = .for_simple, - .main_token = for_token, - .data = .{ - .lhs = array_expr, - .rhs = then_expr, - }, - }); - }; - const else_expr = try p.expectExpr(); - return p.addNode(.{ - .tag = .@"for", - .main_token = for_token, - .data = .{ - .lhs = array_expr, - .rhs = try p.addExtra(Node.If{ - .then_expr = then_expr, - .else_expr = else_expr, - }), - }, - }); - } - - /// WhilePrefix <- KEYWORD_while LPAREN Expr RPAREN PtrPayload? WhileContinueExpr? - /// - /// WhileExpr <- WhilePrefix Expr (KEYWORD_else Payload? Expr)? - fn parseWhileExpr(p: *Parser) !Node.Index { - const while_token = p.eatToken(.keyword_while) orelse return null_node; - _ = try p.expectToken(.l_paren); - const condition = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - _ = try p.parsePtrPayload(); - const cont_expr = try p.parseWhileContinueExpr(); - - const then_expr = try p.expectExpr(); - _ = p.eatToken(.keyword_else) orelse { - if (cont_expr == 0) { - return p.addNode(.{ - .tag = .while_simple, - .main_token = while_token, - .data = .{ - .lhs = condition, - .rhs = then_expr, - }, - }); - } else { - return p.addNode(.{ - .tag = .while_cont, - .main_token = while_token, - .data = .{ - .lhs = condition, - .rhs = try p.addExtra(Node.WhileCont{ - .cont_expr = cont_expr, - .then_expr = then_expr, - }), - }, - }); - } - }; - _ = try p.parsePayload(); - const else_expr = try p.expectExpr(); - return p.addNode(.{ - .tag = .@"while", - .main_token = while_token, - .data = .{ - .lhs = condition, - .rhs = try p.addExtra(Node.While{ - .cont_expr = cont_expr, - .then_expr = then_expr, - .else_expr = else_expr, - }), - }, - }); - } - - /// CurlySuffixExpr <- TypeExpr InitList? - /// - /// InitList - /// <- LBRACE FieldInit (COMMA FieldInit)* COMMA? RBRACE - /// / LBRACE Expr (COMMA Expr)* COMMA? RBRACE - /// / LBRACE RBRACE - fn parseCurlySuffixExpr(p: *Parser) !Node.Index { - const lhs = try p.parseTypeExpr(); - if (lhs == 0) return null_node; - const lbrace = p.eatToken(.l_brace) orelse return lhs; - - // If there are 0 or 1 items, we can use ArrayInitOne/StructInitOne; - // otherwise we use the full ArrayInit/StructInit. - - const scratch_top = p.scratch.items.len; - defer p.scratch.shrinkRetainingCapacity(scratch_top); - const field_init = try p.parseFieldInit(); - if (field_init != 0) { - try p.scratch.append(p.gpa, field_init); - while (true) { - switch (p.token_tags[p.tok_i]) { - .comma => p.tok_i += 1, - .r_brace => { - p.tok_i += 1; - break; - }, - .colon, .r_paren, .r_bracket => return p.failExpected(.r_brace), - // Likely just a missing comma; give error but continue parsing. - else => try p.warn(.expected_comma_after_initializer), - } - if (p.eatToken(.r_brace)) |_| break; - const next = try p.expectFieldInit(); - try p.scratch.append(p.gpa, next); - } - const comma = (p.token_tags[p.tok_i - 2] == .comma); - const inits = p.scratch.items[scratch_top..]; - switch (inits.len) { - 0 => unreachable, - 1 => return p.addNode(.{ - .tag = if (comma) .struct_init_one_comma else .struct_init_one, - .main_token = lbrace, - .data = .{ - .lhs = lhs, - .rhs = inits[0], - }, - }), - else => return p.addNode(.{ - .tag = if (comma) .struct_init_comma else .struct_init, - .main_token = lbrace, - .data = .{ - .lhs = lhs, - .rhs = try p.addExtra(try p.listToSpan(inits)), - }, - }), - } - } - - while (true) { - if (p.eatToken(.r_brace)) |_| break; - const elem_init = try p.expectExpr(); - try p.scratch.append(p.gpa, elem_init); - switch (p.token_tags[p.tok_i]) { - .comma => p.tok_i += 1, - .r_brace => { - p.tok_i += 1; - break; - }, - .colon, .r_paren, .r_bracket => return p.failExpected(.r_brace), - // Likely just a missing comma; give error but continue parsing. - else => try p.warn(.expected_comma_after_initializer), - } - } - const comma = (p.token_tags[p.tok_i - 2] == .comma); - const inits = p.scratch.items[scratch_top..]; - switch (inits.len) { - 0 => return p.addNode(.{ - .tag = .struct_init_one, - .main_token = lbrace, - .data = .{ - .lhs = lhs, - .rhs = 0, - }, - }), - 1 => return p.addNode(.{ - .tag = if (comma) .array_init_one_comma else .array_init_one, - .main_token = lbrace, - .data = .{ - .lhs = lhs, - .rhs = inits[0], - }, - }), - else => return p.addNode(.{ - .tag = if (comma) .array_init_comma else .array_init, - .main_token = lbrace, - .data = .{ - .lhs = lhs, - .rhs = try p.addExtra(try p.listToSpan(inits)), - }, - }), - } - } - - /// ErrorUnionExpr <- SuffixExpr (EXCLAMATIONMARK TypeExpr)? - fn parseErrorUnionExpr(p: *Parser) !Node.Index { - const suffix_expr = try p.parseSuffixExpr(); - if (suffix_expr == 0) return null_node; - const bang = p.eatToken(.bang) orelse return suffix_expr; - return p.addNode(.{ - .tag = .error_union, - .main_token = bang, - .data = .{ - .lhs = suffix_expr, - .rhs = try p.expectTypeExpr(), - }, - }); - } - - /// SuffixExpr - /// <- KEYWORD_async PrimaryTypeExpr SuffixOp* FnCallArguments - /// / PrimaryTypeExpr (SuffixOp / FnCallArguments)* - /// - /// FnCallArguments <- LPAREN ExprList RPAREN - /// - /// ExprList <- (Expr COMMA)* Expr? - fn parseSuffixExpr(p: *Parser) !Node.Index { - if (p.eatToken(.keyword_async)) |_| { - var res = try p.expectPrimaryTypeExpr(); - while (true) { - const node = try p.parseSuffixOp(res); - if (node == 0) break; - res = node; - } - const lparen = p.eatToken(.l_paren) orelse { - try p.warn(.expected_param_list); - return res; - }; - const scratch_top = p.scratch.items.len; - defer p.scratch.shrinkRetainingCapacity(scratch_top); - while (true) { - if (p.eatToken(.r_paren)) |_| break; - const param = try p.expectExpr(); - try p.scratch.append(p.gpa, param); - switch (p.token_tags[p.tok_i]) { - .comma => p.tok_i += 1, - .r_paren => { - p.tok_i += 1; - break; - }, - .colon, .r_brace, .r_bracket => return p.failExpected(.r_paren), - // Likely just a missing comma; give error but continue parsing. - else => try p.warn(.expected_comma_after_arg), - } - } - const comma = (p.token_tags[p.tok_i - 2] == .comma); - const params = p.scratch.items[scratch_top..]; - switch (params.len) { - 0 => return p.addNode(.{ - .tag = if (comma) .async_call_one_comma else .async_call_one, - .main_token = lparen, - .data = .{ - .lhs = res, - .rhs = 0, - }, - }), - 1 => return p.addNode(.{ - .tag = if (comma) .async_call_one_comma else .async_call_one, - .main_token = lparen, - .data = .{ - .lhs = res, - .rhs = params[0], - }, - }), - else => return p.addNode(.{ - .tag = if (comma) .async_call_comma else .async_call, - .main_token = lparen, - .data = .{ - .lhs = res, - .rhs = try p.addExtra(try p.listToSpan(params)), - }, - }), - } - } - - var res = try p.parsePrimaryTypeExpr(); - if (res == 0) return res; - while (true) { - const suffix_op = try p.parseSuffixOp(res); - if (suffix_op != 0) { - res = suffix_op; - continue; - } - const lparen = p.eatToken(.l_paren) orelse return res; - const scratch_top = p.scratch.items.len; - defer p.scratch.shrinkRetainingCapacity(scratch_top); - while (true) { - if (p.eatToken(.r_paren)) |_| break; - const param = try p.expectExpr(); - try p.scratch.append(p.gpa, param); - switch (p.token_tags[p.tok_i]) { - .comma => p.tok_i += 1, - .r_paren => { - p.tok_i += 1; - break; - }, - .colon, .r_brace, .r_bracket => return p.failExpected(.r_paren), - // Likely just a missing comma; give error but continue parsing. - else => try p.warn(.expected_comma_after_arg), - } - } - const comma = (p.token_tags[p.tok_i - 2] == .comma); - const params = p.scratch.items[scratch_top..]; - res = switch (params.len) { - 0 => try p.addNode(.{ - .tag = if (comma) .call_one_comma else .call_one, - .main_token = lparen, - .data = .{ - .lhs = res, - .rhs = 0, - }, - }), - 1 => try p.addNode(.{ - .tag = if (comma) .call_one_comma else .call_one, - .main_token = lparen, - .data = .{ - .lhs = res, - .rhs = params[0], - }, - }), - else => try p.addNode(.{ - .tag = if (comma) .call_comma else .call, - .main_token = lparen, - .data = .{ - .lhs = res, - .rhs = try p.addExtra(try p.listToSpan(params)), - }, - }), - }; - } - } - - /// PrimaryTypeExpr - /// <- BUILTINIDENTIFIER FnCallArguments - /// / CHAR_LITERAL - /// / ContainerDecl - /// / DOT IDENTIFIER - /// / DOT InitList - /// / ErrorSetDecl - /// / FLOAT - /// / FnProto - /// / GroupedExpr - /// / LabeledTypeExpr - /// / IDENTIFIER - /// / IfTypeExpr - /// / INTEGER - /// / KEYWORD_comptime TypeExpr - /// / KEYWORD_error DOT IDENTIFIER - /// / KEYWORD_anyframe - /// / KEYWORD_unreachable - /// / STRINGLITERAL - /// / SwitchExpr - /// - /// ContainerDecl <- (KEYWORD_extern / KEYWORD_packed)? ContainerDeclAuto - /// - /// ContainerDeclAuto <- ContainerDeclType LBRACE container_doc_comment? ContainerMembers RBRACE - /// - /// InitList - /// <- LBRACE FieldInit (COMMA FieldInit)* COMMA? RBRACE - /// / LBRACE Expr (COMMA Expr)* COMMA? RBRACE - /// / LBRACE RBRACE - /// - /// ErrorSetDecl <- KEYWORD_error LBRACE IdentifierList RBRACE - /// - /// GroupedExpr <- LPAREN Expr RPAREN - /// - /// IfTypeExpr <- IfPrefix TypeExpr (KEYWORD_else Payload? TypeExpr)? - /// - /// LabeledTypeExpr - /// <- BlockLabel Block - /// / BlockLabel? LoopTypeExpr - /// - /// LoopTypeExpr <- KEYWORD_inline? (ForTypeExpr / WhileTypeExpr) - fn parsePrimaryTypeExpr(p: *Parser) !Node.Index { - switch (p.token_tags[p.tok_i]) { - .char_literal => return p.addNode(.{ - .tag = .char_literal, - .main_token = p.nextToken(), - .data = .{ - .lhs = undefined, - .rhs = undefined, - }, - }), - .number_literal => return p.addNode(.{ - .tag = .number_literal, - .main_token = p.nextToken(), - .data = .{ - .lhs = undefined, - .rhs = undefined, - }, - }), - .keyword_unreachable => return p.addNode(.{ - .tag = .unreachable_literal, - .main_token = p.nextToken(), - .data = .{ - .lhs = undefined, - .rhs = undefined, - }, - }), - .keyword_anyframe => return p.addNode(.{ - .tag = .anyframe_literal, - .main_token = p.nextToken(), - .data = .{ - .lhs = undefined, - .rhs = undefined, - }, - }), - .string_literal => { - const main_token = p.nextToken(); - return p.addNode(.{ - .tag = .string_literal, - .main_token = main_token, - .data = .{ - .lhs = undefined, - .rhs = undefined, - }, - }); - }, - - .builtin => return p.parseBuiltinCall(), - .keyword_fn => return p.parseFnProto(), - .keyword_if => return p.parseIf(expectTypeExpr), - .keyword_switch => return p.expectSwitchExpr(), - - .keyword_extern, - .keyword_packed, - => { - p.tok_i += 1; - return p.parseContainerDeclAuto(); - }, - - .keyword_struct, - .keyword_opaque, - .keyword_enum, - .keyword_union, - => return p.parseContainerDeclAuto(), - - .keyword_comptime => return p.addNode(.{ - .tag = .@"comptime", - .main_token = p.nextToken(), - .data = .{ - .lhs = try p.expectTypeExpr(), - .rhs = undefined, - }, - }), - .multiline_string_literal_line => { - const first_line = p.nextToken(); - while (p.token_tags[p.tok_i] == .multiline_string_literal_line) { - p.tok_i += 1; - } - return p.addNode(.{ - .tag = .multiline_string_literal, - .main_token = first_line, - .data = .{ - .lhs = first_line, - .rhs = p.tok_i - 1, - }, - }); - }, - .identifier => switch (p.token_tags[p.tok_i + 1]) { - .colon => switch (p.token_tags[p.tok_i + 2]) { - .keyword_inline => { - p.tok_i += 3; - switch (p.token_tags[p.tok_i]) { - .keyword_for => return p.parseForTypeExpr(), - .keyword_while => return p.parseWhileTypeExpr(), - else => return p.fail(.expected_inlinable), - } - }, - .keyword_for => { - p.tok_i += 2; - return p.parseForTypeExpr(); - }, - .keyword_while => { - p.tok_i += 2; - return p.parseWhileTypeExpr(); - }, - .l_brace => { - p.tok_i += 2; - return p.parseBlock(); - }, - else => return p.addNode(.{ - .tag = .identifier, - .main_token = p.nextToken(), - .data = .{ - .lhs = undefined, - .rhs = undefined, - }, - }), - }, - else => return p.addNode(.{ - .tag = .identifier, - .main_token = p.nextToken(), - .data = .{ - .lhs = undefined, - .rhs = undefined, - }, - }), - }, - .keyword_inline => { - p.tok_i += 1; - switch (p.token_tags[p.tok_i]) { - .keyword_for => return p.parseForTypeExpr(), - .keyword_while => return p.parseWhileTypeExpr(), - else => return p.fail(.expected_inlinable), - } - }, - .keyword_for => return p.parseForTypeExpr(), - .keyword_while => return p.parseWhileTypeExpr(), - .period => switch (p.token_tags[p.tok_i + 1]) { - .identifier => return p.addNode(.{ - .tag = .enum_literal, - .data = .{ - .lhs = p.nextToken(), // dot - .rhs = undefined, - }, - .main_token = p.nextToken(), // identifier - }), - .l_brace => { - const lbrace = p.tok_i + 1; - p.tok_i = lbrace + 1; - - // If there are 0, 1, or 2 items, we can use ArrayInitDotTwo/StructInitDotTwo; - // otherwise we use the full ArrayInitDot/StructInitDot. - - const scratch_top = p.scratch.items.len; - defer p.scratch.shrinkRetainingCapacity(scratch_top); - const field_init = try p.parseFieldInit(); - if (field_init != 0) { - try p.scratch.append(p.gpa, field_init); - while (true) { - switch (p.token_tags[p.tok_i]) { - .comma => p.tok_i += 1, - .r_brace => { - p.tok_i += 1; - break; - }, - .colon, .r_paren, .r_bracket => return p.failExpected(.r_brace), - // Likely just a missing comma; give error but continue parsing. - else => try p.warn(.expected_comma_after_initializer), - } - if (p.eatToken(.r_brace)) |_| break; - const next = try p.expectFieldInit(); - try p.scratch.append(p.gpa, next); - } - const comma = (p.token_tags[p.tok_i - 2] == .comma); - const inits = p.scratch.items[scratch_top..]; - switch (inits.len) { - 0 => unreachable, - 1 => return p.addNode(.{ - .tag = if (comma) .struct_init_dot_two_comma else .struct_init_dot_two, - .main_token = lbrace, - .data = .{ - .lhs = inits[0], - .rhs = 0, - }, - }), - 2 => return p.addNode(.{ - .tag = if (comma) .struct_init_dot_two_comma else .struct_init_dot_two, - .main_token = lbrace, - .data = .{ - .lhs = inits[0], - .rhs = inits[1], - }, - }), - else => { - const span = try p.listToSpan(inits); - return p.addNode(.{ - .tag = if (comma) .struct_init_dot_comma else .struct_init_dot, - .main_token = lbrace, - .data = .{ - .lhs = span.start, - .rhs = span.end, - }, - }); - }, - } - } - - while (true) { - if (p.eatToken(.r_brace)) |_| break; - const elem_init = try p.expectExpr(); - try p.scratch.append(p.gpa, elem_init); - switch (p.token_tags[p.tok_i]) { - .comma => p.tok_i += 1, - .r_brace => { - p.tok_i += 1; - break; - }, - .colon, .r_paren, .r_bracket => return p.failExpected(.r_brace), - // Likely just a missing comma; give error but continue parsing. - else => try p.warn(.expected_comma_after_initializer), - } - } - const comma = (p.token_tags[p.tok_i - 2] == .comma); - const inits = p.scratch.items[scratch_top..]; - switch (inits.len) { - 0 => return p.addNode(.{ - .tag = .struct_init_dot_two, - .main_token = lbrace, - .data = .{ - .lhs = 0, - .rhs = 0, - }, - }), - 1 => return p.addNode(.{ - .tag = if (comma) .array_init_dot_two_comma else .array_init_dot_two, - .main_token = lbrace, - .data = .{ - .lhs = inits[0], - .rhs = 0, - }, - }), - 2 => return p.addNode(.{ - .tag = if (comma) .array_init_dot_two_comma else .array_init_dot_two, - .main_token = lbrace, - .data = .{ - .lhs = inits[0], - .rhs = inits[1], - }, - }), - else => { - const span = try p.listToSpan(inits); - return p.addNode(.{ - .tag = if (comma) .array_init_dot_comma else .array_init_dot, - .main_token = lbrace, - .data = .{ - .lhs = span.start, - .rhs = span.end, - }, - }); - }, - } - }, - else => return null_node, - }, - .keyword_error => switch (p.token_tags[p.tok_i + 1]) { - .l_brace => { - const error_token = p.tok_i; - p.tok_i += 2; - while (true) { - if (p.eatToken(.r_brace)) |_| break; - _ = try p.eatDocComments(); - _ = try p.expectToken(.identifier); - switch (p.token_tags[p.tok_i]) { - .comma => p.tok_i += 1, - .r_brace => { - p.tok_i += 1; - break; - }, - .colon, .r_paren, .r_bracket => return p.failExpected(.r_brace), - // Likely just a missing comma; give error but continue parsing. - else => try p.warn(.expected_comma_after_field), - } - } - return p.addNode(.{ - .tag = .error_set_decl, - .main_token = error_token, - .data = .{ - .lhs = undefined, - .rhs = p.tok_i - 1, // rbrace - }, - }); - }, - else => { - const main_token = p.nextToken(); - const period = p.eatToken(.period); - if (period == null) try p.warnExpected(.period); - const identifier = p.eatToken(.identifier); - if (identifier == null) try p.warnExpected(.identifier); - return p.addNode(.{ - .tag = .error_value, - .main_token = main_token, - .data = .{ - .lhs = period orelse 0, - .rhs = identifier orelse 0, - }, - }); - }, - }, - .l_paren => return p.addNode(.{ - .tag = .grouped_expression, - .main_token = p.nextToken(), - .data = .{ - .lhs = try p.expectExpr(), - .rhs = try p.expectToken(.r_paren), - }, - }), - else => return null_node, - } - } - - fn expectPrimaryTypeExpr(p: *Parser) !Node.Index { - const node = try p.parsePrimaryTypeExpr(); - if (node == 0) { - return p.fail(.expected_primary_type_expr); - } - return node; - } - - /// ForPrefix <- KEYWORD_for LPAREN Expr RPAREN PtrIndexPayload - /// - /// ForTypeExpr <- ForPrefix TypeExpr (KEYWORD_else TypeExpr)? - fn parseForTypeExpr(p: *Parser) !Node.Index { - const for_token = p.eatToken(.keyword_for) orelse return null_node; - _ = try p.expectToken(.l_paren); - const array_expr = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - const found_payload = try p.parsePtrIndexPayload(); - if (found_payload == 0) try p.warn(.expected_loop_payload); - - const then_expr = try p.expectTypeExpr(); - _ = p.eatToken(.keyword_else) orelse { - return p.addNode(.{ - .tag = .for_simple, - .main_token = for_token, - .data = .{ - .lhs = array_expr, - .rhs = then_expr, - }, - }); - }; - const else_expr = try p.expectTypeExpr(); - return p.addNode(.{ - .tag = .@"for", - .main_token = for_token, - .data = .{ - .lhs = array_expr, - .rhs = try p.addExtra(Node.If{ - .then_expr = then_expr, - .else_expr = else_expr, - }), - }, - }); - } - - /// WhilePrefix <- KEYWORD_while LPAREN Expr RPAREN PtrPayload? WhileContinueExpr? - /// - /// WhileTypeExpr <- WhilePrefix TypeExpr (KEYWORD_else Payload? TypeExpr)? - fn parseWhileTypeExpr(p: *Parser) !Node.Index { - const while_token = p.eatToken(.keyword_while) orelse return null_node; - _ = try p.expectToken(.l_paren); - const condition = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - _ = try p.parsePtrPayload(); - const cont_expr = try p.parseWhileContinueExpr(); - - const then_expr = try p.expectTypeExpr(); - _ = p.eatToken(.keyword_else) orelse { - if (cont_expr == 0) { - return p.addNode(.{ - .tag = .while_simple, - .main_token = while_token, - .data = .{ - .lhs = condition, - .rhs = then_expr, - }, - }); - } else { - return p.addNode(.{ - .tag = .while_cont, - .main_token = while_token, - .data = .{ - .lhs = condition, - .rhs = try p.addExtra(Node.WhileCont{ - .cont_expr = cont_expr, - .then_expr = then_expr, - }), - }, - }); - } - }; - _ = try p.parsePayload(); - const else_expr = try p.expectTypeExpr(); - return p.addNode(.{ - .tag = .@"while", - .main_token = while_token, - .data = .{ - .lhs = condition, - .rhs = try p.addExtra(Node.While{ - .cont_expr = cont_expr, - .then_expr = then_expr, - .else_expr = else_expr, - }), - }, - }); - } - - /// SwitchExpr <- KEYWORD_switch LPAREN Expr RPAREN LBRACE SwitchProngList RBRACE - fn expectSwitchExpr(p: *Parser) !Node.Index { - const switch_token = p.assertToken(.keyword_switch); - _ = try p.expectToken(.l_paren); - const expr_node = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - _ = try p.expectToken(.l_brace); - const cases = try p.parseSwitchProngList(); - const trailing_comma = p.token_tags[p.tok_i - 1] == .comma; - _ = try p.expectToken(.r_brace); - - return p.addNode(.{ - .tag = if (trailing_comma) .switch_comma else .@"switch", - .main_token = switch_token, - .data = .{ - .lhs = expr_node, - .rhs = try p.addExtra(Node.SubRange{ - .start = cases.start, - .end = cases.end, - }), - }, - }); - } - - /// AsmExpr <- KEYWORD_asm KEYWORD_volatile? LPAREN Expr AsmOutput? RPAREN - /// - /// AsmOutput <- COLON AsmOutputList AsmInput? - /// - /// AsmInput <- COLON AsmInputList AsmClobbers? - /// - /// AsmClobbers <- COLON StringList - /// - /// StringList <- (STRINGLITERAL COMMA)* STRINGLITERAL? - /// - /// AsmOutputList <- (AsmOutputItem COMMA)* AsmOutputItem? - /// - /// AsmInputList <- (AsmInputItem COMMA)* AsmInputItem? - fn expectAsmExpr(p: *Parser) !Node.Index { - const asm_token = p.assertToken(.keyword_asm); - _ = p.eatToken(.keyword_volatile); - _ = try p.expectToken(.l_paren); - const template = try p.expectExpr(); - - if (p.eatToken(.r_paren)) |rparen| { - return p.addNode(.{ - .tag = .asm_simple, - .main_token = asm_token, - .data = .{ - .lhs = template, - .rhs = rparen, - }, - }); - } - - _ = try p.expectToken(.colon); - - const scratch_top = p.scratch.items.len; - defer p.scratch.shrinkRetainingCapacity(scratch_top); - - while (true) { - const output_item = try p.parseAsmOutputItem(); - if (output_item == 0) break; - try p.scratch.append(p.gpa, output_item); - switch (p.token_tags[p.tok_i]) { - .comma => p.tok_i += 1, - // All possible delimiters. - .colon, .r_paren, .r_brace, .r_bracket => break, - // Likely just a missing comma; give error but continue parsing. - else => try p.warnExpected(.comma), - } - } - if (p.eatToken(.colon)) |_| { - while (true) { - const input_item = try p.parseAsmInputItem(); - if (input_item == 0) break; - try p.scratch.append(p.gpa, input_item); - switch (p.token_tags[p.tok_i]) { - .comma => p.tok_i += 1, - // All possible delimiters. - .colon, .r_paren, .r_brace, .r_bracket => break, - // Likely just a missing comma; give error but continue parsing. - else => try p.warnExpected(.comma), - } - } - if (p.eatToken(.colon)) |_| { - while (p.eatToken(.string_literal)) |_| { - switch (p.token_tags[p.tok_i]) { - .comma => p.tok_i += 1, - .colon, .r_paren, .r_brace, .r_bracket => break, - // Likely just a missing comma; give error but continue parsing. - else => try p.warnExpected(.comma), - } - } - } - } - const rparen = try p.expectToken(.r_paren); - const span = try p.listToSpan(p.scratch.items[scratch_top..]); - return p.addNode(.{ - .tag = .@"asm", - .main_token = asm_token, - .data = .{ - .lhs = template, - .rhs = try p.addExtra(Node.Asm{ - .items_start = span.start, - .items_end = span.end, - .rparen = rparen, - }), - }, - }); - } - - /// AsmOutputItem <- LBRACKET IDENTIFIER RBRACKET STRINGLITERAL LPAREN (MINUSRARROW TypeExpr / IDENTIFIER) RPAREN - fn parseAsmOutputItem(p: *Parser) !Node.Index { - _ = p.eatToken(.l_bracket) orelse return null_node; - const identifier = try p.expectToken(.identifier); - _ = try p.expectToken(.r_bracket); - _ = try p.expectToken(.string_literal); - _ = try p.expectToken(.l_paren); - const type_expr: Node.Index = blk: { - if (p.eatToken(.arrow)) |_| { - break :blk try p.expectTypeExpr(); - } else { - _ = try p.expectToken(.identifier); - break :blk null_node; - } - }; - const rparen = try p.expectToken(.r_paren); - return p.addNode(.{ - .tag = .asm_output, - .main_token = identifier, - .data = .{ - .lhs = type_expr, - .rhs = rparen, - }, - }); - } - - /// AsmInputItem <- LBRACKET IDENTIFIER RBRACKET STRINGLITERAL LPAREN Expr RPAREN - fn parseAsmInputItem(p: *Parser) !Node.Index { - _ = p.eatToken(.l_bracket) orelse return null_node; - const identifier = try p.expectToken(.identifier); - _ = try p.expectToken(.r_bracket); - _ = try p.expectToken(.string_literal); - _ = try p.expectToken(.l_paren); - const expr = try p.expectExpr(); - const rparen = try p.expectToken(.r_paren); - return p.addNode(.{ - .tag = .asm_input, - .main_token = identifier, - .data = .{ - .lhs = expr, - .rhs = rparen, - }, - }); - } - - /// BreakLabel <- COLON IDENTIFIER - fn parseBreakLabel(p: *Parser) !TokenIndex { - _ = p.eatToken(.colon) orelse return @as(TokenIndex, 0); - return p.expectToken(.identifier); - } - - /// BlockLabel <- IDENTIFIER COLON - fn parseBlockLabel(p: *Parser) TokenIndex { - if (p.token_tags[p.tok_i] == .identifier and - p.token_tags[p.tok_i + 1] == .colon) - { - const identifier = p.tok_i; - p.tok_i += 2; - return identifier; - } - return null_node; - } - - /// FieldInit <- DOT IDENTIFIER EQUAL Expr - fn parseFieldInit(p: *Parser) !Node.Index { - if (p.token_tags[p.tok_i + 0] == .period and - p.token_tags[p.tok_i + 1] == .identifier and - p.token_tags[p.tok_i + 2] == .equal) - { - p.tok_i += 3; - return p.expectExpr(); - } else { - return null_node; - } - } - - fn expectFieldInit(p: *Parser) !Node.Index { - if (p.token_tags[p.tok_i] != .period or - p.token_tags[p.tok_i + 1] != .identifier or - p.token_tags[p.tok_i + 2] != .equal) - return p.fail(.expected_initializer); - - p.tok_i += 3; - return p.expectExpr(); - } - - /// WhileContinueExpr <- COLON LPAREN AssignExpr RPAREN - fn parseWhileContinueExpr(p: *Parser) !Node.Index { - _ = p.eatToken(.colon) orelse { - if (p.token_tags[p.tok_i] == .l_paren and - p.tokensOnSameLine(p.tok_i - 1, p.tok_i)) - return p.fail(.expected_continue_expr); - return null_node; - }; - _ = try p.expectToken(.l_paren); - const node = try p.parseAssignExpr(); - if (node == 0) return p.fail(.expected_expr_or_assignment); - _ = try p.expectToken(.r_paren); - return node; - } - - /// LinkSection <- KEYWORD_linksection LPAREN Expr RPAREN - fn parseLinkSection(p: *Parser) !Node.Index { - _ = p.eatToken(.keyword_linksection) orelse return null_node; - _ = try p.expectToken(.l_paren); - const expr_node = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - return expr_node; - } - - /// CallConv <- KEYWORD_callconv LPAREN Expr RPAREN - fn parseCallconv(p: *Parser) !Node.Index { - _ = p.eatToken(.keyword_callconv) orelse return null_node; - _ = try p.expectToken(.l_paren); - const expr_node = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - return expr_node; - } - - /// AddrSpace <- KEYWORD_addrspace LPAREN Expr RPAREN - fn parseAddrSpace(p: *Parser) !Node.Index { - _ = p.eatToken(.keyword_addrspace) orelse return null_node; - _ = try p.expectToken(.l_paren); - const expr_node = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - return expr_node; - } - - /// This function can return null nodes and then still return nodes afterwards, - /// such as in the case of anytype and `...`. Caller must look for rparen to find - /// out when there are no more param decls left. - /// - /// ParamDecl - /// <- doc_comment? (KEYWORD_noalias / KEYWORD_comptime)? (IDENTIFIER COLON)? ParamType - /// / DOT3 - /// - /// ParamType - /// <- KEYWORD_anytype - /// / TypeExpr - fn expectParamDecl(p: *Parser) !Node.Index { - _ = try p.eatDocComments(); - switch (p.token_tags[p.tok_i]) { - .keyword_noalias, .keyword_comptime => p.tok_i += 1, - .ellipsis3 => { - p.tok_i += 1; - return null_node; - }, - else => {}, - } - if (p.token_tags[p.tok_i] == .identifier and - p.token_tags[p.tok_i + 1] == .colon) - { - p.tok_i += 2; - } - switch (p.token_tags[p.tok_i]) { - .keyword_anytype => { - p.tok_i += 1; - return null_node; - }, - else => return p.expectTypeExpr(), - } - } - - /// Payload <- PIPE IDENTIFIER PIPE - fn parsePayload(p: *Parser) !TokenIndex { - _ = p.eatToken(.pipe) orelse return @as(TokenIndex, 0); - const identifier = try p.expectToken(.identifier); - _ = try p.expectToken(.pipe); - return identifier; - } - - /// PtrPayload <- PIPE ASTERISK? IDENTIFIER PIPE - fn parsePtrPayload(p: *Parser) !TokenIndex { - _ = p.eatToken(.pipe) orelse return @as(TokenIndex, 0); - _ = p.eatToken(.asterisk); - const identifier = try p.expectToken(.identifier); - _ = try p.expectToken(.pipe); - return identifier; - } - - /// Returns the first identifier token, if any. - /// - /// PtrIndexPayload <- PIPE ASTERISK? IDENTIFIER (COMMA IDENTIFIER)? PIPE - fn parsePtrIndexPayload(p: *Parser) !TokenIndex { - _ = p.eatToken(.pipe) orelse return @as(TokenIndex, 0); - _ = p.eatToken(.asterisk); - const identifier = try p.expectToken(.identifier); - if (p.eatToken(.comma) != null) { - _ = try p.expectToken(.identifier); - } - _ = try p.expectToken(.pipe); - return identifier; - } - - /// SwitchProng <- KEYWORD_inline? SwitchCase EQUALRARROW PtrIndexPayload? AssignExpr - /// - /// SwitchCase - /// <- SwitchItem (COMMA SwitchItem)* COMMA? - /// / KEYWORD_else - fn parseSwitchProng(p: *Parser) !Node.Index { - const scratch_top = p.scratch.items.len; - defer p.scratch.shrinkRetainingCapacity(scratch_top); - - const is_inline = p.eatToken(.keyword_inline) != null; - - if (p.eatToken(.keyword_else) == null) { - while (true) { - const item = try p.parseSwitchItem(); - if (item == 0) break; - try p.scratch.append(p.gpa, item); - if (p.eatToken(.comma) == null) break; - } - if (scratch_top == p.scratch.items.len) { - if (is_inline) p.tok_i -= 1; - return null_node; - } - } - const arrow_token = try p.expectToken(.equal_angle_bracket_right); - _ = try p.parsePtrIndexPayload(); - - const items = p.scratch.items[scratch_top..]; - switch (items.len) { - 0 => return p.addNode(.{ - .tag = if (is_inline) .switch_case_inline_one else .switch_case_one, - .main_token = arrow_token, - .data = .{ - .lhs = 0, - .rhs = try p.expectAssignExpr(), - }, - }), - 1 => return p.addNode(.{ - .tag = if (is_inline) .switch_case_inline_one else .switch_case_one, - .main_token = arrow_token, - .data = .{ - .lhs = items[0], - .rhs = try p.expectAssignExpr(), - }, - }), - else => return p.addNode(.{ - .tag = if (is_inline) .switch_case_inline else .switch_case, - .main_token = arrow_token, - .data = .{ - .lhs = try p.addExtra(try p.listToSpan(items)), - .rhs = try p.expectAssignExpr(), - }, - }), - } - } - - /// SwitchItem <- Expr (DOT3 Expr)? - fn parseSwitchItem(p: *Parser) !Node.Index { - const expr = try p.parseExpr(); - if (expr == 0) return null_node; - - if (p.eatToken(.ellipsis3)) |token| { - return p.addNode(.{ - .tag = .switch_range, - .main_token = token, - .data = .{ - .lhs = expr, - .rhs = try p.expectExpr(), - }, - }); - } - return expr; - } - - const PtrModifiers = struct { - align_node: Node.Index, - addrspace_node: Node.Index, - bit_range_start: Node.Index, - bit_range_end: Node.Index, - }; - - fn parsePtrModifiers(p: *Parser) !PtrModifiers { - var result: PtrModifiers = .{ - .align_node = 0, - .addrspace_node = 0, - .bit_range_start = 0, - .bit_range_end = 0, - }; - var saw_const = false; - var saw_volatile = false; - var saw_allowzero = false; - var saw_addrspace = false; - while (true) { - switch (p.token_tags[p.tok_i]) { - .keyword_align => { - if (result.align_node != 0) { - try p.warn(.extra_align_qualifier); - } - p.tok_i += 1; - _ = try p.expectToken(.l_paren); - result.align_node = try p.expectExpr(); - - if (p.eatToken(.colon)) |_| { - result.bit_range_start = try p.expectExpr(); - _ = try p.expectToken(.colon); - result.bit_range_end = try p.expectExpr(); - } - - _ = try p.expectToken(.r_paren); - }, - .keyword_const => { - if (saw_const) { - try p.warn(.extra_const_qualifier); - } - p.tok_i += 1; - saw_const = true; - }, - .keyword_volatile => { - if (saw_volatile) { - try p.warn(.extra_volatile_qualifier); - } - p.tok_i += 1; - saw_volatile = true; - }, - .keyword_allowzero => { - if (saw_allowzero) { - try p.warn(.extra_allowzero_qualifier); - } - p.tok_i += 1; - saw_allowzero = true; - }, - .keyword_addrspace => { - if (saw_addrspace) { - try p.warn(.extra_addrspace_qualifier); - } - result.addrspace_node = try p.parseAddrSpace(); - }, - else => return result, - } - } - } - - /// SuffixOp - /// <- LBRACKET Expr (DOT2 (Expr? (COLON Expr)?)?)? RBRACKET - /// / DOT IDENTIFIER - /// / DOTASTERISK - /// / DOTQUESTIONMARK - fn parseSuffixOp(p: *Parser, lhs: Node.Index) !Node.Index { - switch (p.token_tags[p.tok_i]) { - .l_bracket => { - const lbracket = p.nextToken(); - const index_expr = try p.expectExpr(); - - if (p.eatToken(.ellipsis2)) |_| { - const end_expr = try p.parseExpr(); - if (p.eatToken(.colon)) |_| { - const sentinel = try p.expectExpr(); - _ = try p.expectToken(.r_bracket); - return p.addNode(.{ - .tag = .slice_sentinel, - .main_token = lbracket, - .data = .{ - .lhs = lhs, - .rhs = try p.addExtra(Node.SliceSentinel{ - .start = index_expr, - .end = end_expr, - .sentinel = sentinel, - }), - }, - }); - } - _ = try p.expectToken(.r_bracket); - if (end_expr == 0) { - return p.addNode(.{ - .tag = .slice_open, - .main_token = lbracket, - .data = .{ - .lhs = lhs, - .rhs = index_expr, - }, - }); - } - return p.addNode(.{ - .tag = .slice, - .main_token = lbracket, - .data = .{ - .lhs = lhs, - .rhs = try p.addExtra(Node.Slice{ - .start = index_expr, - .end = end_expr, - }), - }, - }); - } - _ = try p.expectToken(.r_bracket); - return p.addNode(.{ - .tag = .array_access, - .main_token = lbracket, - .data = .{ - .lhs = lhs, - .rhs = index_expr, - }, - }); - }, - .period_asterisk => return p.addNode(.{ - .tag = .deref, - .main_token = p.nextToken(), - .data = .{ - .lhs = lhs, - .rhs = undefined, - }, - }), - .invalid_periodasterisks => { - try p.warn(.asterisk_after_ptr_deref); - return p.addNode(.{ - .tag = .deref, - .main_token = p.nextToken(), - .data = .{ - .lhs = lhs, - .rhs = undefined, - }, - }); - }, - .period => switch (p.token_tags[p.tok_i + 1]) { - .identifier => return p.addNode(.{ - .tag = .field_access, - .main_token = p.nextToken(), - .data = .{ - .lhs = lhs, - .rhs = p.nextToken(), - }, - }), - .question_mark => return p.addNode(.{ - .tag = .unwrap_optional, - .main_token = p.nextToken(), - .data = .{ - .lhs = lhs, - .rhs = p.nextToken(), - }, - }), - .l_brace => { - // this a misplaced `.{`, handle the error somewhere else - return null_node; - }, - else => { - p.tok_i += 1; - try p.warn(.expected_suffix_op); - return null_node; - }, - }, - else => return null_node, - } - } - - /// Caller must have already verified the first token. - /// - /// ContainerDeclAuto <- ContainerDeclType LBRACE container_doc_comment? ContainerMembers RBRACE - /// - /// ContainerDeclType - /// <- KEYWORD_struct (LPAREN Expr RPAREN)? - /// / KEYWORD_opaque - /// / KEYWORD_enum (LPAREN Expr RPAREN)? - /// / KEYWORD_union (LPAREN (KEYWORD_enum (LPAREN Expr RPAREN)? / Expr) RPAREN)? - fn parseContainerDeclAuto(p: *Parser) !Node.Index { - const main_token = p.nextToken(); - const arg_expr = switch (p.token_tags[main_token]) { - .keyword_opaque => null_node, - .keyword_struct, .keyword_enum => blk: { - if (p.eatToken(.l_paren)) |_| { - const expr = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - break :blk expr; - } else { - break :blk null_node; - } - }, - .keyword_union => blk: { - if (p.eatToken(.l_paren)) |_| { - if (p.eatToken(.keyword_enum)) |_| { - if (p.eatToken(.l_paren)) |_| { - const enum_tag_expr = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - _ = try p.expectToken(.r_paren); - - _ = try p.expectToken(.l_brace); - const members = try p.parseContainerMembers(); - const members_span = try members.toSpan(p); - _ = try p.expectToken(.r_brace); - return p.addNode(.{ - .tag = switch (members.trailing) { - true => .tagged_union_enum_tag_trailing, - false => .tagged_union_enum_tag, - }, - .main_token = main_token, - .data = .{ - .lhs = enum_tag_expr, - .rhs = try p.addExtra(members_span), - }, - }); - } else { - _ = try p.expectToken(.r_paren); - - _ = try p.expectToken(.l_brace); - const members = try p.parseContainerMembers(); - _ = try p.expectToken(.r_brace); - if (members.len <= 2) { - return p.addNode(.{ - .tag = switch (members.trailing) { - true => .tagged_union_two_trailing, - false => .tagged_union_two, - }, - .main_token = main_token, - .data = .{ - .lhs = members.lhs, - .rhs = members.rhs, - }, - }); - } else { - const span = try members.toSpan(p); - return p.addNode(.{ - .tag = switch (members.trailing) { - true => .tagged_union_trailing, - false => .tagged_union, - }, - .main_token = main_token, - .data = .{ - .lhs = span.start, - .rhs = span.end, - }, - }); - } - } - } else { - const expr = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - break :blk expr; - } - } else { - break :blk null_node; - } - }, - else => { - p.tok_i -= 1; - return p.fail(.expected_container); - }, - }; - _ = try p.expectToken(.l_brace); - const members = try p.parseContainerMembers(); - _ = try p.expectToken(.r_brace); - if (arg_expr == 0) { - if (members.len <= 2) { - return p.addNode(.{ - .tag = switch (members.trailing) { - true => .container_decl_two_trailing, - false => .container_decl_two, - }, - .main_token = main_token, - .data = .{ - .lhs = members.lhs, - .rhs = members.rhs, - }, - }); - } else { - const span = try members.toSpan(p); - return p.addNode(.{ - .tag = switch (members.trailing) { - true => .container_decl_trailing, - false => .container_decl, - }, - .main_token = main_token, - .data = .{ - .lhs = span.start, - .rhs = span.end, - }, - }); - } - } else { - const span = try members.toSpan(p); - return p.addNode(.{ - .tag = switch (members.trailing) { - true => .container_decl_arg_trailing, - false => .container_decl_arg, - }, - .main_token = main_token, - .data = .{ - .lhs = arg_expr, - .rhs = try p.addExtra(Node.SubRange{ - .start = span.start, - .end = span.end, - }), - }, - }); - } - } - - /// Give a helpful error message for those transitioning from - /// C's 'struct Foo {};' to Zig's 'const Foo = struct {};'. - fn parseCStyleContainer(p: *Parser) Error!bool { - const main_token = p.tok_i; - switch (p.token_tags[p.tok_i]) { - .keyword_enum, .keyword_union, .keyword_struct => {}, - else => return false, - } - const identifier = p.tok_i + 1; - if (p.token_tags[identifier] != .identifier) return false; - p.tok_i += 2; - - try p.warnMsg(.{ - .tag = .c_style_container, - .token = identifier, - .extra = .{ .expected_tag = p.token_tags[main_token] }, - }); - try p.warnMsg(.{ - .tag = .zig_style_container, - .is_note = true, - .token = identifier, - .extra = .{ .expected_tag = p.token_tags[main_token] }, - }); - - _ = try p.expectToken(.l_brace); - _ = try p.parseContainerMembers(); - _ = try p.expectToken(.r_brace); - try p.expectSemicolon(.expected_semi_after_decl, true); - return true; - } - - /// Holds temporary data until we are ready to construct the full ContainerDecl AST node. - /// - /// ByteAlign <- KEYWORD_align LPAREN Expr RPAREN - fn parseByteAlign(p: *Parser) !Node.Index { - _ = p.eatToken(.keyword_align) orelse return null_node; - _ = try p.expectToken(.l_paren); - const expr = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - return expr; - } - - /// SwitchProngList <- (SwitchProng COMMA)* SwitchProng? - fn parseSwitchProngList(p: *Parser) !Node.SubRange { - const scratch_top = p.scratch.items.len; - defer p.scratch.shrinkRetainingCapacity(scratch_top); - - while (true) { - const item = try parseSwitchProng(p); - if (item == 0) break; - - try p.scratch.append(p.gpa, item); - - switch (p.token_tags[p.tok_i]) { - .comma => p.tok_i += 1, - // All possible delimiters. - .colon, .r_paren, .r_brace, .r_bracket => break, - // Likely just a missing comma; give error but continue parsing. - else => try p.warn(.expected_comma_after_switch_prong), - } - } - return p.listToSpan(p.scratch.items[scratch_top..]); - } - - /// ParamDeclList <- (ParamDecl COMMA)* ParamDecl? - fn parseParamDeclList(p: *Parser) !SmallSpan { - _ = try p.expectToken(.l_paren); - const scratch_top = p.scratch.items.len; - defer p.scratch.shrinkRetainingCapacity(scratch_top); - var varargs: union(enum) { none, seen, nonfinal: TokenIndex } = .none; - while (true) { - if (p.eatToken(.r_paren)) |_| break; - if (varargs == .seen) varargs = .{ .nonfinal = p.tok_i }; - const param = try p.expectParamDecl(); - if (param != 0) { - try p.scratch.append(p.gpa, param); - } else if (p.token_tags[p.tok_i - 1] == .ellipsis3) { - if (varargs == .none) varargs = .seen; - } - switch (p.token_tags[p.tok_i]) { - .comma => p.tok_i += 1, - .r_paren => { - p.tok_i += 1; - break; - }, - .colon, .r_brace, .r_bracket => return p.failExpected(.r_paren), - // Likely just a missing comma; give error but continue parsing. - else => try p.warn(.expected_comma_after_param), - } - } - if (varargs == .nonfinal) { - try p.warnMsg(.{ .tag = .varargs_nonfinal, .token = varargs.nonfinal }); - } - const params = p.scratch.items[scratch_top..]; - return switch (params.len) { - 0 => SmallSpan{ .zero_or_one = 0 }, - 1 => SmallSpan{ .zero_or_one = params[0] }, - else => SmallSpan{ .multi = try p.listToSpan(params) }, - }; - } - - /// FnCallArguments <- LPAREN ExprList RPAREN - /// - /// ExprList <- (Expr COMMA)* Expr? - fn parseBuiltinCall(p: *Parser) !Node.Index { - const builtin_token = p.assertToken(.builtin); - if (p.token_tags[p.nextToken()] != .l_paren) { - p.tok_i -= 1; - try p.warn(.expected_param_list); - // Pretend this was an identifier so we can continue parsing. - return p.addNode(.{ - .tag = .identifier, - .main_token = builtin_token, - .data = .{ - .lhs = undefined, - .rhs = undefined, - }, - }); - } - const scratch_top = p.scratch.items.len; - defer p.scratch.shrinkRetainingCapacity(scratch_top); - while (true) { - if (p.eatToken(.r_paren)) |_| break; - const param = try p.expectExpr(); - try p.scratch.append(p.gpa, param); - switch (p.token_tags[p.tok_i]) { - .comma => p.tok_i += 1, - .r_paren => { - p.tok_i += 1; - break; - }, - // Likely just a missing comma; give error but continue parsing. - else => try p.warn(.expected_comma_after_arg), - } - } - const comma = (p.token_tags[p.tok_i - 2] == .comma); - const params = p.scratch.items[scratch_top..]; - switch (params.len) { - 0 => return p.addNode(.{ - .tag = .builtin_call_two, - .main_token = builtin_token, - .data = .{ - .lhs = 0, - .rhs = 0, - }, - }), - 1 => return p.addNode(.{ - .tag = if (comma) .builtin_call_two_comma else .builtin_call_two, - .main_token = builtin_token, - .data = .{ - .lhs = params[0], - .rhs = 0, - }, - }), - 2 => return p.addNode(.{ - .tag = if (comma) .builtin_call_two_comma else .builtin_call_two, - .main_token = builtin_token, - .data = .{ - .lhs = params[0], - .rhs = params[1], - }, - }), - else => { - const span = try p.listToSpan(params); - return p.addNode(.{ - .tag = if (comma) .builtin_call_comma else .builtin_call, - .main_token = builtin_token, - .data = .{ - .lhs = span.start, - .rhs = span.end, - }, - }); - }, - } - } - - /// IfPrefix <- KEYWORD_if LPAREN Expr RPAREN PtrPayload? - fn parseIf(p: *Parser, comptime bodyParseFn: fn (p: *Parser) Error!Node.Index) !Node.Index { - const if_token = p.eatToken(.keyword_if) orelse return null_node; - _ = try p.expectToken(.l_paren); - const condition = try p.expectExpr(); - _ = try p.expectToken(.r_paren); - _ = try p.parsePtrPayload(); - - const then_expr = try bodyParseFn(p); - assert(then_expr != 0); - - _ = p.eatToken(.keyword_else) orelse return p.addNode(.{ - .tag = .if_simple, - .main_token = if_token, - .data = .{ - .lhs = condition, - .rhs = then_expr, - }, - }); - _ = try p.parsePayload(); - const else_expr = try bodyParseFn(p); - assert(then_expr != 0); - - return p.addNode(.{ - .tag = .@"if", - .main_token = if_token, - .data = .{ - .lhs = condition, - .rhs = try p.addExtra(Node.If{ - .then_expr = then_expr, - .else_expr = else_expr, - }), - }, - }); - } - - /// Skips over doc comment tokens. Returns the first one, if any. - fn eatDocComments(p: *Parser) !?TokenIndex { - if (p.eatToken(.doc_comment)) |tok| { - var first_line = tok; - if (tok > 0 and tokensOnSameLine(p, tok - 1, tok)) { - try p.warnMsg(.{ - .tag = .same_line_doc_comment, - .token = tok, - }); - first_line = p.eatToken(.doc_comment) orelse return null; - } - while (p.eatToken(.doc_comment)) |_| {} - return first_line; - } - return null; - } - - fn tokensOnSameLine(p: *Parser, token1: TokenIndex, token2: TokenIndex) bool { - return std.mem.indexOfScalar(u8, p.source[p.token_starts[token1]..p.token_starts[token2]], '\n') == null; - } - - fn eatToken(p: *Parser, tag: Token.Tag) ?TokenIndex { - return if (p.token_tags[p.tok_i] == tag) p.nextToken() else null; - } - - fn assertToken(p: *Parser, tag: Token.Tag) TokenIndex { - const token = p.nextToken(); - assert(p.token_tags[token] == tag); - return token; - } - - fn expectToken(p: *Parser, tag: Token.Tag) Error!TokenIndex { - if (p.token_tags[p.tok_i] != tag) { - return p.failMsg(.{ - .tag = .expected_token, - .token = p.tok_i, - .extra = .{ .expected_tag = tag }, - }); - } - return p.nextToken(); - } - - fn expectSemicolon(p: *Parser, error_tag: AstError.Tag, recoverable: bool) Error!void { - if (p.token_tags[p.tok_i] == .semicolon) { - _ = p.nextToken(); - return; - } - try p.warn(error_tag); - if (!recoverable) return error.ParseError; - } - - fn nextToken(p: *Parser) TokenIndex { - const result = p.tok_i; - p.tok_i += 1; - return result; - } -}; - -test { - _ = @import("parser_test.zig"); -} diff --git a/lib/std/zig/parser_test.zig b/lib/std/zig/parser_test.zig index 49b0715695..3c44322ccc 100644 --- a/lib/std/zig/parser_test.zig +++ b/lib/std/zig/parser_test.zig @@ -6073,7 +6073,7 @@ var fixed_buffer_mem: [100 * 1024]u8 = undefined; fn testParse(source: [:0]const u8, allocator: mem.Allocator, anything_changed: *bool) ![]u8 { const stderr = io.getStdErr().writer(); - var tree = try std.zig.parse(allocator, source); + var tree = try std.zig.Ast.parse(allocator, source, .zig); defer tree.deinit(allocator); for (tree.errors) |parse_error| { @@ -6124,7 +6124,7 @@ fn testCanonical(source: [:0]const u8) !void { const Error = std.zig.Ast.Error.Tag; fn testError(source: [:0]const u8, expected_errors: []const Error) !void { - var tree = try std.zig.parse(std.testing.allocator, source); + var tree = try std.zig.Ast.parse(std.testing.allocator, source, .zig); defer tree.deinit(std.testing.allocator); std.testing.expectEqual(expected_errors.len, tree.errors.len) catch |err| { diff --git a/lib/std/zig/perf_test.zig b/lib/std/zig/perf_test.zig index d3fc90eaea..58f7a67694 100644 --- a/lib/std/zig/perf_test.zig +++ b/lib/std/zig/perf_test.zig @@ -1,7 +1,6 @@ const std = @import("std"); const mem = std.mem; const Tokenizer = std.zig.Tokenizer; -const Parser = std.zig.Parser; const io = std.io; const fmtIntSizeBin = std.fmt.fmtIntSizeBin; @@ -34,6 +33,6 @@ pub fn main() !void { fn testOnce() usize { var fixed_buf_alloc = std.heap.FixedBufferAllocator.init(fixed_buffer_mem[0..]); var allocator = fixed_buf_alloc.allocator(); - _ = std.zig.parse(allocator, source) catch @panic("parse failure"); + _ = std.zig.Ast.parse(allocator, source, .zig) catch @panic("parse failure"); return fixed_buf_alloc.end_index; } diff --git a/src/Module.zig b/src/Module.zig index b395c0a950..3bb15e78c3 100644 --- a/src/Module.zig +++ b/src/Module.zig @@ -2057,7 +2057,7 @@ pub const File = struct { if (file.tree_loaded) return &file.tree; const source = try file.getSource(gpa); - file.tree = try std.zig.parse(gpa, source.bytes); + file.tree = try Ast.parse(gpa, source.bytes, .zig); file.tree_loaded = true; return &file.tree; } @@ -3662,7 +3662,7 @@ pub fn astGenFile(mod: *Module, file: *File) !void { file.source = source; file.source_loaded = true; - file.tree = try std.zig.parse(gpa, source); + file.tree = try Ast.parse(gpa, source, .zig); defer if (!file.tree_loaded) file.tree.deinit(gpa); if (file.tree.errors.len != 0) { @@ -3977,7 +3977,7 @@ pub fn populateBuiltinFile(mod: *Module) !void { else => |e| return e, } - file.tree = try std.zig.parse(gpa, file.source); + file.tree = try Ast.parse(gpa, file.source, .zig); file.tree_loaded = true; assert(file.tree.errors.len == 0); // builtin.zig must parse diff --git a/src/main.zig b/src/main.zig index 72e7e094e6..06c36bad87 100644 --- a/src/main.zig +++ b/src/main.zig @@ -4361,7 +4361,7 @@ pub fn cmdFmt(gpa: Allocator, arena: Allocator, args: []const []const u8) !void }; defer gpa.free(source_code); - var tree = std.zig.parse(gpa, source_code) catch |err| { + var tree = Ast.parse(gpa, source_code, .zig) catch |err| { fatal("error parsing stdin: {}", .{err}); }; defer tree.deinit(gpa); @@ -4566,7 +4566,7 @@ fn fmtPathFile( // Add to set after no longer possible to get error.IsDir. if (try fmt.seen.fetchPut(stat.inode, {})) |_| return; - var tree = try std.zig.parse(fmt.gpa, source_code); + var tree = try Ast.parse(fmt.gpa, source_code, .zig); defer tree.deinit(fmt.gpa); try printErrsMsgToStdErr(fmt.gpa, fmt.arena, tree.errors, tree, file_path, fmt.color); @@ -5312,7 +5312,7 @@ pub fn cmdAstCheck( file.pkg = try Package.create(gpa, "root", null, file.sub_file_path); defer file.pkg.destroy(gpa); - file.tree = try std.zig.parse(gpa, file.source); + file.tree = try Ast.parse(gpa, file.source, .zig); file.tree_loaded = true; defer file.tree.deinit(gpa); @@ -5438,7 +5438,7 @@ pub fn cmdChangelist( file.source = source; file.source_loaded = true; - file.tree = try std.zig.parse(gpa, file.source); + file.tree = try Ast.parse(gpa, file.source, .zig); file.tree_loaded = true; defer file.tree.deinit(gpa); @@ -5476,7 +5476,7 @@ pub fn cmdChangelist( if (new_amt != new_stat.size) return error.UnexpectedEndOfFile; - var new_tree = try std.zig.parse(gpa, new_source); + var new_tree = try Ast.parse(gpa, new_source, .zig); defer new_tree.deinit(gpa); try printErrsMsgToStdErr(gpa, arena, new_tree.errors, new_tree, new_source_file, .auto); From 81c27c74bc8ccc8087b75c5d4eb1b350ad907cd0 Mon Sep 17 00:00:00 2001 From: Andrew Kelley Date: Thu, 2 Feb 2023 23:45:23 -0700 Subject: [PATCH 81/84] use build.zig.zon instead of build.zig.ini for the manifest file * improve error message when build manifest file is missing * update std.zig.Ast to support ZON * Compilation.AllErrors.Message: make the notes field a const slice * move build manifest parsing logic into src/Manifest.zig and add more checks, and make the checks integrate into the standard error reporting code so that reported errors look sexy closes #14290 --- lib/std/Build.zig | 4 +- lib/std/array_hash_map.zig | 3 +- lib/std/zig/Ast.zig | 4 + lib/std/zig/Parse.zig | 13 +- src/Compilation.zig | 2 +- src/Manifest.zig | 499 +++++++++++++++++++++++++++++++++++++ src/Package.zig | 347 ++++++++++---------------- src/main.zig | 17 +- 8 files changed, 665 insertions(+), 224 deletions(-) create mode 100644 src/Manifest.zig diff --git a/lib/std/Build.zig b/lib/std/Build.zig index d695637fc3..6846007443 100644 --- a/lib/std/Build.zig +++ b/lib/std/Build.zig @@ -1496,8 +1496,8 @@ pub fn dependency(b: *Build, name: []const u8, args: anytype) *Dependency { } } - const full_path = b.pathFromRoot("build.zig.ini"); - std.debug.print("no dependency named '{s}' in '{s}'\n", .{ name, full_path }); + const full_path = b.pathFromRoot("build.zig.zon"); + std.debug.print("no dependency named '{s}' in '{s}'. All packages used in build.zig must be declared in this file.\n", .{ name, full_path }); std.process.exit(1); } diff --git a/lib/std/array_hash_map.zig b/lib/std/array_hash_map.zig index cf04a54116..57821d1b51 100644 --- a/lib/std/array_hash_map.zig +++ b/lib/std/array_hash_map.zig @@ -1145,7 +1145,8 @@ pub fn ArrayHashMapUnmanaged( } /// Create a copy of the hash map which can be modified separately. - /// The copy uses the same context and allocator as this instance. + /// The copy uses the same context as this instance, but is allocated + /// with the provided allocator. pub fn clone(self: Self, allocator: Allocator) !Self { if (@sizeOf(ByIndexContext) != 0) @compileError("Cannot infer context " ++ @typeName(Context) ++ ", call cloneContext instead."); diff --git a/lib/std/zig/Ast.zig b/lib/std/zig/Ast.zig index a9a02606eb..80dda052ab 100644 --- a/lib/std/zig/Ast.zig +++ b/lib/std/zig/Ast.zig @@ -1,4 +1,8 @@ //! Abstract Syntax Tree for Zig source code. +//! For Zig syntax, the root node is at nodes[0] and contains the list of +//! sub-nodes. +//! For Zon syntax, the root node is at nodes[0] and contains lhs as the node +//! index of the main expression. /// Reference to externally-owned data. source: [:0]const u8, diff --git a/lib/std/zig/Parse.zig b/lib/std/zig/Parse.zig index f599a08f55..d498366b34 100644 --- a/lib/std/zig/Parse.zig +++ b/lib/std/zig/Parse.zig @@ -181,17 +181,26 @@ pub fn parseRoot(p: *Parse) !void { /// TODO: set a flag in Parse struct, and honor that flag /// by emitting compilation errors when non-zon nodes are encountered. pub fn parseZon(p: *Parse) !void { - const node_index = p.parseExpr() catch |err| switch (err) { + // We must use index 0 so that 0 can be used as null elsewhere. + p.nodes.appendAssumeCapacity(.{ + .tag = .root, + .main_token = 0, + .data = undefined, + }); + const node_index = p.expectExpr() catch |err| switch (err) { error.ParseError => { assert(p.errors.items.len > 0); return; }, else => |e| return e, }; - assert(node_index == 0); if (p.token_tags[p.tok_i] != .eof) { try p.warnExpected(.eof); } + p.nodes.items(.data)[0] = .{ + .lhs = node_index, + .rhs = undefined, + }; } /// ContainerMembers <- ContainerDeclarations (ContainerField COMMA)* (ContainerField / ContainerDeclarations) diff --git a/src/Compilation.zig b/src/Compilation.zig index 7d42d3b610..e09b8f18ab 100644 --- a/src/Compilation.zig +++ b/src/Compilation.zig @@ -385,7 +385,7 @@ pub const AllErrors = struct { count: u32 = 1, /// Does not include the trailing newline. source_line: ?[]const u8, - notes: []Message = &.{}, + notes: []const Message = &.{}, reference_trace: []Message = &.{}, /// Splits the error message up into lines to properly indent them diff --git a/src/Manifest.zig b/src/Manifest.zig new file mode 100644 index 0000000000..c3f77aec98 --- /dev/null +++ b/src/Manifest.zig @@ -0,0 +1,499 @@ +pub const basename = "build.zig.zon"; +pub const Hash = std.crypto.hash.sha2.Sha256; + +pub const Dependency = struct { + url: []const u8, + url_tok: Ast.TokenIndex, + hash: ?[]const u8, + hash_tok: Ast.TokenIndex, +}; + +pub const ErrorMessage = struct { + msg: []const u8, + tok: Ast.TokenIndex, + off: u32, +}; + +pub const MultihashFunction = enum(u16) { + identity = 0x00, + sha1 = 0x11, + @"sha2-256" = 0x12, + @"sha2-512" = 0x13, + @"sha3-512" = 0x14, + @"sha3-384" = 0x15, + @"sha3-256" = 0x16, + @"sha3-224" = 0x17, + @"sha2-384" = 0x20, + @"sha2-256-trunc254-padded" = 0x1012, + @"sha2-224" = 0x1013, + @"sha2-512-224" = 0x1014, + @"sha2-512-256" = 0x1015, + @"blake2b-256" = 0xb220, + _, +}; + +pub const multihash_function: MultihashFunction = switch (Hash) { + std.crypto.hash.sha2.Sha256 => .@"sha2-256", + else => @compileError("unreachable"), +}; +comptime { + // We avoid unnecessary uleb128 code in hexDigest by asserting here the + // values are small enough to be contained in the one-byte encoding. + assert(@enumToInt(multihash_function) < 127); + assert(Hash.digest_length < 127); +} +pub const multihash_len = 1 + 1 + Hash.digest_length; + +name: []const u8, +version: std.SemanticVersion, +dependencies: std.StringArrayHashMapUnmanaged(Dependency), + +errors: []ErrorMessage, +arena_state: std.heap.ArenaAllocator.State, + +pub const Error = Allocator.Error; + +pub fn parse(gpa: Allocator, ast: std.zig.Ast) Error!Manifest { + const node_tags = ast.nodes.items(.tag); + const node_datas = ast.nodes.items(.data); + assert(node_tags[0] == .root); + const main_node_index = node_datas[0].lhs; + + var arena_instance = std.heap.ArenaAllocator.init(gpa); + errdefer arena_instance.deinit(); + + var p: Parse = .{ + .gpa = gpa, + .ast = ast, + .arena = arena_instance.allocator(), + .errors = .{}, + + .name = undefined, + .version = undefined, + .dependencies = .{}, + .buf = .{}, + }; + defer p.buf.deinit(gpa); + defer p.errors.deinit(gpa); + defer p.dependencies.deinit(gpa); + + p.parseRoot(main_node_index) catch |err| switch (err) { + error.ParseFailure => assert(p.errors.items.len > 0), + else => |e| return e, + }; + + return .{ + .name = p.name, + .version = p.version, + .dependencies = try p.dependencies.clone(p.arena), + .errors = try p.arena.dupe(ErrorMessage, p.errors.items), + .arena_state = arena_instance.state, + }; +} + +pub fn deinit(man: *Manifest, gpa: Allocator) void { + man.arena_state.promote(gpa).deinit(); + man.* = undefined; +} + +const hex_charset = "0123456789abcdef"; + +pub fn hex64(x: u64) [16]u8 { + var result: [16]u8 = undefined; + var i: usize = 0; + while (i < 8) : (i += 1) { + const byte = @truncate(u8, x >> @intCast(u6, 8 * i)); + result[i * 2 + 0] = hex_charset[byte >> 4]; + result[i * 2 + 1] = hex_charset[byte & 15]; + } + return result; +} + +test hex64 { + const s = "[" ++ hex64(0x12345678_abcdef00) ++ "]"; + try std.testing.expectEqualStrings("[00efcdab78563412]", s); +} + +pub fn hexDigest(digest: [Hash.digest_length]u8) [multihash_len * 2]u8 { + var result: [multihash_len * 2]u8 = undefined; + + result[0] = hex_charset[@enumToInt(multihash_function) >> 4]; + result[1] = hex_charset[@enumToInt(multihash_function) & 15]; + + result[2] = hex_charset[Hash.digest_length >> 4]; + result[3] = hex_charset[Hash.digest_length & 15]; + + for (digest) |byte, i| { + result[4 + i * 2] = hex_charset[byte >> 4]; + result[5 + i * 2] = hex_charset[byte & 15]; + } + return result; +} + +const Parse = struct { + gpa: Allocator, + ast: std.zig.Ast, + arena: Allocator, + buf: std.ArrayListUnmanaged(u8), + errors: std.ArrayListUnmanaged(ErrorMessage), + + name: []const u8, + version: std.SemanticVersion, + dependencies: std.StringArrayHashMapUnmanaged(Dependency), + + const InnerError = error{ ParseFailure, OutOfMemory }; + + fn parseRoot(p: *Parse, node: Ast.Node.Index) !void { + const ast = p.ast; + const main_tokens = ast.nodes.items(.main_token); + const main_token = main_tokens[node]; + + var buf: [2]Ast.Node.Index = undefined; + const struct_init = ast.fullStructInit(&buf, node) orelse { + return fail(p, main_token, "expected top level expression to be a struct", .{}); + }; + + var have_name = false; + var have_version = false; + + for (struct_init.ast.fields) |field_init| { + const name_token = ast.firstToken(field_init) - 2; + const field_name = try identifierTokenString(p, name_token); + // We could get fancy with reflection and comptime logic here but doing + // things manually provides an opportunity to do any additional verification + // that is desirable on a per-field basis. + if (mem.eql(u8, field_name, "dependencies")) { + try parseDependencies(p, field_init); + } else if (mem.eql(u8, field_name, "name")) { + p.name = try parseString(p, field_init); + have_name = true; + } else if (mem.eql(u8, field_name, "version")) { + const version_text = try parseString(p, field_init); + p.version = std.SemanticVersion.parse(version_text) catch |err| v: { + try appendError(p, main_tokens[field_init], "unable to parse semantic version: {s}", .{@errorName(err)}); + break :v undefined; + }; + have_version = true; + } else { + // Ignore unknown fields so that we can add fields in future zig + // versions without breaking older zig versions. + } + } + + if (!have_name) { + try appendError(p, main_token, "missing top-level 'name' field", .{}); + } + + if (!have_version) { + try appendError(p, main_token, "missing top-level 'version' field", .{}); + } + } + + fn parseDependencies(p: *Parse, node: Ast.Node.Index) !void { + const ast = p.ast; + const main_tokens = ast.nodes.items(.main_token); + + var buf: [2]Ast.Node.Index = undefined; + const struct_init = ast.fullStructInit(&buf, node) orelse { + const tok = main_tokens[node]; + return fail(p, tok, "expected dependencies expression to be a struct", .{}); + }; + + for (struct_init.ast.fields) |field_init| { + const name_token = ast.firstToken(field_init) - 2; + const dep_name = try identifierTokenString(p, name_token); + const dep = try parseDependency(p, field_init); + try p.dependencies.put(p.gpa, dep_name, dep); + } + } + + fn parseDependency(p: *Parse, node: Ast.Node.Index) !Dependency { + const ast = p.ast; + const main_tokens = ast.nodes.items(.main_token); + + var buf: [2]Ast.Node.Index = undefined; + const struct_init = ast.fullStructInit(&buf, node) orelse { + const tok = main_tokens[node]; + return fail(p, tok, "expected dependency expression to be a struct", .{}); + }; + + var dep: Dependency = .{ + .url = undefined, + .url_tok = undefined, + .hash = null, + .hash_tok = undefined, + }; + var have_url = false; + + for (struct_init.ast.fields) |field_init| { + const name_token = ast.firstToken(field_init) - 2; + const field_name = try identifierTokenString(p, name_token); + // We could get fancy with reflection and comptime logic here but doing + // things manually provides an opportunity to do any additional verification + // that is desirable on a per-field basis. + if (mem.eql(u8, field_name, "url")) { + dep.url = parseString(p, field_init) catch |err| switch (err) { + error.ParseFailure => continue, + else => |e| return e, + }; + dep.url_tok = main_tokens[field_init]; + have_url = true; + } else if (mem.eql(u8, field_name, "hash")) { + dep.hash = parseHash(p, field_init) catch |err| switch (err) { + error.ParseFailure => continue, + else => |e| return e, + }; + dep.hash_tok = main_tokens[field_init]; + } else { + // Ignore unknown fields so that we can add fields in future zig + // versions without breaking older zig versions. + } + } + + if (!have_url) { + try appendError(p, main_tokens[node], "dependency is missing 'url' field", .{}); + } + + return dep; + } + + fn parseString(p: *Parse, node: Ast.Node.Index) ![]const u8 { + const ast = p.ast; + const node_tags = ast.nodes.items(.tag); + const main_tokens = ast.nodes.items(.main_token); + if (node_tags[node] != .string_literal) { + return fail(p, main_tokens[node], "expected string literal", .{}); + } + const str_lit_token = main_tokens[node]; + const token_bytes = ast.tokenSlice(str_lit_token); + p.buf.clearRetainingCapacity(); + try parseStrLit(p, str_lit_token, &p.buf, token_bytes, 0); + const duped = try p.arena.dupe(u8, p.buf.items); + return duped; + } + + fn parseHash(p: *Parse, node: Ast.Node.Index) ![]const u8 { + const ast = p.ast; + const main_tokens = ast.nodes.items(.main_token); + const tok = main_tokens[node]; + const h = try parseString(p, node); + + if (h.len >= 2) { + const their_multihash_func = std.fmt.parseInt(u8, h[0..2], 16) catch |err| { + return fail(p, tok, "invalid multihash value: unable to parse hash function: {s}", .{ + @errorName(err), + }); + }; + if (@intToEnum(MultihashFunction, their_multihash_func) != multihash_function) { + return fail(p, tok, "unsupported hash function: only sha2-256 is supported", .{}); + } + } + + const hex_multihash_len = 2 * Manifest.multihash_len; + if (h.len != hex_multihash_len) { + return fail(p, tok, "wrong hash size. expected: {d}, found: {d}", .{ + hex_multihash_len, h.len, + }); + } + + return h; + } + + /// TODO: try to DRY this with AstGen.identifierTokenString + fn identifierTokenString(p: *Parse, token: Ast.TokenIndex) InnerError![]const u8 { + const ast = p.ast; + const token_tags = ast.tokens.items(.tag); + assert(token_tags[token] == .identifier); + const ident_name = ast.tokenSlice(token); + if (!mem.startsWith(u8, ident_name, "@")) { + return ident_name; + } + p.buf.clearRetainingCapacity(); + try parseStrLit(p, token, &p.buf, ident_name, 1); + const duped = try p.arena.dupe(u8, p.buf.items); + return duped; + } + + /// TODO: try to DRY this with AstGen.parseStrLit + fn parseStrLit( + p: *Parse, + token: Ast.TokenIndex, + buf: *std.ArrayListUnmanaged(u8), + bytes: []const u8, + offset: u32, + ) InnerError!void { + const raw_string = bytes[offset..]; + var buf_managed = buf.toManaged(p.gpa); + const result = std.zig.string_literal.parseWrite(buf_managed.writer(), raw_string); + buf.* = buf_managed.moveToUnmanaged(); + switch (try result) { + .success => {}, + .failure => |err| try p.appendStrLitError(err, token, bytes, offset), + } + } + + /// TODO: try to DRY this with AstGen.failWithStrLitError + fn appendStrLitError( + p: *Parse, + err: std.zig.string_literal.Error, + token: Ast.TokenIndex, + bytes: []const u8, + offset: u32, + ) Allocator.Error!void { + const raw_string = bytes[offset..]; + switch (err) { + .invalid_escape_character => |bad_index| { + try p.appendErrorOff( + token, + offset + @intCast(u32, bad_index), + "invalid escape character: '{c}'", + .{raw_string[bad_index]}, + ); + }, + .expected_hex_digit => |bad_index| { + try p.appendErrorOff( + token, + offset + @intCast(u32, bad_index), + "expected hex digit, found '{c}'", + .{raw_string[bad_index]}, + ); + }, + .empty_unicode_escape_sequence => |bad_index| { + try p.appendErrorOff( + token, + offset + @intCast(u32, bad_index), + "empty unicode escape sequence", + .{}, + ); + }, + .expected_hex_digit_or_rbrace => |bad_index| { + try p.appendErrorOff( + token, + offset + @intCast(u32, bad_index), + "expected hex digit or '}}', found '{c}'", + .{raw_string[bad_index]}, + ); + }, + .invalid_unicode_codepoint => |bad_index| { + try p.appendErrorOff( + token, + offset + @intCast(u32, bad_index), + "unicode escape does not correspond to a valid codepoint", + .{}, + ); + }, + .expected_lbrace => |bad_index| { + try p.appendErrorOff( + token, + offset + @intCast(u32, bad_index), + "expected '{{', found '{c}", + .{raw_string[bad_index]}, + ); + }, + .expected_rbrace => |bad_index| { + try p.appendErrorOff( + token, + offset + @intCast(u32, bad_index), + "expected '}}', found '{c}", + .{raw_string[bad_index]}, + ); + }, + .expected_single_quote => |bad_index| { + try p.appendErrorOff( + token, + offset + @intCast(u32, bad_index), + "expected single quote ('), found '{c}", + .{raw_string[bad_index]}, + ); + }, + .invalid_character => |bad_index| { + try p.appendErrorOff( + token, + offset + @intCast(u32, bad_index), + "invalid byte in string or character literal: '{c}'", + .{raw_string[bad_index]}, + ); + }, + } + } + + fn fail( + p: *Parse, + tok: Ast.TokenIndex, + comptime fmt: []const u8, + args: anytype, + ) InnerError { + try appendError(p, tok, fmt, args); + return error.ParseFailure; + } + + fn appendError(p: *Parse, tok: Ast.TokenIndex, comptime fmt: []const u8, args: anytype) !void { + return appendErrorOff(p, tok, 0, fmt, args); + } + + fn appendErrorOff( + p: *Parse, + tok: Ast.TokenIndex, + byte_offset: u32, + comptime fmt: []const u8, + args: anytype, + ) Allocator.Error!void { + try p.errors.append(p.gpa, .{ + .msg = try std.fmt.allocPrint(p.arena, fmt, args), + .tok = tok, + .off = byte_offset, + }); + } +}; + +const Manifest = @This(); +const std = @import("std"); +const mem = std.mem; +const Allocator = std.mem.Allocator; +const assert = std.debug.assert; +const Ast = std.zig.Ast; +const testing = std.testing; + +test "basic" { + const gpa = testing.allocator; + + const example = + \\.{ + \\ .name = "foo", + \\ .version = "3.2.1", + \\ .dependencies = .{ + \\ .bar = .{ + \\ .url = "https://example.com/baz.tar.gz", + \\ .hash = "1220f1b680b6065fcfc94fe777f22e73bcb7e2767e5f4d99d4255fe76ded69c7a35f", + \\ }, + \\ }, + \\} + ; + + var ast = try std.zig.Ast.parse(gpa, example, .zon); + defer ast.deinit(gpa); + + try testing.expect(ast.errors.len == 0); + + var manifest = try Manifest.parse(gpa, ast); + defer manifest.deinit(gpa); + + try testing.expectEqualStrings("foo", manifest.name); + + try testing.expectEqual(@as(std.SemanticVersion, .{ + .major = 3, + .minor = 2, + .patch = 1, + }), manifest.version); + + try testing.expect(manifest.dependencies.count() == 1); + try testing.expectEqualStrings("bar", manifest.dependencies.keys()[0]); + try testing.expectEqualStrings( + "https://example.com/baz.tar.gz", + manifest.dependencies.values()[0].url, + ); + try testing.expectEqualStrings( + "1220f1b680b6065fcfc94fe777f22e73bcb7e2767e5f4d99d4255fe76ded69c7a35f", + manifest.dependencies.values()[0].hash orelse return error.TestFailed, + ); +} diff --git a/src/Package.zig b/src/Package.zig index 35b1ff5056..401eef2121 100644 --- a/src/Package.zig +++ b/src/Package.zig @@ -6,8 +6,8 @@ const fs = std.fs; const mem = std.mem; const Allocator = mem.Allocator; const assert = std.debug.assert; -const Hash = std.crypto.hash.sha2.Sha256; const log = std.log.scoped(.package); +const main = @import("main.zig"); const Compilation = @import("Compilation.zig"); const Module = @import("Module.zig"); @@ -15,6 +15,7 @@ const ThreadPool = @import("ThreadPool.zig"); const WaitGroup = @import("WaitGroup.zig"); const Cache = @import("Cache.zig"); const build_options = @import("build_options"); +const Manifest = @import("Manifest.zig"); pub const Table = std.StringHashMapUnmanaged(*Package); @@ -141,10 +142,10 @@ pub fn addAndAdopt(parent: *Package, gpa: Allocator, child: *Package) !void { } pub const build_zig_basename = "build.zig"; -pub const ini_basename = build_zig_basename ++ ".ini"; pub fn fetchAndAddDependencies( pkg: *Package, + arena: Allocator, thread_pool: *ThreadPool, http_client: *std.http.Client, directory: Compilation.Directory, @@ -153,89 +154,77 @@ pub fn fetchAndAddDependencies( dependencies_source: *std.ArrayList(u8), build_roots_source: *std.ArrayList(u8), name_prefix: []const u8, + color: main.Color, ) !void { const max_bytes = 10 * 1024 * 1024; const gpa = thread_pool.allocator; - const build_zig_ini = directory.handle.readFileAlloc(gpa, ini_basename, max_bytes) catch |err| switch (err) { + const build_zig_zon_bytes = directory.handle.readFileAllocOptions( + arena, + Manifest.basename, + max_bytes, + null, + 1, + 0, + ) catch |err| switch (err) { error.FileNotFound => { // Handle the same as no dependencies. return; }, else => |e| return e, }; - defer gpa.free(build_zig_ini); - const ini: std.Ini = .{ .bytes = build_zig_ini }; - var any_error = false; - var it = ini.iterateSection("\n[dependency]\n"); - while (it.next()) |dep| { - var line_it = mem.split(u8, dep, "\n"); - var opt_name: ?[]const u8 = null; - var opt_url: ?[]const u8 = null; - var expected_hash: ?[]const u8 = null; - while (line_it.next()) |kv| { - const eq_pos = mem.indexOfScalar(u8, kv, '=') orelse continue; - const key = kv[0..eq_pos]; - const value = kv[eq_pos + 1 ..]; - if (mem.eql(u8, key, "name")) { - opt_name = value; - } else if (mem.eql(u8, key, "url")) { - opt_url = value; - } else if (mem.eql(u8, key, "hash")) { - expected_hash = value; - } else { - const loc = std.zig.findLineColumn(ini.bytes, @ptrToInt(key.ptr) - @ptrToInt(ini.bytes.ptr)); - std.log.warn("{s}/{s}:{d}:{d} unrecognized key: '{s}'", .{ - directory.path orelse ".", - "build.zig.ini", - loc.line, - loc.column, - key, - }); - } + var ast = try std.zig.Ast.parse(gpa, build_zig_zon_bytes, .zon); + defer ast.deinit(gpa); + + if (ast.errors.len > 0) { + const file_path = try directory.join(arena, &.{Manifest.basename}); + try main.printErrsMsgToStdErr(gpa, arena, ast, file_path, color); + return error.PackageFetchFailed; + } + + var manifest = try Manifest.parse(gpa, ast); + defer manifest.deinit(gpa); + + if (manifest.errors.len > 0) { + const ttyconf: std.debug.TTY.Config = switch (color) { + .auto => std.debug.detectTTYConfig(std.io.getStdErr()), + .on => .escape_codes, + .off => .no_color, + }; + const file_path = try directory.join(arena, &.{Manifest.basename}); + for (manifest.errors) |msg| { + Report.renderErrorMessage(ast, file_path, ttyconf, msg, &.{}); } + return error.PackageFetchFailed; + } - const name = opt_name orelse { - const loc = std.zig.findLineColumn(ini.bytes, @ptrToInt(dep.ptr) - @ptrToInt(ini.bytes.ptr)); - std.log.err("{s}/{s}:{d}:{d} missing key: 'name'", .{ - directory.path orelse ".", - "build.zig.ini", - loc.line, - loc.column, - }); - any_error = true; - continue; - }; + const report: Report = .{ + .ast = &ast, + .directory = directory, + .color = color, + .arena = arena, + }; - const url = opt_url orelse { - const loc = std.zig.findLineColumn(ini.bytes, @ptrToInt(dep.ptr) - @ptrToInt(ini.bytes.ptr)); - std.log.err("{s}/{s}:{d}:{d} missing key: 'name'", .{ - directory.path orelse ".", - "build.zig.ini", - loc.line, - loc.column, - }); - any_error = true; - continue; - }; + var any_error = false; + const deps_list = manifest.dependencies.values(); + for (manifest.dependencies.keys()) |name, i| { + const dep = deps_list[i]; - const sub_prefix = try std.fmt.allocPrint(gpa, "{s}{s}.", .{ name_prefix, name }); - defer gpa.free(sub_prefix); + const sub_prefix = try std.fmt.allocPrint(arena, "{s}{s}.", .{ name_prefix, name }); const fqn = sub_prefix[0 .. sub_prefix.len - 1]; const sub_pkg = try fetchAndUnpack( thread_pool, http_client, global_cache_directory, - url, - expected_hash, - ini, - directory, + dep, + report, build_roots_source, fqn, ); try pkg.fetchAndAddDependencies( + arena, thread_pool, http_client, sub_pkg.root_src_directory, @@ -244,6 +233,7 @@ pub fn fetchAndAddDependencies( dependencies_source, build_roots_source, sub_prefix, + color, ); try addAndAdopt(pkg, gpa, sub_pkg); @@ -253,7 +243,7 @@ pub fn fetchAndAddDependencies( }); } - if (any_error) return error.InvalidBuildZigIniFile; + if (any_error) return error.InvalidBuildManifestFile; } pub fn createFilePkg( @@ -264,7 +254,7 @@ pub fn createFilePkg( contents: []const u8, ) !*Package { const rand_int = std.crypto.random.int(u64); - const tmp_dir_sub_path = "tmp" ++ fs.path.sep_str ++ hex64(rand_int); + const tmp_dir_sub_path = "tmp" ++ fs.path.sep_str ++ Manifest.hex64(rand_int); { var tmp_dir = try cache_directory.handle.makeOpenPath(tmp_dir_sub_path, .{}); defer tmp_dir.close(); @@ -282,14 +272,73 @@ pub fn createFilePkg( return createWithDir(gpa, name, cache_directory, o_dir_sub_path, basename); } +const Report = struct { + ast: *const std.zig.Ast, + directory: Compilation.Directory, + color: main.Color, + arena: Allocator, + + fn fail( + report: Report, + tok: std.zig.Ast.TokenIndex, + comptime fmt_string: []const u8, + fmt_args: anytype, + ) error{ PackageFetchFailed, OutOfMemory } { + return failWithNotes(report, &.{}, tok, fmt_string, fmt_args); + } + + fn failWithNotes( + report: Report, + notes: []const Compilation.AllErrors.Message, + tok: std.zig.Ast.TokenIndex, + comptime fmt_string: []const u8, + fmt_args: anytype, + ) error{ PackageFetchFailed, OutOfMemory } { + const ttyconf: std.debug.TTY.Config = switch (report.color) { + .auto => std.debug.detectTTYConfig(std.io.getStdErr()), + .on => .escape_codes, + .off => .no_color, + }; + const file_path = try report.directory.join(report.arena, &.{Manifest.basename}); + renderErrorMessage(report.ast.*, file_path, ttyconf, .{ + .tok = tok, + .off = 0, + .msg = try std.fmt.allocPrint(report.arena, fmt_string, fmt_args), + }, notes); + return error.PackageFetchFailed; + } + + fn renderErrorMessage( + ast: std.zig.Ast, + file_path: []const u8, + ttyconf: std.debug.TTY.Config, + msg: Manifest.ErrorMessage, + notes: []const Compilation.AllErrors.Message, + ) void { + const token_starts = ast.tokens.items(.start); + const start_loc = ast.tokenLocation(0, msg.tok); + Compilation.AllErrors.Message.renderToStdErr(.{ .src = .{ + .msg = msg.msg, + .src_path = file_path, + .line = @intCast(u32, start_loc.line), + .column = @intCast(u32, start_loc.column), + .span = .{ + .start = token_starts[msg.tok], + .end = @intCast(u32, token_starts[msg.tok] + ast.tokenSlice(msg.tok).len), + .main = token_starts[msg.tok] + msg.off, + }, + .source_line = ast.source[start_loc.line_start..start_loc.line_end], + .notes = notes, + } }, ttyconf); + } +}; + fn fetchAndUnpack( thread_pool: *ThreadPool, http_client: *std.http.Client, global_cache_directory: Compilation.Directory, - url: []const u8, - expected_hash: ?[]const u8, - ini: std.Ini, - comp_directory: Compilation.Directory, + dep: Manifest.Dependency, + report: Report, build_roots_source: *std.ArrayList(u8), fqn: []const u8, ) !*Package { @@ -298,37 +347,8 @@ fn fetchAndUnpack( // Check if the expected_hash is already present in the global package // cache, and thereby avoid both fetching and unpacking. - if (expected_hash) |h| cached: { - const hex_multihash_len = 2 * multihash_len; - if (h.len >= 2) { - const their_multihash_func = std.fmt.parseInt(u8, h[0..2], 16) catch |err| { - return reportError( - ini, - comp_directory, - h.ptr, - "invalid multihash value: unable to parse hash function: {s}", - .{@errorName(err)}, - ); - }; - if (@intToEnum(MultihashFunction, their_multihash_func) != multihash_function) { - return reportError( - ini, - comp_directory, - h.ptr, - "unsupported hash function: only sha2-256 is supported", - .{}, - ); - } - } - if (h.len != hex_multihash_len) { - return reportError( - ini, - comp_directory, - h.ptr, - "wrong hash size. expected: {d}, found: {d}", - .{ hex_multihash_len, h.len }, - ); - } + if (dep.hash) |h| cached: { + const hex_multihash_len = 2 * Manifest.multihash_len; const hex_digest = h[0..hex_multihash_len]; const pkg_dir_sub_path = "p" ++ s ++ hex_digest; var pkg_dir = global_cache_directory.handle.openDir(pkg_dir_sub_path, .{}) catch |err| switch (err) { @@ -366,10 +386,10 @@ fn fetchAndUnpack( return ptr; } - const uri = try std.Uri.parse(url); + const uri = try std.Uri.parse(dep.url); const rand_int = std.crypto.random.int(u64); - const tmp_dir_sub_path = "tmp" ++ s ++ hex64(rand_int); + const tmp_dir_sub_path = "tmp" ++ s ++ Manifest.hex64(rand_int); const actual_hash = a: { var tmp_directory: Compilation.Directory = d: { @@ -398,13 +418,9 @@ fn fetchAndUnpack( // by default, so the same logic applies for buffering the reader as for gzip. try unpackTarball(gpa, &req, tmp_directory.handle, std.compress.xz); } else { - return reportError( - ini, - comp_directory, - uri.path.ptr, - "unknown file extension for path '{s}'", - .{uri.path}, - ); + return report.fail(dep.url_tok, "unknown file extension for path '{s}'", .{ + uri.path, + }); } // TODO: delete files not included in the package prior to computing the package hash. @@ -415,28 +431,21 @@ fn fetchAndUnpack( break :a try computePackageHash(thread_pool, .{ .dir = tmp_directory.handle }); }; - const pkg_dir_sub_path = "p" ++ s ++ hexDigest(actual_hash); + const pkg_dir_sub_path = "p" ++ s ++ Manifest.hexDigest(actual_hash); try renameTmpIntoCache(global_cache_directory.handle, tmp_dir_sub_path, pkg_dir_sub_path); - const actual_hex = hexDigest(actual_hash); - if (expected_hash) |h| { + const actual_hex = Manifest.hexDigest(actual_hash); + if (dep.hash) |h| { if (!mem.eql(u8, h, &actual_hex)) { - return reportError( - ini, - comp_directory, - h.ptr, - "hash mismatch: expected: {s}, found: {s}", - .{ h, actual_hex }, - ); + return report.fail(dep.hash_tok, "hash mismatch: expected: {s}, found: {s}", .{ + h, actual_hex, + }); } } else { - return reportError( - ini, - comp_directory, - url.ptr, - "url field is missing corresponding hash field: hash={s}", - .{&actual_hex}, - ); + const notes: [1]Compilation.AllErrors.Message = .{.{ .plain = .{ + .msg = try std.fmt.allocPrint(report.arena, "expected .hash = \"{s}\",", .{&actual_hex}), + } }}; + return report.failWithNotes(¬es, dep.url_tok, "url field is missing corresponding hash field", .{}); } const build_root = try global_cache_directory.join(gpa, &.{pkg_dir_sub_path}); @@ -471,29 +480,9 @@ fn unpackTarball( }); } -fn reportError( - ini: std.Ini, - comp_directory: Compilation.Directory, - src_ptr: [*]const u8, - comptime fmt_string: []const u8, - fmt_args: anytype, -) error{PackageFetchFailed} { - const loc = std.zig.findLineColumn(ini.bytes, @ptrToInt(src_ptr) - @ptrToInt(ini.bytes.ptr)); - if (comp_directory.path) |p| { - std.debug.print("{s}{c}{s}:{d}:{d}: error: " ++ fmt_string ++ "\n", .{ - p, fs.path.sep, ini_basename, loc.line + 1, loc.column + 1, - } ++ fmt_args); - } else { - std.debug.print("{s}:{d}:{d}: error: " ++ fmt_string ++ "\n", .{ - ini_basename, loc.line + 1, loc.column + 1, - } ++ fmt_args); - } - return error.PackageFetchFailed; -} - const HashedFile = struct { path: []const u8, - hash: [Hash.digest_length]u8, + hash: [Manifest.Hash.digest_length]u8, failure: Error!void, const Error = fs.File.OpenError || fs.File.ReadError || fs.File.StatError; @@ -507,7 +496,7 @@ const HashedFile = struct { fn computePackageHash( thread_pool: *ThreadPool, pkg_dir: fs.IterableDir, -) ![Hash.digest_length]u8 { +) ![Manifest.Hash.digest_length]u8 { const gpa = thread_pool.allocator; // We'll use an arena allocator for the path name strings since they all @@ -550,7 +539,7 @@ fn computePackageHash( std.sort.sort(*HashedFile, all_files.items, {}, HashedFile.lessThan); - var hasher = Hash.init(.{}); + var hasher = Manifest.Hash.init(.{}); var any_failures = false; for (all_files.items) |hashed_file| { hashed_file.failure catch |err| { @@ -571,7 +560,7 @@ fn workerHashFile(dir: fs.Dir, hashed_file: *HashedFile, wg: *WaitGroup) void { fn hashFileFallible(dir: fs.Dir, hashed_file: *HashedFile) HashedFile.Error!void { var buf: [8000]u8 = undefined; var file = try dir.openFile(hashed_file.path, .{}); - var hasher = Hash.init(.{}); + var hasher = Manifest.Hash.init(.{}); hasher.update(hashed_file.path); hasher.update(&.{ 0, @boolToInt(try isExecutable(file)) }); while (true) { @@ -595,52 +584,6 @@ fn isExecutable(file: fs.File) !bool { } } -const hex_charset = "0123456789abcdef"; - -fn hex64(x: u64) [16]u8 { - var result: [16]u8 = undefined; - var i: usize = 0; - while (i < 8) : (i += 1) { - const byte = @truncate(u8, x >> @intCast(u6, 8 * i)); - result[i * 2 + 0] = hex_charset[byte >> 4]; - result[i * 2 + 1] = hex_charset[byte & 15]; - } - return result; -} - -test hex64 { - const s = "[" ++ hex64(0x12345678_abcdef00) ++ "]"; - try std.testing.expectEqualStrings("[00efcdab78563412]", s); -} - -const multihash_function: MultihashFunction = switch (Hash) { - std.crypto.hash.sha2.Sha256 => .@"sha2-256", - else => @compileError("unreachable"), -}; -comptime { - // We avoid unnecessary uleb128 code in hexDigest by asserting here the - // values are small enough to be contained in the one-byte encoding. - assert(@enumToInt(multihash_function) < 127); - assert(Hash.digest_length < 127); -} -const multihash_len = 1 + 1 + Hash.digest_length; - -fn hexDigest(digest: [Hash.digest_length]u8) [multihash_len * 2]u8 { - var result: [multihash_len * 2]u8 = undefined; - - result[0] = hex_charset[@enumToInt(multihash_function) >> 4]; - result[1] = hex_charset[@enumToInt(multihash_function) & 15]; - - result[2] = hex_charset[Hash.digest_length >> 4]; - result[3] = hex_charset[Hash.digest_length & 15]; - - for (digest) |byte, i| { - result[4 + i * 2] = hex_charset[byte >> 4]; - result[5 + i * 2] = hex_charset[byte & 15]; - } - return result; -} - fn renameTmpIntoCache( cache_dir: fs.Dir, tmp_dir_sub_path: []const u8, @@ -669,21 +612,3 @@ fn renameTmpIntoCache( break; } } - -const MultihashFunction = enum(u16) { - identity = 0x00, - sha1 = 0x11, - @"sha2-256" = 0x12, - @"sha2-512" = 0x13, - @"sha3-512" = 0x14, - @"sha3-384" = 0x15, - @"sha3-256" = 0x16, - @"sha3-224" = 0x17, - @"sha2-384" = 0x20, - @"sha2-256-trunc254-padded" = 0x1012, - @"sha2-224" = 0x1013, - @"sha2-512-224" = 0x1014, - @"sha2-512-256" = 0x1015, - @"blake2b-256" = 0xb220, - _, -}; diff --git a/src/main.zig b/src/main.zig index 06c36bad87..f634c259ff 100644 --- a/src/main.zig +++ b/src/main.zig @@ -3915,6 +3915,7 @@ pub const usage_build = ; pub fn cmdBuild(gpa: Allocator, arena: Allocator, args: []const []const u8) !void { + var color: Color = .auto; var prominent_compile_errors: bool = false; // We want to release all the locks before executing the child process, so we make a nice @@ -4117,6 +4118,7 @@ pub fn cmdBuild(gpa: Allocator, arena: Allocator, args: []const []const u8) !voi // Here we borrow main package's table and will replace it with a fresh // one after this process completes. main_pkg.fetchAndAddDependencies( + arena, &thread_pool, &http_client, build_directory, @@ -4125,6 +4127,7 @@ pub fn cmdBuild(gpa: Allocator, arena: Allocator, args: []const []const u8) !voi &dependencies_source, &build_roots_source, "", + color, ) catch |err| switch (err) { error.PackageFetchFailed => process.exit(1), else => |e| return e, @@ -4366,7 +4369,7 @@ pub fn cmdFmt(gpa: Allocator, arena: Allocator, args: []const []const u8) !void }; defer tree.deinit(gpa); - try printErrsMsgToStdErr(gpa, arena, tree.errors, tree, "", color); + try printErrsMsgToStdErr(gpa, arena, tree, "", color); var has_ast_error = false; if (check_ast_flag) { const Module = @import("Module.zig"); @@ -4569,7 +4572,7 @@ fn fmtPathFile( var tree = try Ast.parse(fmt.gpa, source_code, .zig); defer tree.deinit(fmt.gpa); - try printErrsMsgToStdErr(fmt.gpa, fmt.arena, tree.errors, tree, file_path, fmt.color); + try printErrsMsgToStdErr(fmt.gpa, fmt.arena, tree, file_path, fmt.color); if (tree.errors.len != 0) { fmt.any_error = true; return; @@ -4649,14 +4652,14 @@ fn fmtPathFile( } } -fn printErrsMsgToStdErr( +pub fn printErrsMsgToStdErr( gpa: mem.Allocator, arena: mem.Allocator, - parse_errors: []const Ast.Error, tree: Ast, path: []const u8, color: Color, ) !void { + const parse_errors: []const Ast.Error = tree.errors; var i: usize = 0; while (i < parse_errors.len) : (i += 1) { const parse_error = parse_errors[i]; @@ -5316,7 +5319,7 @@ pub fn cmdAstCheck( file.tree_loaded = true; defer file.tree.deinit(gpa); - try printErrsMsgToStdErr(gpa, arena, file.tree.errors, file.tree, file.sub_file_path, color); + try printErrsMsgToStdErr(gpa, arena, file.tree, file.sub_file_path, color); if (file.tree.errors.len != 0) { process.exit(1); } @@ -5442,7 +5445,7 @@ pub fn cmdChangelist( file.tree_loaded = true; defer file.tree.deinit(gpa); - try printErrsMsgToStdErr(gpa, arena, file.tree.errors, file.tree, old_source_file, .auto); + try printErrsMsgToStdErr(gpa, arena, file.tree, old_source_file, .auto); if (file.tree.errors.len != 0) { process.exit(1); } @@ -5479,7 +5482,7 @@ pub fn cmdChangelist( var new_tree = try Ast.parse(gpa, new_source, .zig); defer new_tree.deinit(gpa); - try printErrsMsgToStdErr(gpa, arena, new_tree.errors, new_tree, new_source_file, .auto); + try printErrsMsgToStdErr(gpa, arena, new_tree, new_source_file, .auto); if (new_tree.errors.len != 0) { process.exit(1); } From 9db084f43d6f253f36484b9e3b76ea483917a893 Mon Sep 17 00:00:00 2001 From: Ryan Liptak Date: Thu, 2 Feb 2023 00:54:07 -0800 Subject: [PATCH 82/84] Add test for optional error set return types Closes #5820 --- test/behavior/error.zig | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/test/behavior/error.zig b/test/behavior/error.zig index b2a6cc5a50..f30290eb91 100644 --- a/test/behavior/error.zig +++ b/test/behavior/error.zig @@ -896,3 +896,18 @@ test "optional error union return type" { }; try expect(1234 == try S.foo().?); } + +test "optional error set return type" { + if (builtin.zig_backend == .stage2_arm) return error.SkipZigTest; // TODO + if (builtin.zig_backend == .stage2_aarch64) return error.SkipZigTest; // TODO + + const E = error{ A, B }; + const S = struct { + fn foo(return_null: bool) ?E { + return if (return_null) null else E.A; + } + }; + + try expect(null == S.foo(true)); + try expect(E.A == S.foo(false).?); +} From c181ba102234756f39207402d4932303449f1c41 Mon Sep 17 00:00:00 2001 From: Manlio Perillo Date: Thu, 2 Feb 2023 15:11:13 +0100 Subject: [PATCH 83/84] langref: remove link to closed issue #4026 In the math builtin functions documentation, remove the link to issue https://github.com/ziglang/zig/issues/4026, since it was closed by https://github.com/ziglang/zig/pull/11532. --- doc/langref.html.in | 42 ++++++++++++++---------------------------- 1 file changed, 14 insertions(+), 28 deletions(-) diff --git a/doc/langref.html.in b/doc/langref.html.in index a6a46979c4..36711e555a 100644 --- a/doc/langref.html.in +++ b/doc/langref.html.in @@ -9206,8 +9206,7 @@ fn doTheTest() !void { when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} {#header_open|@sin#} @@ -9217,8 +9216,7 @@ fn doTheTest() !void { when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} @@ -9229,8 +9227,7 @@ fn doTheTest() !void { when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} @@ -9241,8 +9238,7 @@ fn doTheTest() !void { Uses a dedicated hardware instruction when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} @@ -9253,8 +9249,7 @@ fn doTheTest() !void { when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} {#header_open|@exp2#} @@ -9264,8 +9259,7 @@ fn doTheTest() !void { when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} {#header_open|@log#} @@ -9275,8 +9269,7 @@ fn doTheTest() !void { when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} {#header_open|@log2#} @@ -9286,8 +9279,7 @@ fn doTheTest() !void { when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} {#header_open|@log10#} @@ -9297,8 +9289,7 @@ fn doTheTest() !void { when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} {#header_open|@fabs#} @@ -9308,8 +9299,7 @@ fn doTheTest() !void { when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} {#header_open|@floor#} @@ -9319,8 +9309,7 @@ fn doTheTest() !void { Uses a dedicated hardware instruction when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} {#header_open|@ceil#} @@ -9330,8 +9319,7 @@ fn doTheTest() !void { Uses a dedicated hardware instruction when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} {#header_open|@trunc#} @@ -9341,8 +9329,7 @@ fn doTheTest() !void { Uses a dedicated hardware instruction when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} {#header_open|@round#} @@ -9352,8 +9339,7 @@ fn doTheTest() !void { when available.

- Supports {#link|Floats#} and {#link|Vectors#} of floats, with the caveat that - some float operations are not yet implemented for all float types. + Supports {#link|Floats#} and {#link|Vectors#} of floats.

{#header_close#} From 4c7f8286d53bf3df22b1a4596cfdd38d3736240e Mon Sep 17 00:00:00 2001 From: Loris Cro Date: Fri, 3 Feb 2023 18:05:07 +0100 Subject: [PATCH 84/84] autodoc: fix search regression --- lib/docs/main.js | 1 - 1 file changed, 1 deletion(-) diff --git a/lib/docs/main.js b/lib/docs/main.js index 62af5866b6..fae39c5fba 100644 --- a/lib/docs/main.js +++ b/lib/docs/main.js @@ -3162,7 +3162,6 @@ const NAV_MODES = { canonTypeDecls = new Array(zigAnalysis.types.length); for (let pkgI = 0; pkgI < zigAnalysis.packages.length; pkgI += 1) { - if (pkgI === zigAnalysis.rootPkg && rootIsStd) continue; let pkg = zigAnalysis.packages[pkgI]; let pkgNames = canonPkgPaths[pkgI]; if (pkgNames === undefined) continue;

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 )C!Fw>`}CehcJi# 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