std.os.uefi.pool_allocator.Allocator
别名
别名目标 std.mem.Allocator
std.os.uefi.pool_allocator.assert
别名
别名目标 std.debug.assert
std.os.uefi.pool_allocator.mem
别名
别名目标 std.mem
std.os.uefi.pool_allocator.pool_allocator
常量
支持完整的 Allocator 接口,包括对齐。
若需直接调用 allocatePool,参见 raw_pool_allocator。
std.os.uefi.pool_allocator.pool_allocator_vtable
常量
std.os.uefi.pool_allocator.raw_pool_allocator
常量
断言分配按 8 字节对齐,并调用 boot_services.allocatePool。
std.os.uefi.pool_allocator.raw_pool_allocator_table
常量
std.os.uefi.pool_allocator.std
别名
别名目标 std
std.os.uefi.pool_allocator.uefi
别名
别名目标 std.os.uefi
std.os.uefi.pool_allocator.uefi_alloc
函数
fn uefi_alloc( _: *anyopaque, len: usize, alignment: mem.Alignment, ret_addr: usize, ) ?[*]u8
参数
std.os.uefi.pool_allocator.uefi_free
函数
fn uefi_free( _: *anyopaque, buf: []u8, alignment: mem.Alignment, ret_addr: usize, ) void
参数
std.os.uefi.pool_allocator.uefi_remap
函数
fn uefi_remap( _: *anyopaque, buf: []u8, alignment: mem.Alignment, new_len: usize, ret_addr: usize, ) ?[*]u8
参数
std.os.uefi.pool_allocator.uefi_resize
函数
fn uefi_resize( _: *anyopaque, buf: []u8, alignment: mem.Alignment, new_len: usize, ret_addr: usize, ) bool
参数
std.os.uefi.pool_allocator.UefiPoolAllocator
命名空间
std.os.uefi.pool_allocator.UefiPoolAllocator.alloc
函数
fn alloc( _: *anyopaque, len: usize, alignment: mem.Alignment, ret_addr: usize, ) ?[*]u8
参数
std.os.uefi.pool_allocator.UefiPoolAllocator.free
函数
fn free( _: *anyopaque, buf: []u8, alignment: mem.Alignment, ret_addr: usize, ) void
参数
std.os.uefi.pool_allocator.UefiPoolAllocator.getHeader
函数
fn getHeader(ptr: [*]u8) *[*]align(8) u8
参数
ptr: [*]u8
std.os.uefi.pool_allocator.UefiPoolAllocator.remap
函数
fn remap( _: *anyopaque, buf: []u8, alignment: mem.Alignment, new_len: usize, ret_addr: usize, ) ?[*]u8
参数
std.os.uefi.pool_allocator.UefiPoolAllocator.resize
函数
fn resize( _: *anyopaque, buf: []u8, alignment: mem.Alignment, new_len: usize, ret_addr: usize, ) bool
参数
源码
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;
}