diff options
Diffstat (limited to 'share/cmake-3.2/Help/command/execute_process.rst')
-rwxr-xr-x | share/cmake-3.2/Help/command/execute_process.rst | 75 |
1 files changed, 0 insertions, 75 deletions
diff --git a/share/cmake-3.2/Help/command/execute_process.rst b/share/cmake-3.2/Help/command/execute_process.rst deleted file mode 100755 index 478b30e..0000000 --- a/share/cmake-3.2/Help/command/execute_process.rst +++ /dev/null @@ -1,75 +0,0 @@ -execute_process ---------------- - -Execute one or more child processes. - -.. code-block:: cmake - - execute_process(COMMAND <cmd1> [args1...]] - [COMMAND <cmd2> [args2...] [...]] - [WORKING_DIRECTORY <directory>] - [TIMEOUT <seconds>] - [RESULT_VARIABLE <variable>] - [OUTPUT_VARIABLE <variable>] - [ERROR_VARIABLE <variable>] - [INPUT_FILE <file>] - [OUTPUT_FILE <file>] - [ERROR_FILE <file>] - [OUTPUT_QUIET] - [ERROR_QUIET] - [OUTPUT_STRIP_TRAILING_WHITESPACE] - [ERROR_STRIP_TRAILING_WHITESPACE]) - -Runs the given sequence of one or more commands with the standard -output of each process piped to the standard input of the next. -A single standard error pipe is used for all processes. - -Options: - -COMMAND - A child process command line. - - CMake executes the child process using operating system APIs directly. - All arguments are passed VERBATIM to the child process. - No intermediate shell is used, so shell operators such as ``>`` - are treated as normal arguments. - (Use the ``INPUT_*``, ``OUTPUT_*``, and ``ERROR_*`` options to - redirect stdin, stdout, and stderr.) - -WORKING_DIRECTORY - The named directory will be set as the current working directory of - the child processes. - -TIMEOUT - The child processes will be terminated if they do not finish in the - specified number of seconds (fractions are allowed). - -RESULT_VARIABLE - The variable will be set to contain the result of running the processes. - This will be an integer return code from the last child or a string - describing an error condition. - -OUTPUT_VARIABLE, ERROR_VARIABLE - The variable named will be set with the contents of the standard output - and standard error pipes, respectively. If the same variable is named - for both pipes their output will be merged in the order produced. - -INPUT_FILE, OUTPUT_FILE, ERROR_FILE - The file named will be attached to the standard input of the first - process, standard output of the last process, or standard error of - all processes, respectively. - -OUTPUT_QUIET, ERROR_QUIET - The standard output or standard error results will be quietly ignored. - -If more than one ``OUTPUT_*`` or ``ERROR_*`` option is given for the -same pipe the precedence is not specified. -If no ``OUTPUT_*`` or ``ERROR_*`` options are given the output will -be shared with the corresponding pipes of the CMake process itself. - -The :command:`execute_process` command is a newer more powerful version of -:command:`exec_program`, but the old command has been kept for compatibility. -Both commands run while CMake is processing the project prior to build -system generation. Use :command:`add_custom_target` and -:command:`add_custom_command` to create custom commands that run at -build time. |