Musa.Core

KO | EN

gitlite — search

#python #hacktoberfest #ai #typescript #go #android #rust #deep-learning #java #kubernetes #ios #mcp #openai #open-source

(★ 98)

Use ntdll/ntoskrnl to implement Kernel32, Advapi32 and other APIs. It includes user-mode and kernel-mode.

Musa.Core 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# [Musa.Core](https://github.com/MiroKaku/Musa.Core)

[![Actions Status](https://github.com/MiroKaku/Musa.Core/workflows/CI/badge.svg)](https://github.com/MiroKaku/Musa.Core/actions)
[![Downloads](https://img.shields.io/nuget/dt/Musa.Core?logo=NuGet&logoColor=blue)](https://www.nuget.org/packages/Musa.Core/)
[![LICENSE](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/MiroKaku/Musa.Core/blob/main/LICENSE)
![Visual Studio](https://img.shields.io/badge/Visual%20Studio-2022-purple.svg)
![Windows](https://img.shields.io/badge/Windows-10+-orange.svg)
![Platform](https://img.shields.io/badge/Windows-X64%7CARM64-%23FFBCD9)

* [简体中文](./README.zh-CN.md)

## Overview

> **Warning**
>
> Musa.Core is in beta.

Musa.Core is a derivative of the low-level API implementation from [Musa.Runtime](https://github.com/MiroKaku/Musa.Runtime) (formerly [ucxxrt](https://github.com/MiroKaku/ucxxrt)). It reimplements Kernel32, Advapi32, and other Win32 APIs on top of ntoskrnl in kernel mode.

## Architecture

```mermaid
graph TD
    A[Kernel Driver] --> B[MusaCoreStartup]
    B --> C[Musa.Core StaticLibrary]
    C --> D[Musa.CoreLite]
    D --> E[Musa.Veil]
    E --> F[ntoskrnl.exe]
    C --> G[Kernel32 Thunks]
    C --> H[Advapi32 Thunks]
    C --> I[Ntdll Thunks]
    G --> F
    H --> F
    I --> F
```

## Quick Start

### NuGet Install

```xml
<ItemGroup>
  <PackageReference Include="Musa.Core">
    <Version>0.7.0</Version>
  </PackageReference>
</ItemGroup>
```

The NuGet package depends on [Musa.CoreLite](https://github.com/MiroKaku/Musa.CoreLite). You can directly include `<Veil.h>` to access underlying APIs.

### DriverEntry Example

```c
NTSTATUS DriverEntry(PDRIVER_OBJECT DriverObject, PUNICODE_STRING RegistryPath)
{
    NTSTATUS Status = MusaCoreStartup(DriverObject, RegistryPath, FALSE);
    if (!NT_SUCCESS(Status)) return Status;

// Kernel32/Advapi32 APIs now available
    WCHAR Dir[MAX_PATH];
    DWORD Len = GetCurrentDirectoryW(MAX_PATH, Dir);

return Status;
}
```

### Build Requirements

| Dependency | Minimum Version |
|---|---|
| Visual Studio 2022 | 17.10+ |
| Windows Driver Kit (WDK) | Matching SDK build |
| Mile.Project.Configurations | 1.0.1917 |

### Building from Source

```cmd
.\BuildAllTargets.cmd
```

Build artifacts are output to the `Publish/` directory.

## Implemented Modules

| Module | Status |
|---|---|
| Zw Routines | ✅ All available |
| Rtl Series API | ✅ Partial |
| KernelBase API | ✅ Partial |
| Kernel32 Thunks (Phase 1-6) | ✅ Implemented |
| Advapi32 API | 🚧 In Progress |

## Key Features

- **Kernel-mode only** — exclusively supports KernelMode toolset projects; enforced at consumer build time
- **NuGet integration** — auto-configures header and library paths, injects `/INTEGRITYCHECK` linker flag
- **Debug logging** — `MusaLOG` macro outputs `DbgPrintEx` in Debug builds, no-op in Release

## Documentation

- [System Architecture](./docs/system-architecture.md) — component relationships, data flow, service dependencies
- [Deployment Guide](./docs/deployment-guide.md) — CI/CD pipeline and NuGet publishing
- [Configuration Guide](./docs/configuration-guide.md) — complete build configuration reference
- [Changelog](./docs/changelog.md) — version history

## License

[MIT License](./LICENSE)

## References

- [systeminformer](https://github.com/winsiderss/systeminformer)/phnt
- [Windows_OS_Internals_Curriculum_Resource_Kit-ACADEMIC](https://github.com/MeeSong/Windows_OS_Internals_Curriculum_Resource_Kit-ACADEMIC)
- Zw routine resolution approach provided by @[xiaobfly](https://github.com/xiaobfly)

Musa.Core

Musa.Core 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Musa.Core

Musa.Core 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README