fe2a6db786
rust / build / test / clippy / fmt (push) Has been cancelled
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>
78 lines
2.5 KiB
C#
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);
|
|
}
|
|
}
|