Lightemerald/windows-user-space-emulator
2
0
Fork 0
mirror of https://github.com/momo5502/emulator.git synced 2026-01-11 16:46:16 +00:00
Code Issues Packages Projects Releases Wiki Activity
1,653 Commits 2 Branches 0 Tags
925874f6b9ec65d9692bafcee95db32fb60ab22b
Go to file
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE
Maurice Heumann 925874f6b9 Bump @eslint/js from 9.28.0 to 9.29.0 in /page (#375) 
Bumps
[@eslint/js](https://github.com/eslint/eslint/tree/HEAD/packages/js)
from 9.28.0 to 9.29.0.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/eslint/eslint/releases"><code>@​eslint/js</code>'s
releases</a>.</em></p>
<blockquote>
<h2>v9.29.0</h2>
<h2>Features</h2>
<ul>
<li><a
href="f686fcb51e"><code>f686fcb</code></a>
feat: add <code>ecmaVersion: 2026</code>, parsing <code>using</code> and
<code>await using</code> (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19832">#19832</a>)
(Milos Djermanovic)</li>
<li><a
href="19cdd226bb"><code>19cdd22</code></a>
feat: prune suppressions for non-existent files (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19825">#19825</a>)
(TKDev7)</li>
<li><a
href="b3d720f82f"><code>b3d720f</code></a>
feat: add ES2025 globals (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19835">#19835</a>)
(fisker Cheung)</li>
<li><a
href="677a2837a1"><code>677a283</code></a>
feat: add auto-accessor fields support to class-methods-use-this (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19789">#19789</a>)
(sethamus)</li>
<li><a
href="dbba0589f5"><code>dbba058</code></a>
feat: allow global type declaration in <code>no-var</code> (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19714">#19714</a>)
(Remco Haszing)</li>
<li><a
href="342bd29e1a"><code>342bd29</code></a>
feat: ignore type annotations in no-restricted-globals (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19781">#19781</a>)
(sethamus)</li>
<li><a
href="786bcd1365"><code>786bcd1</code></a>
feat: add allowProperties option to no-restricted-properties (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19772">#19772</a>)
(sethamus)</li>
<li><a
href="05b66d05bd"><code>05b66d0</code></a>
feat: add <code>sourceCode.isGlobalReference(node)</code> method (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19695">#19695</a>)
(Nitin Kumar)</li>
</ul>
<h2>Bug Fixes</h2>
<ul>
<li><a
href="85c082c54b"><code>85c082c</code></a>
fix: explicit matching behavior with negated patterns and arrays (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19845">#19845</a>)
(Milos Djermanovic)</li>
<li><a
href="9bda4a9bf1"><code>9bda4a9</code></a>
fix: fix <code>LintOptions.filterCodeBlock</code> types (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19837">#19837</a>)
(ntnyq)</li>
<li><a
href="7ab77a2c76"><code>7ab77a2</code></a>
fix: correct breaking deprecation of FlatConfig type (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19826">#19826</a>)
(Logicer)</li>
<li><a
href="1ba33181ab"><code>1ba3318</code></a>
fix: add <code>language</code> and <code>dialects</code> to
<code>no-use-before-define</code> (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19808">#19808</a>)
(Francesco Trotta)</li>
</ul>
<h2>Documentation</h2>
<ul>
<li><a
href="00e3e6ad13"><code>00e3e6a</code></a>
docs: add support for custom name parameter to
<code>includeIgnoreFile</code> (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19795">#19795</a>)
(루밀LuMir)</li>
<li><a
href="3aed0756ed"><code>3aed075</code></a>
docs: Update README (GitHub Actions Bot)</li>
<li><a
href="a2f888d679"><code>a2f888d</code></a>
docs: enhance documentation with links and fix typos (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19761">#19761</a>)
(루밀LuMir)</li>
<li><a
href="53c3235ba1"><code>53c3235</code></a>
docs: update to clarify prompt usage (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19748">#19748</a>)
(Jennifer Davis)</li>
</ul>
<h2>Chores</h2>
<ul>
<li><a
href="5c114c962f"><code>5c114c9</code></a>
chore: upgrade <code>@​eslint/js</code><a
href="https://github.com/9"><code>@​9</code></a>.29.0 (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19851">#19851</a>)
(Milos Djermanovic)</li>
<li><a
href="acf2201a06"><code>acf2201</code></a>
chore: package.json update for <code>@​eslint/js</code> release
(Jenkins)</li>
<li><a
href="a806994263"><code>a806994</code></a>
refactor: Remove eslintrc from flat config functionality (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19833">#19833</a>)
(Nicholas C. Zakas)</li>
<li><a
href="152ed51329"><code>152ed51</code></a>
test: switch to flat config mode in code path analysis tests (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19824">#19824</a>)
(Milos Djermanovic)</li>
<li><a
href="b647239272"><code>b647239</code></a>
chore: Update first-party dependencies faster with Renovate (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19822">#19822</a>)
(Nicholas C. Zakas)</li>
<li><a
href="7abe42e2de"><code>7abe42e</code></a>
refactor: SafeEmitter -&gt; SourceCodeVisitor (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19708">#19708</a>)
(Nicholas C. Zakas)</li>
<li><a
href="e392895967"><code>e392895</code></a>
perf: improve time complexity of <code>getLocFromIndex</code> (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19782">#19782</a>)
(루밀LuMir)</li>
<li><a
href="0ed289c5ce"><code>0ed289c</code></a>
chore: remove accidentally committed file (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19807">#19807</a>)
(Francesco Trotta)</li>
</ul>
</blockquote>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/eslint/eslint/blob/main/CHANGELOG.md"><code>@​eslint/js</code>'s
changelog</a>.</em></p>
<blockquote>
<p>v9.29.0 - June 13, 2025</p>
<ul>
<li><a
href="5c114c962f"><code>5c114c9</code></a>
chore: upgrade <code>@​eslint/js</code><a
href="https://github.com/9"><code>@​9</code></a>.29.0 (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19851">#19851</a>)
(Milos Djermanovic)</li>
<li><a
href="acf2201a06"><code>acf2201</code></a>
chore: package.json update for <code>@​eslint/js</code> release
(Jenkins)</li>
<li><a
href="f686fcb51e"><code>f686fcb</code></a>
feat: add <code>ecmaVersion: 2026</code>, parsing <code>using</code> and
<code>await using</code> (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19832">#19832</a>)
(Milos Djermanovic)</li>
<li><a
href="85c082c54b"><code>85c082c</code></a>
fix: explicit matching behavior with negated patterns and arrays (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19845">#19845</a>)
(Milos Djermanovic)</li>
<li><a
href="00e3e6ad13"><code>00e3e6a</code></a>
docs: add support for custom name parameter to
<code>includeIgnoreFile</code> (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19795">#19795</a>)
(루밀LuMir)</li>
<li><a
href="9bda4a9bf1"><code>9bda4a9</code></a>
fix: fix <code>LintOptions.filterCodeBlock</code> types (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19837">#19837</a>)
(ntnyq)</li>
<li><a
href="a806994263"><code>a806994</code></a>
refactor: Remove eslintrc from flat config functionality (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19833">#19833</a>)
(Nicholas C. Zakas)</li>
<li><a
href="19cdd226bb"><code>19cdd22</code></a>
feat: prune suppressions for non-existent files (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19825">#19825</a>)
(TKDev7)</li>
<li><a
href="b3d720f82f"><code>b3d720f</code></a>
feat: add ES2025 globals (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19835">#19835</a>)
(fisker Cheung)</li>
<li><a
href="677a2837a1"><code>677a283</code></a>
feat: add auto-accessor fields support to class-methods-use-this (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19789">#19789</a>)
(sethamus)</li>
<li><a
href="3aed0756ed"><code>3aed075</code></a>
docs: Update README (GitHub Actions Bot)</li>
<li><a
href="7ab77a2c76"><code>7ab77a2</code></a>
fix: correct breaking deprecation of FlatConfig type (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19826">#19826</a>)
(Logicer)</li>
<li><a
href="a2f888d679"><code>a2f888d</code></a>
docs: enhance documentation with links and fix typos (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19761">#19761</a>)
(루밀LuMir)</li>
<li><a
href="dbba0589f5"><code>dbba058</code></a>
feat: allow global type declaration in <code>no-var</code> (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19714">#19714</a>)
(Remco Haszing)</li>
<li><a
href="152ed51329"><code>152ed51</code></a>
test: switch to flat config mode in code path analysis tests (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19824">#19824</a>)
(Milos Djermanovic)</li>
<li><a
href="b647239272"><code>b647239</code></a>
chore: Update first-party dependencies faster with Renovate (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19822">#19822</a>)
(Nicholas C. Zakas)</li>
<li><a
href="7abe42e2de"><code>7abe42e</code></a>
refactor: SafeEmitter -&gt; SourceCodeVisitor (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19708">#19708</a>)
(Nicholas C. Zakas)</li>
<li><a
href="342bd29e1a"><code>342bd29</code></a>
feat: ignore type annotations in no-restricted-globals (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19781">#19781</a>)
(sethamus)</li>
<li><a
href="e392895967"><code>e392895</code></a>
perf: improve time complexity of <code>getLocFromIndex</code> (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19782">#19782</a>)
(루밀LuMir)</li>
<li><a
href="1ba33181ab"><code>1ba3318</code></a>
fix: add <code>language</code> and <code>dialects</code> to
<code>no-use-before-define</code> (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19808">#19808</a>)
(Francesco Trotta)</li>
<li><a
href="786bcd1365"><code>786bcd1</code></a>
feat: add allowProperties option to no-restricted-properties (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19772">#19772</a>)
(sethamus)</li>
<li><a
href="05b66d05bd"><code>05b66d0</code></a>
feat: add <code>sourceCode.isGlobalReference(node)</code> method (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19695">#19695</a>)
(Nitin Kumar)</li>
<li><a
href="53c3235ba1"><code>53c3235</code></a>
docs: update to clarify prompt usage (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19748">#19748</a>)
(Jennifer Davis)</li>
<li><a
href="0ed289c5ce"><code>0ed289c</code></a>
chore: remove accidentally committed file (<a
href="https://github.com/eslint/eslint/tree/HEAD/packages/js/issues/19807">#19807</a>)
(Francesco Trotta)</li>
</ul>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="acf2201a06"><code>acf2201</code></a>
chore: package.json update for <code>@​eslint/js</code> release</li>
<li>See full diff in <a
href="https://github.com/eslint/eslint/commits/v9.29.0/packages/js">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=@eslint/js&package-manager=npm_and_yarn&previous-version=9.28.0&new-version=9.29.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)


</details>
2025-06-14 14:45:33 +02:00
.github
Add MCP server to dependabot
2025-06-14 09:08:24 +02:00
cmake
Remove sccache
2025-06-01 12:36:50 +02:00
deps
Bump deps/googletest from e9092b1 to 35b75a2 (#365)
2025-06-14 14:32:38 +02:00
docs/images
Add cover image
2025-01-10 21:13:15 +01:00
mcp
Add experimental MCP server
2025-06-14 08:45:50 +02:00
page
Bump @eslint/js from 9.28.0 to 9.29.0 in /page (#375)
2025-06-14 14:45:33 +02:00
src
Add NtRemoveIoCompletionEx syscall stub
2025-06-14 08:46:27 +02:00
.clang-tidy
Fix more warnings
2025-03-18 20:58:26 +01:00
.gitignore
Ignore compile-commands.json symlink
2025-06-07 18:37:14 +02:00
.gitmodules
Shallow clone all submodules
2025-06-14 08:24:46 +02:00
CMakeLists.txt
Remove sccache
2025-06-01 12:36:50 +02:00
CMakePresets.json
Use RelWithDebInfo
2025-05-29 10:13:17 +02:00
LICENSE
Switch to GPL as unicorn requires it
2024-10-23 19:10:13 +02:00
README.md
Update README.md
2025-04-22 11:21:24 +02:00

README.md

Sogen

Sogen is a high-performance Windows user space emulator that operates at syscall level, providing full control over process execution through comprehensive hooking capabilities.

Perfect for security research, malware analysis, and DRM research where fine-grained control over process execution is required.

Built in C++ and powered by the Unicorn Engine (or the icicle-emu 🆕).

Try it out: sogen.dev

Key Features

  • 🔄 Syscall-Level Emulation
    • Instead of reimplementing Windows APIs, the emulator operates at the syscall level, allowing it to leverage existing system DLLs
  • 📝 Advanced Memory Management
    • Supports Windows-specific memory types including reserved, committed, built on top of Unicorn's memory management
  • 📦 Complete PE Loading
    • Handles executable and DLL loading with proper memory mapping, relocations, and TLS
  • ⚡ Exception Handling
    • Implements Windows structured exception handling (SEH) with proper exception dispatcher and unwinding support
  • 🧵 Threading Support
    • Provides a scheduled (round-robin) threading model
  • 💾 State Management
    • Supports both full state serialization and fast in-memory snapshots (currently broken 😕)
  • 💻 Debugging Interface
    • Implements GDB serial protocol for integration with common debugging tools (IDA Pro, GDB, LLDB, VS Code, ...)

Note

The project is still in a very early, prototypical state. The code still needs a lot of cleanup and many features and syscalls need to be implemented. However, constant progress is being made :)

Preview

Preview

YouTube Overview

YouTube video

Click here for the slides.

Quick Start (Windows + Visual Studio)

Tip

Checkout the Wiki for more details on how to build & run the emulator on Windows, Linux, macOS, ...

1. Checkout the code:

git clone --recurse-submodules https://github.com/momo5502/sogen.git

2. Run the following command in an x64 Development Command Prompt in the cloned directory:

cmake --preset=vs2022

3. Build the solution that was generated at build/vs2022/emulator.sln

4. Create a registry dump by running the grab-registry.bat as administrator and place it in the artifacts folder next to the analyzer.exe

5. Run the program of your choice:

analyzer.exe C:\example.exe
Description
🪅 Windows User Space Emulator
emulatorhacktoberfestreverse-engineeringwindows
Readme GPL-2.0 15 MiB
Languages
C++ 85%
TypeScript 10%
Rust 2.7%
CMake 1.5%
CSS 0.3%
Other 0.4%