2 // System.Diagnostics.StackFrame.cs
5 // Alexander Klyubin (klyubin@aqris.com)
6 // Dietmar Maurer (dietmar@ximian.com)
9 // Copyright (C) 2004-2005 Novell, Inc (http://www.novell.com)
11 // Permission is hereby granted, free of charge, to any person obtaining
12 // a copy of this software and associated documentation files (the
13 // "Software"), to deal in the Software without restriction, including
14 // without limitation the rights to use, copy, modify, merge, publish,
15 // distribute, sublicense, and/or sell copies of the Software, and to
16 // permit persons to whom the Software is furnished to do so, subject to
17 // the following conditions:
19 // The above copyright notice and this permission notice shall be
20 // included in all copies or substantial portions of the Software.
22 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
23 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
24 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
25 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
26 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
27 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
28 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
32 using System.Reflection;
33 using System.Runtime.CompilerServices;
34 using System.Security;
35 using System.Security.Permissions;
37 using System.Runtime.InteropServices;
39 namespace System.Diagnostics {
43 [MonoTODO ("Serialized objects are not compatible with MS.NET")]
44 [StructLayout (LayoutKind.Sequential)]
45 public class StackFrame {
47 public const int OFFSET_UNKNOWN = -1;
49 #region Keep in sync with object-internals.h
50 private int ilOffset = OFFSET_UNKNOWN;
51 private int nativeOffset = OFFSET_UNKNOWN;
52 private long methodAddress;
53 private MethodBase methodBase;
54 private string fileName;
55 private int lineNumber;
56 private int columnNumber;
57 #pragma warning disable 649
58 private string internalMethodName;
59 #pragma warning restore 649
62 [MethodImplAttribute(MethodImplOptions.InternalCall)]
63 extern static bool get_frame_info (int skip, bool needFileInfo, out MethodBase method,
64 out int iloffset, out int native_offset,
65 out string file, out int line, out int column);
69 get_frame_info (2, false, out methodBase, out ilOffset,
70 out nativeOffset, out fileName, out lineNumber,
74 public StackFrame (bool fNeedFileInfo)
76 get_frame_info (2, fNeedFileInfo, out methodBase, out ilOffset,
77 out nativeOffset, out fileName, out lineNumber,
81 public StackFrame (int skipFrames)
83 get_frame_info (skipFrames + 2, false, out methodBase, out ilOffset,
84 out nativeOffset, out fileName, out lineNumber,
88 public StackFrame (int skipFrames, bool fNeedFileInfo)
90 get_frame_info (skipFrames + 2, fNeedFileInfo, out methodBase, out ilOffset,
91 out nativeOffset, out fileName, out lineNumber,
95 // LAMESPEC: According to the MSDN docs, this creates a frame with _only_
96 // the filename and lineNumber, but MS fills out the frame info as well.
97 public StackFrame (string fileName, int lineNumber)
99 get_frame_info (2, false, out methodBase, out ilOffset,
100 out nativeOffset, out fileName, out lineNumber,
102 this.fileName = fileName;
103 this.lineNumber = lineNumber;
104 this.columnNumber = 0;
107 // LAMESPEC: According to the MSDN docs, this creates a frame with _only_
108 // the filename, lineNumber and colNumber, but MS fills out the frame info as well.
109 public StackFrame (string fileName, int lineNumber, int colNumber)
111 get_frame_info (2, false, out methodBase, out ilOffset,
112 out nativeOffset, out fileName, out lineNumber,
114 this.fileName = fileName;
115 this.lineNumber = lineNumber;
116 this.columnNumber = colNumber;
119 public virtual int GetFileLineNumber()
124 public virtual int GetFileColumnNumber()
129 public virtual string GetFileName()
132 if (SecurityManager.SecurityEnabled && (fileName != null) && (fileName.Length > 0)) {
133 string fn = Path.GetFullPath (fileName);
134 new FileIOPermission (FileIOPermissionAccess.PathDiscovery, fn).Demand ();
140 internal string GetSecureFileName ()
142 string filename = "<filename unknown>";
143 if (fileName == null)
146 filename = GetFileName ();
148 catch (SecurityException) {
154 public virtual int GetILOffset()
159 public virtual MethodBase GetMethod ()
164 public virtual int GetNativeOffset()
169 internal long GetMethodAddress ()
171 return methodAddress;
174 internal string GetInternalMethodName ()
176 return internalMethodName;
179 public override string ToString ()
181 StringBuilder sb = new StringBuilder ();
183 if (methodBase == null) {
184 sb.Append (Locale.GetText ("<unknown method>"));
186 sb.Append (methodBase.Name);
189 sb.Append (Locale.GetText (" at "));
191 if (ilOffset == OFFSET_UNKNOWN) {
192 sb.Append (Locale.GetText ("<unknown offset>"));
194 sb.Append (Locale.GetText ("offset "));
195 sb.Append (ilOffset);
198 sb.Append (Locale.GetText (" in file:line:column "));
199 sb.Append (GetSecureFileName ());
200 sb.AppendFormat (":{0}:{1}", lineNumber, columnNumber);
201 return sb.ToString ();