LoguxNET.Server.Interop 1.0.0

LoguxNET.Server.Interop

Русская версия

Low-level P/Invoke bindings to the clogux native shared library (logux-core).

Target Framework

net10.0 — uses source-generated LibraryImport for zero-overhead marshalling.

Purpose

This project is the foundation layer of the server stack. It is not intended for direct use — LoguxNET.Server.Core and LoguxNET.Server.AspNet build on top of it.

Structure

LoguxNET.Server.Interop/
├── LoguxError.cs              Error code enum (Ok, InvalidJson, UnknownConnection, ...)
├── LoguxHandle.cs             Generational connection handle (Page + Slot + Generation)
├── LoguxStats.cs              Server statistics snapshot (27 fields)
└── Native/
    ├── CloguxNative.cs        LibraryImport P/Invoke declarations
    ├── NativeCallbacks.cs     Unmanaged delegate types for 7 callbacks
    └── NativeStructs.cs       Blittable struct mirrors (NativeLoguxConfig, NativeLoguxOutbound)

Public Types

LoguxHandle

Generational handle to a connection slot in the clogux engine. Matches the C LoguxHandle struct layout exactly.

public readonly struct LoguxHandle : IEquatable<LoguxHandle>
{
    public readonly ushort Page;
    public readonly ushort Slot;
    public readonly uint Generation;
    public static LoguxHandle Null => default;
    public bool IsNull { get; }
}

LoguxError

Error codes returned by native library functions:

LoguxStats

Snapshot of 27 server statistics fields — gauges (active connections, queue depth) and monotonic counters (bytes in/out, actions processed, errors, etc.).

Internal Types

CloguxNative

Source-generated LibraryImport bindings for all 15 native functions:

• Lifecycle: logux_server_create, logux_server_destroy, logux_server_shutdown
• Connections: logux_connection_accept, logux_feed_data, logux_connection_close
• Event loop: logux_tick, logux_poll_outbound
• Introspection: logux_get_stats, logux_version
• Memory: logux_free
• Callbacks: 7 logux_set_*_callback functions

NativeCallbacks

7 unmanaged delegate types matching C function pointer typedefs: NativeAuthCallback, NativeAccessCallback, NativeProcessCallback, NativeResendCallback, NativeChannelAccessCallback, NativeChannelLoadCallback, NativeErrorCallback.

Native Library

The library name is logux-core. Place the appropriate binary next to the application: