7d8b5a10c8
Explain how it's different than ProcessBuilder Explain that you have to call close when you're done with the pty's file descriptor. Note in the doc comment that the implementation relies on a private FileDescriptor API. Also remove an unused method. Automated import of CL 144152
76 lines
2.4 KiB
Java
76 lines
2.4 KiB
Java
/*
|
|
* Copyright (C) 2007 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package com.android.term;
|
|
|
|
import java.io.FileDescriptor;
|
|
|
|
/**
|
|
* Utility methods for creating and managing a subprocess.
|
|
* <p>
|
|
* Note: The native methods access a package-private
|
|
* java.io.FileDescriptor field to get and set the raw Linux
|
|
* file descriptor. This might break if the implementation of
|
|
* java.io.FileDescriptor is changed.
|
|
*/
|
|
|
|
public class Exec
|
|
{
|
|
static {
|
|
System.loadLibrary("term");
|
|
}
|
|
|
|
/**
|
|
* Create a subprocess. Differs from java.lang.ProcessBuilder in
|
|
* that a pty is used to communicate with the subprocess.
|
|
* <p>
|
|
* Callers are responsible for calling Exec.close() on the returned
|
|
* file descriptor.
|
|
*
|
|
* @param cmd The command to execute
|
|
* @param arg0 The first argument to the command, may be null
|
|
* @param arg1 the second argument to the command, may be null
|
|
* @param processId A one-element array to which the process ID of the
|
|
* started process will be written.
|
|
* @return the file descriptor of the started process.
|
|
*
|
|
*/
|
|
public static native FileDescriptor createSubprocess(
|
|
String cmd, String arg0, String arg1, int[] processId);
|
|
|
|
/**
|
|
* Set the widow size for a given pty. Allows programs
|
|
* connected to the pty learn how large their screen is.
|
|
*/
|
|
public static native void setPtyWindowSize(FileDescriptor fd,
|
|
int row, int col, int xpixel, int ypixel);
|
|
|
|
/**
|
|
* Causes the calling thread to wait for the process associated with the
|
|
* receiver to finish executing.
|
|
*
|
|
* @return The exit value of the Process being waited on
|
|
*
|
|
*/
|
|
public static native int waitFor(int processId);
|
|
|
|
/**
|
|
* Close a given file descriptor.
|
|
*/
|
|
public static native void close(FileDescriptor fd);
|
|
}
|
|
|