ВСё ещё дневник =)

2026-05-06 14:19:36 +05:00
parent fba2382ed5
commit b9c2a05010
2 changed files with 93 additions and 14 deletions
@@ -1154,7 +1154,7 @@ void* fxalloc_proxy(size_t NBytes) {

 ### CP + proxy

-Пожалуй, это самый логичный способ защитить модуль от некоректного использования. При компиляции с `const`-указателями работаем через прокси, в противном случае - включаем 3-ю космическую. Пример реализации такого подхода приведён ниже:
+Пожалуй, это самый логичный способ защитить модуль от некоректного использования. При компиляции с `const`-указателями работаем через прокси, в противном случае — включаем 3-ю космическую. Пример реализации такого подхода приведён ниже:
 ```C
 /* includes/FXAlloc.h */
 #ifndef _I_UNDERSTAND_THAT_I_SHOULD_NEVER_CHANGE_THESE_POINTERS_
@@ -1185,4 +1185,51 @@ void* fxalloc_proxy(size_t NBytes) {
    void* (*fxalloc)(size_t) = fxalloc_init_malloc; ///< работает прямым вызовом
 #endif
 ```
-Рабочие функции(вроде `fxalloc_init_alloc`) не знают о существовании дополнительной переменной, им без разницы кто их вызывает, они выполняют свои прямые обязанности несмотря на контекст.
+Рабочие функции(вроде `fxalloc_init_alloc`) не знают о существовании дополнительной переменной, им без разницы кто их вызывает, они выполняют свои прямые обязанности несмотря на контекст.
+
+### Промежуточный итог
+
+Не смотря на общую парадигму проекта **KISS+YAGNI** стоит реализовать защиту в виде **proxy + CP** ибо нам самим потом будет гараздо удобнее профилировать и настраивать сервер(на клиентах будет достаточно обычного `malloc/free`).
+
+# 06.05.2026(Раздел редактируется)
+
+## Итоговый интерфейс
+
+### Функции
+
+#### `fxalloc_profile`:
+
+```C
+int fxalloc_profile(eFXAllocProfile Profile);
+```
+Изменяет режим работы аллокатора **для всех потоков** одновременно
+
+#### Параметры
+
+* `Profile`(`eFXAllocProfile`) — режим работы аллокатора, см. `eFXAllocProfile`
+
+#### Возвращаемые значение
+
+* `eFXAllocProfile` — предыдущий режим работы.
+* при `Profile == FXALLOC_GETPROFILE` — текущий режим работы.
+
+
+#### `fxalloc_profile_thread`:
+
+```C
+int fxalloc_profile_thread(eFXAllocProfile Profile);
+```
+### Структуры/перечисления
+
+`enum eFXAllocProfile` — перечисление режимов работы аллокатора, используется как аргумент или возвращаемое значение функций `int fxalloc_profile(eFXAllocProfile Profile)`(глобально) и `int fxalloc_profile_thread(eFXAllocProfile Profile)`(для текущеко потока).
+
+|              Элемент | Описание                                        |
+|---------------------:|:------------------------------------------------|
+|      `FXALLOC_SPEED` | Максимальная производительность без статистики. |
+|    `FXALLOC_SUMMARY` | Поверхностная статистика: количество выделенных/свободных блоков по грейдам |
+|       `FXALLOC_FULL` | Глубокий анализ расхода памяти: количество выделенных/свободных блоков по грейдам, средний объём использования, минимальное/максимальное использование |
+| `FXALLOC_GETPROFILE` | Используется для получения текущего профиля. |
+
+
+
+Итоговый интерфей увековечен в файле [includes/FXAlloc.h](ccpp/fxalloc/includes/FXAlloc.h)