<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<!-- Generated by HsColour, http://www.cs.york.ac.uk/fp/darcs/hscolour/ -->
<title>src/System/Cmd/Utils.hs</title>
<link type='text/css' rel='stylesheet' href='hscolour.css' />
</head>
<body>
<pre><a name="line-1"></a><span class='hs-comment'>-- arch-tag: Command utilities main file</span>
<a name="line-2"></a><span class='hs-comment'>{-# LANGUAGE CPP #-}</span>
<a name="line-3"></a><span class='hs-comment'>{-
<a name="line-4"></a>Copyright (C) 2004-2006 John Goerzen <jgoerzen@complete.org>
<a name="line-5"></a>
<a name="line-6"></a>This program is free software; you can redistribute it and/or modify
<a name="line-7"></a>it under the terms of the GNU General Public License as published by
<a name="line-8"></a>the Free Software Foundation; either version 2 of the License, or
<a name="line-9"></a>(at your option) any later version.
<a name="line-10"></a>
<a name="line-11"></a>This program is distributed in the hope that it will be useful,
<a name="line-12"></a>but WITHOUT ANY WARRANTY; without even the implied warranty of
<a name="line-13"></a>MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
<a name="line-14"></a>GNU General Public License for more details.
<a name="line-15"></a>
<a name="line-16"></a>You should have received a copy of the GNU General Public License
<a name="line-17"></a>along with this program; if not, write to the Free Software
<a name="line-18"></a>Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
<a name="line-19"></a>-}</span>
<a name="line-20"></a>
<a name="line-21"></a><span class='hs-comment'>{- |
<a name="line-22"></a> Module : System.Cmd.Utils
<a name="line-23"></a> Copyright : Copyright (C) 2004-2006 John Goerzen
<a name="line-24"></a> License : GNU GPL, version 2 or above
<a name="line-25"></a>
<a name="line-26"></a> Maintainer : John Goerzen <jgoerzen@complete.org>
<a name="line-27"></a> Stability : provisional
<a name="line-28"></a> Portability: portable to platforms with POSIX process\/signal tools
<a name="line-29"></a>
<a name="line-30"></a>Command invocation utilities.
<a name="line-31"></a>
<a name="line-32"></a>Written by John Goerzen, jgoerzen\@complete.org
<a name="line-33"></a>
<a name="line-34"></a>Please note: Most of this module is not compatible with Hugs.
<a name="line-35"></a>
<a name="line-36"></a>Command lines executed will be logged using "System.Log.Logger" at the
<a name="line-37"></a>DEBUG level. Failure messages will be logged at the WARNING level in addition
<a name="line-38"></a>to being raised as an exception. Both are logged under
<a name="line-39"></a>\"System.Cmd.Utils.funcname\" -- for instance,
<a name="line-40"></a>\"System.Cmd.Utils.safeSystem\". If you wish to suppress these messages
<a name="line-41"></a>globally, you can simply run:
<a name="line-42"></a>
<a name="line-43"></a>> updateGlobalLogger "System.Cmd.Utils.safeSystem"
<a name="line-44"></a>> (setLevel CRITICAL)
<a name="line-45"></a>
<a name="line-46"></a>See also: 'System.Log.Logger.updateGlobalLogger',
<a name="line-47"></a>"System.Log.Logger".
<a name="line-48"></a>
<a name="line-49"></a>It is possible to set up pipelines with these utilities. Example:
<a name="line-50"></a>
<a name="line-51"></a>> (pid1, x1) <- pipeFrom "ls" ["/etc"]
<a name="line-52"></a>> (pid2, x2) <- pipeBoth "grep" ["x"] x1
<a name="line-53"></a>> putStr x2
<a name="line-54"></a>> ... the grep output is displayed ...
<a name="line-55"></a>> forceSuccess pid2
<a name="line-56"></a>> forceSuccess pid1
<a name="line-57"></a>
<a name="line-58"></a>Remember, when you use the functions that return a String, you must not call
<a name="line-59"></a>'forceSuccess' until after all data from the String has been consumed. Failure
<a name="line-60"></a>to wait will cause your program to appear to hang.
<a name="line-61"></a>
<a name="line-62"></a>Here is an example of the wrong way to do it:
<a name="line-63"></a>
<a name="line-64"></a>> (pid, x) <- pipeFrom "ls" ["/etc"]
<a name="line-65"></a>> forceSuccess pid -- Hangs; the called program hasn't terminated yet
<a name="line-66"></a>> processTheData x
<a name="line-67"></a>
<a name="line-68"></a>You must instead process the data before calling 'forceSuccess'.
<a name="line-69"></a>
<a name="line-70"></a>When using the hPipe family of functions, this is probably more obvious.
<a name="line-71"></a>
<a name="line-72"></a>Most of this module will be incompatible with Windows.
<a name="line-73"></a>-}</span>
<a name="line-74"></a>
<a name="line-75"></a>
<a name="line-76"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Cmd</span><span class='hs-varop'>.</span><span class='hs-conid'>Utils</span><span class='hs-layout'>(</span><span class='hs-comment'>-- * High-Level Tools</span>
<a name="line-77"></a> <span class='hs-conid'>PipeHandle</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span>
<a name="line-78"></a> <span class='hs-varid'>safeSystem</span><span class='hs-layout'>,</span>
<a name="line-79"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-80"></a> <span class='hs-varid'>forceSuccess</span><span class='hs-layout'>,</span>
<a name="line-81"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-82"></a> <span class='hs-varid'>posixRawSystem</span><span class='hs-layout'>,</span>
<a name="line-83"></a> <span class='hs-varid'>forkRawSystem</span><span class='hs-layout'>,</span>
<a name="line-84"></a> <span class='hs-comment'>-- ** Piping with lazy strings</span>
<a name="line-85"></a> <span class='hs-varid'>pipeFrom</span><span class='hs-layout'>,</span>
<a name="line-86"></a> <span class='hs-varid'>pipeLinesFrom</span><span class='hs-layout'>,</span>
<a name="line-87"></a> <span class='hs-varid'>pipeTo</span><span class='hs-layout'>,</span>
<a name="line-88"></a> <span class='hs-varid'>pipeBoth</span><span class='hs-layout'>,</span>
<a name="line-89"></a> <span class='hs-comment'>-- ** Piping with handles</span>
<a name="line-90"></a> <span class='hs-varid'>hPipeFrom</span><span class='hs-layout'>,</span>
<a name="line-91"></a> <span class='hs-varid'>hPipeTo</span><span class='hs-layout'>,</span>
<a name="line-92"></a> <span class='hs-varid'>hPipeBoth</span><span class='hs-layout'>,</span>
<a name="line-93"></a><span class='hs-cpp'>#endif</span>
<a name="line-94"></a><span class='hs-cpp'>#endif</span>
<a name="line-95"></a> <span class='hs-comment'>-- * Low-Level Tools</span>
<a name="line-96"></a> <span class='hs-conid'>PipeMode</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span>
<a name="line-97"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-98"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-99"></a> <span class='hs-varid'>pOpen</span><span class='hs-layout'>,</span> <span class='hs-varid'>pOpen3</span><span class='hs-layout'>,</span> <span class='hs-varid'>pOpen3Raw</span>
<a name="line-100"></a><span class='hs-cpp'>#endif</span>
<a name="line-101"></a><span class='hs-cpp'>#endif</span>
<a name="line-102"></a> <span class='hs-layout'>)</span>
<a name="line-103"></a><span class='hs-keyword'>where</span>
<a name="line-104"></a>
<a name="line-105"></a><span class='hs-comment'>-- FIXME - largely obsoleted by 6.4 - convert to wrappers.</span>
<a name="line-106"></a>
<a name="line-107"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Exit</span>
<a name="line-108"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Cmd</span>
<a name="line-109"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Log</span><span class='hs-varop'>.</span><span class='hs-conid'>Logger</span>
<a name="line-110"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-111"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Posix</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span>
<a name="line-112"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Posix</span><span class='hs-varop'>.</span><span class='hs-conid'>Process</span>
<a name="line-113"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Posix</span><span class='hs-varop'>.</span><span class='hs-conid'>Signals</span>
<a name="line-114"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Posix</span><span class='hs-varop'>.</span><span class='hs-conid'>Signals</span>
<a name="line-115"></a><span class='hs-cpp'>#endif</span>
<a name="line-116"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Posix</span><span class='hs-varop'>.</span><span class='hs-conid'>Types</span>
<a name="line-117"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span>
<a name="line-118"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span><span class='hs-varop'>.</span><span class='hs-conid'>Error</span>
<a name="line-119"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Concurrent</span><span class='hs-layout'>(</span><span class='hs-varid'>forkIO</span><span class='hs-layout'>)</span>
<a name="line-120"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Exception</span><span class='hs-layout'>(</span><span class='hs-varid'>finally</span><span class='hs-layout'>)</span>
<a name="line-121"></a>
<a name="line-122"></a><a name="PipeMode"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>PipeMode</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>ReadFromPipe</span> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>WriteToPipe</span>
<a name="line-123"></a>
<a name="line-124"></a><a name="logbase"></a><span class='hs-definition'>logbase</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span>
<a name="line-125"></a><span class='hs-definition'>logbase</span> <span class='hs-keyglyph'>=</span> <span class='hs-str'>"System.Cmd.Utils"</span>
<a name="line-126"></a>
<a name="line-127"></a><a name="PipeHandle"></a><span class='hs-comment'>{- | Return value from 'pipeFrom', 'pipeLinesFrom', 'pipeTo', or
<a name="line-128"></a>'pipeBoth'. Contains both a ProcessID and the original command that was
<a name="line-129"></a>executed. If you prefer not to use 'forceSuccess' on the result of one
<a name="line-130"></a>of these pipe calls, you can use (processID ph), assuming ph is your 'PipeHandle',
<a name="line-131"></a>as a parameter to 'System.Posix.Process.getProcessStatus'. -}</span>
<a name="line-132"></a><a name="PipeHandle"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>PipeHandle</span> <span class='hs-keyglyph'>=</span>
<a name="line-133"></a> <span class='hs-conid'>PipeHandle</span> <span class='hs-layout'>{</span> <span class='hs-varid'>processID</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ProcessID</span><span class='hs-layout'>,</span>
<a name="line-134"></a> <span class='hs-varid'>phCommand</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span><span class='hs-layout'>,</span>
<a name="line-135"></a> <span class='hs-varid'>phArgs</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>,</span>
<a name="line-136"></a> <span class='hs-varid'>phCreator</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-comment'>-- ^ Function that created it</span>
<a name="line-137"></a> <span class='hs-layout'>}</span>
<a name="line-138"></a> <span class='hs-keyword'>deriving</span> <span class='hs-layout'>(</span><span class='hs-conid'>Eq</span><span class='hs-layout'>,</span> <span class='hs-conid'>Show</span><span class='hs-layout'>)</span>
<a name="line-139"></a>
<a name="line-140"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-141"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-142"></a><a name="pipeLinesFrom"></a><span class='hs-comment'>{- | Like 'pipeFrom', but returns data in lines instead of just a String.
<a name="line-143"></a>Shortcut for calling lines on the result from 'pipeFrom'.
<a name="line-144"></a>
<a name="line-145"></a>Note: this function logs as pipeFrom.
<a name="line-146"></a>
<a name="line-147"></a>Not available on Windows. -}</span>
<a name="line-148"></a><span class='hs-definition'>pipeLinesFrom</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>PipeHandle</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span>
<a name="line-149"></a><span class='hs-definition'>pipeLinesFrom</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-keyglyph'>=</span>
<a name="line-150"></a> <span class='hs-keyword'>do</span> <span class='hs-layout'>(</span><span class='hs-varid'>pid</span><span class='hs-layout'>,</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>pipeFrom</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span>
<a name="line-151"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-layout'>(</span><span class='hs-varid'>pid</span><span class='hs-layout'>,</span> <span class='hs-varid'>lines</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span>
<a name="line-152"></a><span class='hs-cpp'>#endif</span>
<a name="line-153"></a><span class='hs-cpp'>#endif</span>
<a name="line-154"></a>
<a name="line-155"></a><a name="logRunning"></a><span class='hs-definition'>logRunning</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-156"></a><span class='hs-definition'>logRunning</span> <span class='hs-varid'>func</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>debugM</span> <span class='hs-layout'>(</span><span class='hs-varid'>logbase</span> <span class='hs-varop'>++</span> <span class='hs-str'>"."</span> <span class='hs-varop'>++</span> <span class='hs-varid'>func</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>showCmd</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span><span class='hs-layout'>)</span>
<a name="line-157"></a>
<a name="line-158"></a><a name="warnFail"></a><span class='hs-definition'>warnFail</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Char</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Char</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-varid'>t</span>
<a name="line-159"></a><span class='hs-definition'>warnFail</span> <span class='hs-varid'>funcname</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varid'>msg</span> <span class='hs-keyglyph'>=</span>
<a name="line-160"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>showCmd</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varop'>++</span> <span class='hs-str'>": "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>msg</span>
<a name="line-161"></a> <span class='hs-keyword'>in</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>warningM</span> <span class='hs-layout'>(</span><span class='hs-varid'>logbase</span> <span class='hs-varop'>++</span> <span class='hs-str'>"."</span> <span class='hs-varop'>++</span> <span class='hs-varid'>funcname</span><span class='hs-layout'>)</span> <span class='hs-varid'>m</span>
<a name="line-162"></a> <span class='hs-varid'>fail</span> <span class='hs-varid'>m</span>
<a name="line-163"></a>
<a name="line-164"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-165"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-166"></a><a name="hPipeFrom"></a><span class='hs-comment'>{- | Read data from a pipe. Returns a Handle and a 'PipeHandle'.
<a name="line-167"></a>
<a name="line-168"></a>When done, you must hClose the handle, and then use either 'forceSuccess' or
<a name="line-169"></a>getProcessStatus on the 'PipeHandle'. Zombies will result otherwise.
<a name="line-170"></a>
<a name="line-171"></a>This function logs as pipeFrom.
<a name="line-172"></a>
<a name="line-173"></a>Not available on Windows or with Hugs.
<a name="line-174"></a>-}</span>
<a name="line-175"></a><span class='hs-definition'>hPipeFrom</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>PipeHandle</span><span class='hs-layout'>,</span> <span class='hs-conid'>Handle</span><span class='hs-layout'>)</span>
<a name="line-176"></a><span class='hs-definition'>hPipeFrom</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-keyglyph'>=</span>
<a name="line-177"></a> <span class='hs-keyword'>do</span> <span class='hs-varid'>pipepair</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>createPipe</span>
<a name="line-178"></a> <span class='hs-varid'>logRunning</span> <span class='hs-str'>"pipeFrom"</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span>
<a name="line-179"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>childstuff</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>dupTo</span> <span class='hs-layout'>(</span><span class='hs-varid'>snd</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span> <span class='hs-varid'>stdOutput</span>
<a name="line-180"></a> <span class='hs-varid'>closeFd</span> <span class='hs-layout'>(</span><span class='hs-varid'>fst</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span>
<a name="line-181"></a> <span class='hs-varid'>executeFile</span> <span class='hs-varid'>fp</span> <span class='hs-conid'>True</span> <span class='hs-varid'>args</span> <span class='hs-conid'>Nothing</span>
<a name="line-182"></a> <span class='hs-varid'>p</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>try</span> <span class='hs-layout'>(</span><span class='hs-varid'>forkProcess</span> <span class='hs-varid'>childstuff</span><span class='hs-layout'>)</span>
<a name="line-183"></a> <span class='hs-comment'>-- parent</span>
<a name="line-184"></a> <span class='hs-varid'>pid</span> <span class='hs-keyglyph'><-</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>p</span> <span class='hs-keyword'>of</span>
<a name="line-185"></a> <span class='hs-conid'>Right</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-varid'>x</span>
<a name="line-186"></a> <span class='hs-conid'>Left</span> <span class='hs-varid'>e</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>warnFail</span> <span class='hs-str'>"pipeFrom"</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varop'>$</span>
<a name="line-187"></a> <span class='hs-str'>"Error in fork: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>e</span>
<a name="line-188"></a> <span class='hs-varid'>closeFd</span> <span class='hs-layout'>(</span><span class='hs-varid'>snd</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span>
<a name="line-189"></a> <span class='hs-varid'>h</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>fdToHandle</span> <span class='hs-layout'>(</span><span class='hs-varid'>fst</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span>
<a name="line-190"></a> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>PipeHandle</span> <span class='hs-varid'>pid</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-str'>"pipeFrom"</span><span class='hs-layout'>,</span> <span class='hs-varid'>h</span><span class='hs-layout'>)</span>
<a name="line-191"></a><span class='hs-cpp'>#endif</span>
<a name="line-192"></a><span class='hs-cpp'>#endif</span>
<a name="line-193"></a>
<a name="line-194"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-195"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-196"></a><a name="pipeFrom"></a><span class='hs-comment'>{- | Read data from a pipe. Returns a lazy string and a 'PipeHandle'.
<a name="line-197"></a>
<a name="line-198"></a>ONLY AFTER the string has been read completely, You must call either
<a name="line-199"></a>'System.Posix.Process.getProcessStatus' or 'forceSuccess' on the 'PipeHandle'.
<a name="line-200"></a>Zombies will result otherwise.
<a name="line-201"></a>
<a name="line-202"></a>Not available on Windows.
<a name="line-203"></a>-}</span>
<a name="line-204"></a><span class='hs-definition'>pipeFrom</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>PipeHandle</span><span class='hs-layout'>,</span> <span class='hs-conid'>String</span><span class='hs-layout'>)</span>
<a name="line-205"></a><span class='hs-definition'>pipeFrom</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-keyglyph'>=</span>
<a name="line-206"></a> <span class='hs-keyword'>do</span> <span class='hs-layout'>(</span><span class='hs-varid'>pid</span><span class='hs-layout'>,</span> <span class='hs-varid'>h</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>hPipeFrom</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span>
<a name="line-207"></a> <span class='hs-varid'>c</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>hGetContents</span> <span class='hs-varid'>h</span>
<a name="line-208"></a> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-varid'>pid</span><span class='hs-layout'>,</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span>
<a name="line-209"></a><span class='hs-cpp'>#endif</span>
<a name="line-210"></a><span class='hs-cpp'>#endif</span>
<a name="line-211"></a>
<a name="line-212"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-213"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-214"></a><a name="hPipeTo"></a><span class='hs-comment'>{- | Write data to a pipe. Returns a 'PipeHandle' and a new Handle to write
<a name="line-215"></a>to.
<a name="line-216"></a>
<a name="line-217"></a>When done, you must hClose the handle, and then use either 'forceSuccess' or
<a name="line-218"></a>getProcessStatus on the 'PipeHandle'. Zombies will result otherwise.
<a name="line-219"></a>
<a name="line-220"></a>This function logs as pipeTo.
<a name="line-221"></a>
<a name="line-222"></a>Not available on Windows.
<a name="line-223"></a>-}</span>
<a name="line-224"></a><span class='hs-definition'>hPipeTo</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>PipeHandle</span><span class='hs-layout'>,</span> <span class='hs-conid'>Handle</span><span class='hs-layout'>)</span>
<a name="line-225"></a><span class='hs-definition'>hPipeTo</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-keyglyph'>=</span>
<a name="line-226"></a> <span class='hs-keyword'>do</span> <span class='hs-varid'>pipepair</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>createPipe</span>
<a name="line-227"></a> <span class='hs-varid'>logRunning</span> <span class='hs-str'>"pipeTo"</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span>
<a name="line-228"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>childstuff</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>dupTo</span> <span class='hs-layout'>(</span><span class='hs-varid'>fst</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span> <span class='hs-varid'>stdInput</span>
<a name="line-229"></a> <span class='hs-varid'>closeFd</span> <span class='hs-layout'>(</span><span class='hs-varid'>snd</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span>
<a name="line-230"></a> <span class='hs-varid'>executeFile</span> <span class='hs-varid'>fp</span> <span class='hs-conid'>True</span> <span class='hs-varid'>args</span> <span class='hs-conid'>Nothing</span>
<a name="line-231"></a> <span class='hs-varid'>p</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>try</span> <span class='hs-layout'>(</span><span class='hs-varid'>forkProcess</span> <span class='hs-varid'>childstuff</span><span class='hs-layout'>)</span>
<a name="line-232"></a> <span class='hs-comment'>-- parent</span>
<a name="line-233"></a> <span class='hs-varid'>pid</span> <span class='hs-keyglyph'><-</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>p</span> <span class='hs-keyword'>of</span>
<a name="line-234"></a> <span class='hs-conid'>Right</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-varid'>x</span>
<a name="line-235"></a> <span class='hs-conid'>Left</span> <span class='hs-varid'>e</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>warnFail</span> <span class='hs-str'>"pipeTo"</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varop'>$</span>
<a name="line-236"></a> <span class='hs-str'>"Error in fork: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>e</span>
<a name="line-237"></a> <span class='hs-varid'>closeFd</span> <span class='hs-layout'>(</span><span class='hs-varid'>fst</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span>
<a name="line-238"></a> <span class='hs-varid'>h</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>fdToHandle</span> <span class='hs-layout'>(</span><span class='hs-varid'>snd</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span>
<a name="line-239"></a> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>PipeHandle</span> <span class='hs-varid'>pid</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-str'>"pipeTo"</span><span class='hs-layout'>,</span> <span class='hs-varid'>h</span><span class='hs-layout'>)</span>
<a name="line-240"></a><span class='hs-cpp'>#endif</span>
<a name="line-241"></a><span class='hs-cpp'>#endif</span>
<a name="line-242"></a>
<a name="line-243"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-244"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-245"></a><a name="pipeTo"></a><span class='hs-comment'>{- | Write data to a pipe. Returns a ProcessID.
<a name="line-246"></a>
<a name="line-247"></a>You must call either
<a name="line-248"></a>'System.Posix.Process.getProcessStatus' or 'forceSuccess' on the ProcessID.
<a name="line-249"></a>Zombies will result otherwise.
<a name="line-250"></a>
<a name="line-251"></a>Not available on Windows.
<a name="line-252"></a>-}</span>
<a name="line-253"></a><span class='hs-definition'>pipeTo</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>PipeHandle</span>
<a name="line-254"></a><span class='hs-definition'>pipeTo</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varid'>message</span> <span class='hs-keyglyph'>=</span>
<a name="line-255"></a> <span class='hs-keyword'>do</span> <span class='hs-layout'>(</span><span class='hs-varid'>pid</span><span class='hs-layout'>,</span> <span class='hs-varid'>h</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>hPipeTo</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span>
<a name="line-256"></a> <span class='hs-varid'>finally</span> <span class='hs-layout'>(</span><span class='hs-varid'>hPutStr</span> <span class='hs-varid'>h</span> <span class='hs-varid'>message</span><span class='hs-layout'>)</span>
<a name="line-257"></a> <span class='hs-layout'>(</span><span class='hs-varid'>hClose</span> <span class='hs-varid'>h</span><span class='hs-layout'>)</span>
<a name="line-258"></a> <span class='hs-varid'>return</span> <span class='hs-varid'>pid</span>
<a name="line-259"></a><span class='hs-cpp'>#endif</span>
<a name="line-260"></a><span class='hs-cpp'>#endif</span>
<a name="line-261"></a>
<a name="line-262"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-263"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-264"></a><a name="hPipeBoth"></a><span class='hs-comment'>{- | Like a combination of 'hPipeTo' and 'hPipeFrom'; returns
<a name="line-265"></a>a 3-tuple of ('PipeHandle', Data From Pipe, Data To Pipe).
<a name="line-266"></a>
<a name="line-267"></a>When done, you must hClose both handles, and then use either 'forceSuccess' or
<a name="line-268"></a>getProcessStatus on the 'PipeHandle'. Zombies will result otherwise.
<a name="line-269"></a>
<a name="line-270"></a>Hint: you will usually need to ForkIO a thread to handle one of the Handles;
<a name="line-271"></a>otherwise, deadlock can result.
<a name="line-272"></a>
<a name="line-273"></a>This function logs as pipeBoth.
<a name="line-274"></a>
<a name="line-275"></a>Not available on Windows.
<a name="line-276"></a>-}</span>
<a name="line-277"></a><span class='hs-definition'>hPipeBoth</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>PipeHandle</span><span class='hs-layout'>,</span> <span class='hs-conid'>Handle</span><span class='hs-layout'>,</span> <span class='hs-conid'>Handle</span><span class='hs-layout'>)</span>
<a name="line-278"></a><span class='hs-definition'>hPipeBoth</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-keyglyph'>=</span>
<a name="line-279"></a> <span class='hs-keyword'>do</span> <span class='hs-varid'>frompair</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>createPipe</span>
<a name="line-280"></a> <span class='hs-varid'>topair</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>createPipe</span>
<a name="line-281"></a> <span class='hs-varid'>logRunning</span> <span class='hs-str'>"pipeBoth"</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span>
<a name="line-282"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>childstuff</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>dupTo</span> <span class='hs-layout'>(</span><span class='hs-varid'>snd</span> <span class='hs-varid'>frompair</span><span class='hs-layout'>)</span> <span class='hs-varid'>stdOutput</span>
<a name="line-283"></a> <span class='hs-varid'>closeFd</span> <span class='hs-layout'>(</span><span class='hs-varid'>fst</span> <span class='hs-varid'>frompair</span><span class='hs-layout'>)</span>
<a name="line-284"></a> <span class='hs-varid'>dupTo</span> <span class='hs-layout'>(</span><span class='hs-varid'>fst</span> <span class='hs-varid'>topair</span><span class='hs-layout'>)</span> <span class='hs-varid'>stdInput</span>
<a name="line-285"></a> <span class='hs-varid'>closeFd</span> <span class='hs-layout'>(</span><span class='hs-varid'>snd</span> <span class='hs-varid'>topair</span><span class='hs-layout'>)</span>
<a name="line-286"></a> <span class='hs-varid'>executeFile</span> <span class='hs-varid'>fp</span> <span class='hs-conid'>True</span> <span class='hs-varid'>args</span> <span class='hs-conid'>Nothing</span>
<a name="line-287"></a> <span class='hs-varid'>p</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>try</span> <span class='hs-layout'>(</span><span class='hs-varid'>forkProcess</span> <span class='hs-varid'>childstuff</span><span class='hs-layout'>)</span>
<a name="line-288"></a> <span class='hs-comment'>-- parent</span>
<a name="line-289"></a> <span class='hs-varid'>pid</span> <span class='hs-keyglyph'><-</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>p</span> <span class='hs-keyword'>of</span>
<a name="line-290"></a> <span class='hs-conid'>Right</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-varid'>x</span>
<a name="line-291"></a> <span class='hs-conid'>Left</span> <span class='hs-varid'>e</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>warnFail</span> <span class='hs-str'>"pipeBoth"</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varop'>$</span>
<a name="line-292"></a> <span class='hs-str'>"Error in fork: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>e</span>
<a name="line-293"></a> <span class='hs-varid'>closeFd</span> <span class='hs-layout'>(</span><span class='hs-varid'>snd</span> <span class='hs-varid'>frompair</span><span class='hs-layout'>)</span>
<a name="line-294"></a> <span class='hs-varid'>closeFd</span> <span class='hs-layout'>(</span><span class='hs-varid'>fst</span> <span class='hs-varid'>topair</span><span class='hs-layout'>)</span>
<a name="line-295"></a> <span class='hs-varid'>fromh</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>fdToHandle</span> <span class='hs-layout'>(</span><span class='hs-varid'>fst</span> <span class='hs-varid'>frompair</span><span class='hs-layout'>)</span>
<a name="line-296"></a> <span class='hs-varid'>toh</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>fdToHandle</span> <span class='hs-layout'>(</span><span class='hs-varid'>snd</span> <span class='hs-varid'>topair</span><span class='hs-layout'>)</span>
<a name="line-297"></a> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>PipeHandle</span> <span class='hs-varid'>pid</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-str'>"pipeBoth"</span><span class='hs-layout'>,</span> <span class='hs-varid'>fromh</span><span class='hs-layout'>,</span> <span class='hs-varid'>toh</span><span class='hs-layout'>)</span>
<a name="line-298"></a><span class='hs-cpp'>#endif</span>
<a name="line-299"></a><span class='hs-cpp'>#endif</span>
<a name="line-300"></a>
<a name="line-301"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-302"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-303"></a><a name="pipeBoth"></a><span class='hs-comment'>{- | Like a combination of 'pipeTo' and 'pipeFrom'; forks an IO thread
<a name="line-304"></a>to send data to the piped program, and simultaneously returns its output
<a name="line-305"></a>stream.
<a name="line-306"></a>
<a name="line-307"></a>The same note about checking the return status applies here as with 'pipeFrom'.
<a name="line-308"></a>
<a name="line-309"></a>Not available on Windows. -}</span>
<a name="line-310"></a><span class='hs-definition'>pipeBoth</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>PipeHandle</span><span class='hs-layout'>,</span> <span class='hs-conid'>String</span><span class='hs-layout'>)</span>
<a name="line-311"></a><span class='hs-definition'>pipeBoth</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varid'>message</span> <span class='hs-keyglyph'>=</span>
<a name="line-312"></a> <span class='hs-keyword'>do</span> <span class='hs-layout'>(</span><span class='hs-varid'>pid</span><span class='hs-layout'>,</span> <span class='hs-varid'>fromh</span><span class='hs-layout'>,</span> <span class='hs-varid'>toh</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>hPipeBoth</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span>
<a name="line-313"></a> <span class='hs-varid'>forkIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>finally</span> <span class='hs-layout'>(</span><span class='hs-varid'>hPutStr</span> <span class='hs-varid'>toh</span> <span class='hs-varid'>message</span><span class='hs-layout'>)</span>
<a name="line-314"></a> <span class='hs-layout'>(</span><span class='hs-varid'>hClose</span> <span class='hs-varid'>toh</span><span class='hs-layout'>)</span>
<a name="line-315"></a> <span class='hs-varid'>c</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>hGetContents</span> <span class='hs-varid'>fromh</span>
<a name="line-316"></a> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-varid'>pid</span><span class='hs-layout'>,</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span>
<a name="line-317"></a><span class='hs-cpp'>#endif</span>
<a name="line-318"></a><span class='hs-cpp'>#endif</span>
<a name="line-319"></a>
<a name="line-320"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-321"></a><a name="forceSuccess"></a><span class='hs-comment'>{- | Uses 'System.Posix.Process.getProcessStatus' to obtain the exit status
<a name="line-322"></a>of the given process ID. If the process terminated normally, does nothing.
<a name="line-323"></a>Otherwise, raises an exception with an appropriate error message.
<a name="line-324"></a>
<a name="line-325"></a>This call will block waiting for the given pid to terminate.
<a name="line-326"></a>
<a name="line-327"></a>Not available on Windows. -}</span>
<a name="line-328"></a><span class='hs-definition'>forceSuccess</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>PipeHandle</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-329"></a><span class='hs-definition'>forceSuccess</span> <span class='hs-layout'>(</span><span class='hs-conid'>PipeHandle</span> <span class='hs-varid'>pid</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varid'>funcname</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span>
<a name="line-330"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>warnfail</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>warnFail</span> <span class='hs-varid'>funcname</span>
<a name="line-331"></a> <span class='hs-keyword'>in</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>status</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>getProcessStatus</span> <span class='hs-conid'>True</span> <span class='hs-conid'>False</span> <span class='hs-varid'>pid</span>
<a name="line-332"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>status</span> <span class='hs-keyword'>of</span>
<a name="line-333"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>warnfail</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varop'>$</span> <span class='hs-str'>"Got no process status"</span>
<a name="line-334"></a> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-conid'>Exited</span> <span class='hs-layout'>(</span><span class='hs-conid'>ExitSuccess</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-335"></a> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-conid'>Exited</span> <span class='hs-layout'>(</span><span class='hs-conid'>ExitFailure</span> <span class='hs-varid'>fc</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span>
<a name="line-336"></a> <span class='hs-varid'>cmdfailed</span> <span class='hs-varid'>funcname</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varid'>fc</span>
<a name="line-337"></a> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-conid'>Terminated</span> <span class='hs-varid'>sig</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span>
<a name="line-338"></a> <span class='hs-varid'>warnfail</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varop'>$</span> <span class='hs-str'>"Terminated by signal "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>sig</span>
<a name="line-339"></a> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-conid'>Stopped</span> <span class='hs-varid'>sig</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span>
<a name="line-340"></a> <span class='hs-varid'>warnfail</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varop'>$</span> <span class='hs-str'>"Stopped by signal "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>sig</span>
<a name="line-341"></a><span class='hs-cpp'>#endif</span>
<a name="line-342"></a>
<a name="line-343"></a><a name="safeSystem"></a><span class='hs-comment'>{- | Invokes the specified command in a subprocess, waiting for the result.
<a name="line-344"></a>If the command terminated successfully, return normally. Otherwise,
<a name="line-345"></a>raises a userError with the problem.
<a name="line-346"></a>
<a name="line-347"></a>Implemented in terms of 'posixRawSystem' where supported, and System.Posix.rawSystem otherwise.
<a name="line-348"></a>-}</span>
<a name="line-349"></a><span class='hs-definition'>safeSystem</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-350"></a><span class='hs-definition'>safeSystem</span> <span class='hs-varid'>command</span> <span class='hs-varid'>args</span> <span class='hs-keyglyph'>=</span>
<a name="line-351"></a> <span class='hs-keyword'>do</span> <span class='hs-varid'>debugM</span> <span class='hs-layout'>(</span><span class='hs-varid'>logbase</span> <span class='hs-varop'>++</span> <span class='hs-str'>".safeSystem"</span><span class='hs-layout'>)</span>
<a name="line-352"></a> <span class='hs-layout'>(</span><span class='hs-str'>"Running: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>command</span> <span class='hs-varop'>++</span> <span class='hs-str'>" "</span> <span class='hs-varop'>++</span> <span class='hs-layout'>(</span><span class='hs-varid'>show</span> <span class='hs-varid'>args</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-353"></a><span class='hs-cpp'>#if defined(__HUGS__) || defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__)</span>
<a name="line-354"></a> <span class='hs-varid'>ec</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>rawSystem</span> <span class='hs-varid'>command</span> <span class='hs-varid'>args</span>
<a name="line-355"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>ec</span> <span class='hs-keyword'>of</span>
<a name="line-356"></a> <span class='hs-conid'>ExitSuccess</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-357"></a> <span class='hs-conid'>ExitFailure</span> <span class='hs-varid'>fc</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>cmdfailed</span> <span class='hs-str'>"safeSystem"</span> <span class='hs-varid'>command</span> <span class='hs-varid'>args</span> <span class='hs-varid'>fc</span>
<a name="line-358"></a><span class='hs-cpp'>#else</span>
<a name="line-359"></a> <span class='hs-varid'>ec</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>posixRawSystem</span> <span class='hs-varid'>command</span> <span class='hs-varid'>args</span>
<a name="line-360"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>ec</span> <span class='hs-keyword'>of</span>
<a name="line-361"></a> <span class='hs-conid'>Exited</span> <span class='hs-conid'>ExitSuccess</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-362"></a> <span class='hs-conid'>Exited</span> <span class='hs-layout'>(</span><span class='hs-conid'>ExitFailure</span> <span class='hs-varid'>fc</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>cmdfailed</span> <span class='hs-str'>"safeSystem"</span> <span class='hs-varid'>command</span> <span class='hs-varid'>args</span> <span class='hs-varid'>fc</span>
<a name="line-363"></a> <span class='hs-conid'>Terminated</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>cmdsignalled</span> <span class='hs-str'>"safeSystem"</span> <span class='hs-varid'>command</span> <span class='hs-varid'>args</span> <span class='hs-varid'>s</span>
<a name="line-364"></a> <span class='hs-conid'>Stopped</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>cmdsignalled</span> <span class='hs-str'>"safeSystem"</span> <span class='hs-varid'>command</span> <span class='hs-varid'>args</span> <span class='hs-varid'>s</span>
<a name="line-365"></a><span class='hs-cpp'>#endif</span>
<a name="line-366"></a>
<a name="line-367"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-368"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-369"></a><a name="posixRawSystem"></a><span class='hs-comment'>{- | Invokes the specified command in a subprocess, waiting for the result.
<a name="line-370"></a>Return the result status. Never raises an exception. Only available
<a name="line-371"></a>on POSIX platforms.
<a name="line-372"></a>
<a name="line-373"></a>Like system(3), this command ignores SIGINT and SIGQUIT and blocks SIGCHLD
<a name="line-374"></a>during its execution.
<a name="line-375"></a>
<a name="line-376"></a>Logs as System.Cmd.Utils.posixRawSystem -}</span>
<a name="line-377"></a><span class='hs-definition'>posixRawSystem</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ProcessStatus</span>
<a name="line-378"></a><span class='hs-definition'>posixRawSystem</span> <span class='hs-varid'>program</span> <span class='hs-varid'>args</span> <span class='hs-keyglyph'>=</span>
<a name="line-379"></a> <span class='hs-keyword'>do</span> <span class='hs-varid'>debugM</span> <span class='hs-layout'>(</span><span class='hs-varid'>logbase</span> <span class='hs-varop'>++</span> <span class='hs-str'>".posixRawSystem"</span><span class='hs-layout'>)</span>
<a name="line-380"></a> <span class='hs-layout'>(</span><span class='hs-str'>"Running: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>program</span> <span class='hs-varop'>++</span> <span class='hs-str'>" "</span> <span class='hs-varop'>++</span> <span class='hs-layout'>(</span><span class='hs-varid'>show</span> <span class='hs-varid'>args</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-381"></a> <span class='hs-varid'>oldint</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>installHandler</span> <span class='hs-varid'>sigINT</span> <span class='hs-conid'>Ignore</span> <span class='hs-conid'>Nothing</span>
<a name="line-382"></a> <span class='hs-varid'>oldquit</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>installHandler</span> <span class='hs-varid'>sigQUIT</span> <span class='hs-conid'>Ignore</span> <span class='hs-conid'>Nothing</span>
<a name="line-383"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>sigset</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>addSignal</span> <span class='hs-varid'>sigCHLD</span> <span class='hs-varid'>emptySignalSet</span>
<a name="line-384"></a> <span class='hs-varid'>oldset</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>getSignalMask</span>
<a name="line-385"></a> <span class='hs-varid'>blockSignals</span> <span class='hs-varid'>sigset</span>
<a name="line-386"></a> <span class='hs-varid'>childpid</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>forkProcess</span> <span class='hs-layout'>(</span><span class='hs-varid'>childaction</span> <span class='hs-varid'>oldint</span> <span class='hs-varid'>oldquit</span> <span class='hs-varid'>oldset</span><span class='hs-layout'>)</span>
<a name="line-387"></a>
<a name="line-388"></a> <span class='hs-varid'>mps</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>getProcessStatus</span> <span class='hs-conid'>True</span> <span class='hs-conid'>False</span> <span class='hs-varid'>childpid</span>
<a name="line-389"></a> <span class='hs-varid'>restoresignals</span> <span class='hs-varid'>oldint</span> <span class='hs-varid'>oldquit</span> <span class='hs-varid'>oldset</span>
<a name="line-390"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>retval</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>mps</span> <span class='hs-keyword'>of</span>
<a name="line-391"></a> <span class='hs-conid'>Just</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>x</span>
<a name="line-392"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>error</span> <span class='hs-str'>"Nothing returned from getProcessStatus"</span>
<a name="line-393"></a>
<a name="line-394"></a> <span class='hs-varid'>debugM</span> <span class='hs-layout'>(</span><span class='hs-varid'>logbase</span> <span class='hs-varop'>++</span> <span class='hs-str'>".posixRawSystem"</span><span class='hs-layout'>)</span>
<a name="line-395"></a> <span class='hs-layout'>(</span><span class='hs-varid'>program</span> <span class='hs-varop'>++</span> <span class='hs-str'>": exited with "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>retval</span><span class='hs-layout'>)</span>
<a name="line-396"></a> <span class='hs-varid'>return</span> <span class='hs-varid'>retval</span>
<a name="line-397"></a>
<a name="line-398"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>childaction</span> <span class='hs-varid'>oldint</span> <span class='hs-varid'>oldquit</span> <span class='hs-varid'>oldset</span> <span class='hs-keyglyph'>=</span>
<a name="line-399"></a> <span class='hs-keyword'>do</span> <span class='hs-varid'>restoresignals</span> <span class='hs-varid'>oldint</span> <span class='hs-varid'>oldquit</span> <span class='hs-varid'>oldset</span>
<a name="line-400"></a> <span class='hs-varid'>executeFile</span> <span class='hs-varid'>program</span> <span class='hs-conid'>True</span> <span class='hs-varid'>args</span> <span class='hs-conid'>Nothing</span>
<a name="line-401"></a> <span class='hs-varid'>restoresignals</span> <span class='hs-varid'>oldint</span> <span class='hs-varid'>oldquit</span> <span class='hs-varid'>oldset</span> <span class='hs-keyglyph'>=</span>
<a name="line-402"></a> <span class='hs-keyword'>do</span> <span class='hs-varid'>installHandler</span> <span class='hs-varid'>sigINT</span> <span class='hs-varid'>oldint</span> <span class='hs-conid'>Nothing</span>
<a name="line-403"></a> <span class='hs-varid'>installHandler</span> <span class='hs-varid'>sigQUIT</span> <span class='hs-varid'>oldquit</span> <span class='hs-conid'>Nothing</span>
<a name="line-404"></a> <span class='hs-varid'>setSignalMask</span> <span class='hs-varid'>oldset</span>
<a name="line-405"></a>
<a name="line-406"></a><span class='hs-cpp'>#endif</span>
<a name="line-407"></a><span class='hs-cpp'>#endif</span>
<a name="line-408"></a>
<a name="line-409"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-410"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-411"></a><a name="forkRawSystem"></a><span class='hs-comment'>{- | Invokes the specified command in a subprocess, without waiting for
<a name="line-412"></a>the result. Returns the PID of the subprocess -- it is YOUR responsibility
<a name="line-413"></a>to use getProcessStatus or getAnyProcessStatus on that at some point. Failure
<a name="line-414"></a>to do so will lead to resource leakage (zombie processes).
<a name="line-415"></a>
<a name="line-416"></a>This function does nothing with signals. That too is up to you.
<a name="line-417"></a>
<a name="line-418"></a>Logs as System.Cmd.Utils.forkRawSystem -}</span>
<a name="line-419"></a><span class='hs-definition'>forkRawSystem</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ProcessID</span>
<a name="line-420"></a><span class='hs-definition'>forkRawSystem</span> <span class='hs-varid'>program</span> <span class='hs-varid'>args</span> <span class='hs-keyglyph'>=</span>
<a name="line-421"></a> <span class='hs-keyword'>do</span> <span class='hs-varid'>debugM</span> <span class='hs-layout'>(</span><span class='hs-varid'>logbase</span> <span class='hs-varop'>++</span> <span class='hs-str'>".forkRawSystem"</span><span class='hs-layout'>)</span>
<a name="line-422"></a> <span class='hs-layout'>(</span><span class='hs-str'>"Running: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>program</span> <span class='hs-varop'>++</span> <span class='hs-str'>" "</span> <span class='hs-varop'>++</span> <span class='hs-layout'>(</span><span class='hs-varid'>show</span> <span class='hs-varid'>args</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-423"></a> <span class='hs-varid'>forkProcess</span> <span class='hs-varid'>childaction</span>
<a name="line-424"></a> <span class='hs-keyword'>where</span>
<a name="line-425"></a> <span class='hs-varid'>childaction</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>executeFile</span> <span class='hs-varid'>program</span> <span class='hs-conid'>True</span> <span class='hs-varid'>args</span> <span class='hs-conid'>Nothing</span>
<a name="line-426"></a>
<a name="line-427"></a><span class='hs-cpp'>#endif</span>
<a name="line-428"></a><span class='hs-cpp'>#endif</span>
<a name="line-429"></a>
<a name="line-430"></a><a name="cmdfailed"></a><span class='hs-definition'>cmdfailed</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span>
<a name="line-431"></a><span class='hs-definition'>cmdfailed</span> <span class='hs-varid'>funcname</span> <span class='hs-varid'>command</span> <span class='hs-varid'>args</span> <span class='hs-varid'>failcode</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-432"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>errormsg</span> <span class='hs-keyglyph'>=</span> <span class='hs-str'>"Command "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>command</span> <span class='hs-varop'>++</span> <span class='hs-str'>" "</span> <span class='hs-varop'>++</span> <span class='hs-layout'>(</span><span class='hs-varid'>show</span> <span class='hs-varid'>args</span><span class='hs-layout'>)</span> <span class='hs-varop'>++</span>
<a name="line-433"></a> <span class='hs-str'>" failed; exit code "</span> <span class='hs-varop'>++</span> <span class='hs-layout'>(</span><span class='hs-varid'>show</span> <span class='hs-varid'>failcode</span><span class='hs-layout'>)</span>
<a name="line-434"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>e</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>userError</span> <span class='hs-layout'>(</span><span class='hs-varid'>errormsg</span><span class='hs-layout'>)</span>
<a name="line-435"></a> <span class='hs-varid'>warningM</span> <span class='hs-layout'>(</span><span class='hs-varid'>logbase</span> <span class='hs-varop'>++</span> <span class='hs-str'>"."</span> <span class='hs-varop'>++</span> <span class='hs-varid'>funcname</span><span class='hs-layout'>)</span> <span class='hs-varid'>errormsg</span>
<a name="line-436"></a> <span class='hs-varid'>ioError</span> <span class='hs-varid'>e</span>
<a name="line-437"></a>
<a name="line-438"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-439"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-440"></a><a name="cmdsignalled"></a><span class='hs-definition'>cmdsignalled</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Signal</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span>
<a name="line-441"></a><span class='hs-definition'>cmdsignalled</span> <span class='hs-varid'>funcname</span> <span class='hs-varid'>command</span> <span class='hs-varid'>args</span> <span class='hs-varid'>failcode</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-442"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>errormsg</span> <span class='hs-keyglyph'>=</span> <span class='hs-str'>"Command "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>command</span> <span class='hs-varop'>++</span> <span class='hs-str'>" "</span> <span class='hs-varop'>++</span> <span class='hs-layout'>(</span><span class='hs-varid'>show</span> <span class='hs-varid'>args</span><span class='hs-layout'>)</span> <span class='hs-varop'>++</span>
<a name="line-443"></a> <span class='hs-str'>" failed due to signal "</span> <span class='hs-varop'>++</span> <span class='hs-layout'>(</span><span class='hs-varid'>show</span> <span class='hs-varid'>failcode</span><span class='hs-layout'>)</span>
<a name="line-444"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>e</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>userError</span> <span class='hs-layout'>(</span><span class='hs-varid'>errormsg</span><span class='hs-layout'>)</span>
<a name="line-445"></a> <span class='hs-varid'>warningM</span> <span class='hs-layout'>(</span><span class='hs-varid'>logbase</span> <span class='hs-varop'>++</span> <span class='hs-str'>"."</span> <span class='hs-varop'>++</span> <span class='hs-varid'>funcname</span><span class='hs-layout'>)</span> <span class='hs-varid'>errormsg</span>
<a name="line-446"></a> <span class='hs-varid'>ioError</span> <span class='hs-varid'>e</span>
<a name="line-447"></a><span class='hs-cpp'>#endif</span>
<a name="line-448"></a><span class='hs-cpp'>#endif</span>
<a name="line-449"></a>
<a name="line-450"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-451"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-452"></a><a name="pOpen"></a><span class='hs-comment'>{- | Open a pipe to the specified command.
<a name="line-453"></a>
<a name="line-454"></a>Passes the handle on to the specified function.
<a name="line-455"></a>
<a name="line-456"></a>The 'PipeMode' specifies what you will be doing. That is, specifing 'ReadFromPipe'
<a name="line-457"></a>sets up a pipe from stdin, and 'WriteToPipe' sets up a pipe from stdout.
<a name="line-458"></a>
<a name="line-459"></a>Not available on Windows.
<a name="line-460"></a> -}</span>
<a name="line-461"></a><span class='hs-definition'>pOpen</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>PipeMode</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span>
<a name="line-462"></a> <span class='hs-layout'>(</span><span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span>
<a name="line-463"></a><span class='hs-definition'>pOpen</span> <span class='hs-varid'>pm</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varid'>func</span> <span class='hs-keyglyph'>=</span>
<a name="line-464"></a> <span class='hs-keyword'>do</span>
<a name="line-465"></a> <span class='hs-varid'>pipepair</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>createPipe</span>
<a name="line-466"></a> <span class='hs-varid'>debugM</span> <span class='hs-layout'>(</span><span class='hs-varid'>logbase</span> <span class='hs-varop'>++</span> <span class='hs-str'>".pOpen"</span><span class='hs-layout'>)</span>
<a name="line-467"></a> <span class='hs-layout'>(</span><span class='hs-str'>"Running: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>fp</span> <span class='hs-varop'>++</span> <span class='hs-str'>" "</span> <span class='hs-varop'>++</span> <span class='hs-layout'>(</span><span class='hs-varid'>show</span> <span class='hs-varid'>args</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-468"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>pm</span> <span class='hs-keyword'>of</span>
<a name="line-469"></a> <span class='hs-conid'>ReadFromPipe</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span>
<a name="line-470"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>callfunc</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-471"></a> <span class='hs-varid'>closeFd</span> <span class='hs-layout'>(</span><span class='hs-varid'>snd</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span>
<a name="line-472"></a> <span class='hs-varid'>h</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>fdToHandle</span> <span class='hs-layout'>(</span><span class='hs-varid'>fst</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span>
<a name="line-473"></a> <span class='hs-varid'>x</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>func</span> <span class='hs-varid'>h</span>
<a name="line-474"></a> <span class='hs-varid'>hClose</span> <span class='hs-varid'>h</span>
<a name="line-475"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-varid'>x</span>
<a name="line-476"></a> <span class='hs-varid'>pOpen3</span> <span class='hs-conid'>Nothing</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>snd</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-conid'>Nothing</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span>
<a name="line-477"></a> <span class='hs-varid'>callfunc</span> <span class='hs-layout'>(</span><span class='hs-varid'>closeFd</span> <span class='hs-layout'>(</span><span class='hs-varid'>fst</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-478"></a> <span class='hs-conid'>WriteToPipe</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span>
<a name="line-479"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>callfunc</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-480"></a> <span class='hs-varid'>closeFd</span> <span class='hs-layout'>(</span><span class='hs-varid'>fst</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span>
<a name="line-481"></a> <span class='hs-varid'>h</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>fdToHandle</span> <span class='hs-layout'>(</span><span class='hs-varid'>snd</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span>
<a name="line-482"></a> <span class='hs-varid'>x</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>func</span> <span class='hs-varid'>h</span>
<a name="line-483"></a> <span class='hs-varid'>hClose</span> <span class='hs-varid'>h</span>
<a name="line-484"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-varid'>x</span>
<a name="line-485"></a> <span class='hs-varid'>pOpen3</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>fst</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-conid'>Nothing</span> <span class='hs-conid'>Nothing</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span>
<a name="line-486"></a> <span class='hs-varid'>callfunc</span> <span class='hs-layout'>(</span><span class='hs-varid'>closeFd</span> <span class='hs-layout'>(</span><span class='hs-varid'>snd</span> <span class='hs-varid'>pipepair</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-487"></a><span class='hs-cpp'>#endif</span>
<a name="line-488"></a><span class='hs-cpp'>#endif</span>
<a name="line-489"></a>
<a name="line-490"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-491"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-492"></a><a name="pOpen3"></a><span class='hs-comment'>{- | Runs a command, redirecting things to pipes.
<a name="line-493"></a>
<a name="line-494"></a>Not available on Windows.
<a name="line-495"></a>
<a name="line-496"></a>Note that you may not use the same fd on more than one item. If you
<a name="line-497"></a>want to redirect stdout and stderr, dup it first.
<a name="line-498"></a>-}</span>
<a name="line-499"></a><span class='hs-definition'>pOpen3</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Fd</span> <span class='hs-comment'>-- ^ Send stdin to this fd</span>
<a name="line-500"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Fd</span> <span class='hs-comment'>-- ^ Get stdout from this fd</span>
<a name="line-501"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Fd</span> <span class='hs-comment'>-- ^ Get stderr from this fd</span>
<a name="line-502"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>FilePath</span> <span class='hs-comment'>-- ^ Command to run</span>
<a name="line-503"></a> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-comment'>-- ^ Command args</span>
<a name="line-504"></a> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>ProcessID</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- ^ Action to run in parent</span>
<a name="line-505"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span> <span class='hs-comment'>-- ^ Action to run in child before execing (if you don't need something, set this to @return ()@) -- IGNORED IN HUGS</span>
<a name="line-506"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span>
<a name="line-507"></a><span class='hs-definition'>pOpen3</span> <span class='hs-varid'>pin</span> <span class='hs-varid'>pout</span> <span class='hs-varid'>perr</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varid'>func</span> <span class='hs-varid'>childfunc</span> <span class='hs-keyglyph'>=</span>
<a name="line-508"></a> <span class='hs-keyword'>do</span> <span class='hs-varid'>pid</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>pOpen3Raw</span> <span class='hs-varid'>pin</span> <span class='hs-varid'>pout</span> <span class='hs-varid'>perr</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varid'>childfunc</span>
<a name="line-509"></a> <span class='hs-varid'>retval</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>func</span> <span class='hs-varop'>$!</span> <span class='hs-varid'>pid</span>
<a name="line-510"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>rv</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>seq</span> <span class='hs-varid'>retval</span> <span class='hs-varid'>retval</span>
<a name="line-511"></a> <span class='hs-varid'>forceSuccess</span> <span class='hs-layout'>(</span><span class='hs-conid'>PipeHandle</span> <span class='hs-layout'>(</span><span class='hs-varid'>seq</span> <span class='hs-varid'>retval</span> <span class='hs-varid'>pid</span><span class='hs-layout'>)</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-str'>"pOpen3"</span><span class='hs-layout'>)</span>
<a name="line-512"></a> <span class='hs-varid'>return</span> <span class='hs-varid'>rv</span>
<a name="line-513"></a><span class='hs-cpp'>#endif</span>
<a name="line-514"></a><span class='hs-cpp'>#endif</span>
<a name="line-515"></a>
<a name="line-516"></a><span class='hs-cpp'>#if !(defined(mingw32_HOST_OS) || defined(mingw32_TARGET_OS) || defined(__MINGW32__))</span>
<a name="line-517"></a><span class='hs-cpp'>#ifndef __HUGS__</span>
<a name="line-518"></a><a name="pOpen3Raw"></a><span class='hs-comment'>{- | Runs a command, redirecting things to pipes.
<a name="line-519"></a>
<a name="line-520"></a>Not available on Windows.
<a name="line-521"></a>
<a name="line-522"></a>Returns immediately with the PID of the child. Using 'waitProcess' on it
<a name="line-523"></a>is YOUR responsibility!
<a name="line-524"></a>
<a name="line-525"></a>Note that you may not use the same fd on more than one item. If you
<a name="line-526"></a>want to redirect stdout and stderr, dup it first.
<a name="line-527"></a>-}</span>
<a name="line-528"></a><span class='hs-definition'>pOpen3Raw</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Fd</span> <span class='hs-comment'>-- ^ Send stdin to this fd</span>
<a name="line-529"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Fd</span> <span class='hs-comment'>-- ^ Get stdout from this fd</span>
<a name="line-530"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Fd</span> <span class='hs-comment'>-- ^ Get stderr from this fd</span>
<a name="line-531"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>FilePath</span> <span class='hs-comment'>-- ^ Command to run</span>
<a name="line-532"></a> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-comment'>-- ^ Command args</span>
<a name="line-533"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span> <span class='hs-comment'>-- ^ Action to run in child before execing (if you don't need something, set this to @return ()@) -- IGNORED IN HUGS</span>
<a name="line-534"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ProcessID</span>
<a name="line-535"></a><span class='hs-definition'>pOpen3Raw</span> <span class='hs-varid'>pin</span> <span class='hs-varid'>pout</span> <span class='hs-varid'>perr</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-varid'>childfunc</span> <span class='hs-keyglyph'>=</span>
<a name="line-536"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>mayberedir</span> <span class='hs-conid'>Nothing</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-537"></a> <span class='hs-varid'>mayberedir</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-varid'>fromfd</span><span class='hs-layout'>)</span> <span class='hs-varid'>tofd</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-538"></a> <span class='hs-varid'>dupTo</span> <span class='hs-varid'>fromfd</span> <span class='hs-varid'>tofd</span>
<a name="line-539"></a> <span class='hs-varid'>closeFd</span> <span class='hs-varid'>fromfd</span>
<a name="line-540"></a> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-541"></a> <span class='hs-varid'>childstuff</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-542"></a> <span class='hs-varid'>mayberedir</span> <span class='hs-varid'>pin</span> <span class='hs-varid'>stdInput</span>
<a name="line-543"></a> <span class='hs-varid'>mayberedir</span> <span class='hs-varid'>pout</span> <span class='hs-varid'>stdOutput</span>
<a name="line-544"></a> <span class='hs-varid'>mayberedir</span> <span class='hs-varid'>perr</span> <span class='hs-varid'>stdError</span>
<a name="line-545"></a> <span class='hs-varid'>childfunc</span>
<a name="line-546"></a> <span class='hs-varid'>debugM</span> <span class='hs-layout'>(</span><span class='hs-varid'>logbase</span> <span class='hs-varop'>++</span> <span class='hs-str'>".pOpen3"</span><span class='hs-layout'>)</span>
<a name="line-547"></a> <span class='hs-layout'>(</span><span class='hs-str'>"Running: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>fp</span> <span class='hs-varop'>++</span> <span class='hs-str'>" "</span> <span class='hs-varop'>++</span> <span class='hs-layout'>(</span><span class='hs-varid'>show</span> <span class='hs-varid'>args</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-548"></a> <span class='hs-varid'>executeFile</span> <span class='hs-varid'>fp</span> <span class='hs-conid'>True</span> <span class='hs-varid'>args</span> <span class='hs-conid'>Nothing</span>
<a name="line-549"></a><span class='hs-comment'>{-
<a name="line-550"></a> realfunc p = do
<a name="line-551"></a> System.Posix.Signals.installHandler
<a name="line-552"></a> System.Posix.Signals.sigPIPE
<a name="line-553"></a> System.Posix.Signals.Ignore
<a name="line-554"></a> Nothing
<a name="line-555"></a> func p
<a name="line-556"></a>-}</span>
<a name="line-557"></a> <span class='hs-keyword'>in</span>
<a name="line-558"></a> <span class='hs-keyword'>do</span>
<a name="line-559"></a> <span class='hs-varid'>p</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>try</span> <span class='hs-layout'>(</span><span class='hs-varid'>forkProcess</span> <span class='hs-varid'>childstuff</span><span class='hs-layout'>)</span>
<a name="line-560"></a> <span class='hs-varid'>pid</span> <span class='hs-keyglyph'><-</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>p</span> <span class='hs-keyword'>of</span>
<a name="line-561"></a> <span class='hs-conid'>Right</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-varid'>x</span>
<a name="line-562"></a> <span class='hs-conid'>Left</span> <span class='hs-varid'>e</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>fail</span> <span class='hs-layout'>(</span><span class='hs-str'>"Error in fork: "</span> <span class='hs-varop'>++</span> <span class='hs-layout'>(</span><span class='hs-varid'>show</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-563"></a> <span class='hs-varid'>return</span> <span class='hs-varid'>pid</span>
<a name="line-564"></a>
<a name="line-565"></a><span class='hs-cpp'>#endif</span>
<a name="line-566"></a><span class='hs-cpp'>#endif</span>
<a name="line-567"></a>
<a name="line-568"></a><a name="showCmd"></a><span class='hs-definition'>showCmd</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>String</span>
<a name="line-569"></a><span class='hs-definition'>showCmd</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>args</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fp</span> <span class='hs-varop'>++</span> <span class='hs-str'>" "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>args</span>
</pre></body>
</html>
