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

objectVerifierDiagnosticCodes

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