1
/*******************************************************************************
2
* Copyright (c) 2002, 2007 QNX Software Systems and others.
3
* All rights reserved. This program and the accompanying materials
4
* are made available under the terms of the Eclipse Public License v1.0
5
* which accompanies this distribution, and is available at
6
* http://www.eclipse.org/legal/epl-v10.html
9
* QNX Software Systems - Initial API and implementation
10
*******************************************************************************/
12
package org.eclipse.cdt.debug.core.cdi.model;
14
import org.eclipse.cdt.debug.core.cdi.CDIException;
17
* The memory manager manages the collection of memory blocks
18
* specified for the debug session.
20
* ICDIMemoryBlockManagement
23
public interface ICDIMemoryBlockManagement {
26
* Returns a memory block specified by given identifier.
28
* @param units - number of bytes
29
* @param wordSize - this parameter has been deprecated in 4.0
30
* and will always be passed as the value 1. If the memory
31
* has an addressable size (number of bytes per address)
32
* greather than 1, the CDI client should take care not to
33
* return the value of wordSize we pass in here, but rather
34
* return the actual addressable size for that memory.
35
* @return a memory block with the specified identifier
36
* @throws CDIException on failure. Reasons include:
38
ICDIMemoryBlock createMemoryBlock(String address, int units, int wordSize)
42
* Removes the given array of memory blocks from the debug session.
44
* @param memoryBlock - the array of memory blocks to be removed
45
* @exception CDIException on failure. Reasons include:
47
void removeBlocks(ICDIMemoryBlock[] memoryBlocks) throws CDIException;
50
* Removes all memory blocks from the debug session.
52
* @exception CDIException on failure. Reasons include:
54
void removeAllBlocks() throws CDIException;
57
* Returns an array of all memory blocks set for this debug session.
59
* @return an array of all memory blocks set for this debug session
60
* @throws CDIException on failure. Reasons include:
62
ICDIMemoryBlock[] getMemoryBlocks() throws CDIException;