Files
mxaccess/src/MxNativeCodec/NmxOperationStatusMessage.cs
T
Joseph Doherty fe2a6db786
rust / build / test / clippy / fmt (push) Has been cancelled
Initial project state: .NET reference, design, Rust port (M0+M1), evidence
Layout:
- src/                    .NET 10 x64 reference: MxNativeCodec, MxNativeClient,
                          MxAsbClient, probes, tests, harnesses. Executable spec.
- design/                 Architectural plan for the Rust port (M0–M6), error
                          model, protocol invariants, risks (R1–R16), adversarial
                          review log (review.md).
- rust/                   Rust workspace. M0 skeleton + M1 codec parity.
                          mxaccess-codec: 215 unit tests + 2 cross-implementation
                          parity tests (byte-identical against .NET reference).
                          Other crates are M0 stubs awaiting M2+.
- captures/               Frida + netsh + pcap evidence per CLAUDE.md
                          ("captures are evidence, not throwaway logs").
- analysis/               Decompiled C# (frida/proxy/decompiled-*),
                          Ghidra exports for native DLLs (`exports/` only —
                          working state at `projects/` and AVEVA's input
                          binaries at `input/` are gitignored).
- docs/                   Reverse-engineering reference docs.
- tools/                  Setup-LiveProbeEnv.ps1 (Infisical credential fetcher),
                          Compute-Crc.ps1 (.NET parity helper).
- .github/workflows/      Rust CI: fmt + build + test + clippy on Windows.
- LICENSE                 MIT (Joseph Doherty, 2026).

Verified:
- cargo test --workspace → 217 passed (215 unit + 2 .NET parity), 0 failed
- cargo clippy --workspace -- -D warnings → clean
- cargo fmt --all -- --check → clean
- cargo publish --dry-run -p mxaccess-codec → packages cleanly

Excluded from history (see .gitignore):
- **/bin, **/obj, **/target — build artifacts
- analysis/ghidra/projects/ — Ghidra working state (regenerable)
- analysis/ghidra/input/ — AVEVA proprietary DLLs (vendor IP)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 06:21:00 -04:00

78 lines
2.5 KiB
C#

namespace MxNativeCodec;
public enum NmxOperationStatusFormat
{
CompletionOnly,
StatusWord,
}
public sealed record NmxOperationStatusMessage(
NmxOperationStatusFormat Format,
byte Command,
ushort StatusCode,
byte CompletionCode,
MxStatus Status)
{
public bool IsMxAccessWriteComplete => Format == NmxOperationStatusFormat.StatusWord
&& StatusCode == 0x8050
&& CompletionCode == 0x00;
public static bool TryParseProcessDataReceivedBody(ReadOnlyMemory<byte> body, out NmxOperationStatusMessage message)
{
try
{
var envelope = NmxObservedEnvelope.ParseProcessDataReceivedBodyFlexible(body);
return TryParseInner(envelope.InnerBody.Span, out message);
}
catch (ArgumentException)
{
message = null!;
return false;
}
}
public static bool TryParseInner(ReadOnlySpan<byte> inner, out NmxOperationStatusMessage message)
{
if (inner.Length == 1)
{
byte completionCode = inner[0];
message = new NmxOperationStatusMessage(
Format: NmxOperationStatusFormat.CompletionOnly,
Command: 0,
StatusCode: 0,
CompletionCode: completionCode,
Status: CreateUnpromotedCompletionStatus(completionCode));
return true;
}
if (inner.Length == 5 && inner[0] == 0x00 && inner[1] == 0x00)
{
ushort statusCode = (ushort)(inner[2] | (inner[3] << 8));
byte completionCode = inner[4];
message = new NmxOperationStatusMessage(
Format: NmxOperationStatusFormat.StatusWord,
Command: inner[0],
StatusCode: statusCode,
CompletionCode: completionCode,
Status: statusCode == 0x8050 && completionCode == 0x00 ? MxStatus.WriteCompleteOk : new MxStatus(
Success: 0,
Category: MxStatusCategory.Unknown,
DetectedBy: MxStatusSource.Unknown,
Detail: completionCode == 0x00 ? unchecked((short)statusCode) : completionCode));
return true;
}
message = null!;
return false;
}
private static MxStatus CreateUnpromotedCompletionStatus(byte completionCode)
{
return new MxStatus(
Success: 0,
Category: MxStatusCategory.Unknown,
DetectedBy: MxStatusSource.Unknown,
Detail: completionCode);
}
}