// // rootcontext.cs: keeps track of our tree representation, and assemblies loaded. // // Author: Miguel de Icaza (miguel@ximian.com) // Ravi Pratap (ravi@ximian.com) // // Licensed under the terms of the GNU GPL // // (C) 2001 Ximian, Inc (http://www.ximian.com) // (C) 2004 Novell, Inc using System; using System.Collections; using System.Reflection; using System.Reflection.Emit; using System.Diagnostics; namespace Mono.CSharp { public enum LanguageVersion { Default = 0, ISO_1 = 1 } public class RootContext { // // Contains the parsed tree // static RootTypes root; // // This hashtable contains all of the #definitions across the source code // it is used by the ConditionalAttribute handler. // public static Hashtable AllDefines = new Hashtable (); // // Whether we are being linked against the standard libraries. // This is only used to tell whether `System.Object' should // have a base class or not. // public static bool StdLib; // // This keeps track of the order in which classes were defined // so that we can poulate them in that order. // // Order is important, because we need to be able to tell, by // examining the list of methods of the base class, which ones are virtual // or abstract as well as the parent names (to implement new, // override). // static ArrayList type_container_resolve_order; // // Holds a reference to the Private Implementation Details // class. // static ArrayList helper_classes; static TypeBuilder impl_details_class; public static int WarningLevel; public static Target Target; public static string TargetExt; public static bool VerifyClsCompliance = true; /// /// Holds /optimize option /// public static bool Optimize = true; public static LanguageVersion Version; // // We keep strongname related info here because // it's also used as complier options from CSC 8.x // public static string StrongNameKeyFile; public static string StrongNameKeyContainer; public static bool StrongNameDelaySign; // // If set, enable XML documentation generation // public static Documentation Documentation; static public string MainClass; // // Constructor // static RootContext () { Reset (); } public static void Reset () { root = new RootTypes (); type_container_resolve_order = new ArrayList (); EntryPoint = null; WarningLevel = 3; Checked = false; Unsafe = false; StdLib = true; StrongNameKeyFile = null; StrongNameKeyContainer = null; StrongNameDelaySign = false; MainClass = null; Target = Target.Exe; TargetExt = ".exe"; Version = LanguageVersion.Default; Documentation = null; impl_details_class = null; helper_classes = null; } public static bool NeedsEntryPoint { get { return RootContext.Target == Target.Exe || RootContext.Target == Target.WinExe; } } static public RootTypes ToplevelTypes { get { return root; } } public static void RegisterOrder (TypeContainer tc) { type_container_resolve_order.Add (tc); } // // The default compiler checked state // static public bool Checked; // // Whether to allow Unsafe code // static public bool Unsafe; // // This function is used to resolve the hierarchy tree. // It processes interfaces, structs and classes in that order. // // It creates the TypeBuilder's as it processes the user defined // types. // static public void ResolveTree () { // // Interfaces are processed next, as classes and // structs might inherit from an object or implement // a set of interfaces, we need to be able to tell // them appart by just using the TypeManager. // ArrayList ifaces = root.Interfaces; if (ifaces != null){ foreach (TypeContainer i in ifaces) i.DefineType (); } foreach (TypeContainer tc in root.Types) tc.DefineType (); if (root.Delegates != null) foreach (Delegate d in root.Delegates) d.DefineType (); if (root.Enums != null) foreach (Enum e in root.Enums) e.DefineType (); } static void Error_TypeConflict (string name, Location loc) { Report.Error ( 520, loc, "`" + name + "' conflicts with a predefined type"); } static void Error_TypeConflict (string name) { Report.Error ( 520, "`" + name + "' conflicts with a predefined type"); } // // Resolves a single class during the corlib bootstrap process // static TypeBuilder BootstrapCorlib_ResolveClass (TypeContainer root, string name) { object o = root.GetDefinition (name); if (o == null){ Report.Error (518, "The predefined type `" + name + "' is not defined or imported"); return null; } if (!(o is Class)){ if (o is DeclSpace){ DeclSpace d = (DeclSpace) o; Error_TypeConflict (name, d.Location); } else Error_TypeConflict (name); return null; } return ((DeclSpace) o).DefineType (); } // // Resolves a struct during the corlib bootstrap process // static void BootstrapCorlib_ResolveStruct (TypeContainer root, string name) { object o = root.GetDefinition (name); if (o == null){ Report.Error (518, "The predefined type `" + name + "' is not defined or imported"); return; } if (!(o is Struct)){ if (o is DeclSpace){ DeclSpace d = (DeclSpace) o; Error_TypeConflict (name, d.Location); } else Error_TypeConflict (name); return; } ((DeclSpace) o).DefineType (); } // // Resolves a struct during the corlib bootstrap process // static void BootstrapCorlib_ResolveInterface (TypeContainer root, string name) { object o = root.GetDefinition (name); if (o == null){ Report.Error (518, "The predefined type `" + name + "' is not defined or imported"); return; } if (!(o is Interface)){ if (o is DeclSpace){ DeclSpace d = (DeclSpace) o; Error_TypeConflict (name, d.Location); } else Error_TypeConflict (name); return; } ((DeclSpace) o).DefineType (); } // // Resolves a delegate during the corlib bootstrap process // static void BootstrapCorlib_ResolveDelegate (TypeContainer root, string name) { object o = root.GetDefinition (name); if (o == null){ Report.Error (518, "The predefined type `" + name + "' is not defined or imported"); return; } if (!(o is Delegate)){ Error_TypeConflict (name); return; } ((DeclSpace) o).DefineType (); } /// /// Resolves the core types in the compiler when compiling with --nostdlib /// static public void ResolveCore () { TypeManager.object_type = BootstrapCorlib_ResolveClass (root, "System.Object"); TypeManager.system_object_expr.Type = TypeManager.object_type; TypeManager.value_type = BootstrapCorlib_ResolveClass (root, "System.ValueType"); TypeManager.system_valuetype_expr.Type = TypeManager.value_type; TypeManager.attribute_type = BootstrapCorlib_ResolveClass (root, "System.Attribute"); TypeManager.indexer_name_type = BootstrapCorlib_ResolveClass (root, "System.Runtime.CompilerServices.IndexerNameAttribute"); string [] interfaces_first_stage = { "System.IComparable", "System.ICloneable", "System.IConvertible", "System.Collections.IEnumerable", "System.Collections.ICollection", "System.Collections.IEnumerator", "System.Collections.IList", "System.IAsyncResult", "System.IDisposable", "System.Runtime.Serialization.ISerializable", "System.Reflection.IReflect", "System.Reflection.ICustomAttributeProvider", #if GMCS_SOURCE "System.Runtime.InteropServices._Exception", // // Generic types // "System.Collections.Generic.IEnumerator`1", "System.Collections.Generic.IEnumerable`1" #endif }; foreach (string iname in interfaces_first_stage) BootstrapCorlib_ResolveInterface (root, iname); // // These are the base value types // string [] structs_first_stage = { "System.Byte", "System.SByte", "System.Int16", "System.UInt16", "System.Int32", "System.UInt32", "System.Int64", "System.UInt64", }; foreach (string cname in structs_first_stage) BootstrapCorlib_ResolveStruct (root, cname); // // Now, we can load the enumerations, after this point, // we can use enums. // TypeManager.InitEnumUnderlyingTypes (); string [] structs_second_stage = { "System.Single", "System.Double", "System.Char", "System.Boolean", "System.Decimal", "System.Void", "System.RuntimeFieldHandle", "System.RuntimeArgumentHandle", "System.RuntimeTypeHandle", "System.IntPtr", "System.TypedReference", "System.ArgIterator" }; foreach (string cname in structs_second_stage) BootstrapCorlib_ResolveStruct (root, cname); // // These are classes that depends on the core interfaces // string [] classes_second_stage = { "System.Enum", "System.String", "System.Array", "System.Reflection.MemberInfo", "System.Type", "System.Exception", #if GMCS_SOURCE "System.Activator", #endif // // These are not really important in the order, but they // are used by the compiler later on (typemanager/CoreLookupType-d) // "System.Runtime.CompilerServices.RuntimeHelpers", "System.Reflection.DefaultMemberAttribute", "System.Threading.Monitor", "System.Threading.Interlocked", "System.AttributeUsageAttribute", "System.Runtime.InteropServices.DllImportAttribute", "System.Runtime.CompilerServices.MethodImplAttribute", "System.Runtime.InteropServices.MarshalAsAttribute", #if GMCS_SOURCE "System.Runtime.CompilerServices.CompilerGeneratedAttribute", "System.Runtime.CompilerServices.FixedBufferAttribute", #endif "System.Diagnostics.ConditionalAttribute", "System.ObsoleteAttribute", "System.ParamArrayAttribute", "System.CLSCompliantAttribute", "System.Security.UnverifiableCodeAttribute", "System.Security.Permissions.SecurityAttribute", "System.Runtime.CompilerServices.DecimalConstantAttribute", "System.Runtime.InteropServices.InAttribute", "System.Runtime.InteropServices.OutAttribute", "System.Runtime.InteropServices.StructLayoutAttribute", "System.Runtime.InteropServices.FieldOffsetAttribute", #if GMCS_SOURCE "System.Runtime.InteropServices.DefaultCharSetAttribute", #endif "System.InvalidOperationException", "System.NotSupportedException", "System.MarshalByRefObject", "System.Security.CodeAccessPermission", "System.Runtime.CompilerServices.RequiredAttributeAttribute", "System.Runtime.InteropServices.GuidAttribute", "System.Reflection.AssemblyCultureAttribute" }; foreach (string cname in classes_second_stage) BootstrapCorlib_ResolveClass (root, cname); #if GMCS_SOURCE BootstrapCorlib_ResolveStruct (root, "System.Nullable`1"); #endif BootstrapCorlib_ResolveDelegate (root, "System.AsyncCallback"); // These will be defined indirectly during the previous ResolveDelegate. // However make sure the rest of the checks happen. string [] delegate_types = { "System.Delegate", "System.MulticastDelegate" }; foreach (string cname in delegate_types) BootstrapCorlib_ResolveClass (root, cname); } // // Closes all open types // // // // We usually use TypeBuilder types. When we are done // creating the type (which will happen after we have added // methods, fields, etc) we need to "Define" them before we // can save the Assembly // static public void CloseTypes () { if (root.Enums != null) foreach (Enum en in root.Enums) en.CloseType (); // // We do this in two passes, first we close the structs, // then the classes, because it seems the code needs it this // way. If this is really what is going on, we should probably // make sure that we define the structs in order as well. // foreach (TypeContainer tc in type_container_resolve_order){ if (tc.Kind == Kind.Struct && tc.Parent == root){ tc.CloseType (); } } foreach (TypeContainer tc in type_container_resolve_order){ if (!(tc.Kind == Kind.Struct && tc.Parent == root)) tc.CloseType (); } if (root.Delegates != null) foreach (Delegate d in root.Delegates) d.CloseType (); // // If we have a class, close it // if (helper_classes != null){ foreach (TypeBuilder type_builder in helper_classes) { #if GMCS_SOURCE type_builder.SetCustomAttribute (TypeManager.compiler_generated_attr); #endif type_builder.CreateType (); } } type_container_resolve_order = null; helper_classes = null; //root = null; TypeManager.CleanUp (); } /// /// Used to register classes that need to be closed after all the /// user defined classes /// public static void RegisterCompilerGeneratedType (TypeBuilder helper_class) { if (helper_classes == null) helper_classes = new ArrayList (); helper_classes.Add (helper_class); } static public void PopulateCoreType (TypeContainer root, string name) { DeclSpace ds = (DeclSpace) root.GetDefinition (name); ds.DefineMembers (); ds.Define (); } static public void BootCorlib_PopulateCoreTypes () { PopulateCoreType (root, "System.Object"); PopulateCoreType (root, "System.ValueType"); PopulateCoreType (root, "System.Attribute"); PopulateCoreType (root, "System.Runtime.CompilerServices.IndexerNameAttribute"); } // // Populates the structs and classes with fields and methods // // // This is invoked after all interfaces, structs and classes // have been defined through `ResolveTree' static public void PopulateTypes () { if (type_container_resolve_order != null){ #if GMCS_SOURCE foreach (TypeContainer tc in type_container_resolve_order) tc.ResolveType (); #endif foreach (TypeContainer tc in type_container_resolve_order) tc.DefineMembers (); } ArrayList delegates = root.Delegates; if (delegates != null){ foreach (Delegate d in delegates) d.DefineMembers (); } ArrayList enums = root.Enums; if (enums != null){ foreach (Enum en in enums) en.DefineMembers (); } // // Check for cycles in the struct layout // if (type_container_resolve_order != null){ Hashtable seen = new Hashtable (); foreach (TypeContainer tc in type_container_resolve_order) TypeManager.CheckStructCycles (tc, seen); } } // // A generic hook delegate // public delegate void Hook (); // // A hook invoked when the code has been generated. // public static event Hook EmitCodeHook; // // DefineTypes is used to fill in the members of each type. // static public void DefineTypes () { ArrayList delegates = root.Delegates; if (delegates != null){ foreach (Delegate d in delegates) d.Define (); } if (type_container_resolve_order != null){ foreach (TypeContainer tc in type_container_resolve_order) { // When compiling corlib, these types have already been // populated from BootCorlib_PopulateCoreTypes (). if (!RootContext.StdLib && ((tc.Name == "System.Object") || (tc.Name == "System.Attribute") || (tc.Name == "System.ValueType") || (tc.Name == "System.Runtime.CompilerServices.IndexerNameAttribute"))) continue; tc.Define (); } } ArrayList enums = root.Enums; if (enums != null){ foreach (Enum en in enums) en.Define (); } } static public void EmitCode () { if (root.Enums != null) { foreach (Enum e in root.Enums) e.Emit (); } if (type_container_resolve_order != null) { foreach (TypeContainer tc in type_container_resolve_order) tc.EmitType (); if (Report.Errors > 0) return; foreach (TypeContainer tc in type_container_resolve_order) tc.VerifyMembers (); } if (root.Delegates != null) { foreach (Delegate d in root.Delegates) d.Emit (); } // // Run any hooks after all the types have been defined. // This is used to create nested auxiliary classes for example // if (EmitCodeHook != null) EmitCodeHook (); CodeGen.Assembly.Emit (root); CodeGen.Module.Emit (root); } // // Public Field, used to track which method is the public entry // point. // static public MethodInfo EntryPoint; // // Track the location of the entry point. // static public Location EntryPointLocation; // // These are used to generate unique names on the structs and fields. // static int field_count; // // Makes an initialized struct, returns the field builder that // references the data. Thanks go to Sergey Chaban for researching // how to do this. And coming up with a shorter mechanism than I // was able to figure out. // // This works but makes an implicit public struct $ArrayType$SIZE and // makes the fields point to it. We could get more control if we did // use instead: // // 1. DefineNestedType on the impl_details_class with our struct. // // 2. Define the field on the impl_details_class // static public FieldBuilder MakeStaticData (byte [] data) { FieldBuilder fb; if (impl_details_class == null){ impl_details_class = CodeGen.Module.Builder.DefineType ( "", TypeAttributes.NotPublic, TypeManager.object_type); RegisterCompilerGeneratedType (impl_details_class); } fb = impl_details_class.DefineInitializedData ( "$$field-" + (field_count++), data, FieldAttributes.Static | FieldAttributes.Assembly); return fb; } public static void CheckUnsafeOption (Location loc) { if (!Unsafe) { Report.Error (227, loc, "Unsafe code requires the `unsafe' command line option to be specified"); } } } }