Skip to main content
aboutsummaryrefslogtreecommitdiffstats
path: root/debug
diff options
context:
space:
mode:
Diffstat (limited to 'debug')
-rw-r--r--debug/org.eclipse.cdt.debug.core/src/org/eclipse/cdt/debug/core/model/provisional/IRecurringDebugContext.java38
1 files changed, 38 insertions, 0 deletions
diff --git a/debug/org.eclipse.cdt.debug.core/src/org/eclipse/cdt/debug/core/model/provisional/IRecurringDebugContext.java b/debug/org.eclipse.cdt.debug.core/src/org/eclipse/cdt/debug/core/model/provisional/IRecurringDebugContext.java
new file mode 100644
index 00000000000..101ff67c1f3
--- /dev/null
+++ b/debug/org.eclipse.cdt.debug.core/src/org/eclipse/cdt/debug/core/model/provisional/IRecurringDebugContext.java
@@ -0,0 +1,38 @@
+/*******************************************************************************
+ * Copyright (c) 2011, Texas Instruments and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ * Texas Instruments - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.cdt.debug.core.model.provisional;
+
+import org.eclipse.debug.core.DebugException;
+
+/**
+ * This interface should be implemented by context objects that can provide an
+ * identifier that is unique among other contexts of the same type in a debug
+ * session, but which will be reused if the underlying thing appears in a future
+ * debug session. For example, the executable name can typically be used to
+ * identify that the process context in two successive debug sessions represent
+ * the same program. Where threads are programatically given meaningful names,
+ * the thread name can be used to detect that we're dealing with the same thread
+ * in successive debug sessions. Implementations should stay away from using
+ * identifiers that are assigned by the underlying runtime system (e.g., PIDs
+ * and TIDs), since such IDs are often assigned and reused in non-deterministic
+ * ways.
+ *
+ * @author Alain Lee
+ */
+public interface IRecurringDebugContext {
+
+ /**
+ * Returns the unique identifier associated with this recurring context. If
+ * this context re-appears in a future debug session, it should return the
+ * same value.
+ */
+ String getContextID() throws DebugException;
+}

Back to the top