diff options
author | John Cortell | 2010-10-12 19:35:07 +0000 |
---|---|---|
committer | John Cortell | 2010-10-12 19:35:07 +0000 |
commit | 6174986b48b3a26c0ebd65c92670b697d872976d (patch) | |
tree | c85bd20ca40bf917ac90b017e4e02a1419fe34f2 /dsf/org.eclipse.cdt.dsf | |
parent | a28e2e0f5917666db8acadb5d4538db4c7aba640 (diff) | |
download | org.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.java | 20 |
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 79794457d91..78d9ca0764c 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); |