Comment
[mono-project.git] / mcs / class / corlib / System.Diagnostics / Debugger.cs
blobd102d4892f7e90f413b6f027dc82222c1c096daf
1 //
2 // System.Diagnostics.Debugger.cs
3 //
4 // Author:
5 // John R. Hicks (angryjohn69@nc.rr.com)
6 //
7 // (C) 2001
8 //
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:
20 //
21 // The above copyright notice and this permission notice shall be
22 // included in all copies or substantial portions of the Software.
23 //
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.
32 using System;
34 namespace System.Diagnostics
36 /// <summary>
37 /// Enables communication with a debugger.
38 /// </summary>
39 [MonoTODO ("The Debugger class is not functional")]
40 public sealed class Debugger
42 private static bool isAttached;
44 /// <summary>
45 /// Represents the default category of a message with a constant.
46 /// </summary>
47 public static readonly string DefaultCategory = "";
49 /// <summary>
50 /// Returns a Boolean indicating whether a debugger is attached to a process.
51 /// </summary>
52 /// <value>
53 /// true if debugger is attached; otherwise, false.
54 /// </value>
55 public static bool IsAttached
57 get
59 return isAttached;
63 /// <summary>
64 /// Causes a breakpoint to be signaled to an attached debugger.
65 /// </summary>
66 public static void Break()
68 // The JIT inserts a breakpoint on the caller.
71 /// <summary>
72 /// Checks to see if logging is enabled by an attached debugger.
73 /// </summary>
74 public static bool IsLogging()
76 // Return false. DefaultTraceListener invokes this method, so throwing
77 // a NotImplementedException wouldn't be appropriate.
78 return false;
82 /// <summary>
83 /// Launches and attaches a debugger to the process.
84 /// </summary>
85 [MonoTODO ("Not implemented")]
86 public static bool Launch()
88 throw new NotImplementedException();
91 /// <summary>
92 /// Posts a message for the attached debugger.
93 /// </summary>
94 /// <param name="level">
95 /// A description of the importance of this message
96 /// </param>
97 /// <param name="category">
98 /// A string describing the category of this message.
99 /// </param>
100 /// <param name="message">
101 /// A string representing the message to show.
102 /// </param>
103 public static void Log(int level, string category, string message)
105 // Do nothing. DefaultTraceListener invokes this method, so throwing
106 // a NotImplementedException wouldn't be appropriate.
109 public Debugger()
111 isAttached = false;