dgrove@google.com
4c0f559d23
git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@15 260f80e4-7a28-3924-810f-c04153c831b5
67 lines
1.7 KiB
Dart
67 lines
1.7 KiB
Dart
// Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file
|
|
// for details. All rights reserved. Use of this source code is governed by a
|
|
// BSD-style license that can be found in the LICENSE file.
|
|
|
|
interface Process factory _Process {
|
|
/*
|
|
* Creates a new process object preparing to run the executable
|
|
* found at [path] with the specified [arguments]. [arguments] has
|
|
* to be a const string array, c.f. bug 5314640.
|
|
*/
|
|
Process(String path, List<String> arguments);
|
|
|
|
/*
|
|
* Start the process by running the specified executable. An
|
|
* exception of type [ProcessException] is thrown if the process
|
|
* cannot be started. There is a remote possibility of an exception
|
|
* being thrown even though the child process did actually start.
|
|
*/
|
|
void start();
|
|
|
|
/*
|
|
* Returns an input stream of the process stdout.
|
|
*/
|
|
InputStream get stdoutStream();
|
|
|
|
/*
|
|
* Returns an input stream of the process stderr.
|
|
*/
|
|
InputStream get stderrStream();
|
|
|
|
/*
|
|
* Returns an output stream to the process stdin.
|
|
*/
|
|
OutputStream get stdinStream();
|
|
|
|
/*
|
|
* Sets an exit handler which gets invoked when the process terminates.
|
|
*/
|
|
void setExitHandler(void callback(int exitCode));
|
|
|
|
/*
|
|
* Kills the process with [signal].
|
|
*/
|
|
bool kill();
|
|
|
|
/*
|
|
* Terminates the streams and closes the exit handler of a process.
|
|
*/
|
|
void close();
|
|
}
|
|
|
|
|
|
class ProcessException implements Exception {
|
|
const ProcessException([String this.message, int this.errorCode = 0]);
|
|
String toString() => "ProcessException: $message";
|
|
|
|
/*
|
|
* Contains the system message for the process exception if any.
|
|
*/
|
|
final String message;
|
|
|
|
/*
|
|
* Contains the OS error code for the process exception if any.
|
|
*/
|
|
final int errorCode;
|
|
}
|