/*******************************************************************************
* Copyright (c) 2004, 2005 QNX Software Systems 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:
* QNX Software Systems - Initial API and implementation
*******************************************************************************/
package org.eclipse.cdt.debug.core.model;
import org.eclipse.cdt.core.IAddress;
import org.eclipse.debug.core.DebugException;
import org.eclipse.debug.core.model.IDebugTarget;
import org.eclipse.debug.core.model.IRegisterGroup;
/**
* C/C++ extension of <code>IDebugTarget</code>.
*/
public interface ICDebugTarget extends IDebugTarget,
IExecFileInfo,
IRestart,
IResumeWithoutSignal,
ICDebugElement,
ISteppingModeTarget,
IModuleRetrieval,
ITargetProperties {
/**
* Returns whether this target is little endian.
*
* @return whether this target is little endian
*/
public boolean isLittleEndian();
/**
* Returns whether this target supports signals.
*
* @return whether this target supports signals
* @throws DebugException if this method fails.
*/
public boolean hasSignals() throws DebugException;
/**
* Returns the list of signals defined for this target.
*
* @return the list of signals defined for this target
* @throws DebugException if this method fails.
*/
public ICSignal[] getSignals() throws DebugException;
/**
* Returns the disassembly provider of this debug target.
*
* @return the disassembly provider of this debug target
* @throws DebugException if this method fails.
*/
public IDisassembly getDisassembly() throws DebugException;
/**
* Returns whether this target is a post mortem type.
*
* @return whether this target is a post mortem type
*/
public boolean isPostMortem();
/**
* Returns the list of descriptors of the target registers
*
* @return the list register descriptors
* @throws DebugException if this method fails. Reasons include:
*
* @since 3.0
*/
public IRegisterDescriptor[] getRegisterDescriptors() throws DebugException;
/**
* Adds a new user-defined register group to this target
*
* @param name the group name
* @param descriptors the list of registers to be grouped
*
* @since 3.0
*/
public void addRegisterGroup( String name, IRegisterDescriptor[] descriptors );
/**
* Removes the given register group from the target
*
* @param group a group to be removed
*
* @since 3.0
*/
public void removeRegisterGroups( IRegisterGroup[] groups );
/**
* Replace the given group's register descriptors by the specified descriptors.
*
* @param group a group to be modified
* @param descriptors a descriptor array to replace existing descriptors
*
* @since 3.0
*/
public void modifyRegisterGroup( IPersistableRegisterGroup group, IRegisterDescriptor[] descriptors );
/**
* Removes all user-defined register groups and restores the hardware groups.
*
* @since 3.0
*/
public void restoreDefaultRegisterGroups();
/**
* Returns the target address of the given breakpoint.
*
* @return the target address of the given breakpoint
* @throws DebugException if the address is not available
*/
public IAddress getBreakpointAddress( ICLineBreakpoint breakpoint ) throws DebugException;
}