Pro .NET Memory Management Companion Code

The UnmanagedLibrary project is a Dynamic Link Library (DLL) generated using the Visual C++ Application Wizard. It consists of the following key components:

• Main DLL Source File: The primary source file containing the implementation logic for the DLL.
• Project File: Contains configuration for Visual C++ versions, platforms, and project features.
• Filters File: Manages file grouping within the IDE (e.g., associating .cpp files with 'Source Files').
• Precompiled Headers (StdAfx.h, StdAfx.cpp): Used to build the .pch (precompiled header) and StdAfx.obj files to improve build performance.

Note on Customization: The source code contains TODO: comments to indicate specific areas where you should add or customize implementation logic.

CoreCLR.ZeroGC is a minimal Garbage Collector (GC) implementation for CoreCLR. Unlike the default GC, it does not automatically reclaim memory. It provides the bare minimum functionality required by the Execution Engine to allow object allocation without the overhead of automatic memory management.

Use Cases

• Custom GC Development: Serves as a foundational implementation for developers building their own custom garbage collection mechanisms.
• Zero-Allocation/No-Alloc Programming: Useful for specialized applications with extremely short lifespans or those designed to perform almost no memory allocations, where the overhead of a standard GC is unnecessary.

The CppBenchmark application is a VC++ console application generated by AppWizard. The project structure consists of the following key components:

• CppBenchmark.vcxproj: The main Visual C++ project file containing platform, configuration, and feature settings.
• CppBenchmark.vcxproj.filters: An IDE-specific file that manages the grouping of files (e.g., associating .cpp files with the 'Source Files' node).
• CppBenchmark.cpp: The primary source file containing the application's entry point and main logic.
• StdAfx.h & StdAfx.cpp: Files used to implement Precompiled Headers (PCH) to improve build times, resulting in CppBenchmark.pch and StdAfx.obj.

Note for developers: Look for TODO: comments within the source code to identify areas intended for customization or additional implementation.

This repository uses Git Large File Storage (LFS) to manage large files. To ensure you download the actual content instead of small placeholder files, you must install Git LFS before cloning.

1. Install Git LFS.
2. Clone the repository using Git or GitHub Desktop.

If you cannot use Git LFS, you must manually download the large files from GitHub to replace the placeholder files in your local clone:

1. Clone or download the repository as a ZIP (this will contain only placeholder files).
2. For every large file missing content, navigate to that specific file on GitHub in your web browser.
3. Click the Download button to retrieve the actual file from Git Large File Storage.

hayai can be installed via package managers depending on your operating system:

macOS (via Homebrew): Use brew install hayai.

Ubuntu LTS (via PPA): Add the bruun/hayai PPA, update your package list, and install libhayai-dev.

# macOS
$ brew install hayai

# Ubuntu
$ apt-add-repository ppa:bruun/hayai
$ apt-get update
$ apt-get install libhayai-dev

To run the internal test suite for hayai development, configure CMake with the TEST variable set to true before building.

$ cd hayai
$ cmake -DTEST=true .
$ make
$ make test

hayai is a header-only framework. However, if you want to use the simple main function provided by the framework, you must compile the source code to provide libhayai_main. This requires CMake.

$ cd hayai
$ cmake .
$ make

The app.rc file is a Microsoft Visual C++ generated resource script used to embed assets like icons and header files into the MemoryLeaks.Library project.

Key resource types defined:

• ICON: The application icon is defined by the first icon resource or the one with the lowest ID value. In this project, it uses app.ico.
• TEXTINCLUDE: Used to include C++ header files (like resource.h and afxres.h) into the resource script during compilation.

// Icon
1 ICON "app.ico"

// Text Includes
1 TEXTINCLUDE
BEGIN
    "resource.h\0"
    "\0"
END

2 TEXTINCLUDE
BEGIN
    "#include ""afxres.h""\r\n"
    "\0"
END