1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
/*
* Copyright (c) 2023 Vaughn Nugent
*
* Library: VNLib
* Package: VNLib.Plugins.Extensions.VNCache
* File: BucketLocalManagerFactory.cs
*
* BucketLocalManagerFactory.cs is part of VNLib.Plugins.Extensions.VNCache
* which is part of the larger VNLib collection of libraries and utilities.
*
* VNLib.Plugins.Extensions.VNCache is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* VNLib.Plugins.Extensions.VNCache is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see https://www.gnu.org/licenses/.
*/
using System;
using System.Buffers;
using System.Text.Json;
using System.Collections.Generic;
using System.Runtime.CompilerServices;
using VNLib.Plugins;
using VNLib.Utils;
using VNLib.Utils.Memory;
using VNLib.Utils.Extensions;
using VNLib.Plugins.Extensions.Loading;
/*
* How bucket local memory works:
*
* The object cache library allows us to create a memory manager for use with
* an individual bucket. Each bucket is mutually exclusive, so memory operations
* are "thread-safe" This means we can create a heap for each bucket and use it
* for all memory operations for that bucket. Since no contention will occur,
* we can get a little more performance out of the memory operations. The internal
* heap impls will still likely have locks enabled, but no contention will occur
*/
namespace VNLib.Data.Caching.ObjectCache.Server
{
[ConfigurationName("memory_manager", Required = false)]
internal sealed class BucketLocalManagerFactory : VnDisposeable, ICacheMemoryManagerFactory
{
private readonly LinkedList<BucketLocalManager> _managers = new ();
private readonly bool _zeroAll;
///<inheritdoc/>
public ICacheEntryMemoryManager CreateForBucket(uint bucketId)
{
//Init a new heap for the individual bucket
IUnmangedHeap localHeap = MemoryUtil.InitializeNewHeapForProcess();
BucketLocalManager manager = new (localHeap, bucketId, _zeroAll);
_managers.AddLast(manager);
return manager;
}
public BucketLocalManagerFactory(PluginBase plugin) : this(plugin, null)
{ }
public BucketLocalManagerFactory(PluginBase plugin, IConfigScope? config)
{
if (config != null)
{
//Try to get the zero all flag
if (config.TryGetValue("zero_all", out JsonElement zeroEl))
{
_zeroAll = zeroEl.GetBoolean();
}
}
}
protected override void Free()
{
//Free heaps on exit
foreach (BucketLocalManager manager in _managers)
{
manager.Heap.Dispose();
}
}
/*
* Buckets are mutually exclusive, so we can use a single heap for each bucket
* to get a little more performance on memory operations
*/
private sealed record class BucketLocalManager(IUnmangedHeap Heap, uint BucketId, bool Zero) : ICacheEntryMemoryManager
{
///<inheritdoc/>
public object AllocHandle(uint size) => Heap.Alloc<byte>(size, Zero);
///<inheritdoc/>
public void FreeHandle(object handle)
{
_ = handle ?? throw new ArgumentNullException(nameof(handle));
MemoryHandle<byte> _handle = Unsafe.As<object, MemoryHandle<byte>>(ref handle);
//Free the handle
_handle.Dispose();
}
///<inheritdoc/>
public uint GetHandleSize(object handle)
{
_ = handle ?? throw new ArgumentNullException(nameof(handle));
MemoryHandle<byte> _handle = Unsafe.As<object, MemoryHandle<byte>>(ref handle);
return (uint)_handle.Length;
}
///<inheritdoc/>
public Span<byte> GetSpan(object handle, uint offset, uint length)
{
_ = handle ?? throw new ArgumentNullException(nameof(handle));
MemoryHandle<byte> _handle = Unsafe.As<object, MemoryHandle<byte>>(ref handle);
return _handle.GetOffsetSpan(offset, checked((int)length));
}
///<inheritdoc/>
public MemoryHandle PinHandle(object handle, int offset)
{
_ = handle ?? throw new ArgumentNullException(nameof(handle));
MemoryHandle<byte> _handle = Unsafe.As<object, MemoryHandle<byte>>(ref handle);
//Pin the handle
return _handle.Pin(offset);
}
///<inheritdoc/>
public void ResizeHandle(object handle, uint newSize)
{
_ = handle ?? throw new ArgumentNullException(nameof(handle));
MemoryHandle<byte> _handle = Unsafe.As<object, MemoryHandle<byte>>(ref handle);
//Resize the handle
_handle.ResizeIfSmaller(newSize);
}
}
}
}
|
