2 // System.Diagnostics.Debugger.cs
5 // John R. Hicks (angryjohn69@nc.rr.com)
11 // Copyright (C) 2004 Novell, Inc (http://www.novell.com)
13 // Permission is hereby granted, free of charge, to any person obtaining
14 // a copy of this software and associated documentation files (the
15 // "Software"), to deal in the Software without restriction, including
16 // without limitation the rights to use, copy, modify, merge, publish,
17 // distribute, sublicense, and/or sell copies of the Software, and to
18 // permit persons to whom the Software is furnished to do so, subject to
19 // the following conditions:
21 // The above copyright notice and this permission notice shall be
22 // included in all copies or substantial portions of the Software.
24 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
25 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
26 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
27 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
28 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
29 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
30 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
33 using System
.Runtime
.CompilerServices
;
35 using System
.Runtime
.InteropServices
;
37 namespace System
.Diagnostics
40 /// Enables communication with a debugger.
43 [MonoTODO ("The Debugger class is not functional")]
44 public sealed class Debugger
48 /// Represents the default category of a message with a constant.
50 public static readonly string DefaultCategory
= "";
53 /// Returns a Boolean indicating whether a debugger is attached to a process.
56 /// true if debugger is attached; otherwise, false.
58 public static bool IsAttached
62 return IsAttached_internal ();
66 [MethodImplAttribute (MethodImplOptions
.InternalCall
)]
67 private extern static bool IsAttached_internal ();
70 /// Causes a breakpoint to be signaled to an attached debugger.
72 public static void Break()
74 // The JIT inserts a breakpoint on the caller.
78 /// Checks to see if logging is enabled by an attached debugger.
80 [MethodImplAttribute(MethodImplOptions
.InternalCall
)]
81 public static extern bool IsLogging();
84 /// Launches and attaches a debugger to the process.
86 [MonoTODO ("Not implemented")]
87 public static bool Launch()
89 throw new NotImplementedException();
93 /// Posts a message for the attached debugger.
95 /// <param name="level">
96 /// A description of the importance of this message
98 /// <param name="category">
99 /// A string describing the category of this message.
101 /// <param name="message">
102 /// A string representing the message to show.
104 [MethodImplAttribute(MethodImplOptions
.InternalCall
)]
105 public static extern void Log(int level
, string category
, string message
);