<?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://code.haskell.org/~malcolm/hscolour/ -->
<title>src/Darcs/Ssh.hs</title>
<link type='text/css' rel='stylesheet' href='hscolour.css' />
</head>
<body>
<pre><a name="line-1"></a><span class='hs-comment'>{-# LANGUAGE CPP, ForeignFunctionInterface #-}</span>
<a name="line-2"></a>
<a name="line-3"></a><span class='hs-comment'>-- |</span>
<a name="line-4"></a><span class='hs-comment'>-- Module : Darcs.Ssh</span>
<a name="line-5"></a><span class='hs-comment'>-- Maintainer : darcs-devel@darcs.net</span>
<a name="line-6"></a><span class='hs-comment'>-- Stability : experimental</span>
<a name="line-7"></a><span class='hs-comment'>-- Portability : portable</span>
<a name="line-8"></a>
<a name="line-9"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Darcs</span><span class='hs-varop'>.</span><span class='hs-conid'>Ssh</span>
<a name="line-10"></a> <span class='hs-layout'>(</span>
<a name="line-11"></a> <span class='hs-varid'>copySSH</span>
<a name="line-12"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>SSHCmd</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span>
<a name="line-13"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>getSSH</span>
<a name="line-14"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>environmentHelpSsh</span>
<a name="line-15"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>environmentHelpScp</span>
<a name="line-16"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>environmentHelpSshPort</span>
<a name="line-17"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>remoteDarcs</span>
<a name="line-18"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-19"></a>
<a name="line-20"></a>
<a name="line-21"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Prelude</span> <span class='hs-varid'>hiding</span> <span class='hs-layout'>(</span> <span class='hs-varid'>lookup</span><span class='hs-layout'>,</span> <span class='hs-varid'>catch</span> <span class='hs-layout'>)</span>
<a name="line-22"></a>
<a name="line-23"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Ratified</span> <span class='hs-layout'>(</span> <span class='hs-varid'>hGetContents</span> <span class='hs-layout'>)</span>
<a name="line-24"></a>
<a name="line-25"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Environment</span> <span class='hs-layout'>(</span> <span class='hs-varid'>getEnv</span> <span class='hs-layout'>)</span>
<a name="line-26"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Exit</span> <span class='hs-layout'>(</span> <span class='hs-conid'>ExitCode</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span> <span class='hs-layout'>)</span>
<a name="line-27"></a>
<a name="line-28"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span> <span class='hs-layout'>(</span> <span class='hs-varid'>when</span> <span class='hs-layout'>)</span>
<a name="line-29"></a>
<a name="line-30"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>B</span> <span class='hs-layout'>(</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>,</span> <span class='hs-varid'>hGet</span><span class='hs-layout'>,</span> <span class='hs-varid'>writeFile</span> <span class='hs-layout'>)</span>
<a name="line-31"></a>
<a name="line-32"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Map</span> <span class='hs-layout'>(</span> <span class='hs-conid'>Map</span><span class='hs-layout'>,</span> <span class='hs-varid'>empty</span><span class='hs-layout'>,</span> <span class='hs-varid'>insert</span><span class='hs-layout'>,</span> <span class='hs-varid'>lookup</span> <span class='hs-layout'>)</span>
<a name="line-33"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>IORef</span> <span class='hs-layout'>(</span> <span class='hs-conid'>IORef</span><span class='hs-layout'>,</span> <span class='hs-varid'>newIORef</span><span class='hs-layout'>,</span> <span class='hs-varid'>readIORef</span><span class='hs-layout'>,</span> <span class='hs-varid'>modifyIORef</span> <span class='hs-layout'>)</span>
<a name="line-34"></a>
<a name="line-35"></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-layout'>(</span> <span class='hs-conid'>Handle</span><span class='hs-layout'>,</span> <span class='hs-varid'>hSetBinaryMode</span><span class='hs-layout'>,</span> <span class='hs-varid'>hPutStrLn</span><span class='hs-layout'>,</span> <span class='hs-varid'>hGetLine</span><span class='hs-layout'>,</span> <span class='hs-varid'>hFlush</span> <span class='hs-layout'>)</span>
<a name="line-36"></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'>Unsafe</span> <span class='hs-layout'>(</span> <span class='hs-varid'>unsafePerformIO</span> <span class='hs-layout'>)</span>
<a name="line-37"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Process</span> <span class='hs-layout'>(</span> <span class='hs-varid'>runInteractiveProcess</span> <span class='hs-layout'>)</span>
<a name="line-38"></a>
<a name="line-39"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Darcs</span><span class='hs-varop'>.</span><span class='hs-conid'>SignalHandler</span> <span class='hs-layout'>(</span> <span class='hs-varid'>catchNonSignal</span> <span class='hs-layout'>)</span>
<a name="line-40"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Darcs</span><span class='hs-varop'>.</span><span class='hs-conid'>Flags</span><span class='hs-layout'>(</span> <span class='hs-conid'>RemoteDarcs</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span> <span class='hs-layout'>)</span>
<a name="line-41"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Darcs</span><span class='hs-varop'>.</span><span class='hs-conid'>Global</span> <span class='hs-layout'>(</span> <span class='hs-varid'>defaultSsh</span><span class='hs-layout'>,</span> <span class='hs-conid'>SshSettings</span><span class='hs-layout'>)</span>
<a name="line-42"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Darcs</span><span class='hs-varop'>.</span><span class='hs-conid'>URL</span> <span class='hs-layout'>(</span><span class='hs-conid'>SshFilePath</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>urlOf</span><span class='hs-layout'>)</span>
<a name="line-43"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Darcs</span><span class='hs-varop'>.</span><span class='hs-conid'>Utils</span> <span class='hs-layout'>(</span> <span class='hs-varid'>breakCommand</span><span class='hs-layout'>,</span> <span class='hs-varid'>prettyException</span><span class='hs-layout'>,</span> <span class='hs-varid'>catchall</span> <span class='hs-layout'>)</span>
<a name="line-44"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Exec</span> <span class='hs-layout'>(</span> <span class='hs-varid'>exec</span><span class='hs-layout'>,</span> <span class='hs-conid'>Redirect</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-layout'>)</span>
<a name="line-45"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Progress</span> <span class='hs-layout'>(</span> <span class='hs-varid'>withoutProgress</span><span class='hs-layout'>,</span> <span class='hs-varid'>debugMessage</span><span class='hs-layout'>,</span> <span class='hs-varid'>debugFail</span> <span class='hs-layout'>)</span>
<a name="line-46"></a>
<a name="line-47"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Darcs</span><span class='hs-varop'>.</span><span class='hs-conid'>Global</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>Settings</span>
<a name="line-48"></a>
<a name="line-49"></a>
<a name="line-50"></a><a name="sshConnections"></a><span class='hs-definition'>sshConnections</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IORef</span> <span class='hs-layout'>(</span><span class='hs-conid'>Map</span> <span class='hs-conid'>String</span> <span class='hs-layout'>(</span><span class='hs-conid'>Maybe</span> <span class='hs-conid'>Connection</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-51"></a><span class='hs-definition'>sshConnections</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafePerformIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>newIORef</span> <span class='hs-varid'>empty</span>
<a name="line-52"></a><span class='hs-comment'>{-# NOINLINE sshConnections #-}</span>
<a name="line-53"></a>
<a name="line-54"></a>
<a name="line-55"></a><a name="Connection"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>Connection</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>C</span>
<a name="line-56"></a> <span class='hs-layout'>{</span> <span class='hs-varid'>inp</span> <span class='hs-keyglyph'>::</span> <span class='hs-varop'>!</span><span class='hs-conid'>Handle</span>
<a name="line-57"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>out</span> <span class='hs-keyglyph'>::</span> <span class='hs-varop'>!</span><span class='hs-conid'>Handle</span>
<a name="line-58"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>err</span> <span class='hs-keyglyph'>::</span> <span class='hs-varop'>!</span><span class='hs-conid'>Handle</span>
<a name="line-59"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>deb</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'>()</span>
<a name="line-60"></a> <span class='hs-layout'>}</span>
<a name="line-61"></a>
<a name="line-62"></a>
<a name="line-63"></a><a name="withSSHConnection"></a><span class='hs-comment'>-- | @withSSHConnection rdarcs repoid withconnection withoutconnection@</span>
<a name="line-64"></a><span class='hs-comment'>-- performs an action on a remote host. If we are already connected to @repoid @,</span>
<a name="line-65"></a><span class='hs-comment'>-- then it does @withconnection@, else @withoutconnection@.</span>
<a name="line-66"></a><span class='hs-definition'>withSSHConnection</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-comment'>-- ^ rdarcs</span>
<a name="line-67"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>SshFilePath</span> <span class='hs-comment'>-- ^ Destination repo id</span>
<a name="line-68"></a> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Connection</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'>-- ^ withconnection</span>
<a name="line-69"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span> <span class='hs-comment'>-- ^ withoutconnection</span>
<a name="line-70"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span>
<a name="line-71"></a><span class='hs-definition'>withSSHConnection</span> <span class='hs-varid'>rdarcs</span> <span class='hs-varid'>repoid</span> <span class='hs-varid'>withconnection</span> <span class='hs-varid'>withoutconnection</span> <span class='hs-keyglyph'>=</span>
<a name="line-72"></a> <span class='hs-varid'>withoutProgress</span> <span class='hs-varop'>$</span>
<a name="line-73"></a> <span class='hs-keyword'>do</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>readIORef</span> <span class='hs-varid'>sshConnections</span>
<a name="line-74"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>lookup</span> <span class='hs-layout'>(</span><span class='hs-varid'>sshUhost</span> <span class='hs-varid'>repoid</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>cs</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Map</span> <span class='hs-conid'>String</span> <span class='hs-layout'>(</span><span class='hs-conid'>Maybe</span> <span class='hs-conid'>Connection</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyword'>of</span>
<a name="line-75"></a> <span class='hs-conid'>Just</span> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>withoutconnection</span>
<a name="line-76"></a> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>withconnection</span> <span class='hs-varid'>c</span>
<a name="line-77"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span>
<a name="line-78"></a> <span class='hs-keyword'>do</span> <span class='hs-varid'>mc</span> <span class='hs-keyglyph'><-</span> <span class='hs-keyword'>do</span> <span class='hs-layout'>(</span><span class='hs-varid'>ssh</span><span class='hs-layout'>,</span><span class='hs-varid'>sshargs_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>getSSH</span> <span class='hs-conid'>SSH</span>
<a name="line-79"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>sshargs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>sshargs_</span> <span class='hs-varop'>++</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>sshUhost</span> <span class='hs-varid'>repoid</span><span class='hs-layout'>,</span> <span class='hs-varid'>rdarcs</span><span class='hs-layout'>,</span>
<a name="line-80"></a> <span class='hs-str'>"transfer-mode"</span><span class='hs-layout'>,</span><span class='hs-str'>"--repodir"</span><span class='hs-layout'>,</span><span class='hs-varid'>sshRepo</span> <span class='hs-varid'>repoid</span><span class='hs-keyglyph'>]</span>
<a name="line-81"></a> <span class='hs-varid'>debugMessage</span> <span class='hs-varop'>$</span> <span class='hs-varid'>unwords</span> <span class='hs-layout'>(</span><span class='hs-varid'>ssh</span> <span class='hs-conop'>:</span> <span class='hs-varid'>sshargs</span><span class='hs-layout'>)</span>
<a name="line-82"></a> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-layout'>,</span><span class='hs-varid'>o</span><span class='hs-layout'>,</span><span class='hs-varid'>e</span><span class='hs-layout'>,</span><span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>runInteractiveProcess</span> <span class='hs-varid'>ssh</span> <span class='hs-varid'>sshargs</span> <span class='hs-conid'>Nothing</span> <span class='hs-conid'>Nothing</span>
<a name="line-83"></a> <span class='hs-varid'>hSetBinaryMode</span> <span class='hs-varid'>i</span> <span class='hs-conid'>True</span>
<a name="line-84"></a> <span class='hs-varid'>hSetBinaryMode</span> <span class='hs-varid'>o</span> <span class='hs-conid'>True</span>
<a name="line-85"></a> <span class='hs-varid'>l</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>hGetLine</span> <span class='hs-varid'>o</span>
<a name="line-86"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>l</span> <span class='hs-varop'>==</span> <span class='hs-str'>"Hello user, I am darcs transfer mode"</span>
<a name="line-87"></a> <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-88"></a> <span class='hs-keyword'>else</span> <span class='hs-varid'>debugFail</span> <span class='hs-str'>"Couldn't start darcs transfer-mode on server"</span>
<a name="line-89"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>C</span> <span class='hs-layout'>{</span> <span class='hs-varid'>inp</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>i</span><span class='hs-layout'>,</span> <span class='hs-varid'>out</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>o</span><span class='hs-layout'>,</span> <span class='hs-varid'>err</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>e</span><span class='hs-layout'>,</span>
<a name="line-90"></a> <span class='hs-varid'>deb</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>s</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>debugMessage</span> <span class='hs-layout'>(</span><span class='hs-str'>"with ssh (transfer-mode) "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>sshUhost</span> <span class='hs-varid'>repoid</span> <span class='hs-varop'>++</span> <span class='hs-str'>" "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>}</span>
<a name="line-91"></a> <span class='hs-varid'>modifyIORef</span> <span class='hs-varid'>sshConnections</span> <span class='hs-layout'>(</span><span class='hs-varid'>insert</span> <span class='hs-layout'>(</span><span class='hs-varid'>sshUhost</span> <span class='hs-varid'>repoid</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-92"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-conid'>Just</span> <span class='hs-varid'>c</span>
<a name="line-93"></a> <span class='hs-varop'>`catchNonSignal`</span>
<a name="line-94"></a> <span class='hs-keyglyph'>\</span><span class='hs-varid'>e</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span> <span class='hs-varid'>debugMessage</span> <span class='hs-varop'>$</span> <span class='hs-str'>"Failed to start ssh connection:\n "</span><span class='hs-varop'>++</span>
<a name="line-95"></a> <span class='hs-varid'>prettyException</span> <span class='hs-varid'>e</span>
<a name="line-96"></a> <span class='hs-varid'>severSSHConnection</span> <span class='hs-varid'>repoid</span>
<a name="line-97"></a> <span class='hs-varid'>debugMessage</span> <span class='hs-varop'>$</span> <span class='hs-varid'>unlines</span> <span class='hs-varop'>$</span>
<a name="line-98"></a> <span class='hs-keyglyph'>[</span> <span class='hs-str'>"NOTE: the server may be running a version of darcs prior to 2.0.0."</span>
<a name="line-99"></a> <span class='hs-layout'>,</span> <span class='hs-str'>""</span>
<a name="line-100"></a> <span class='hs-layout'>,</span> <span class='hs-str'>"Installing darcs 2 on the server will speed up ssh-based commands."</span>
<a name="line-101"></a> <span class='hs-keyglyph'>]</span>
<a name="line-102"></a> <span class='hs-varid'>return</span> <span class='hs-conid'>Nothing</span>
<a name="line-103"></a> <span class='hs-varid'>maybe</span> <span class='hs-varid'>withoutconnection</span> <span class='hs-varid'>withconnection</span> <span class='hs-varid'>mc</span>
<a name="line-104"></a>
<a name="line-105"></a><a name="severSSHConnection"></a><span class='hs-definition'>severSSHConnection</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>SshFilePath</span>
<a name="line-106"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-107"></a><span class='hs-definition'>severSSHConnection</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-108"></a> <span class='hs-varid'>debugMessage</span> <span class='hs-varop'>$</span> <span class='hs-str'>"Severing ssh failed connection to "</span> <span class='hs-varop'>++</span> <span class='hs-layout'>(</span><span class='hs-varid'>sshUhost</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span>
<a name="line-109"></a> <span class='hs-varid'>modifyIORef</span> <span class='hs-varid'>sshConnections</span> <span class='hs-layout'>(</span><span class='hs-varid'>insert</span> <span class='hs-layout'>(</span><span class='hs-varid'>urlOf</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-conid'>Nothing</span><span class='hs-layout'>)</span>
<a name="line-110"></a>
<a name="line-111"></a>
<a name="line-112"></a><a name="grabSSH"></a><span class='hs-definition'>grabSSH</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>SshFilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Connection</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span>
<a name="line-113"></a><span class='hs-definition'>grabSSH</span> <span class='hs-varid'>dest</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-114"></a> <span class='hs-varid'>debugMessage</span> <span class='hs-varop'>$</span> <span class='hs-str'>"grabSSH dest="</span> <span class='hs-varop'>++</span> <span class='hs-varid'>urlOf</span> <span class='hs-varid'>dest</span>
<a name="line-115"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>failwith</span> <span class='hs-varid'>e</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>severSSHConnection</span> <span class='hs-varid'>dest</span>
<a name="line-116"></a> <span class='hs-comment'>-- hGetContents is ok here because we're</span>
<a name="line-117"></a> <span class='hs-comment'>-- only grabbing stderr, and we're also</span>
<a name="line-118"></a> <span class='hs-comment'>-- about to throw the contents.</span>
<a name="line-119"></a> <span class='hs-varid'>eee</span> <span class='hs-keyglyph'><-</span> <span class='hs-conid'>Ratified</span><span class='hs-varop'>.</span><span class='hs-varid'>hGetContents</span> <span class='hs-layout'>(</span><span class='hs-varid'>err</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span>
<a name="line-120"></a> <span class='hs-varid'>debugFail</span> <span class='hs-varop'>$</span> <span class='hs-varid'>e</span> <span class='hs-varop'>++</span> <span class='hs-str'>" grabbing ssh file "</span><span class='hs-varop'>++</span>
<a name="line-121"></a> <span class='hs-varid'>urlOf</span> <span class='hs-varid'>dest</span><span class='hs-varop'>++</span><span class='hs-str'>"/"</span><span class='hs-varop'>++</span> <span class='hs-varid'>file</span> <span class='hs-varop'>++</span><span class='hs-str'>"\n"</span><span class='hs-varop'>++</span><span class='hs-varid'>eee</span>
<a name="line-122"></a> <span class='hs-varid'>file</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>sshFile</span> <span class='hs-varid'>dest</span>
<a name="line-123"></a> <span class='hs-varid'>deb</span> <span class='hs-varid'>c</span> <span class='hs-varop'>$</span> <span class='hs-str'>"get "</span><span class='hs-varop'>++</span> <span class='hs-varid'>file</span>
<a name="line-124"></a> <span class='hs-varid'>hPutStrLn</span> <span class='hs-layout'>(</span><span class='hs-varid'>inp</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-str'>"get "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>file</span>
<a name="line-125"></a> <span class='hs-varid'>hFlush</span> <span class='hs-layout'>(</span><span class='hs-varid'>inp</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span>
<a name="line-126"></a> <span class='hs-varid'>l2</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>hGetLine</span> <span class='hs-layout'>(</span><span class='hs-varid'>out</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span>
<a name="line-127"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>l2</span> <span class='hs-varop'>==</span> <span class='hs-str'>"got "</span><span class='hs-varop'>++</span><span class='hs-varid'>file</span>
<a name="line-128"></a> <span class='hs-keyword'>then</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>showlen</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>hGetLine</span> <span class='hs-layout'>(</span><span class='hs-varid'>out</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span>
<a name="line-129"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>reads</span> <span class='hs-varid'>showlen</span> <span class='hs-keyword'>of</span>
<a name="line-130"></a> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-layout'>,</span><span class='hs-str'>""</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>hGet</span> <span class='hs-layout'>(</span><span class='hs-varid'>out</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>len</span>
<a name="line-131"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>failwith</span> <span class='hs-str'>"Couldn't get length"</span>
<a name="line-132"></a> <span class='hs-keyword'>else</span> <span class='hs-keyword'>if</span> <span class='hs-varid'>l2</span> <span class='hs-varop'>==</span> <span class='hs-str'>"error "</span><span class='hs-varop'>++</span><span class='hs-varid'>file</span>
<a name="line-133"></a> <span class='hs-keyword'>then</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>e</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>hGetLine</span> <span class='hs-layout'>(</span><span class='hs-varid'>out</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span>
<a name="line-134"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>reads</span> <span class='hs-varid'>e</span> <span class='hs-keyword'>of</span>
<a name="line-135"></a> <span class='hs-layout'>(</span><span class='hs-varid'>msg</span><span class='hs-layout'>,</span><span class='hs-keyword'>_</span><span class='hs-layout'>)</span><span class='hs-conop'>:</span><span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>debugFail</span> <span class='hs-varop'>$</span> <span class='hs-str'>"Error reading file remotely:\n"</span><span class='hs-varop'>++</span><span class='hs-varid'>msg</span>
<a name="line-136"></a> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>failwith</span> <span class='hs-str'>"An error occurred"</span>
<a name="line-137"></a> <span class='hs-keyword'>else</span> <span class='hs-varid'>failwith</span> <span class='hs-str'>"Error"</span>
<a name="line-138"></a>
<a name="line-139"></a><a name="remoteDarcs"></a><span class='hs-definition'>remoteDarcs</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>RemoteDarcs</span>
<a name="line-140"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>String</span>
<a name="line-141"></a><span class='hs-definition'>remoteDarcs</span> <span class='hs-conid'>DefaultRemoteDarcs</span> <span class='hs-keyglyph'>=</span> <span class='hs-str'>"darcs"</span>
<a name="line-142"></a><span class='hs-definition'>remoteDarcs</span> <span class='hs-layout'>(</span><span class='hs-conid'>RemoteDarcs</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>x</span>
<a name="line-143"></a>
<a name="line-144"></a>
<a name="line-145"></a><a name="copySSH"></a><span class='hs-definition'>copySSH</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>RemoteDarcs</span>
<a name="line-146"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>SshFilePath</span>
<a name="line-147"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>FilePath</span>
<a name="line-148"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-149"></a><span class='hs-definition'>copySSH</span> <span class='hs-varid'>remote</span> <span class='hs-varid'>dest</span> <span class='hs-varid'>to</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>rdarcs</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>remoteDarcs</span> <span class='hs-varid'>remote</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-150"></a> <span class='hs-varid'>debugMessage</span> <span class='hs-varop'>$</span> <span class='hs-str'>"copySSH file: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>urlOf</span> <span class='hs-varid'>dest</span>
<a name="line-151"></a> <span class='hs-varid'>withSSHConnection</span> <span class='hs-varid'>rdarcs</span> <span class='hs-varid'>dest</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>c</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>grabSSH</span> <span class='hs-varid'>dest</span> <span class='hs-varid'>c</span> <span class='hs-varop'>>>=</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>writeFile</span> <span class='hs-varid'>to</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>do</span>
<a name="line-152"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>u</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>escape_dollar</span> <span class='hs-varop'>$</span> <span class='hs-varid'>urlOf</span> <span class='hs-varid'>dest</span>
<a name="line-153"></a> <span class='hs-layout'>(</span><span class='hs-varid'>scp</span><span class='hs-layout'>,</span> <span class='hs-varid'>args</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>getSSH</span> <span class='hs-conid'>SCP</span>
<a name="line-154"></a> <span class='hs-varid'>r</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>exec</span> <span class='hs-varid'>scp</span> <span class='hs-layout'>(</span><span class='hs-varid'>args</span> <span class='hs-varop'>++</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>u</span><span class='hs-layout'>,</span> <span class='hs-varid'>to</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>AsIs</span><span class='hs-layout'>,</span><span class='hs-conid'>AsIs</span><span class='hs-layout'>,</span><span class='hs-conid'>AsIs</span><span class='hs-layout'>)</span>
<a name="line-155"></a> <span class='hs-varid'>when</span> <span class='hs-layout'>(</span><span class='hs-varid'>r</span> <span class='hs-varop'>/=</span> <span class='hs-conid'>ExitSuccess</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span>
<a name="line-156"></a> <span class='hs-varid'>debugFail</span> <span class='hs-varop'>$</span> <span class='hs-str'>"(scp) failed to fetch: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>u</span>
<a name="line-157"></a> <span class='hs-keyword'>where</span>
<a name="line-158"></a> <span class='hs-comment'>-- '$' in filenames is troublesome for scp, for some reason.</span>
<a name="line-159"></a> <span class='hs-varid'>escape_dollar</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>String</span>
<a name="line-160"></a> <span class='hs-varid'>escape_dollar</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>concatMap</span> <span class='hs-varid'>tr</span>
<a name="line-161"></a> <span class='hs-keyword'>where</span>
<a name="line-162"></a> <span class='hs-varid'>tr</span> <span class='hs-chr'>'$'</span> <span class='hs-keyglyph'>=</span> <span class='hs-str'>"\\$"</span>
<a name="line-163"></a> <span class='hs-varid'>tr</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>c</span><span class='hs-keyglyph'>]</span>
<a name="line-164"></a>
<a name="line-165"></a>
<a name="line-166"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-167"></a><span class='hs-comment'>-- older ssh helper functions</span>
<a name="line-168"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-169"></a>
<a name="line-170"></a><a name="SSHCmd"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>SSHCmd</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>SSH</span>
<a name="line-171"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>SCP</span>
<a name="line-172"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>SFTP</span>
<a name="line-173"></a>
<a name="line-174"></a>
<a name="line-175"></a><a name="fromSshCmd"></a><span class='hs-definition'>fromSshCmd</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>SshSettings</span>
<a name="line-176"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>SSHCmd</span>
<a name="line-177"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>String</span>
<a name="line-178"></a><span class='hs-definition'>fromSshCmd</span> <span class='hs-varid'>s</span> <span class='hs-conid'>SSH</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Settings</span><span class='hs-varop'>.</span><span class='hs-varid'>ssh</span> <span class='hs-varid'>s</span>
<a name="line-179"></a><span class='hs-definition'>fromSshCmd</span> <span class='hs-varid'>s</span> <span class='hs-conid'>SCP</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Settings</span><span class='hs-varop'>.</span><span class='hs-varid'>scp</span> <span class='hs-varid'>s</span>
<a name="line-180"></a><span class='hs-definition'>fromSshCmd</span> <span class='hs-varid'>s</span> <span class='hs-conid'>SFTP</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Settings</span><span class='hs-varop'>.</span><span class='hs-varid'>sftp</span> <span class='hs-varid'>s</span>
<a name="line-181"></a>
<a name="line-182"></a>
<a name="line-183"></a><a name="getSSH"></a><span class='hs-comment'>-- | Return the command and arguments needed to run an ssh command</span>
<a name="line-184"></a><span class='hs-comment'>-- First try the appropriate darcs environment variable and SSH_PORT</span>
<a name="line-185"></a><span class='hs-comment'>-- defaulting to "ssh" and no specified port.</span>
<a name="line-186"></a><span class='hs-definition'>getSSH</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>SSHCmd</span>
<a name="line-187"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>String</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-188"></a><span class='hs-definition'>getSSH</span> <span class='hs-varid'>cmd</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-189"></a> <span class='hs-varid'>port</span> <span class='hs-keyglyph'><-</span> <span class='hs-layout'>(</span><span class='hs-varid'>portFlag</span> <span class='hs-varid'>cmd</span> <span class='hs-varop'>`fmap`</span> <span class='hs-varid'>getEnv</span> <span class='hs-str'>"SSH_PORT"</span><span class='hs-layout'>)</span> <span class='hs-varop'>`catchall`</span> <span class='hs-varid'>return</span> <span class='hs-conid'>[]</span>
<a name="line-190"></a> <span class='hs-keyword'>let</span> <span class='hs-layout'>(</span><span class='hs-varid'>ssh</span><span class='hs-layout'>,</span> <span class='hs-varid'>ssh_args</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>breakCommand</span> <span class='hs-varid'>command</span>
<a name="line-191"></a> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-varid'>ssh</span><span class='hs-layout'>,</span> <span class='hs-varid'>ssh_args</span> <span class='hs-varop'>++</span> <span class='hs-varid'>port</span><span class='hs-layout'>)</span>
<a name="line-192"></a> <span class='hs-keyword'>where</span>
<a name="line-193"></a> <span class='hs-varid'>command</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fromSshCmd</span> <span class='hs-varid'>defaultSsh</span> <span class='hs-varid'>cmd</span>
<a name="line-194"></a> <span class='hs-varid'>portFlag</span> <span class='hs-conid'>SSH</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-str'>"-p"</span><span class='hs-layout'>,</span> <span class='hs-varid'>x</span><span class='hs-keyglyph'>]</span>
<a name="line-195"></a> <span class='hs-varid'>portFlag</span> <span class='hs-conid'>SCP</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-str'>"-P"</span><span class='hs-layout'>,</span> <span class='hs-varid'>x</span><span class='hs-keyglyph'>]</span>
<a name="line-196"></a> <span class='hs-varid'>portFlag</span> <span class='hs-conid'>SFTP</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-str'>"-oPort="</span> <span class='hs-varop'>++</span> <span class='hs-varid'>x</span><span class='hs-keyglyph'>]</span>
<a name="line-197"></a>
<a name="line-198"></a>
<a name="line-199"></a><a name="environmentHelpSsh"></a><span class='hs-definition'>environmentHelpSsh</span> <span class='hs-keyglyph'>::</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> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span>
<a name="line-200"></a><span class='hs-definition'>environmentHelpSsh</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>[</span><span class='hs-str'>"DARCS_SSH"</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span>
<a name="line-201"></a> <span class='hs-str'>"Repositories of the form [user@]host:[dir] are taken to be remote"</span><span class='hs-layout'>,</span>
<a name="line-202"></a> <span class='hs-str'>"repositories, which Darcs accesses with the external program ssh(1)."</span><span class='hs-layout'>,</span>
<a name="line-203"></a> <span class='hs-str'>""</span><span class='hs-layout'>,</span>
<a name="line-204"></a> <span class='hs-str'>"The environment variable $DARCS_SSH can be used to specify an"</span><span class='hs-layout'>,</span>
<a name="line-205"></a> <span class='hs-str'>"alternative SSH client. Arguments may be included, separated by"</span><span class='hs-layout'>,</span>
<a name="line-206"></a> <span class='hs-str'>"whitespace. The value is not interpreted by a shell, so shell"</span><span class='hs-layout'>,</span>
<a name="line-207"></a> <span class='hs-str'>"constructs cannot be used; in particular, it is not possible for the"</span><span class='hs-layout'>,</span>
<a name="line-208"></a> <span class='hs-str'>"program name to contain whitespace by using quoting or escaping."</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span>
<a name="line-209"></a>
<a name="line-210"></a>
<a name="line-211"></a><a name="environmentHelpScp"></a><span class='hs-definition'>environmentHelpScp</span> <span class='hs-keyglyph'>::</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> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span>
<a name="line-212"></a><span class='hs-definition'>environmentHelpScp</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>[</span><span class='hs-str'>"DARCS_SCP"</span><span class='hs-layout'>,</span> <span class='hs-str'>"DARCS_SFTP"</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span>
<a name="line-213"></a> <span class='hs-str'>"When reading from a remote repository, Darcs will attempt to run"</span><span class='hs-layout'>,</span>
<a name="line-214"></a> <span class='hs-str'>"`darcs transfer-mode' on the remote host. This will fail if the"</span><span class='hs-layout'>,</span>
<a name="line-215"></a> <span class='hs-str'>"remote host only has Darcs 1 installed, doesn't have Darcs installed"</span><span class='hs-layout'>,</span>
<a name="line-216"></a> <span class='hs-str'>"at all, or only allows SFTP."</span><span class='hs-layout'>,</span>
<a name="line-217"></a> <span class='hs-str'>""</span><span class='hs-layout'>,</span>
<a name="line-218"></a> <span class='hs-str'>"If transfer-mode fails, Darcs will fall back on scp(1) and sftp(1)."</span><span class='hs-layout'>,</span>
<a name="line-219"></a> <span class='hs-str'>"The commands invoked can be customized with the environment variables"</span><span class='hs-layout'>,</span>
<a name="line-220"></a> <span class='hs-str'>"$DARCS_SCP and $DARCS_SFTP respectively, which behave like $DARCS_SSH."</span><span class='hs-layout'>,</span>
<a name="line-221"></a> <span class='hs-str'>"If the remote end allows only sftp, try setting DARCS_SCP=sftp."</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span>
<a name="line-222"></a>
<a name="line-223"></a>
<a name="line-224"></a><a name="environmentHelpSshPort"></a><span class='hs-definition'>environmentHelpSshPort</span> <span class='hs-keyglyph'>::</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> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span>
<a name="line-225"></a><span class='hs-definition'>environmentHelpSshPort</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>[</span><span class='hs-str'>"SSH_PORT"</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span>
<a name="line-226"></a> <span class='hs-str'>"If this environment variable is set, it will be used as the port"</span><span class='hs-layout'>,</span>
<a name="line-227"></a> <span class='hs-str'>"number for all SSH calls made by Darcs (when accessing remote"</span><span class='hs-layout'>,</span>
<a name="line-228"></a> <span class='hs-str'>"repositories over SSH). This is useful if your SSH server does not"</span><span class='hs-layout'>,</span>
<a name="line-229"></a> <span class='hs-str'>"run on the default port, and your SSH client does not support"</span><span class='hs-layout'>,</span>
<a name="line-230"></a> <span class='hs-str'>"ssh_config(5). OpenSSH users will probably prefer to put something"</span><span class='hs-layout'>,</span>
<a name="line-231"></a> <span class='hs-str'>"like `Host *.example.net Port 443' into their ~/.ssh/config file."</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span>
</pre></body>
</html>
