org.anarres.qemu.exec

Class QEmuCommandLine

java.lang.Object

org.anarres.qemu.exec.QEmuCommandLine

public class QEmuCommandLine
extends Object

An execution command line for a QEmu process. A QEmuCommandLine is a tree of QEmuOption, not a list (see QEmuOptionsList). Disk and bus IDs within a QEmuOption may be allocated using the embedded QEmuIdAllocator in order to guarantee uniqueness. For convenience, composites of commonly used options are provided as QEmuRecipes.

Constructor Summary

Constructors

Constructor and Description
QEmuCommandLine(QEmuArchitecture architecture)
QEmuCommandLine(QEmuCommandLine prototype)

Method Summary

Modifier and Type	Method and Description
void	addOptions(Iterable<? extends QEmuOption> options)
void	addOptions(QEmuOption... options)
Process	exec() Executes this QEmuCommandLine and returns a new Process.
QEmuIdAllocator	getAllocator()
QEmuArchitecture	getArchitecture()
String	getCommandName() Returns the name (possibly with path) of the binary used to execute qemu.
<T extends QEmuOption> T	getOption(Class<T> type) Returns the first option of the specified type in this command line.
List<? extends QEmuOption>	getOptions() Returns all the options in this command line.
<T extends QEmuOption> List<? extends T>	getOptions(Class<T> type) Returns all options of the specified type in this command line.
void	setArchitecture(QEmuArchitecture architecture)
void	setCommandName(String commandName)
List<String>	toCommandWords()
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

QEmuCommandLine

public QEmuCommandLine(@Nonnull
                       QEmuArchitecture architecture)

QEmuCommandLine

public QEmuCommandLine(@Nonnull
                       QEmuCommandLine prototype)

Method Detail

getArchitecture

@Nonnull
public QEmuArchitecture getArchitecture()

setArchitecture

public void setArchitecture(@Nonnull
                            QEmuArchitecture architecture)

getAllocator

@Nonnull
public QEmuIdAllocator getAllocator()

getOptions

@Nonnull
public List<? extends QEmuOption> getOptions()

Returns all the options in this command line.

getCommandName

@Nonnull
public String getCommandName()

Returns the name (possibly with path) of the binary used to execute qemu. This is derived from getArchitecture() if not explicitly set using setCommandName(java.lang.String).

setCommandName

public void setCommandName(@Nonnull
                           String commandName)

getOptions

@Nonnull
public <T extends QEmuOption> List<? extends T> getOptions(@Nonnull
                                                                    Class<T> type)

Returns all options of the specified type in this command line.

getOption

@CheckForNull
public <T extends QEmuOption> T getOption(@Nonnull
                                                        Class<T> type)

Returns the first option of the specified type in this command line. If there are no options of type type, null is returned. If there is more than one option of type type, the subsequent options are ignored.

addOptions

public void addOptions(@Nonnull
                       Iterable<? extends QEmuOption> options)

addOptions

public void addOptions(@Nonnull
                       QEmuOption... options)

toCommandWords

@Nonnull
public List<String> toCommandWords()

exec

@Nonnull
public Process exec()
                      throws IOException

Executes this QEmuCommandLine and returns a new Process.

Throws:

IOException

toString

public String toString()

Overrides:

toString in class Object