| /******************************************************************************* |
| * Copyright (c) 2005 The Regents of the University of California. |
| * This material was produced under U.S. Government contract W-7405-ENG-36 |
| * for Los Alamos National Laboratory, which is operated by the University |
| * of California for the U.S. Department of Energy. The U.S. Government has |
| * rights to use, reproduce, and distribute this software. NEITHER THE |
| * GOVERNMENT NOR THE UNIVERSITY MAKES ANY WARRANTY, EXPRESS OR IMPLIED, OR |
| * ASSUMES ANY LIABILITY FOR THE USE OF THIS SOFTWARE. If software is modified |
| * to produce derivative works, such modified software should be clearly marked, |
| * so as not to confuse it with the version available from LANL. |
| * |
| * Additionally, 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 |
| * |
| * LA-CC 04-115 |
| *******************************************************************************/ |
| package org.eclipse.ptp.debug.core.cdi; |
| |
| import org.eclipse.core.runtime.CoreException; |
| import org.eclipse.core.runtime.IProgressMonitor; |
| import org.eclipse.ptp.core.elements.IPJob; |
| import org.eclipse.ptp.core.util.BitList; |
| import org.eclipse.ptp.debug.core.IAbstractDebugger; |
| import org.eclipse.ptp.debug.core.cdi.model.IPCDITarget; |
| import org.eclipse.ptp.debug.core.launch.IPLaunch; |
| |
| public interface IPCDISession extends ICommonActions { |
| /** Start debugger |
| * @param monitor |
| * @throws CoreException |
| */ |
| public void start(IProgressMonitor monitor) throws CoreException; |
| |
| /** Get debug targets |
| * @return |
| */ |
| IPCDITarget[] getTargets(); |
| /** Set attribute to session |
| * @param key |
| * @param value |
| */ |
| void setAttribute(String key, String value); |
| /** Get value in attribute |
| * @param key |
| * @return |
| */ |
| String getAttribute(String key); |
| /** Get pcid event manager |
| * @return |
| */ |
| IPCDIEventManager getEventManager(); |
| /** Get pcdi breakpoint manager |
| * @return |
| */ |
| IPCDIBreakpointManager getBreakpointManager(); |
| /** Get pcdi session configuration |
| * @return |
| */ |
| IPCDISessionConfiguration getConfiguration(); |
| /** Terminate debugger |
| * @throws PCDIException |
| */ |
| void terminate() throws PCDIException; |
| /** Get session process |
| * @return |
| * @throws PCDIException |
| */ |
| Process getSessionProcess() throws PCDIException; |
| |
| /** Register process to Debug View |
| * @param tasks process ids |
| * @param sendEvent true to send event to UI |
| * @param resumeTarget true to resume this process |
| */ |
| public void registerTargets(BitList tasks, boolean sendEvent, boolean resumeTarget); |
| /** Register processes to Debug View |
| * @param tasks process ids |
| * @param sendEvent true to send event to UI |
| */ |
| public void registerTargets(BitList tasks, boolean sendEvent); |
| /** Unregister process to Debug View |
| * @param tasks process ids |
| * @param sendEvent true to send event to UI |
| */ |
| public void unregisterTargets(BitList tasks, boolean sendEvent); |
| /** Get Job |
| * @return |
| */ |
| public IPJob getJob(); |
| /** Get total processes in this session |
| * @return total processes |
| */ |
| public int getTotalProcesses(); |
| |
| /** Create an empty BitList and set range 0 to total processes |
| * @return |
| */ |
| public BitList createBitList(); |
| /** Create an empty BitList |
| * @return |
| */ |
| public BitList createEmptyBitList(); |
| /** Create an empty BitList and set range to given index |
| * @param index set range to |
| * @return |
| */ |
| public BitList createBitList(int index); |
| |
| /** Get registered debug processes |
| * @return |
| */ |
| public BitList getRegisteredTargets(); |
| /** Get pcdi target by given task ID |
| * @param target_id |
| * @return |
| */ |
| public IPCDITarget getTarget(int target_id); |
| /** Shutdown this session |
| * |
| */ |
| public void shutdown(); |
| |
| /** Get launch |
| * @return |
| */ |
| public IPLaunch getLaunch(); |
| |
| /** Get external debugger |
| * @return |
| */ |
| public IAbstractDebugger getDebugger(); |
| } |