Files
genode/repos/os/include/nic/packet_allocator.h
Norman Feske e380d0da95 base: use 'Allocation' interface for mem alloc
This patch converts the memory-allocator interfaces ('Allocator',
'Range_allocator') and their implementations ('Heap', 'Sliced heap',
'Slab', 'Allocator_avl', 'Synced_allocator') to the new 'Allocation'
utility. The new interface resides at base/memory.h whereas the
traditional allocators implement the new interface.

Down the road, the traditional allocators can successively be decoupled
from the traditional 'Allocator' and 'Range_allocator' interfaces.

Issue #5502
Issue #5245
2025-04-10 14:55:21 +02:00

98 lines
2.9 KiB
C++

/*
* \brief Fast-bitmap allocator for NIC-session packet streams
* \author Sebastian Sumpf
* \date 2012-07-30
*
* This allocator can be used with a nic session. It is *not* required though.
*/
/*
* Copyright (C) 2012-2017 Genode Labs GmbH
*
* This file is part of the Genode OS framework, which is distributed
* under the terms of the GNU Affero General Public License version 3.
*/
#ifndef _INCLUDE__NIC__PACKET_ALLOCATOR__
#define _INCLUDE__NIC__PACKET_ALLOCATOR__
#include <os/packet_allocator.h>
#include <base/log.h>
namespace Nic { struct Packet_allocator; }
/**
* Packet allocator used for packet streaming in nic sessions.
*
* We override the allocator interface to align the IP packet to a 32-bit
* address. The ethernet frame header contains src/dst mac (12) + ethertype (2)
* causing the IP header to be at offset 14 in the packet. This leads to
* problems on platforms that require load/store operations to be naturally
* aligned when reading, for example, 4 byte IP addresses. Therefore, we
* allocate packet size plus OFFSET and offset the returned packet allocation
* at 2 bytes, which effectively aligns the IP header to 4 bytes.
*
* Note, this tweak reduces the usable bytes in the allocated packets to
* DEFAULT_PACKET_SIZE - OFFSET and assumes word-aligned allocations in the
* Genode::Packet_allocator. As DEFAULT_PACKET_SIZE is used for the
* transmission-buffer calculation we could not change it without breaking the
* API. OFFSET_PACKET_SIZE reflects the actual (usable) packet-buffer size.
*/
struct Nic::Packet_allocator : Genode::Packet_allocator
{
enum {
DEFAULT_PACKET_SIZE = 1600,
OFFSET = 2,
OFFSET_PACKET_SIZE = DEFAULT_PACKET_SIZE - OFFSET,
};
using size_t = Genode::size_t;
/**
* Constructor
*
* \param md_alloc Meta-data allocator
*/
Packet_allocator(Genode::Allocator *md_alloc)
: Genode::Packet_allocator(md_alloc, DEFAULT_PACKET_SIZE) {}
Result try_alloc(size_t size) override
{
if (!size || size > OFFSET_PACKET_SIZE) {
Genode::error("unsupported NIC packet size ", size);
return Error::DENIED;
}
return Genode::Packet_allocator::try_alloc(size + OFFSET).convert<Result>(
[&] (Allocation &a) -> Result {
/* assume word-aligned packet buffer and offset packet by 2 bytes */
if ((Genode::addr_t)a.ptr & 0b11) {
Genode::error("NIC packet allocation not word-aligned");
return Error::DENIED;
}
a.deallocate = false;
return { *this, {
.ptr = reinterpret_cast<void *>((Genode::uint8_t *)a.ptr + OFFSET),
.num_bytes = size } };
},
[] (Error e) { return e; });
}
void _free(Allocation &a) override { free(a.ptr, a.num_bytes); }
void free(void *addr, size_t size) override
{
if (!size || size > OFFSET_PACKET_SIZE) {
Genode::error("unsupported NIC packet size ", size);
return;
}
Genode::Packet_allocator::free((Genode::uint8_t *)addr - OFFSET, size + OFFSET);
}
};
#endif /* _INCLUDE__NIC__PACKET_ALLOCATOR__ */