1    /*
     2     * Copyright (c) 2006-2012, Texas Instruments Incorporated
     3     * All rights reserved.
     4     *
     5     * Redistribution and use in source and binary forms, with or without
     6     * modification, are permitted provided that the following conditions
     7     * are met:
     8     *
     9     * *  Redistributions of source code must retain the above copyright
    10     *    notice, this list of conditions and the following disclaimer.
    11     *
    12     * *  Redistributions in binary form must reproduce the above copyright
    13     *    notice, this list of conditions and the following disclaimer in the
    14     *    documentation and/or other materials provided with the distribution.
    15     *
    16     * *  Neither the name of Texas Instruments Incorporated nor the names of
    17     *    its contributors may be used to endorse or promote products derived
    18     *    from this software without specific prior written permission.
    19     *
    20     * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
    21     * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
    22     * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
    23     * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
    24     * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
    25     * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
    26     * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
    27     * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
    28     * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
    29     * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
    30     * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    31     *
    32     */
    33    metaonly module System {
    34    
    35        // this is what the command below returns
    36        struct RunResult {
    37            int    status;
    38            string stdout;
    39            string stderr;
    40            string stdsys;
    41        };
    42    
    43        // commandStr is any sh-style shell command
    44        //     possibly a series of commands chained with pipes
    45        // cbPrint is a callback function that collects the execution log
    46        // detailLevel can be 0..3, determins what part of stdout gets printed
    47        //     through cbPrint; 2 prints all stdout, 3 prints environment as well
    48        RunResult runShellCommand( String commandStr, any cbPrint, int detailLevel );
    49    
    50        // name of any executable that's about to be invoked should be run through
    51        // this function first; it will correct the slashes, and in the case of
    52        // common tools like "grep" decide if they come from a utility dir (Win)
    53        // or from the system (Linux)
    54        string getCommandPath( string command );
    55        string checkPath( string path );
    56    }