| /******************************************************************************* |
| * 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 |
| *******************************************************************************/ |
| /******************************************************************************* |
| * Copyright (c) 2004 QNX Software Systems and others. All rights reserved. This |
| * program and the accompanying materials are made available under the terms of |
| * the Common Public License v1.0 which accompanies this distribution, and is |
| * available at http://www.eclipse.org/legal/cpl-v10.html |
| * |
| * Contributors: QNX Software Systems - initial API and implementation |
| ******************************************************************************/ |
| package org.eclipse.ptp.debug.core; |
| |
| import org.eclipse.core.runtime.CoreException; |
| import org.eclipse.core.runtime.IPath; |
| import org.eclipse.core.runtime.IProgressMonitor; |
| import org.eclipse.debug.core.ILaunchConfiguration; |
| import org.eclipse.ptp.core.attributes.AttributeManager; |
| import org.eclipse.ptp.debug.core.launch.IPLaunch; |
| import org.eclipse.ptp.debug.core.pdi.IPDISession; |
| |
| public interface IPDebugger { |
| /** |
| * Create a new debugger session. |
| * |
| * @param timeout |
| * @param launch |
| * @param corefile |
| * @param monitor |
| * @return |
| * @throws CoreException |
| */ |
| public IPDISession createDebugSession(long timeout, IPLaunch launch, IPath corefile) throws CoreException; |
| |
| /** |
| * Initialize the debugger. This does whatever is necessary to get the debugger ready |
| * to start debugging the user application. The attrMgr argument can supply attributes |
| * from a previously submitted job that may be used to initialize the debug session. |
| * |
| * @param configuration debugger launch configuration |
| * @param attrMgr attribute manager containing attributes for launch |
| * @param monitor progress monitor |
| * @throws CoreException if the debugger cannot be initialized |
| */ |
| public void initialize(ILaunchConfiguration configuration, AttributeManager attrMgr, IProgressMonitor monitor) throws CoreException; |
| |
| /** |
| * Using the supplied ILaunchConfiguration, add the required attributes to attrMgr |
| * need to be passed to the submitJob command to launch the application under debugger control. |
| * |
| * @param configuration launch configuration for the debug session |
| * @param attrMgr attribute manager containing attributes for launch |
| * @throws CoreException |
| */ |
| public void getLaunchAttributes(ILaunchConfiguration configuration, AttributeManager attrMgr) throws CoreException; |
| |
| public void cleanup(ILaunchConfiguration configuration, AttributeManager attrMgr, IPLaunch launch); |
| } |