https://github.com/SpriteOvO/sigmatch

✨ Modern C++ 20 signature match / search library
https://github.com/SpriteOvO/sigmatch

assembler binary binary-analysis compile-time cpp cpp-library cpp20 cpp20-lib cpp20-library header-only library match pattern reverse-engineering search security signature

Last synced: 3 months ago
JSON representation

✨ Modern C++ 20 signature match / search library

• Host: GitHub
• URL: https://github.com/SpriteOvO/sigmatch
• Owner: SpriteOvO
• License: apache-2.0
• Created: 2021-08-05T16:01:25.000Z (over 3 years ago)
• Default Branch: dev
• Last Pushed: 2024-05-07T10:09:59.000Z (6 months ago)
• Last Synced: 2024-06-27T04:34:34.019Z (4 months ago)
• Topics: assembler, binary, binary-analysis, compile-time, cpp, cpp-library, cpp20, cpp20-lib, cpp20-library, header-only, library, match, pattern, reverse-engineering, search, security, signature
• Language: C++
• Homepage:
• Size: 53.7 KB
• Stars: 87
• Watchers: 4
• Forks: 14
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


    

    


    sigmatch



Modern C++ 20 Signature Match / Search Library



    

        

    

    

        

    

    

        

    

    

        

    



## ✨ Features

- 🍃 Header-only, no dependencies, no exceptions.

- ☕ Compile-time literal signature string parsing.

- ❄️ Supports full-byte wildcards (`??` or `**`) and semi-byte wildcards (`1?` or `*B`).

- 🚀 Supports blocking (chunking) and multi-threaded for fast search.

- 🎯 Supports searching in the current process, external processes and files.

- 🍄 Customizable `reader` and `target` allow you to search on more targets (e.g. network traffic packets).

## 🌠 Examples

A quick example:

```cpp

using namespace sigmatch_literals;

sigmatch::this_process_target target;

sigmatch::search_result result = target.in_module("**module_name**").search("1A ?? 3C ** 5* ?F"_sig);

for (const std::byte *address : result.matches()) {

    std::cout << "matched: " << address << '\n';

}

```

See [/examples](/examples) for more.

## 🍰 Todo

- [ ] Complete CI for testing and documentation deployment.

- [ ] Host the documentation on GitHub Pages.

- [ ] Statistical tests coverage.

- [ ] Complete benchmarks.

- [ ] Test compilers other than **MSVC**.

- [ ] Implement class `executable_file_target`.

- [ ] Port to **Linux**.

## 📜 License

**sigmatch** is licensed under the [Apache-2.0 License](/LICENSE).