initial generated optimization tool

Author: JacobBarthelmeh

staticmemory/memory-bucket-optimizer/README.md

@@ -0,0 +1,61 @@
+# Memory Bucket Optimizer for wolfSSL
+
+** Note that the staticmemory build of wolfSSL does not use less memory **
+The staticmemory feature ends up using a bit more memory and is a simple sectioning up of a static buffer used dynamically instead of malloc/free. wolfSSL has the option for users to define custom XMALLOC/XFREE if wanting to use a different allocater.
+
+
+This tool analyzes memory allocation patterns in wolfSSL and recommends optimal static memory bucket configurations to minimize wasted memory.
+
+## Overview
+
+When wolfSSL is built with the `--enable-staticmemory` option, it uses a static memory management system with memory buckets. The size and distribution of these buckets can significantly impact memory usage efficiency. This tool helps optimize these bucket configurations for specific TLS operations.
+
+## Directory Structure
+
+```
+memory-bucket-optimizer/
+├── optimizer/ # Source code for the optimizer
+└── README.md               # This file
+```
+
+## Prerequisites
+
+- wolfSSL (built with `CPPFLAGS="-DWOLFSSL_DEBUG_MEMORY -DWOLFSSL_DEBUG_MEMORY_PRINT` and `--enable-staticmemory`)
+- GCC compiler
+- gnuplot (for visualization)
+
+## Building
+
+```bash
+make
+```
+
+## Usage
+
+### Basic Usage
+
+1. Build wolfSSL with memory logging enabled:
+
+```bash
+cd ~/wolfssl
+./configure CPPFLAGS="-DWOLFSSL_DEBUG_MEMORY -DWOLFSSL_DEBUG_MEMORY_PRINT" --enable-staticmemory
+make
+sudo make install
+```
+
+2. Run the application linked to wolfssl:
+
+```bash
+./wolfcrypt/test/testwolfcrypt &> testwolfcrypt.log
+```
+
+This will run the application with memory log output.
+
+3. Run the log through the optimizer
+
+```bash
+cd optimizer
+make
+./memory_bucket_optimizer testwolfcrypt.log
+```
+

staticmemory/memory-bucket-optimizer/optimizer/Makefile

@@ -0,0 +1,32 @@
+# Makefile for memory_bucket_optimizer
+#
+# Copyright (C) 2006-2025 wolfSSL Inc.
+#
+# This file is part of wolfSSL.
+#
+# wolfSSL is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# wolfSSL 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 General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335, USA
+
+CC = gcc
+LDFLAGS = -lwolfssl
+
+all: memory_bucket_optimizer
+
+memory_bucket_optimizer: memory_bucket_optimizer.c
+	$(CC) $(CFLAGS) -o memory_bucket_optimizer memory_bucket_optimizer.c $(LDFLAGS)
+
+clean:
+	rm -f memory_bucket_optimizer
+
+.PHONY: all clean