Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJohn Cortell2010-10-12 19:35:07 +0000
committerJohn Cortell2010-10-12 19:35:07 +0000
commit6174986b48b3a26c0ebd65c92670b697d872976d (patch)
treec85bd20ca40bf917ac90b017e4e02a1419fe34f2 /dsf/org.eclipse.cdt.dsf
parenta28e2e0f5917666db8acadb5d4538db4c7aba640 (diff)
downloadorg.eclipse.cdt-6174986b48b3a26c0ebd65c92670b697d872976d.tar.gz
org.eclipse.cdt-6174986b48b3a26c0ebd65c92670b697d872976d.tar.xz
org.eclipse.cdt-6174986b48b3a26c0ebd65c92670b697d872976d.zip
Bug 327484: New service for getting information on a memory space. Documentation improvement asked for in comment 6
Diffstat (limited to 'dsf/org.eclipse.cdt.dsf')
-rw-r--r--dsf/org.eclipse.cdt.dsf/src/org/eclipse/cdt/dsf/debug/service/IMemorySpaces.java20
1 files changed, 18 insertions, 2 deletions
diff --git a/dsf/org.eclipse.cdt.dsf/src/org/eclipse/cdt/dsf/debug/service/IMemorySpaces.java b/dsf/org.eclipse.cdt.dsf/src/org/eclipse/cdt/dsf/debug/service/IMemorySpaces.java
index 79794457d9..78d9ca0764 100644
--- a/dsf/org.eclipse.cdt.dsf/src/org/eclipse/cdt/dsf/debug/service/IMemorySpaces.java
+++ b/dsf/org.eclipse.cdt.dsf/src/org/eclipse/cdt/dsf/debug/service/IMemorySpaces.java
@@ -28,7 +28,18 @@ import org.eclipse.core.runtime.CoreException;
*/
public interface IMemorySpaces extends IDsfService{
+ /**
+ * A context that represents a particular memory space. Simple targets have
+ * a single, implicit memory space, but some have multiple, e.g., code,
+ * data, virtual, physical.
+ */
public interface IMemorySpaceDMContext extends IMemoryDMContext {
+
+ /**
+ * The string-based handle used to refer to the memory space, as per
+ * what's returned in
+ * {@link IMemorySpaces#getMemorySpaces(IDMContext, DataRequestMonitor)
+ */
public String getMemorySpaceId();
}
@@ -73,10 +84,15 @@ public interface IMemorySpaces extends IDsfService{
* Provides the memory spaces available in the given context.
*
* @param ctx
- * a DM context
+ * a context which might <i>contain</i> one or more memory
+ * spaces. Contexts that may be <i>associated</i> with a memory
+ * space should not be passed in. E.g., an expression might be
+ * associated with a memory space, but it does not contain memory
+ * spaces, and is thus not an appropriate context for this
+ * method.
* @param rm
* the asynchronous data request monitor. Returns a collection of
- * memory space IDs.
+ * memory space IDs. Never null, but may be empty.
*/
void getMemorySpaces(IDMContext context, final DataRequestMonitor<String[]> rm);

Back to the top