跳转到内容

std.os.windows.tls

标准库Zig 0.17.1官方原文
源码std/os/windows/tls.zig

第 1 行

std.os.windows.tls.__xl_a

变量

第 8 行

windows.PIMAGE_TLS_CALLBACK

std.os.windows.tls.__xl_z

变量

第 9 行

windows.PIMAGE_TLS_CALLBACK

std.os.windows.tls._tls_end

变量

第 7 行

?*anyopaque

std.os.windows.tls._tls_index

变量

第 5 行

u32

std.os.windows.tls._tls_start

变量

第 6 行

?*anyopaque

std.os.windows.tls._tls_used

常量

第 40 行

std.os.windows.tls.builtin

常量

第 2 行

std.os.windows.tls.IMAGE_TLS_DIRECTORY

容器

第 32 行

字段

StartAddressOfRawData: *?*anyopaque
EndAddressOfRawData: *?*anyopaque
AddressOfIndex: *u32
AddressOfCallBacks: [*:null]windows.PIMAGE_TLS_CALLBACK
SizeOfZeroFill: u32
Characteristics: u32

std.os.windows.tls.std

别名

第 1 行

别名目标 std

std.os.windows.tls.windows

别名

第 3 行

别名目标 std.os.windows

源码

std/os/windows/tls.zig

const std = @import("std");
const builtin = @import("builtin");
const windows = std.os.windows;

export var _tls_index: u32 = std.os.windows.TLS_OUT_OF_INDEXES;
export var _tls_start: ?*anyopaque linksection(".tls") = null;
export var _tls_end: ?*anyopaque linksection(".tls$ZZZ") = null;
export var __xl_a: windows.PIMAGE_TLS_CALLBACK linksection(".CRT$XLA") = null;
export var __xl_z: windows.PIMAGE_TLS_CALLBACK linksection(".CRT$XLZ") = null;

comptime {
    if (builtin.cpu.arch == .x86 and !builtin.abi.isGnu() and builtin.zig_backend != .stage2_c) {
        // __tls_array 是 TEB 块中 ThreadLocalStoragePointer 字段的偏移,
        // 该块的基址保存在 %fs 段中。
        asm (
            \\ .global __tls_array
            \\ __tls_array = 0x2C
        );
    }
}

// TODO: 希望能用以下方式表达:
// export const _tls_used linksection(".rdata$T") = std.os.windows.IMAGE_TLS_DIRECTORY {
//    .StartAddressOfRawData = @intFromPtr(&_tls_start),
//    .EndAddressOfRawData = @intFromPtr(&_tls_end),
//    .AddressOfIndex = @intFromPtr(&_tls_index),
//    .AddressOfCallBacks = @intFromPtr(__xl_a),
//    .SizeOfZeroFill = 0,
//    .Characteristics = 0,
// };
// 由于无法在编译期以这种方式执行 @intFromPtr,目前只能使用此变通方案。
pub const IMAGE_TLS_DIRECTORY = extern struct {
    StartAddressOfRawData: *?*anyopaque,
    EndAddressOfRawData: *?*anyopaque,
    AddressOfIndex: *u32,
    AddressOfCallBacks: [*:null]windows.PIMAGE_TLS_CALLBACK,
    SizeOfZeroFill: u32,
    Characteristics: u32,
};
export const _tls_used linksection(".rdata$T") = IMAGE_TLS_DIRECTORY{
    .StartAddressOfRawData = &_tls_start,
    .EndAddressOfRawData = &_tls_end,
    .AddressOfIndex = &_tls_index,
    // __xl_a 只是包含空指针的全局变量;实际回调位于
    // __xl_a 与 __xl_z 之间。因此此处需要跳过 __xl_a。若不存在回调,
    // 则直接指向 __xl_z,即空终止项。
    .AddressOfCallBacks = @as([*:null]windows.PIMAGE_TLS_CALLBACK, @ptrCast(&__xl_a)) + 1,
    .SizeOfZeroFill = 0,
    .Characteristics = 0,
};