implement RuntimeInfo contract

Author: Max Charlamb

src/coreclr/debug/runtimeinfo/contracts.jsonc

@@ -19,6 +19,7 @@
   "PlatformMetadata": 1,
   "PrecodeStubs": 2,
   "ReJIT": 1,
+  "RuntimeInfo": 1,
   "RuntimeTypeSystem": 1,
   "StackWalk": 1,
   "StressLog": 2,

src/coreclr/debug/runtimeinfo/datadescriptor.h

@@ -757,6 +757,31 @@ CDAC_TYPE_END(CalleeSavedRegisters)
 CDAC_TYPES_END()
 
 CDAC_GLOBALS_BEGIN()
+
+// RuntimeInfo OperatingSystem
+#ifdef TARGET_UNIX
+CDAC_GLOBAL(OperatingSystem, uint32, 2) // RuntimeInfoOperatingSystem.Unix
+#else // !TARGET_UNIX
+CDAC_GLOBAL(OperatingSystem, uint32, 1) // RuntimeInfoOperatingSystem.Windows
+#endif // !TARGET_UNIX
+
+// RuntimeInfo Architecture
+#if defined(TARGET_X86)
+CDAC_GLOBAL(Architecture, uint32, 1) // RuntimeInfoArchitecture.X86
+#elif defined(TARGET_AMD64)
+CDAC_GLOBAL(Architecture, uint32, 3) // RuntimeInfoArchitecture.Amd64
+#elif defined(TARGET_ARM)
+CDAC_GLOBAL(Architecture, uint32, 2) // RuntimeInfoArchitecture.Arm32
+#elif defined(TARGET_ARM64)
+CDAC_GLOBAL(Architecture, uint32, 4) // RuntimeInfoArchitecture.Arm64
+#elif defined(TARGET_LOONGARCH64)
+CDAC_GLOBAL(Architecture, uint32, 5) // RuntimeInfoArchitecture.LoongArch64
+#elif defined(TARGET_RISCV64)
+CDAC_GLOBAL(Architecture, uint32, 6) // RuntimeInfoArchitecture.RISCV
+#else
+#error Unknown Processor.
+#endif
+
 CDAC_GLOBAL_POINTER(AppDomain, &AppDomain::m_pTheAppDomain)
 CDAC_GLOBAL_POINTER(ThreadStore, &ThreadStore::s_pThreadStore)
 CDAC_GLOBAL_POINTER(FinalizerThread, &::g_pFinalizerThread)

src/native/managed/cdacreader/Microsoft.Diagnostics.DataContractReader.Abstractions/ContractRegistry.cs

@@ -63,4 +63,8 @@ public abstract class ContractRegistry
     /// Gets an instance of the StackWalk contract for the target.
     /// </summary>
     public abstract IStackWalk StackWalk { get; }
+    /// <summary>
+    /// Gets an instance of the RuntimeInfo contract for the target.
+    /// </summary>
+    public abstract IRuntimeInfo RuntimeInfo { get; }
 }

src/native/managed/cdacreader/Microsoft.Diagnostics.DataContractReader.Abstractions/Contracts/IRuntimeInfo.cs

@@ -0,0 +1,37 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System;
+
+namespace Microsoft.Diagnostics.DataContractReader.Contracts;
+
+public enum RuntimeInfoArchitecture : uint
+{
+    Unknown = 0,
+    X86,
+    Arm32,
+    Amd64,
+    Arm64,
+    LoongArch64,
+    RISCV,
+}
+
+public enum RuntimeInfoOperatingSystem : uint
+{
+    Unknown = 0,
+    Windows,
+    Unix,
+}
+
+public interface IRuntimeInfo : IContract
+{
+    static string IContract.Name { get; } = nameof(RuntimeInfo);
+    public virtual RuntimeInfoArchitecture GetTargetArchitecture() => throw new NotImplementedException();
+    public virtual RuntimeInfoOperatingSystem GetTargetOperatingSystem() => throw new NotImplementedException();
+}
+
+public readonly struct RuntimeInfo : IRuntimeInfo
+{
+    RuntimeInfoArchitecture IRuntimeInfo.GetTargetArchitecture() => RuntimeInfoArchitecture.Unknown;
+    RuntimeInfoOperatingSystem IRuntimeInfo.GetTargetOperatingSystem() => RuntimeInfoOperatingSystem.Unknown;
+}

src/native/managed/cdacreader/Microsoft.Diagnostics.DataContractReader.Contracts/Contracts/RuntimeInfoFactory.cs

@@ -0,0 +1,16 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace Microsoft.Diagnostics.DataContractReader.Contracts;
+
+public sealed class RuntimeInfoFactory : IContractFactory<IRuntimeInfo>
+{
+    IRuntimeInfo IContractFactory<IRuntimeInfo>.CreateContract(Target target, int version)
+    {
+        return version switch
+        {
+            1 => new RuntimeInfo_1(target),
+            _ => default(RuntimeInfo),
+        };
+    }
+}

src/native/managed/cdacreader/Microsoft.Diagnostics.DataContractReader.Contracts/Contracts/RuntimeInfo_1.cs

@@ -0,0 +1,41 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System;
+using System.Collections.Generic;
+using Microsoft.Diagnostics.DataContractReader.Data;
+
+namespace Microsoft.Diagnostics.DataContractReader.Contracts;
+
+internal struct RuntimeInfo_1 : IRuntimeInfo
+{
+    private const string ArchitectureGlobalName = "Architecture";
+    private const string OperatingSystemGlobalName = "OperatingSystem";
+
+    internal readonly Target _target;
+
+    public RuntimeInfo_1(Target target)
+    {
+        _target = target;
+    }
+
+    RuntimeInfoArchitecture IRuntimeInfo.GetTargetArchitecture()
+    {
+        if (_target.TryReadGlobal<uint>(ArchitectureGlobalName, out uint? arch))
+        {
+            return (RuntimeInfoArchitecture)arch;
+        }
+
+        return RuntimeInfoArchitecture.Unknown;
+    }
+
+    RuntimeInfoOperatingSystem IRuntimeInfo.GetTargetOperatingSystem()
+    {
+        if (_target.TryReadGlobal<uint>(OperatingSystemGlobalName, out uint? os))
+        {
+            return (RuntimeInfoOperatingSystem)os;
+        }
+
+        return RuntimeInfoOperatingSystem.Unknown;
+    }
+}

src/native/managed/cdacreader/Microsoft.Diagnostics.DataContractReader/CachingContractRegistry.cs

@@ -38,6 +38,7 @@ public CachingContractRegistry(Target target, TryGetContractVersionDelegate tryG
             [typeof(IPrecodeStubs)] = new PrecodeStubsFactory(),
             [typeof(IReJIT)] = new ReJITFactory(),
             [typeof(IStackWalk)] = new StackWalkFactory(),
+            [typeof(IRuntimeInfo)] = new RuntimeInfoFactory(),
         };
         configureFactories?.Invoke(_factories);
     }
@@ -55,6 +56,7 @@ public CachingContractRegistry(Target target, TryGetContractVersionDelegate tryG
     public override IPrecodeStubs PrecodeStubs => GetContract<IPrecodeStubs>();
     public override IReJIT ReJIT => GetContract<IReJIT>();
     public override IStackWalk StackWalk => GetContract<IStackWalk>();
+    public override IRuntimeInfo RuntimeInfo => GetContract<IRuntimeInfo>();
 
     private TContract GetContract<TContract>() where TContract : IContract
     {