Package Torello.Java

Class Shell.XL

  • Enclosing class:
    Shell

    public static class Shell.XL
    extends java.lang.Object
    Shell XL - Documentation.

    This class is an upgraded version of class Shell. This version of the UNIX Shell interface allows for the user to provide redirects, environment variables, and output/error unification (meaning the Standard-Output and Error-Output Streams are printed together, as if they were being printed to terminal).

    Though the methods in this class require quite a number of input parameters, the power that they provide unifies Java's ProcessBuilder A.P.I. (in java package java.lang.*;) so that most of the functionality that is provided there is reduced to a single method, with a single return value. As with class Shell, these methods shouldn't be thought of as much more than a wrapper around the already existing Java Operating-System 'Process' and 'Runtime' interfaces. With the extensive documentation provided by this JAR Library, it becomes easier to run usual UNIX System Calls easily, while looking directly at the code needed to run these methods and classes at the same time.

    File Redirects: This class can handle redirected input or output from files located on the file-system. As long as a instance-object of Java class java.io.File can be created, then input or output to any UNIX Operating-System process may be redirected to or from that file using the methods in this class.

    Other Pipes: In the days of yore, a UNIX programmer would often find himself piping the input of one method into the output of another. Here, if the input or output of a method is not going to be an actually, physical, file located on disk (the file-system), then the method's in this class will not be of any help. The reality is that since this method is largely a wrapper around Java's java.lang.ProcessBuilder class, the amount of complexity increases so dramatically trying to 'wrap' a Java A.P.I. that already works fine, that no attempt was made to do so.

    If it is necessary to employ more complex pipes or redirects that don't involve piping input and output from a simple text or data-file, re-read Java's documentation for invoking operating system methods in the package java.lang.*; The classes listed below should be of use:

    • class java.lang.Runtime
    • class java.lang.Process
    • class java.lang.ProcessBuilder
    • class java.lang.ProcessBuilder.Redirect


    Other Commands: Using the COMMAND method provides a simple way for the user to invoke UNIX / Shell commands which are not listed or provided by class Shell.XL (this class). It ought to be of note, that the primary reason for writing this class is to merely provide explanation, and additional example use of Java's A.P.I. for executing Shell Processes from within the Java Virtual Machine. Though quite a bit of effort was spent writing wrappers that read all of the output stream generated when invoking a process, these are for the large part, just wrapper methods that surround the already existing Java java.lang.Runtime and java.lang.Process classes.

    Any number of other UNIX / Shell commands not available through the methods in this class may be invoked using this simple COMMAND method by passing the command name as a parameter.

    Wildcard Issue: On most UNIX platforms, whenever a command is issued to the O/S (by typing it, for example, inside a terminal or terminal-window) there is an execution-stage before the process is spawned where file-name and / or directory-name wildcards (usually: '*' and '?') are expanded. When a UNIX command receives a parameter list, if the file and/or directories specified by the user contain a wild-card, those wild-cards shall have already been eliminated and replaced by the O/S before the actual command receives its parameter list. The arguments that the terminal command "sees" are the actual files and/or directories from which the wild-card expression expanded. A wild-card expression (like a "reg-ex expression") is replaced by the complete list of files before the command ever see that expression (usually!)

    Because of this situation, if a user would like, for instance, to copy or move a group of files (for example) - and use Java to do it, then a native Java A.P.I. such as the package java.nio.* (or the class FileNode A.P.I) is really the only way to ensure that wild-card expressions actually work. It is usually easiest to request an array (or a java.util.Stream) of files using the FileNode.flatten(...) routines, and then pass that to the UNIX command.

    Below is an example that uses this class 'TAR' function to create an archive of all '.java' files in the NodeSearch package of this jar-library's source-file directory. Please note, at the UNIX command terminal, a simple wild-card expression would suffice, but when invoking a shell command from Java, the wild-card expression(s) would not be expanded - that is unless code as seen in the example below is used.

    NOTE: The value of using the Shell.XL version of UNIX TAR command (over the standard Shell.TAR(...)) is that the current working directory in which this script is executed may be changed. This means that the when the script runs, the files that are included in the output .tar will not have all of the annoying parent-directory string's prepended to their file-names in the .tar that's created.

    Example:
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    import Torello.Java.*;
    import Torello.Java.FileNode.RetTypeChoice;
    
    import java.util.stream.*;
    import java.io.IOException;
    import java.io.File;
    import java.lang.ProcessBuilder.Redirect;
    
    public class t
    {
        public static void main(String[] argv) throws IOException
        {
            // This uses the 'FileNode' class to retrieve all '.java' source-files that are
            // found in the 'searchLoops/' sub-directory.
            Stream<String> fileNames = FileNode
                .createRoot("Torello/HTML/NodeSearch/")
                .loadTree()
                .pollDir("searchLoops")
                .flattenJustFiles(RetTypeChoice.FULLPATH_STREAM, -1, (FileNode fn) -> fn.name.endsWith(".java"));
    
            // These are the rest of the parameters for the UNIX 'tar' (file-archive) command
            Stream<String> command = Stream.of("-cvf", "MySourceFiles.tar");
    
            // Concat the Streams, here, for readability
            String[] args = Stream.concat(command, fileNames).toArray(String[]::new);
    
            // Creates a '.tar' of all java source files that were found.
            // NOTE: The value of using the "Shell.XL.TAR" - rather than just the "Shell.TAR" command, is that
            //       the root working directory is set to "Torello/HTML/NodeSearch" - which means that none of
            //       the parent-directories will be prepended to the files in the '.tar' that is generated!
            Shell.XL.TAR(
                new File("Torello/HTML/NodeSearch/"),   // 'tar' will use this as the working directory
                true,                                   // Requests that standard-out and error-out print together
                Redirect.to(new File("t.txt")),         // 'Pipes' all output to file "t.txt"
                null,   // No Input Redirects
                null,   // No Error-Redirects (would be ignored anyway, due to 'true' above)
                null,   // No Environment Variable Updates
                args    // The argument list built above, *including* the '.java' file-names
            );
        }
    }
    

    The above code prints the following output to a file named "dir.txt". Note that for brevity, the text printed to terminal is not included in this sample output text. Below is merely the text left in the output file 'dir.txt' Also, the 'tar' command, itself, will leave a tar-file named 'MySourceFiles.tar' in the NodeSearch directory.

    UNIX or DOS Shell Command:
    $ cat dir.txt searchLoops/TNRemove.java searchLoops/ITFind.java searchLoops/CmtNPoll.java searchLoops/ITGetIncl.java searchLoops/ITFindIncl.java searchLoops/TNFindL1Incl.java searchLoops/TNGetL1Incl.java searchLoops/TNPeekL1Incl.java searchLoops/ITGet.java searchLoops/TxNPeek.java searchLoops/TNPeek.java searchLoops/TxNGet.java searchLoops/TNCount.java searchLoops/TNPoll.java searchLoops/TNGetIncl.java searchLoops/TNFindIncl.java searchLoops/CmtNFind.java searchLoops/TxNFind.java searchLoops/TNFind.java searchLoops/TxNCount.java searchLoops/TNGet.java searchLoops/TNRemoveIncl.java searchLoops/ITPeek.java searchLoops/ITCount.java searchLoops/TNPeekIncl.java searchLoops/ITPeekIncl.java searchLoops/TxNPoll.java searchLoops/ITPollIncl.java searchLoops/TNPollIncl.java searchLoops/ITRemoveIncl.java searchLoops/TxNRemove.java searchLoops/CmtNRemove.java searchLoops/CmtNGet.java searchLoops/CmtNCount.java searchLoops/ITPoll.java searchLoops/CmtNPeek.java searchLoops/ITRemove.java


    WORA Pledge: Although Java has always tried to maintain a "Write Once, Run Anywhere" (WORA) motto, there are cases where Java Byte-Codes are very Operating System dependent. Hopefully by the now, the reader understands that the methods in this class are in no way "Java-ized" versions of the listed UNIX System commands. The methods here are just wrappers that allow a programmer to make Operating System calls more easily - and retrieve their output. (And in fact, these wrappers are themselves just wrappers around the standard JDK java.lang.Process and java.lang.ProcessBuilder) classes.

    The bulk-work of the classes in this JAR Library were written and tested in a UNIX environment, but almost all of them are perfectly O/S independent, and running an HTML Parser in an MS DOS or an Apple environment should not present any problems. However, since this class is just a set of hooks into native Operating system calls, any invocation of these methods on a non-UNIX computer, or even a UNIX computer that does not have the indicated functions installed will just throw exceptions.

    Static (Functional) API: The methods in this class are all (100%) defined with the Java Key-Word / Key-Concept 'static'. Furthermore, there is no way to obtain an instance of this class, because there are no public (nor private) constructors. Java's Spring-Boot, MVC feature is *not* utilized because it flies directly in the face of the light-weight data-classes philosophy. This has many advantages over the rather ornate Component Annotations (@Component, @Service, @AutoWired, etc... 'Java Beans') syntax:

    • The methods here use the key-word 'static' which means (by implication) that there is no internal-state. Without any 'internal state' there is no need for constructors in the first place! (This is often the complaint by MVC Programmers).
    • A 'Static' (Functional-Programming) API expects to use fewer data-classes, and light-weight data-classes, making it easier to understand and to program.
    • The Vectorized HTML data-model allows more user-control over HTML parse, search, update & scrape. Also, memory management, memory leakage, and the Java Garbage Collector ought to be intelligible through the 'reuse' of the standard JDK class Vector for storing HTML Web-Page data.

    The power that object-oriented programming extends to a user is (mostly) limited to data-representation. Thinking of "Services" as "Objects" (Spring-MVC, 'Java Beans') is somewhat 'over-applying' the Object Oriented Programming Model. Like most classes in the Java-HTML JAR Library, this class backtracks to a more C-Styled Functional Programming Model (no Objects) - by re-using (quite profusely) the key-word static with all of its methods, and by sticking to Java's well-understood class Vector

    Internal-State: A user may click on this class' source code (see link below) to view any and all internally defined fields class. A cursory inspection of the code would prove that this class has precisely zero internally defined global fields (Spaghetti). All variables used by the methods in this class are local fields only, and therefore this class ought to be though of as 'state-less'.
    See Also:
    Shell, OSResponse, OSResponse.stdOut, OSResponse.stdErr, OSResponse.response, FileNode



    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method
      static OSResponse CHMOD​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse CHOWN​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse CMP​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse COMMAND​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String COMMAND_NAME, String... args)
      static OSResponse CP​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String[] src, String target)
      static OSResponse CP​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String src, String target)
      static OSResponse CP​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, Vector<String> src, String target)
      static OSResponse DATE​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse DF​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse DIFF​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse DU​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse FIND​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse FREE​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse FSCK​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse GREP​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse GZIP​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse JAR​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse JAVA​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse JAVAC​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse JAVADOC​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse LS​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String fileOrDir)
      static OSResponse LS​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String fileOrDir, String switches)
      static OSResponse MV​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String[] src, String target)
      static OSResponse MV​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String src, String target)
      static OSResponse MV​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, Vector<String> src, String target)
      static OSResponse NSLOOKUP​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse PING​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse PS​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse RM​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String s1)
      static OSResponse RM​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String[] sArr)
      static OSResponse RM​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String s1, String switches)
      static OSResponse RM​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, Vector<String> v)
      static OSResponse SED​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse SORT​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse TAR​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse TIME​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse TRACEROUTE​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse UNZIP​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse VMSTAT​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse WHATIS​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      static OSResponse WHEREIS​(java.io.File currentWorkingDirectory, boolean mergeStdErrorAndStdOut, ProcessBuilder.Redirect outputRedirect, ProcessBuilder.Redirect inputRedirect, ProcessBuilder.Redirect errorRedirect, Consumer<Map<String,​String>> environmentVariableUpdater, String... args)
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • CP

        public static OSResponse CP​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String src,
                     java.lang.String target)
                throws java.io.IOException
        
        UNIX Shell Command: Copy

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | cp <src> <target> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        src - UNIX/Linux/BASH-Shell 'cp' command's "source" argument
        target - The 'cp' command "target" argument
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.CP(String, String), OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String[], Appendable)
        Code:
        Exact Method Body:
        1
        2
        3
        4
        5
         return OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, new String[] { "cp", src, target },
             appendable
         );
        
      • CP

        public static OSResponse CP​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.util.Vector<java.lang.String> src,
                     java.lang.String target)
                throws java.io.IOException
        
        UNIX Shell Command: Copy

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | cp <src.elementAt(0)> <src.elementAt(1)> ... <src.elementAt(src.size()-1)> <target> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        src - This may be a list of files to be copied to a target directory
        target - This is the target directory for the files listed.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.CP(Vector, String), OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String[], Appendable)
        Code:
        Exact Method Body:
        1
        2
        3
        4
        5
        6
        7
        8
        9
         String[] command = new String[src.size() + 2];
         command[0] = "cp";
         command[src.size() + 1] = target;
         for (int i=0; i < src.size(); i++) command[1 + i] = src.elementAt(i);
        
         return OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, command, appendable
         );
        
      • CP

        public static OSResponse CP​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String[] src,
                     java.lang.String target)
                throws java.io.IOException
        
        UNIX Shell Command: Copy

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | cp <src[0]> <src[1]> ... <src[src.length-1]> <target> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        src - This may be a list of files to be copied to a target directory
        target - This is the target directory for the files listed.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.CP(String[], String), OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String[], Appendable)
        Code:
        Exact Method Body:
        1
        2
        3
        4
        5
        6
        7
        8
        9
         String[] command = new String[src.length + 2];
         command[0] = "cp";
         command[src.length + 1] = target;
         for (int i=0; i < src.length; i++) command[1 + i] = src[i];
        
         return OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, command, appendable
         );
        
      • LS

        public static OSResponse LS​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String fileOrDir)
                throws java.io.IOException
        
        UNIX Shell Command: List

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | ls <fileOrDir> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        fileOrDir - This is the file OR directory to be searched.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.LS(String), OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String[], Appendable)
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, new String[] { "ls", fileOrDir }, appendable
         );
        
      • LS

        public static OSResponse LS​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String fileOrDir,
                     java.lang.String switches)
                throws java.io.IOException
        
        UNIX Shell Command: List

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | ls <switches> <fileOrDir> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        fileOrDir - This is the file OR directory to be searched.
        switches - These are switches that are added to the command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.CP(String, String), OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String[], Appendable)
        Code:
        Exact Method Body:
        1
        2
        3
        4
        5
         return OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, new String[] { "ls", switches, fileOrDir },
             appendable
         );
        
      • MV

        public static OSResponse MV​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String src,
                     java.lang.String target)
                throws java.io.IOException
        
        UNIX Shell Command: Move

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | mv <src> <target> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        src - The first String in a typical UNIX 'move' command. It is the "source file"
        target - The second String for a "move." This is the destination or target.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.MV(String, String), OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String[], Appendable)
        Code:
        Exact Method Body:
        1
        2
        3
        4
        5
         return OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, new String[] { "mv", src, target },
             appendable
         );
        
      • MV

        public static OSResponse MV​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.util.Vector<java.lang.String> src,
                     java.lang.String target)
                throws java.io.IOException
        
        UNIX Shell Command: Move

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | mv <src.elementAt(0)> <src.elementAt(1)> ... <src.elementAt(src.size()-1)> <target> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        src - The first String in a typical UNIX 'move' command. It is the "source file" - In this method, it is a list of files and expressions saved as a Vector.
        target - The second String for a 'move' UNIX command, and it is the target destination of the source-file.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.MV(Vector, String), OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String[], Appendable)
        Code:
        Exact Method Body:
        1
        2
        3
        4
        5
        6
        7
        8
        9
         String[] command = new String[src.size() + 2];
         command[0] = "mv";
         command[src.size() + 1] = target;
         for (int i=0; i < src.size(); i++) command[1 + i] = src.elementAt(i);
        
         return OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, command, appendable
         );
        
      • MV

        public static OSResponse MV​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String[] src,
                     java.lang.String target)
                throws java.io.IOException
        
        UNIX Shell Command: Move

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | mv <src[0]> <src[1]> ... <src[src.length-1]> <target> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        src - The first String in a typical UNIX 'move' command. It is the "source file" - In this method, it is a list of files and expressions saved as an array.
        target - The second String for a UNIX 'move' command, and it is the target destination
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.MV(String[], String), OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String[], Appendable)
        Code:
        Exact Method Body:
        1
        2
        3
        4
        5
        6
        7
        8
        9
         String[] command = new String[src.length + 2];
         command[0] = "mv";
         command[src.length + 1] = target;
         for (int i=0; i < src.length; i++) command[1 + i] = src[i];
        
         return OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, command, appendable
         );
        
      • RM

        public static OSResponse RM​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String s1)
                throws java.io.IOException
        
        UNIX Shell Command: Remove

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | rm <s1> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        s1 - The item to be removed, using a UNIX operating-system command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.RM(String), OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String[], Appendable)
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, new String[] { "rm", s1 }, appendable
         );
        
      • RM

        public static OSResponse RM​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String[] sArr)
                throws java.io.IOException
        
        UNIX Shell Command: Remove

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | rm <sArr[0]> <sArr[1]> ... <sArr[sArr.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        sArr - An String[] array which is added to the end of this UNIX command. These will be the item(s) removed by the UNIX 'RM' command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.RM(String[]), OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String[], Appendable)
        Code:
        Exact Method Body:
        1
        2
        3
        4
        5
        6
        7
        8
         String[] command = new String[sArr.length + 1];
         command[0] = "rm";
         for (int i=0; i < sArr.length; i++) command[i + 1] = sArr[i];
        
         return OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, command, appendable
         );
        
      • RM

        public static OSResponse RM​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.util.Vector<java.lang.String> v)
                throws java.io.IOException
        
        UNIX Shell Command: Remove

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | rm <src.elementAt(0)> <src.elementAt(1)> ... <src.elementAt(src.size()-1)> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        v - A Vector<String> that contains command-line-parameters which are added, sequentially, to the end of this UNIX command. The String's in this Vector are the item(s) to be removed by the UNIX 'RM' command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.RM(Vector), OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String[], Appendable)
        Code:
        Exact Method Body:
        1
        2
        3
        4
        5
        6
        7
        8
         String[] command = new String[v.size() + 1];
         command[0] = "rm";
         for (int i=0; i < v.size(); i++) command[i + 1] = v.elementAt(i);
        
         return OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, command, appendable
         );
        
      • RM

        public static OSResponse RM​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String s1,
                     java.lang.String switches)
                throws java.io.IOException
        
        UNIX Shell Command: Remove

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | rm <switches> <s1> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        s1 - A file or directory parameter passed to 'RM'
        switches - These are switches (for-instance: -R, recursive).
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.RM(String, String), OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String[], Appendable)
        Code:
        Exact Method Body:
        1
        2
        3
        4
        5
         return OSResponse.PRINT_CMD_RUN_CMD_PRINT_OUTPUT(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, new String[] { "rm", switches, s1 },
             appendable
         );
        
      • TAR

        public static OSResponse TAR​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: tar

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | tar <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.TAR(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "tar", args
         );
        
      • JAR

        public static OSResponse JAR​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: jar

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | jar <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.JAR(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "jar", args
         );
        
      • GREP

        public static OSResponse GREP​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: grep

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | grep <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.GREP(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "grep", args
         );
        
      • FIND

        public static OSResponse FIND​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: find

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | find <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.FIND(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "find", args
         );
        
      • DU

        public static OSResponse DU​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: du

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | du <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.DU(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "du", args
         );
        
      • DF

        public static OSResponse DF​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: df

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | df <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.DF(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "df", args
         );
        
      • SED

        public static OSResponse SED​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: sed

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | sed <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.SED(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "sed", args
         );
        
      • WHATIS

        public static OSResponse WHATIS​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: whatis

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | whatis <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.WHATIS(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "whatis", args
         );
        
      • WHEREIS

        public static OSResponse WHEREIS​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: whereis

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | whereis <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.WHEREIS(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "whereis", args
         );
        
      • VMSTAT

        public static OSResponse VMSTAT​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: vmstat

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | vmstat <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.VMSTAT(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "vmstat", args
         );
        
      • PS

        public static OSResponse PS​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: ps

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | ps <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.PS(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "ps", args
         );
        
      • DIFF

        public static OSResponse DIFF​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: diff

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | diff <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.DIFF(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "diff", args
         );
        
      • CMP

        public static OSResponse CMP​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: cmp

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | cmp <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.CMP(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "CMP", args
         );
        
      • FREE

        public static OSResponse FREE​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: free

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | free <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.FREE(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "free", args
         );
        
      • CHOWN

        public static OSResponse CHOWN​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: chown

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | chown <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.CHOWN(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "chown", args
         );
        
      • CHMOD

        public static OSResponse CHMOD​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: chmod

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | chmod <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.CHMOD(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "chmod", args
         );
        
      • UNZIP

        public static OSResponse UNZIP​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: unzip

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | unzip <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.UNZIP(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "unzip", args
         );
        
      • GZIP

        public static OSResponse GZIP​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: gzip

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | gzip <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.GZIP(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "gzip", args
         );
        
      • SORT

        public static OSResponse SORT​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: sort

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | sort <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.SORT(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "sort", args
         );
        
      • JAVAC

        public static OSResponse JAVAC​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: javac

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | javac <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.JAVAC(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "javac", args
         );
        
      • JAVADOC

        public static OSResponse JAVADOC​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: javadoc

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | javadoc <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.JAVADOC(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "javadoc", args
         );
        
      • JAVA

        public static OSResponse JAVA​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: java

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | java <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.JAVA(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "java", args
         );
        
      • TIME

        public static OSResponse TIME​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: time

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | time <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.TIME(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "time", args
         );
        
      • DATE

        public static OSResponse DATE​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: date

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | date <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.DATE(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "date", args
         );
        
      • PING

        public static OSResponse PING​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: ping

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | ping <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.PING(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "ping", args
         );
        
      • FSCK

        public static OSResponse FSCK​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: fsck

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | fsck <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.FSCK(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "fsck", args
         );
        
      • NSLOOKUP

        public static OSResponse NSLOOKUP​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: nslookup

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | nslookup <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.NSLOOKUP(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "nslookup", args
         );
        
      • TRACEROUTE

        public static OSResponse TRACEROUTE​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command: traceroute

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | traceroute <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.TRACEROUTE(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, "traceroute", args
         );
        
      • COMMAND

        public static OSResponse COMMAND​
                    (java.io.File currentWorkingDirectory,
                     boolean mergeStdErrorAndStdOut,
                     java.lang.ProcessBuilder.Redirect outputRedirect,
                     java.lang.ProcessBuilder.Redirect inputRedirect,
                     java.lang.ProcessBuilder.Redirect errorRedirect,
                     java.util.function.Consumer<java.util.Map<java.lang.String,​java.lang.String>> environmentVariableUpdater,
                     java.lang.String COMMAND_NAME,
                     java.lang.String... args)
                throws java.io.IOException
        
        Runs the UNIX / BASH / LINUX 'shell' command named by the input parameter COMMAND_NAME.

        UNIX or DOS Shell Command:
        $ set <environmentVariables> $ cd <currentWorkingDirectory> $ <input-redirect> | <COMMAND_NAME> <args[0]> <args[1]> ... <args[args.length-1]> | <output-redirect>
        Parameters:
        currentWorkingDirectory - This UNIX Shell command will be run with 'currentWorkingDirectory' set as the directory from whence this command is initiated. null may be passed to this parameter. If it is, it will be ignored, and the process will be run in the whatever directory the O/S has asserted is the current working directory.
        mergeStdErrorAndStdOut - If this boolean is TRUE, both Standard Output and Error Output will be merged into a single stream of text. This can be helpful since error messages are usually printed adjacent-to or immediately-after relevant text from the standard output stream.

        NOTE: The value of this boolean supersedes any redirect reference passed to parameter outputRedirect. When TRUE is passed here, the error stream will be empty, and the error redirect file or pipe will also remain empty. (And vice-versa, when FALSE, Standard Output and Error Output are printed to independent output streams, and both heed the redirect parameters).
        outputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' STANDARD OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        inputRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect file-system files as INPUT to this Process. This parameter may receive 'null'.
        errorRedirect - Read the Java-Doc information for Java class java.lang.ProcessBuilder.Redirect to learn how to redirect this Process' ERROR OUTPUT to a file on the file-system. null may be passed to this parameter. If it is, it will be ignored.
        environmentVariableUpdater - This java.util.function.Consumer shall recieve a java.util.Map<String, String> containing all relevant environment variables, and their values. It may be modified to suit the purposes of this UNIX command. Any implementing class, or a lambda expression, is acceptable here. null may be passed to this parameter. If it is, it will be ignored - and no environment-variable modifications shall occur.
        COMMAND_NAME - This is the name of any UNIX command not already listed inside this class.
        args - Any set of switches and/or arguments to this BASH command.
        Returns:
        Returns an instance of OSResponse. This response-Object (data-record) class holds three public, final fields:
        Process response-code
        Text sent to Standard-Output (as a java.lang.String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.
        Text sent to Error-Output (also as a String) - unless an output-redirect was specified, and if so, the stdOut field would be the zero-length String.

        This OSResponse instance may be discarded without any effect on Process Execution. It is only provided as a convenience in case more information is required about the results of the O/S command invocation.

        Process Status: Upon completion of this method, the Operating-System java.lang.Process is guaranteed to have run to completion.
        Throws:
        java.io.IOException
        See Also:
        Shell.JAVA(String[]), ARGS_PLUS_ONE(File, boolean, ProcessBuilder.Redirect, ProcessBuilder.Redirect, ProcessBuilder.Redirect, Consumer, String, String[])
        Code:
        Exact Method Body:
        1
        2
        3
        4
         return ARGS_PLUS_ONE(
             currentWorkingDirectory, mergeStdErrorAndStdOut, outputRedirect, inputRedirect,
             errorRedirect, environmentVariableUpdater, COMMAND_NAME, args
         );