Lines Matching defs:to
8 * particular file as subject to the "Classpath" exception as provided
18 * 2 along with this work; if not, write to the Free Software Foundation,
39 * This class is used to create operating system processes.
45 * to create new subprocesses with identical or related attributes.
52 * external program file to be invoked and its arguments, if any.
55 * argument to be an element in this list, but there are operating
56 * systems where programs are expected to tokenize command line
58 * require commands to contain exactly two elements.
61 * <i>variables</i> to <i>values</i>. The initial value is a copy of
72 * be redirected to another source using
85 * output and standard error to pipes. Java code can access these pipes
88 * standard error may be redirected to other destinations using
105 * output of a subprocess are sent to two separate streams, which can
109 * <p>If the value is set to {@code true}, then:
113 * to the same destination (this makes it easier to correlate error
133 * It is possible to modify the state of an object so that {@link
134 * #start()} will fail. For example, setting the command attribute to
152 * to be appended to a log file:
191 * updates to the list will be reflected in the state of the
193 * {@code command} corresponds to a valid operating system
208 * constructor that sets the process builder's command to a string
211 * {@code command} corresponds to a valid operating system
225 * {@code command} list. Subsequent updates to the list will
227 * checked whether {@code command} corresponds to a valid
245 * to a string list containing the same strings as the
247 * checked whether {@code command} corresponds to a valid
263 * updates to the list will be reflected in the state of this
276 * initialized to a copy of the current process environment (see
283 * visible to subprocesses started via the {@link #start()}
285 * contain independent process environments, so changes to the
294 * Attempting to insert or query the presence of a null key or
296 * Attempting to query the presence of a key or value which is not
300 * system may not allow modifications to environment variables or
302 * attempts to modify the map may fail with
308 * values is system-dependent, there may not be a one-to-one
326 * <p>When passing information to a Java subprocess,
335 * method doesn't allow access to the process environment
362 // to the child process.
363 // We would like to throw an exception, but do not,
386 * The returned value may be {@code null} -- this means to use
402 * The argument may be {@code null} -- this means to use the
447 * <li>a redirection to read from a file, created by an invocation of
449 * <li>a redirection to write to a file, created by an invocation of
450 * {@link Redirect#to Redirect.to(File)}
451 * <li>a redirection to append to a file, created by an invocation of
483 * {@link Redirect#to Redirect.to(File)}.
501 * Indicates that subprocess I/O will be connected to the
541 * When redirected to a destination file, indicates if the output
542 * is to be written to the end of the file.
549 * Returns a redirect to read from the specified file.
558 * @return a redirect to read from the specified file
567 return "redirect to read from file \"" + file + "\"";
573 * Returns a redirect to write to the specified file.
579 * Redirect.to(file).file() == file &&
580 * Redirect.to(file).type() == Redirect.Type.WRITE
584 * @return a redirect to write to the specified file
586 public static Redirect to(final File file) {
593 return "redirect to write to file \"" + file + "\"";
600 * Returns a redirect to append to the specified file.
601 * Each write operation first advances the position to the
614 * @return a redirect to append to the specified file
623 return "redirect to append to file \"" + file + "\"";
683 * subprocess can be written to using the output stream
685 * If the source is set to any other value, then
692 * if the redirect does not correspond to a valid source
711 * method send their standard output to this destination.
717 * If the destination is set to any other value, then
724 * if the redirect does not correspond to a valid
741 * method send their standard error to this destination.
747 * If the destination is set to any other value, then
758 * if the redirect does not correspond to a valid
772 * Sets this process builder's standard input source to a file.
789 * Sets this process builder's standard output destination to a file.
795 * {@code (Redirect.to(file))}.
802 return redirectOutput(Redirect.to(file));
806 * Sets this process builder's standard error destination to a file.
812 * {@code (Redirect.to(file))}.
819 return redirectError(Redirect.to(file));
840 * method redirect their standard output to this destination.
854 * method redirect their standard error to this destination.
866 * to be the same as those of the current Java process.
879 * This gives behavior equivalent to most operating system
900 * to correlate error messages with the corresponding output.
917 * to correlate error messages with the corresponding output.
942 * be required to start a process on some operating systems.
956 * <li>Access to the program file was denied.
964 * <p>Subsequent modifications to this process builder will not
983 * <li>the standard input to the subprocess was
987 * denies read access to the file, or
991 * {@linkplain #redirectOutput redirected to a file}
994 * denies write access to the file
1003 // Must convert to array first -- a malicious user-supplied
1004 // list might try to circumvent the security check.
1039 // It's much easier for us to create a high-quality error