Table of Contents

Class Run

Namespace
ZeroInstall.Commands.Basic
Assembly
0install.dll

This behaves similarly to Download, except that it also runs the program after ensuring it is in the cache.

public class Run : Download
Inheritance
Run
Inherited Members

Constructors

Run(ICommandHandler)

Creates a new run command.

public Run(ICommandHandler handler)

Parameters

handler ICommandHandler

A callback object used when the user needs to be asked questions or informed about download and IO tasks.

Fields

Name

public const string Name = "run"

Field Value

string

Properties

AdditionalArgsMax

The maximum number of AdditionalArgs allowed. Checked in Parse(IReadOnlyList<string>).

protected override int AdditionalArgsMax { get; }

Property Value

int

Description

A short description of what this command does.

public override string Description { get; }

Property Value

string

Usage

The additional arguments to be displayed after the command name in the help text.

public override string Usage { get; }

Property Value

string

Methods

Execute()

Executes the commands specified by the command-line arguments. Must call Parse(IReadOnlyList<string>) first!

public override ExitCode Execute()

Returns

ExitCode

The exit status code to end the process with.

Remarks

When inheriting this method is usually replaced.

Exceptions

OperationCanceledException

The user canceled the task.

OptionException

The number of arguments passed in on the command-line is incorrect.

WebException

A file could not be downloaded from the internet.

NotSupportedException

A file format, protocol, etc. is unknown or not supported.

IOException

A downloaded file could not be written to the disk or extracted or an external application or file required by the solver could not be accessed.

UnauthorizedAccessException

An operation failed due to insufficient rights.

InvalidDataException

A problem occurred while deserializing an XML file.

SignatureException

The signature data could not be handled for some reason.

FormatException

An URI, local path, version number, etc. is invalid.

DigestMismatchException

An Implementation's Archives don't match the associated ManifestDigest.

SolverException

The ISolver was unable to provide Selections that fulfill the Requirements.

ImplementationNotFoundException

One of the ImplementationBases is not cached yet.

ExecutorException

The IExecutor was unable to process the Selections.

Solve()

Runs Solve(Requirements) (unless SelectionsDocument is true) and stores the result in Selections.

protected override void Solve()

Exceptions

OperationCanceledException

The user canceled the task.

WebException

A file could not be downloaded from the internet.

IOException

An external application or file required by the solver could not be accessed.

SolverException

The ISolver was unable to provide Selections that fulfill the Requirements.