/*******************************************************************************
 * Copyright (c) 2000, 2010 QNX Software Systems and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     QNX Software Systems - Initial API and implementation
 *     Wind River Systems   - Modified for new DSF Reference Implementation
 *     Ericsson AB			- Modified for Execution Contexts
 *******************************************************************************/

package org.eclipse.cdt.dsf.mi.service.command.commands;

import org.eclipse.cdt.dsf.debug.service.IRunControl.IExecutionDMContext;
import org.eclipse.cdt.dsf.mi.service.command.output.MIInfo;

/**
 *
 *      -exec-interrupt [--all | --thread-group ID]
 *
 *  Asynchronous command.  Interrupts the background execution of the
 *  target.  Note how the token associated with the stop message is the one
 *  for the execution command that has been interrupted.  The token for the
 *  interrupt itself only appears in the `^done' output.  If the user is
 *  trying to interrupt a non-running program, an error message will be
 *  printed.
 *
 */
public class MIExecInterrupt extends MICommand<MIInfo> {
	public MIExecInterrupt(IExecutionDMContext dmc) {
		this(dmc, false);
	}

	/**
	 * @since 1.1
	 */
	public MIExecInterrupt(IExecutionDMContext dmc, boolean allThreads) {
		this(dmc, allThreads, null);
	}

	/**
	 * @since 3.0
	 */
	public MIExecInterrupt(IExecutionDMContext dmc, String groupId) {
		this(dmc, false, groupId);
	}

	/*
	 * The parameters allThreads and groupId are mutually exclusive.  allThreads must be false
	 * if we are to use groupId.  The value of this method is to only have one place
	 * where we use the hard-coded strings.
	 */
	private MIExecInterrupt(IExecutionDMContext dmc, boolean allThreads, String groupId) {
		super(dmc, "-exec-interrupt"); //$NON-NLS-1$
		if (allThreads) {
			setParameters(new String[] { "--all" }); //$NON-NLS-1$
		} else if (groupId != null) {
			setParameters(new String[] { "--thread-group", groupId }); //$NON-NLS-1$
		}
	}
}
