跳转到内容

std.os.uefi.pool_allocator

标准库Zig 0.17.0官方原文
源码std/os/uefi/pool_allocator.zig

第 1 行

std.os.uefi.pool_allocator.Allocator

别名

第 8 行

别名目标 std.mem.Allocator

std.os.uefi.pool_allocator.assert

别名

第 6 行

别名目标 std.debug.assert

std.os.uefi.pool_allocator.mem

别名

第 3 行

别名目标 std.mem

std.os.uefi.pool_allocator.pool_allocator

常量

第 87 行

支持完整的 Allocator 接口,包括对齐。 若需直接调用 allocatePool,参见 raw_pool_allocator。

std.os.uefi.pool_allocator.pool_allocator_vtable

常量

第 92 行

std.os.uefi.pool_allocator.raw_pool_allocator

常量

第 100 行

断言分配按 8 字节对齐,并调用 boot_services.allocatePool。

std.os.uefi.pool_allocator.raw_pool_allocator_table

常量

第 105 行

std.os.uefi.pool_allocator.std

别名

第 1 行

别名目标 std

std.os.uefi.pool_allocator.uefi

别名

第 4 行

别名目标 std.os.uefi

std.os.uefi.pool_allocator.uefi_alloc

函数

第 112 行

fn uefi_alloc( _: *anyopaque, len: usize, alignment: mem.Alignment, ret_addr: usize, ) ?[*]u8

参数

_: *anyopaque
len: usize
alignment: mem.Alignment
ret_addr: usize

std.os.uefi.pool_allocator.uefi_free

函数

第 160 行

fn uefi_free( _: *anyopaque, buf: []u8, alignment: mem.Alignment, ret_addr: usize, ) void

参数

_: *anyopaque
buf: []u8
alignment: mem.Alignment
ret_addr: usize

std.os.uefi.pool_allocator.uefi_remap

函数

第 145 行

fn uefi_remap( _: *anyopaque, buf: []u8, alignment: mem.Alignment, new_len: usize, ret_addr: usize, ) ?[*]u8

参数

_: *anyopaque
buf: []u8
alignment: mem.Alignment
new_len: usize
ret_addr: usize

std.os.uefi.pool_allocator.uefi_resize

函数

第 130 行

fn uefi_resize( _: *anyopaque, buf: []u8, alignment: mem.Alignment, new_len: usize, ret_addr: usize, ) bool

参数

_: *anyopaque
buf: []u8
alignment: mem.Alignment
new_len: usize
ret_addr: usize

std.os.uefi.pool_allocator.UefiPoolAllocator

命名空间

第 10 行

std.os.uefi.pool_allocator.UefiPoolAllocator.alloc

函数

第 15 行

fn alloc( _: *anyopaque, len: usize, alignment: mem.Alignment, ret_addr: usize, ) ?[*]u8

参数

_: *anyopaque
len: usize
alignment: mem.Alignment
ret_addr: usize

std.os.uefi.pool_allocator.UefiPoolAllocator.free

函数

第 73 行

fn free( _: *anyopaque, buf: []u8, alignment: mem.Alignment, ret_addr: usize, ) void

参数

_: *anyopaque
buf: []u8
alignment: mem.Alignment
ret_addr: usize

std.os.uefi.pool_allocator.UefiPoolAllocator.getHeader

函数

第 11 行

fn getHeader(ptr: [*]u8) *[*]align(8) u8

参数

ptr: [*]u8

std.os.uefi.pool_allocator.UefiPoolAllocator.remap

函数

第 59 行

fn remap( _: *anyopaque, buf: []u8, alignment: mem.Alignment, new_len: usize, ret_addr: usize, ) ?[*]u8

参数

_: *anyopaque
buf: []u8
alignment: mem.Alignment
new_len: usize
ret_addr: usize

std.os.uefi.pool_allocator.UefiPoolAllocator.resize

函数

第 45 行

fn resize( _: *anyopaque, buf: []u8, alignment: mem.Alignment, new_len: usize, ret_addr: usize, ) bool

参数

_: *anyopaque
buf: []u8
alignment: mem.Alignment
new_len: usize
ret_addr: usize
源码

std/os/uefi/pool_allocator.zig

const std = @import("std");

const mem = std.mem;
const uefi = std.os.uefi;

const assert = std.debug.assert;

const Allocator = mem.Allocator;

