tiny.tldr.Diagnostics

1pub const Diagnostics = struct {2    pub const max_recorded_undefined_symbols = 8;34    first_undefined_symbol: ?UndefinedSymbol = null,5    first_unsupported_relocation: ?UnsupportedRelocation = null,6    first_unsupported_input_format: ?UnsupportedInputFormat = null,7    undefined_symbols: [max_recorded_undefined_symbols]UndefinedSymbol = undefined,8    undefined_symbol_count: usize = 0,910    pub const UndefinedSymbol = struct {11        name: []const u8,12        input_name: []const u8,13    };1415    pub const UnsupportedRelocation = struct {16        input_name: []const u8,17        section_name: []const u8,18        symbol_name: []const u8,19        relocation_type: u32,20    };2122    pub const UnsupportedInputFormat = struct {23        input_name: []const u8,24        member_name: ?[]const u8 = null,25        input_format: ObjectFormat,26        target_format: ObjectFormat,27    };2829    pub const UndefinedSymbols = struct {30        symbols: []const UndefinedSymbol,31        hidden_count: usize = 0,32    };3334    pub const LinkFailure = union(enum) {35        undefined_symbols: UndefinedSymbols,36        undefined_symbol: UndefinedSymbol,37        unsupported_relocation: UnsupportedRelocation,38        unsupported_input_format: UnsupportedInputFormat,39        generic: Error,40    };4142    pub fn clear(self: *Diagnostics) void {43        self.* = .{};44    }4546    pub fn recordUndefinedSymbol(47        self: *Diagnostics,48        input_name: []const u8,49        symbol_name: []const u8,50    ) void {51        if (self.undefined_symbol_count < self.undefined_symbols.len) {52            self.undefined_symbols[self.undefined_symbol_count] = .{53                .name = symbol_name,54                .input_name = input_name,55            };56        }57        self.undefined_symbol_count += 1;58        if (self.first_undefined_symbol == null) {59            self.first_undefined_symbol = .{60                .name = symbol_name,61                .input_name = input_name,62            };63        }64    }6566    pub fn recordedUndefinedSymbols(self: *const Diagnostics) []const UndefinedSymbol {67        return self.undefined_symbols[0..@min(self.undefined_symbol_count, self.undefined_symbols.len)];68    }6970    pub fn recordUnsupportedRelocation(71        self: *Diagnostics,72        input_name: []const u8,73        section_name: []const u8,74        symbol_name: []const u8,75        relocation_type: u32,76    ) void {77        if (self.first_unsupported_relocation == null) {78            self.first_unsupported_relocation = .{79                .input_name = input_name,80                .section_name = section_name,81                .symbol_name = symbol_name,82                .relocation_type = relocation_type,83            };84        }85    }8687    pub fn recordUnsupportedInputFormat(88        self: *Diagnostics,89        input_name: []const u8,90        input_format: ObjectFormat,91        target_format: ObjectFormat,92    ) void {93        if (self.first_unsupported_input_format == null) {94            self.first_unsupported_input_format = .{95                .input_name = input_name,96                .input_format = input_format,97                .target_format = target_format,98            };99        }100    }101102    pub fn recordUnsupportedArchiveMemberFormat(103        self: *Diagnostics,104        input_name: []const u8,105        member_name: []const u8,106        input_format: ObjectFormat,107        target_format: ObjectFormat,108    ) void {109        if (self.first_unsupported_input_format == null) {110            self.first_unsupported_input_format = .{111                .input_name = input_name,112                .member_name = member_name,113                .input_format = input_format,114                .target_format = target_format,115            };116        }117    }118119    pub fn linkFailure(self: *const Diagnostics, err: Error) LinkFailure {120        if (err == error.UndefinedSymbol) {121            const undefined_symbols = self.recordedUndefinedSymbols();122            if (undefined_symbols.len > 1) {123                return .{ .undefined_symbols = .{124                    .symbols = undefined_symbols,125                    .hidden_count = self.undefined_symbol_count - undefined_symbols.len,126                } };127            }128            if (self.first_undefined_symbol) |undefined_symbol| {129                return .{ .undefined_symbol = undefined_symbol };130            }131        }132133        if (err == error.UnsupportedRelocation) {134            if (self.first_unsupported_relocation) |relocation| {135                return .{ .unsupported_relocation = relocation };136            }137        }138139        if (err == error.UnsupportedFormat) {140            if (self.first_unsupported_input_format) |unsupported| {141                return .{ .unsupported_input_format = unsupported };142            }143        }144145        return .{ .generic = err };146    }147};

1pub const Diagnostics = model.Diagnostics;