Skip to content

Class VerifierDiagnosticCodes

Namespace: DotBoxD.Kernels.Verifier.Diagnostics
Assembly: DotBoxD.Kernels.Verifier.dll

Public, maintained reference for the V-* diagnostic codes emitted by DotBoxD.Kernels.Verifier.Generated.IGeneratedAssemblyVerifier through DotBoxD.Kernels.Verifier.Generated.VerificationResult.Diagnostics. Consumers should reference these constants instead of hard-coding magic strings, and can use DotBoxD.Kernels.Verifier.Diagnostics.VerifierDiagnosticCodes.All / DotBoxD.Kernels.Verifier.Diagnostics.VerifierDiagnosticCodes.TryGetReference(System.String,DotBoxD.Kernels.Verifier.Diagnostics.VerifierDiagnosticReference@) to map a code to its documented meaning, likely cause, category, and remediation.

public static class VerifierDiagnosticCodes

object ← VerifierDiagnosticCodes

object.Equals(object?), object.Equals(object?, object?), object.GetHashCode(), object.GetType(), object.MemberwiseClone(), object.ReferenceEquals(object?, object?), object.ToString()

An array allocation uses an element type other than the allowed DotBoxD.Kernels value type.

public const string Array = "V-ARRAY"

string

An assembly reference is not on the policy allow-list.

public const string AssemblyReference = "V-ASM-REF"

string

The compiled Execute/function shape does not match the required DotBoxD.Kernels dispatch shape.

public const string CompiledShape = "V-COMPILED-SHAPE"

string

A branch targets an offset that is not a valid instruction boundary.

public const string ControlFlow = "V-CONTROL-FLOW"

string

The generated assembly carries a custom attribute, which is not allowed.

public const string CustomAttribute = "V-CUSTOM-ATTR"

string

A method body declares exception handlers, which are not allowed.

public const string Exception = "V-EXCEPTION"

string

The Execute method signature does not match the required DotBoxD.Kernels entrypoint signature.

public const string ExecuteSignature = "V-EXECUTE-SIGNATURE"

string

The generated type declares fields, which is not allowed.

public const string Field = "V-FIELD"

string

The generated type declares a mutable static field, which is not allowed.

public const string FieldStatic = "V-FIELD-STATIC"

string

A generated Fn_* helper does not match the required DotBoxD.Kernels function signature.

public const string FunctionSignature = "V-FUNCTION-SIGNATURE"

string

The generated type or a method declares generic parameters, which are not allowed.

public const string Generic = "V-GENERIC"

string

A method body contained malformed or unreadable IL.

public const string IlFormat = "V-IL-FORMAT"

string

Assembly hash is missing from the manifest or does not match the artifact bytes.

public const string ManifestHash = "V-MANIFEST-HASH"

string

Manifest identity does not match the expected verification context, or none was supplied.

public const string ManifestIdentity = "V-MANIFEST-IDENTITY"

string

A member (method/field) reference or local call target is not allowed by policy.

public const string Member = "V-MEMBER"

string

A disallowed metadata table is present (interfaces, properties, events, nested types, layout, and similar).

public const string MetadataShape = "V-METADATA-SHAPE"

string

A method uses unsupported attributes (virtual/abstract/synchronized/native/internal-call/non-static).

public const string MethodAttribute = "V-METHOD-ATTR"

string

A generated executable method is missing its method body.

public const string MethodBody = "V-METHOD-BODY"

string

A method name is not an expected generated method name.

public const string MethodName = "V-METHOD-NAME"

string

A method carries P/Invoke attributes.

public const string MethodPInvoke = "V-METHOD-PINVOKE"

string

A disallowed special method (such as .cctor or Finalize) is present.

public const string MethodSpecial = "V-METHOD-SPECIAL"

string

Module-level (<Module>) methods or fields are present, which is not allowed.

public const string ModuleSurface = "V-MODULE-SURFACE"

string

An IL opcode used in a method body is not on the allow-list or is explicitly forbidden.

public const string OpCode = "V-OPCODE"

string

An argument or local operand index is out of range for the method.

public const string Operand = "V-OPERAND"

string

The assembly carries P/Invoke (ImplMap) metadata, which is not allowed.

public const string PInvoke = "V-PINVOKE"

string

Generated artifact defines an entrypoint, which is not allowed.

public const string PeEntrypoint = "V-PE-ENTRYPOINT"

string

Portable Executable container is malformed or not a valid DotBoxD.Kernels DLL.

public const string PeFormat = "V-PE-FORMAT"

string

Assembly has no CLR metadata or CLR header.

public const string PeMetadata = "V-PE-METADATA"

string

Assembly is mixed-mode or contains native code.

public const string PeMixed = "V-PE-MIXED"

string

Assembly contains native PE or CLR header directories.

public const string PeNative = "V-PE-NATIVE"

string

Assembly contains a disallowed PE section or unsafe section permissions.

public const string PeSection = "V-PE-SECTION"

string

The public surface is wrong: extra types/methods, missing Execute, or bad visibility/name.

public const string PublicSurface = "V-PUBLIC-SURFACE"

string

The assembly embeds resources, which are not allowed.

public const string Resource = "V-RESOURCE"

string

The assembly carries declarative security metadata, which is not allowed.

public const string Security = "V-SECURITY"

string

The operand stack underflowed, mismatched the signature, or branch heights are inconsistent.

public const string Stack = "V-STACK"

string

A value on the operand stack has a type that is not allowed at that position.

public const string StackType = "V-STACK-TYPE"

string

A type reference matches a policy-forbidden prefix.

public const string TypeForbidden = "V-TYPE-FORBIDDEN"

string

A type reference is not on the policy allow-list.

public const string TypeReference = "V-TYPE-REF"

string

The generated type is not a static (abstract+sealed) non-interface type.

public const string TypeShape = "V-TYPE-SHAPE"

string

The complete, maintained catalog of verifier diagnostic codes. Every V-* code that DotBoxD.Kernels.Verifier.Generated.IGeneratedAssemblyVerifier can emit has exactly one entry here.

public static IReadOnlyList<VerifierDiagnosticReference> All { get; }

IReadOnlyList<VerifierDiagnosticReference>

TryGetReference(string, out VerifierDiagnosticReference)

Section titled “ TryGetReference(string, out VerifierDiagnosticReference)”

Looks up the documented reference for a diagnostic code. Returns false for unknown codes; callers on the security path should treat an unknown code conservatively rather than assuming it is benign.

public static bool TryGetReference(string code, out VerifierDiagnosticReference reference)

code string

reference VerifierDiagnosticReference

bool