const UefiPoolAllocator = struct {
    fn getHeader(ptr: [*]u8) *[*]align(8) u8 {
        return @as(*[*]align(8) u8, @ptrFromInt(@intFromPtr(ptr) - @sizeOf(usize)));
    }

    fn alloc(
        _: *anyopaque,
        len: usize,
        alignment: mem.Alignment,
        ret_addr: usize,
    ) ?[*]u8 {
        _ = ret_addr;

        assert(len > 0);

        const ptr_align = alignment.toByteUnits();

        const metadata_len = mem.alignForward(usize, @sizeOf(usize), ptr_align);

        const full_len = metadata_len + len;

        const unaligned_slice = uefi.system_table.boot_services.?.allocatePool(
            uefi.efi_pool_memory_type,
            full_len,
        ) catch return null;

        const unaligned_addr = @intFromPtr(unaligned_slice.ptr);
        const aligned_addr = mem.alignForward(usize, unaligned_addr + @sizeOf(usize), ptr_align);

        const aligned_ptr = unaligned_slice.ptr + (aligned_addr - unaligned_addr);
        getHeader(aligned_ptr).* = unaligned_slice.ptr;

        return aligned_ptr;
    }

    fn resize(
        _: *anyopaque,
        buf: []u8,
        alignment: mem.Alignment,
        new_len: usize,
        ret_addr: usize,
    ) bool {
        _ = ret_addr;
        _ = alignment;

        if (new_len > buf.len) return false;
        return true;
    }

    fn remap(
        _: *anyopaque,
        buf: []u8,
        alignment: mem.Alignment,
        new_len: usize,
        ret_addr: usize,
    ) ?[*]u8 {
        _ = alignment;
        _ = ret_addr;

        if (new_len > buf.len) return null;
        return buf.ptr;
    }

    fn free(
        _: *anyopaque,
        buf: []u8,
        alignment: mem.Alignment,
        ret_addr: usize,
    ) void {
        _ = alignment;
        _ = ret_addr;
        uefi.system_table.boot_services.?.freePool(getHeader(buf.ptr).*) catch unreachable;
    }
};

/// 支持完整的 Allocator 接口,包括对齐。
/// 若需直接调用 `allocatePool`,参见 `raw_pool_allocator`。
pub const pool_allocator = Allocator{
    .ptr = undefined,
    .vtable = &pool_allocator_vtable,
};

const pool_allocator_vtable = Allocator.VTable{
    .alloc = UefiPoolAllocator.alloc,
    .resize = UefiPoolAllocator.resize,
    .remap = UefiPoolAllocator.remap,
    .free = UefiPoolAllocator.free,
};

/// 断言分配按 8 字节对齐,并调用 `boot_services.allocatePool`。
pub const raw_pool_allocator = Allocator{
    .ptr = undefined,
    .vtable = &raw_pool_allocator_table,
};

const raw_pool_allocator_table = Allocator.VTable{
    .alloc = uefi_alloc,
    .resize = uefi_resize,
    .remap = uefi_remap,
    .free = uefi_free,
};

fn uefi_alloc(
    _: *anyopaque,
    len: usize,
    alignment: mem.Alignment,
    ret_addr: usize,
) ?[*]u8 {
    _ = ret_addr;

    std.debug.assert(@backingInt(alignment) <= 3);

    const slice = uefi.system_table.boot_services.?.allocatePool(
        uefi.efi_pool_memory_type,
        len,
    ) catch return null;

    return slice.ptr;
}

fn uefi_resize(
    _: *anyopaque,
    buf: []u8,
    alignment: mem.Alignment,
    new_len: usize,
    ret_addr: usize,
) bool {
    _ = ret_addr;

    std.debug.assert(@backingInt(alignment) <= 3);

    if (new_len > buf.len) return false;
    return true;
}

fn uefi_remap(
    _: *anyopaque,
    buf: []u8,
    alignment: mem.Alignment,
    new_len: usize,
    ret_addr: usize,
) ?[*]u8 {
    _ = ret_addr;

    std.debug.assert(@backingInt(alignment) <= 3);

    if (new_len > buf.len) return null;
    return buf.ptr;
}

fn uefi_free(
    _: *anyopaque,
    buf: []u8,
    alignment: mem.Alignment,
    ret_addr: usize,
) void {
    _ = alignment;
    _ = ret_addr;
    uefi.system_table.boot_services.?.freePool(@alignCast(buf.ptr)) catch unreachable;
}